러시아의 Kilo Code: API 설정과 첫 요청
Kilo Code를 설치하고 OpenAI-compatible provider로 BetterToken을 연결하여 첫 요청을 Dashboard에서 검증합니다.
Kilo Code는 내장 OpenAI Compatible provider로 연결할 수 있습니다. 현재 확장 기능, 자신의 API Key, Base URL, 현재 Model ID가 필요합니다. 설정 후 확장을 다시 시작하고 짧은 요청을 보낸 다음 Dashboard에서 모델, 상태, Token 사용량을 확인하세요.
아직 도구를 고르지 않았다면 먼저 업무를 비교하세요. Claude Cowork, Chat, Claude Code는 서로 다른 종류의 작업을 처리합니다. 에디터 작업에는 Claude Code를 VS Code에 연결하는 가이드도 참고할 수 있습니다. Kilo Code는 프로젝트 접근과 설정 가능한 API provider를 가진 코딩 확장 기능입니다.
설정을 시험할 준비가 되었나요? BetterToken 계정과 API Key를 만들고, 현재 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를 내려받지 마세요.
서로 다른 coding agent의 설치를 비교한다면 Claude Code와 Windows, macOS, Linux용 Codex CLI에는 별도 지침을 사용하세요. 인터페이스, 인증, provider 연결 방식이 다릅니다.
설치 후 Kilo Code 패널을 엽니다. 나타나지 않으면 Command Palette에서 Developer: Reload Window를 실행하세요.
2. API Key 만들기
BetterToken Workspace에 로그인하고 테스트용으로 별도 Key를 만듭니다. 프롬프트, issue, 스크린샷, 저장소 파일에 붙여 넣지 마세요. Kilo Code 인터페이스에서는 키가 선택된 provider의 자격 증명으로 저장됩니다.
설정 전에 다른 서비스의 오래된 OPENAI_API_KEY와 OPENAI_BASE_URL 변수가 환경에 있는지 확인하세요. 값은 기록하지 마세요. 변수가 Kilo Code 설정과 충돌하면 의도적으로 지정한 프로필 또는 shell 파일에서만 제거합니다.
3. OpenAI-compatible provider 추가하기
Kilo Code 설정 UI에서 네 필드를 채웁니다.
- API Provider:
OpenAI Compatible. - Base URL:
https://www.bettertoken.ai/v1. - API Key: 자신의 BetterToken API Key.
- Model: BetterToken 모델 카탈로그의 정확한 현재 Model ID.
Base URL에 /chat/completions나 /responses를 추가하지 마세요. Kilo Code가 요청 경로를 직접 생성합니다. 기본 BetterToken 설정에 추가 헤더는 필요하지 않으며, 특정 upstream 서비스 문서가 직접 요구할 때만 추가합니다.
설정을 저장하고 VS Code를 완전히 다시 시작하거나 확장을 다시 로드합니다.
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을 확인합니다.
필드에 /chat/completions, /responses, 다른 완전한 경로가 있으면 Base URL만 남기고 확장을 다시 시작하세요.
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 서버, 업데이트의 가용성을 보증하지 않습니다. 첫 짧은 요청이 성공했는데 별도의 확장 기능이 실패한다면, 그 기능은 별도 계층으로 진단하세요.
문제가 확장 설정이 아니라 접근 또는 결제라면 먼저 구독, API, Claude Code 한도를 정리하세요. 두 coding tool 사이의 공통 API 경로를 선택하려면 러시아에서 Claude Code와 Codex 연결 비교를 참고하세요.
재설정에는 BetterToken Docs의 Kilo Code 페이지를 사용하세요. 현재 필드, Base URL, provider 제한을 확인할 수 있습니다.