Coding Agent 설정

Kodacode: API 설정 및 429 오류 해결

Kodacode에 BetterToken API Key, Base URL, Model ID를 설정하고 429 오류와 기타 일반적인 문제를 해결하세요.

Kodacode를 BetterToken에 연결하려면 API Key를 준비하고 아래 Base URL을 입력한 후 모델 광장에서 현재 Model ID를 선택하세요. MonkeyCode에서 문제가 발생했다면 별도의 MonkeyCode 가이드를 확인하세요.

주요 설정

필드	값
API Key	BetterToken API Key
Base URL	`https://bettertoken.ai/v1`
모델	모델 광장의 현재 Model ID

사전 요구 사항

최신 버전의 도구가 설치되어 있음
BetterToken API Key: 등록하고 발급받기
모델 광장의 Model ID

가입하고 BetterToken API Key 받기

이미 계정이 있나요? 로그인하고 잔액을 충전한 다음 콘솔에서 키를 만드세요.

추가 요구 사항

VS Code가 설치되어 있음
Kodacode / Koda extension이 설치되어 있음
모델 광장에서 정확한 Model ID를 복사하세요.

설치

Kodacode를 설치하거나 연 다음 아래의 수동 설정을 계속하세요.

수동 설정

필드	값
API Key	BetterToken API Key
Base URL	`https://bettertoken.ai/v1`
모델	모델 광장의 현재 Model ID

설정

Koda panel을 열고 모델 추가

VS Code sidebar에서 KODA panel을 열고 input box 아래의 model selector를 클릭한 다음 모델 추가: Agent / Add model: Agent를 선택하세요.

Koda panel의 model selector에서 Add model: Agent를 선택합니다.

OpenAI-compatible model settings 입력

add model dialog에서 다음 값을 사용하세요.

필드	권장 값
Provider	`Any OpenAI-compatible API`
API Base	`https://bettertoken.ai/v1/`
Model ID	모델 광장의 모델 ID(예: `YOUR_MODEL_ID`)
API Key	BetterToken API Key

fields를 입력한 후 연결 / Connect를 클릭하세요.

Kodacode add model dialog에서 Any OpenAI-compatible API를 선택하고 API Base, Model ID 및 API Key를 입력합니다.

모델이 활성화되었는지 확인

연결에 성공하면 Koda input box 아래의 model selector에서 YOUR_MODEL_ID와 같은 새 모델을 선택하세요. 짧은 message를 보내 response가 반환되는지 확인하세요.

config.yaml 확인

Kodacode는 configuration을 ~/.koda/config.yaml에 작성합니다. 이 file을 열어 모델이 추가되었는지 확인하세요.

OpenAI-compatible model configuration이 추가된 Kodacode config.yaml입니다.

config.yaml 예시

이 전체 structure를 참고하세요. YOUR_API_KEY를 BetterToken API Key로 바꾸고 실제 API Key를 repository에 commit하지 마세요.

name: Koda
version: 0.0.1
schema: v1
models:
  - name: Koda Models
    provider: koda-chat-models
    model: AUTODETECT
    roles:
      - agent
      - chat
      - edit
  - name: YOUR_MODEL_ID
    provider: openai
    model: YOUR_MODEL_ID
    apiKey: YOUR_API_KEY
    apiBase: https://bettertoken.ai/v1/
    roles:
      - agent
      - chat
      - edit
context:
  - provider: code
  - provider: docs
  - provider: diff
  - provider: terminal
  - provider: problems
  - provider: folder
  - provider: codebase

연결 확인

짧은 테스트 prompt를 보내세요. 도구가 authentication 또는 Model ID 오류 없이 response를 반환하면 연결이 작동합니다. configuration을 변경한 후에는 도구를 완전히 다시 시작하세요.

모델 전환

model selector를 열거나 configuration의 Model field를 변경하세요. 모델 광장의 정확한 Model ID를 사용한 다음 현재 session을 다시 시작하세요.

일반적인 오류

오류	확인할 사항
`401` 또는 `Unauthorized`	BetterToken API Key를 확인하고 앞뒤 spaces를 제거하세요.
`404`	Base URL을 확인하고 specific endpoint path를 추가하지 마세요.
`model not found`	모델 광장에서 현재 Model ID를 복사하세요.
Changes가 적용되지 않음	configuration을 저장하고 도구를 완전히 다시 시작하세요.

연결에 실패하면 API Base가 https://bettertoken.ai/v1/인지 확인하고 끝의 /를 유지하세요.
모델 광장에서 정확한 Model ID를 복사하세요.
authentication에 실패하면 API Key를 다시 복사하고 extra spaces 또는 line breaks를 피하세요.
config.yaml 변경 사항이 적용되지 않으면 VS Code를 다시 시작하거나 Developer: Reload Window를 실행하세요.
BetterToken에는 보통 extra User-Agent 또는 custom headers가 필요하지 않습니다.

고급 설정

기술 세부 정보

Protocol, endpoint 및 내부 provider 필드

이 설정은 https://bettertoken.ai/v1을 사용합니다. 도구가 OpenAI-compatible endpoint path를 추가합니다. 특정 field에서 명시적으로 요구하지 않는 한 /chat/completions 또는 /responses를 추가하지 마세요.