문서

Kilo Code

Kilo Code의 사용자 지정 공급자는 네 개 필드로 설정합니다. 필드를 입력하면 확장 프로그램에서 하나의 키로 Claude와 GPT를 사용할 수 있으며, 엔드포인트 뒤에 어떤 벤더가 있는지 알 필요가 없습니다.

Providers → Custom provider → OpenAI Compatible, /v1을 포함한 기본 URL, 입력한 Claude 모델 ID — Kilo Code는 뒤에 어떤 공급자가 있는지 알지 못합니다

Settings → Providers → Custom provider

Provider ID    kunavo
Display name   Kunavo
Provider API   OpenAI Compatible
Base URL       https://api.kunavo.com/v1
API key        sk-kn-...
Models         claude-sonnet-5
               claude-opus-5
               claude-haiku-4-5

여기서는 기본 URL에 /v1 접미사가 포함됩니다. Kilo Code는 경로만 추가하며, 공식 문서의 예시에도 같은 접미사가 붙어 있습니다(/v1). 이는 접미사 없는 기본 주소를 요구하는 Anthropic 방식 클라이언트와 반대입니다.

Provider API는 공급자가 아니라 프로토콜을 선택하는 항목입니다. OpenAI Compatible을 선택한 다음 Claude 모델 ID를 입력하는 것이 의도된 조합입니다. ID는 확장 프로그램이 아니라 엔드포인트에서 확인됩니다.

아직 키가 없나요? Kunavo 계정을 만들고, 키를 생성한 다음(키는 sk-kn-로 시작합니다) $10부터 크레딧을 추가하세요. 호출 비용은 해당 잔액에서 차감되며 실패한 호출에는 요금이 부과되지 않습니다. 그러면 대시보드가 Kilo Code 설정 화면에서 열립니다.

단계별 안내

/app/keys에서 키를 생성해 복사하세요. 키는 한 번만 표시됩니다.
Kilo Code 설정(톱니바퀴 아이콘)을 열고 Providers 탭으로 이동한 뒤 맨 아래로 스크롤하여 Custom provider를 클릭합니다.
위에 나온 대로 Provider ID, 표시 이름, Provider API = OpenAI Compatible, 기본 URL 및 API 키를 입력합니다.
Models에서 ID를 직접 추가하거나 자동으로 가져온 목록에서 선택할 수 있습니다. Kunavo는 GET /v1/models에 응답하므로 목록이 자동으로 채워집니다.
채팅 모드 선택기에서 공급자를 선택하고 메시지를 보내세요. 계속 실행되는 모드에는 저렴한 모델을 고정하고, 계획 수립 모드에는 비싼 모델을 지정하세요.

Kilo Code의 OpenAI Compatible 공급자 페이지에서 확인했습니다(2026년 9월 6일 기준). 서드파티 설정은 변경될 수 있으므로, 여기의 필드 이름이 실제 화면과 다르면 이 문서가 아니라 해당 페이지를 기준으로 삼으세요.

이것이 요약본입니다. 전체 안내—모델 선택, 실제 세션 비용, 실패 유형—는 Kilo Code + Claude 단계별 안내에 있습니다.

클라이언트를 디버깅하기 전에 확인할 사항

한 번의 요청으로 문제가 엔드포인트, 키 또는 구성 파일 중 어디에 있는지 판단할 수 있습니다. 이 요청에서 JSON이 반환되면 동일한 base URL과 키가 Kilo Code에서 작동합니다.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

필드에 입력할 model id

모든 텍스트 모델은 model id로 접근할 수 있습니다. 현재 목록은 GET /v1/models이며, 가격이 포함된 카탈로그는 모델 페이지에서 확인할 수 있습니다. 요금은 토큰 100만 개당 USD 기준이며 입력 / 출력 순서입니다.

모델 ID	Kunavo 입력/출력	Kilo Code에서의 위치
`claude-sonnet-5`	$1.40 / $7.00	Code 및 Architect 모드 — 기본 작업 모델
`claude-opus-5`	$3.50 / $17.50	잘못된 계획의 비용이 큰 대규모 리팩터링에서는 Architect 모드
`claude-haiku-4-5`	$0.70 / $3.50	요청량이 많은 Ask 모드 및 빠른 파일 분류
`gpt-5-6-sol`	$2.00 / $12.00	같은 키로 다른 계열 모델에 2차 의견 요청

월정액 없이 선불 잔액에서 토큰별로 청구됩니다. billing을 참고하세요. 반복되는 컨텍스트(에디터나 채팅 클라이언트가 보내는 데이터의 대부분)에서는 모델 선택보다 프롬프트 캐싱이 청구액에 더 큰 영향을 줍니다.

자주 묻는 질문

Kilo Code에 사용자 지정 공급자를 어떻게 추가하나요?

톱니바퀴 아이콘을 눌러 Kilo Code 설정을 열고 Providers 탭으로 이동한 뒤 목록 맨 아래로 스크롤하여 "Custom provider"를 클릭합니다. Provider ID와 표시 이름을 입력하고, Provider API를 "OpenAI Compatible"로 설정한 다음 엔드포인트의 기본 URL과 API 키를 붙여 넣습니다. 이어서 모델 ID를 직접 입력하거나 자동으로 가져온 목록에서 추가합니다. 그러면 내장 공급자와 마찬가지로 모드 선택기에 표시됩니다.

Anthropic 계정 없이 Kilo Code에서 Claude 모델을 사용할 수 있나요?

예. Kilo Code의 "OpenAI Compatible" Provider API는 공급자가 아니라 통신 프로토콜을 지정하며, 모델 ID를 설정한 기본 URL로 그대로 전달합니다. 따라서 Claude ID는 확장 프로그램이 아니라 해당 엔드포인트에서 확인되며, 사용하는 자격 증명은 Anthropic 계정이 아닌 해당 엔드포인트의 자격 증명입니다.

Kilo Code 기본 URL 끝에 /v1을 붙여야 하나요?

OpenAI 호환 엔드포인트라면 붙여야 합니다. Kilo Code는 /chat/completions, /models와 같은 경로만 추가하므로 기본 URL은 /v1 루트여야 합니다. 예를 들면 https://api.kunavo.com/v1입니다. 공식 문서의 예시에도 같은 접미사가 붙어 있습니다. /v1이 빠지면 인증 오류가 아니라 404가 발생합니다.

공급자를 추가한 뒤 Kilo Code에 모델이 표시되지 않는 이유는 무엇인가요?

모델 목록은 입력한 키를 사용해 엔드포인트의 /v1/models 경로에서 가져옵니다. 따라서 목록이 비어 있다면 공급자에 모델이 없는 것보다 키나 기본 URL이 잘못되었을 가능성이 큽니다. 같은 키와 URL 조합으로 /v1/models에 일반 curl 요청을 보내 확인해 보세요. JSON이 반환되면 확장 프로그램 설정 문제이고, 401이면 키 문제, 404이면 URL 문제입니다. 모델은 언제든 직접 입력할 수도 있습니다.