러시아의 Kilo Code: API 설정과 첫 요청

Kilo Code는 내장 OpenAI Compatible provider로 연결할 수 있습니다. 현재 확장 기능, 자신의 API Key, Base URL, 현재 Model ID가 필요합니다. 설정 후 확장을 다시 시작하고 짧은 요청을 보낸 다음 Dashboard에서 모델, 상태, Token 사용량을 확인하세요.

프로젝트에서 이 설정을 재현해 보시겠어요? BetterToken 계정 만들기

BetterToken은 문서화된 Base URL로 시작하세요. 다른 provider에서는 /v1/chat/completions를 자동으로 제거하지 말고 현재 Provider API와 URL 계약을 먼저 확인하세요.

설정하는 동안 현재 Kilo Code 지침을 열어 두세요. 사용 가능한 모델과 그룹은 바뀔 수 있으므로 Model ID는 여기서 자리표시자로 둡니다.

준비할 것

• 설치된 VS Code.
• 공식 소스에서 설치한 현재 Kilo Code 확장 기능.
• 자신의 BetterToken API Key.
• 모델 카탈로그의 현재 Model ID.
• 첫 요청을 안전하게 실행할 빈 또는 테스트 디렉터리.

BetterToken은 API Endpoint를 담당합니다. Kilo Code 웹사이트, VS Code Marketplace, 다운로드, 업데이트의 이용 가능성은 제3자 서비스에 달려 있습니다. 러시아에서 BetterToken API Endpoint에 연결하는 데 VPN은 필요하지 않지만, 이는 Marketplace나 다른 사이트의 가용성을 약속하는 말이 아닙니다.

1. Kilo Code 설치하기

VS Code에서 Extensions를 열고 공식 Kilo Code 카드를 찾아 현재 버전을 설치하세요. Marketplace를 사용할 수 없으면 현재 Kilo Code 문서의 대안만 사용하고 비공식 VSIX 미러는 사용하지 마세요.

2. API Key 만들기

BetterToken Workspace에 로그인하고 테스트용으로 별도 Key를 만듭니다. 프롬프트, issue, 스크린샷, 저장소 파일에 붙여 넣지 마세요. Kilo Code 인터페이스에서는 키가 선택된 provider의 자격 증명으로 저장됩니다.

설정 전에 다른 서비스의 오래된 OPENAI_API_KEY와 OPENAI_BASE_URL 변수가 환경에 있는지 확인하세요. 값은 기록하지 마세요. 변수가 Kilo Code 설정과 충돌하면 의도적으로 지정한 프로필 또는 shell 파일에서만 제거합니다.

3. OpenAI-compatible provider 추가하기

BetterToken Docs의 Kilo Code 가이드를 열고 현재 provider setup을 first request까지 진행하세요. OpenAI Compatible를 선택하고 자신의 API Key를 사용하며 그 페이지에서 Base URL과 정확한 Model ID를 가져옵니다. Save 후 extension을 restart하세요. fields와 models는 바뀔 수 있으므로 전체 UI를 복사하지 않습니다.

4. 첫 요청 실행하기

중요한 파일에 접근하지 않는 빈 테스트 디렉터리를 열고 요청을 보냅니다.

JSON만 반환하세요: {"tool":"kilo-code","sum":4}. 파일을 변경하지 마세요.

이 테스트는 일반적인 “코드를 작성해” 요청보다 검증하기 쉽습니다. 성공한 연결은 네 가지 징후로 확인합니다.

• Kilo Code가 유효한 JSON을 반환했다.
• 확장이 선택한 Model ID를 사용했다.
• BetterToken Dashboard에 성공 상태의 기록이 있다.
• 기록에 input, output, 해당 cache Token 및 청구가 표시된다.

Dashboard는 요청 메타데이터와 Token 사용량을 확인하는 용도입니다. 전체 프롬프트나 응답 본문을 저장하지 않습니다.

자주 발생하는 오류

401 또는 Unauthorized

Workspace에서 API Key를 다시 복사하고 실수로 들어간 공백을 제거하세요. 필드에는 다른 서비스 키가 아니라 BetterToken Key가 있어야 합니다. 진단을 위해 secret을 구성 파일로 옮기지 마세요.

404

Base URL을 확인합니다.

https://www.bettertoken.ai/v1

BetterToken은 위 문서화된 Base URL로 시작하세요. 다른 full path에서는 Provider API와 current contract를 먼저 확인하세요. Kilo Code는 full endpoint URL을 받으므로 suffix만으로 error라고 볼 수 없습니다.

model not found

현재 카탈로그에서 정확한 Model ID를 복사하세요. 기사, 오래된 스크린샷, 다른 사람의 구성에 있는 모델명은 현재 식별자와 다를 수 있습니다.

설정이 적용되지 않음

provider를 저장하고 Developer: Reload Window를 실행한 뒤 새 Kilo Code 세션을 엽니다. 그 다음 오래된 OPENAI_API_KEY 및 OPENAI_BASE_URL 변수를 공개 로그에 값을 출력하지 않고 확인하세요.

지원 경계는 어디인가요?

이 방식은 OpenAI-compatible provider를 통해 모델 API를 시험합니다. 모든 Kilo Code 기능, 제3자 Marketplace, 계정, MCP 서버, 업데이트의 가용성을 보증하지 않습니다. 첫 짧은 요청이 성공했는데 별도의 확장 기능이 실패한다면, 그 기능은 별도 계층으로 진단하세요.

재설정에는 BetterToken Docs의 Kilo Code 페이지를 사용하세요. 현재 필드, Base URL, provider 제한을 확인할 수 있습니다.