Coding Agent 설정

Kilo Code 설치 및 API 설정

Kilo Code를 설치하고 BetterToken Base URL 및 API Key를 설정한 다음 모델을 선택하고 일반적인 오류를 해결하세요.

Kilo Code를 BetterToken에 연결하려면 API Key를 준비하고 아래 Base URL을 입력한 후 모델 광장에서 현재 Model ID를 선택하세요.

설정은 세 단계입니다. Kilo Code의 Providers 설정에서 Custom provider를 추가하고 OpenAI Compatible을 선택한 뒤 BetterToken API Key, https://bettertoken.ai/v1, 현재 Model ID를 입력하세요. 저장 후 확장 프로그램을 다시 시작하고 새 채팅에서 짧은 첫 요청을 보내 연결을 확인하세요.

주요 설정

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

사전 요구 사항

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

가입하고 BetterToken API Key 받기

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

추가 요구 사항

VS Code가 설치되어 있음

설치

Kilo Code가 이미 설치되어 있다면 수동 설정으로 바로 이동해 BetterToken API Key, Base URL 및 Model ID를 입력하세요.

확장 프로그램을 아직 설치하지 않았거나 설치와 지역별 사용 배경이 필요하다면 영문 Kilo Code 설치 및 custom API 가이드를 읽은 다음 현재 설정 필드를 확인하기 위해 이 페이지로 돌아오세요.

수동 설정

Kilo Code settings UI에서 이 설정을 완료하세요. configuration file을 직접 수정할 필요가 없습니다.

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

설정

충돌하는 environment variables 제거

unset OPENAI_API_KEY
unset OPENAI_BASE_URL

Kilo Code settings 열기

Settings(톱니바퀴 아이콘)를 열고 Providers를 선택한 다음 목록 아래의 Custom provider를 클릭하세요.

API provider 설정

다음을 입력하세요.

Provider ID → bettertoken
Display name → BetterToken
Provider API → OpenAI Compatible
Base URL → https://bettertoken.ai/v1
API Key → BetterToken API Key
Models → 모델 광장에서 복사한 Model ID를 직접 추가하고 표시 이름에도 같은 ID 사용

Submit을 클릭해 provider를 저장하세요. 위 항목은 공식 Custom Models 가이드의 VS Code 확장 프로그램 필드입니다.

공식 문서에서 명시적으로 요구할 때만 extra headers 설정

확인한 Kilo Code 공식 자료에서는 OpenAI-compatible providers에 optional custom headers를 언급하지만, User-Agent를 BetterToken 설정의 필수 단계로 취급하지 않습니다.

custom gateway, tenant routing, observability 또는 caching layer도 사용한다면 해당 upstream service의 공식 문서에 따라서만 headers를 추가하세요.

Kilo Code 다시 시작

config를 변경한 후 VS Code를 다시 시작하거나 Kilo Code extension을 다시 로드하여 새 settings를 적용하세요.

연결 확인

OK만 답하세요와 같은 짧은 첫 요청을 보내세요. 인증 또는 Model ID 오류 없이 응답하면 연결된 것입니다. 설정을 변경한 후에는 도구를 완전히 다시 시작하세요. 실패하면 일반적인 오류를 확인하세요.

Kilo CLI

공식 Kilo CLI를 설치하세요. 확장 프로그램과 별도로 설치해야 합니다. GPT 모델을 사용한 macOS 테스트에서 Kilo CLI 7.8.17은 /v1/chat/completions를 통해 텍스트 요청과 파일 읽기 도구 호출을 완료했습니다.

실행할 터미널에서 BetterToken API Key를 설정하세요.

export BETTERTOKEN_API_KEY="YOUR_API_KEY"

프로젝트에 kilo.json을 만드세요. 모든 YOUR_MODEL_ID를 모델 광장의 정확한 ID로 바꾸세요.

{
  "provider": {
    "bettertoken": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "BetterToken",
      "options": {
        "baseURL": "https://bettertoken.ai/v1",
        "apiKey": "{env:BETTERTOKEN_API_KEY}"
      },
      "models": {
        "YOUR_MODEL_ID": { "name": "YOUR_MODEL_ID" }
      }
    }
  },
  "model": "bettertoken/YOUR_MODEL_ID",
  "permission": { "read": "allow", "edit": "deny", "bash": "deny" },
  "agent": { "build": { "steps": 4 } }
}

KILO_CONFIG을 해당 파일로 지정한 뒤 비대화형 텍스트 확인을 실행하세요.

export KILO_CONFIG="$PWD/kilo.json"
kilo run --format json -m bettertoken/YOUR_MODEL_ID "Reply with only: OK"

최종 답변이 OK인지 확인하세요. 이 구성은 파일 읽기를 허용하고 편집과 셸 명령을 거부합니다. 파일을 KILO_CONFIG로 전달하면 신뢰할 수 있는 구성 소스로 처리되어 {env:...} 참조를 확장할 수 있습니다. 저장소에서만 불러온 프로젝트 구성은 환경 변수 참조를 확장하지 않습니다. 위처럼 KILO_CONFIG를 명시하세요.

모델 전환

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을 저장하고 도구를 완전히 다시 시작하세요.

기술 세부 정보

Protocol, endpoint 및 내부 provider 필드

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