문서

Kimi Code

Kimi Code는 공급자 설정을 TOML 파일에 보관하며, 타사 엔드포인트에는 type, base_url, api_key라는 세 가지 키를 지정합니다. 하나를 Kunavo로 설정하면 CLI가 이미 지원하는 프로토콜을 통해 Claude 및 GPT ID와 통신합니다.

Kimi Code는 ~/.kimi-code/config.toml에 제공자를 저장합니다 — providers.<name>.base_url을 https://api.kunavo.com/v1로 설정하고 type = "openai"를 지정하면 CLI가 하나의 키로 Claude와 GPT ID를 실행합니다

~/.kimi-code/config.toml

default_model = "kunavo/claude-sonnet-5"

[providers.kunavo]
type = "openai"
base_url = "https://api.kunavo.com/v1"
api_key = "sk-kn-..."

[models."kunavo/claude-sonnet-5"]
provider = "kunavo"
model = "claude-sonnet-5"
max_context_size = 200000

base_url에는 /v1 접미사가 포함됩니다. 공급자 페이지에 명시된 내용을 보면 추측할 필요가 없습니다. type = "openai"의 문서 기본값은 https://api.openai.com/v1이며, 환경 변수 페이지에 나온 타사 엔드포인트 예시는 KIMI_MODEL_BASE_URL="https://api.example.com/v1"입니다. Kimi Code는 경로만 추가하므로 여기에 기본 주소만 입력하면 인증 오류가 아니라 404가 발생합니다. 이는 https://api.kunavo.com처럼 접미사 없는 기본 주소를 요구하는 Anthropic 프로토콜 클라이언트와 반대입니다.

셸 변수를 내보내도 공급자에 키가 설정되는 것은 아닙니다. Kimi Code의 config 파일 페이지에는 명확히 나와 있습니다. 터미널에서 export KIMI_API_KEY을 실행해도 공급자에 키가 설정되지는 않습니다. 문서에 나온 우선순위는 api_key 또는 api_key_env입니다. 두 설정은 상호 배타적이므로 정확히 하나만 지정하세요. 둘 다 없으면 [providers.kunavo.env] 하위 테이블의 키를 사용하고, 세 설정이 모두 없으면 시작 시 오류가 발생합니다. 키를 파일에 저장하지 않으려면 api_key 대신 api_key_env = "KUNAVO_API_KEY"를 작성하세요. 변수가 설정되지 않았거나 값이 비어 있으면 변수 이름을 명시하는 오류와 함께 요청이 실패합니다.

Kunavo는 아직 자체 엔드포인트에서 이 클라이언트를 실행해 보지 않았습니다. 위 설정 블록은 실제 세션이 아니라 Kimi Code의 현재 문서를 바탕으로 작성했습니다. 여기에는 Kimi Code의 스트리밍이나 도구 호출 실행 기록이 없으므로, 첫 실제 요청을 확인 과정으로 삼고 이미 검증된 것으로 간주하지 마세요. 게시된 페이지는 설정 안내일 뿐, 테스트 결과가 아닙니다.

type는 공급자가 아니라 프로토콜을 지정합니다. 문서에 열거된 항목은 kimi, anthropic, openai, openai_responses, google-genai, vertexai입니다. 현재 표에는 이전 버전의 OpenAI 변형이 없으므로, 이를 설정하라는 안내는 최신 표보다 오래된 정보입니다. openai을 선택하고 Claude 모델 ID를 입력하는 것이 의도된 조합입니다. ID는 CLI가 아니라 기본 URL에서 확인됩니다.

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

단계별 안내

/app/keys에서 키를 생성해 복사하세요. 키는 한 번만 표시됩니다.
최초 실행 시 생성되는 ~/.kimi-code/config.toml를 엽니다. KIMI_CODE_HOME을 사용해 데이터 디렉터리를 옮겼다면 파일은 $KIMI_CODE_HOME/config.toml에 있습니다. 파일 이름은 항상 config.toml입니다.
위의 [providers.kunavo] 테이블을 추가합니다. 문서에서 이 유형에 대해 제시한 세 키는 다음 순서입니다. type, base_url, api_key.
[models."..."] 아래에 -m 및 default_model에 전달할 이름인 모델 별칭을 선언하고, provider, model, max_context_size을 지정합니다. 세 항목은 모두 필수입니다. model 값은 통신 요청에 실려 전송되는 ID입니다. 마침표가 포함된 별칭은 따옴표로 묶으세요.
처음에는 capabilities을 생략합니다. 공급자 페이지에 따르면 기능은 모델 이름 접두사를 기준으로 자동 매칭되며, 모델 표의 배열은 항목이 추가되기만 하고 삭제되지는 않습니다. 따라서 잘못 지정한 태그는 나중에 설정 파일을 수정해도 해제할 수 없습니다.
kimi을 실행하거나 kimi -m kunavo/claude-sonnet-5을 사용해 한 세션에서 사용할 별칭을 선택합니다. 설정을 전혀 수정하지 않고 엔드포인트를 시험하려면 KIMI_MODEL_NAME, KIMI_MODEL_API_KEY, KIMI_MODEL_PROVIDER_TYPE=openai, KIMI_MODEL_BASE_URL를 설정하세요. CLI가 메모리에서 공급자를 구성하며 파일에는 아무것도 기록하지 않습니다.

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

이것이 요약본입니다. 전체 안내—모델 선택, 실제 세션 비용, 실패 유형—는 Kimi Code와 Claude Code — 어떤 클라이언트, 모델, 계정을 선택할까요?에 있습니다.

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

한 번의 요청으로 문제가 엔드포인트, 키 또는 구성 파일 중 어디에 있는지 판단할 수 있습니다. 이 요청에서 JSON이 반환되면 동일한 base URL과 키가 Kimi 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 입력/출력	Kimi Code에서의 위치
`claude-sonnet-5`	$1.40 / $7.00	기본 별칭 — 편집 및 실행 반복 작업에 사용하는 모델
`claude-opus-5`	$3.50 / $17.50	잘못된 계획의 비용이 큰 계획 수립 작업을 위한 두 번째 별칭
`claude-haiku-4-5`	$0.70 / $3.50	하위 에이전트용 [secondary_model]에 연결할 저렴한 별칭
`gpt-5-6-sol`	$2.00 / $12.00	같은 키와 공급자 테이블을 사용하는 다른 계열 모델의 2차 의견

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

자주 묻는 질문

Kimi Code에서 사용자 지정 API 엔드포인트를 사용하려면 어떻게 하나요?

~/.kimi-code/config.toml에 공급자 테이블을 추가하고 type = "openai", base_url에는 엔드포인트 URL, api_key에는 키를 지정한 다음, [models."<alias>"] 아래에 provider, model, max_context_size를 지정하는 모델 별칭을 선언합니다. Kimi Code의 공급자 페이지에 따르면 type = "openai"는 OpenAI Chat Completions 프로토콜 및 이를 지원하는 모든 타사 서비스에 사용되며, 필요한 경우 base_url을 재정의할 수 있습니다. TUI에서 /provider를 사용해 공급자 관리자를 열 수도 있지만, 알려진 공급자 경로는 models.dev 카탈로그에서 가져옵니다. 해당 카탈로그에 없는 엔드포인트는 직접 추가하는 편이 더 빠릅니다.

Kimi Code의 base_url 끝에 /v1을 붙여야 하나요?

OpenAI 호환 엔드포인트라면 붙여야 합니다. Kimi Code는 경로만 추가하므로 base_url은 /v1 루트여야 합니다. 예를 들면 https://api.kunavo.com/v1입니다. 추측할 필요 없이 문서에서 확인할 수 있습니다. type = "openai"의 기본 base_url은 https://api.openai.com/v1이고, 환경 변수 페이지의 타사 예시는 https://api.example.com/v1입니다. /v1이 빠지면 401이 아니라 404가 발생합니다.

변수를 내보냈는데도 Kimi Code에서 API 키가 없다고 표시되는 이유는 무엇인가요?

어떤 환경 변수를 읽을지 지정하지 않으면 자격 증명에 셸 환경 변수를 사용하지 않기 때문입니다. config 파일 페이지에는 export KIMI_API_KEY를 실행해도 공급자에 키가 설정되지 않는다고 명시되어 있습니다. api_key를 config.toml에 직접 입력하거나, api_key_env에 변수 이름을 지정하세요. 두 설정은 상호 배타적이므로 정확히 하나만 설정해야 합니다. [providers.<name>.env] 하위 테이블은 앞의 두 설정이 모두 없을 때만 확인되며, 세 설정이 모두 없으면 시작 시 오류가 발생합니다.

Kimi Code에서 타사 공급자를 통해 Claude 모델을 실행할 수 있나요?

공급자 유형은 공급자가 아니라 프로토콜을 지정하고, model 값은 설정한 base_url로 전달됩니다. 따라서 openai 유형 공급자에 Claude ID를 지정하면 CLI가 아니라 해당 엔드포인트에서 확인됩니다. Kimi Code에는 Anthropic Messages 프로토콜을 위한 별도의 type = "anthropic" 공급자도 있으며, 이 공급자의 기본 URL에는 /v1 접미사가 없는 기본 주소를 사용합니다. Kunavo는 아직 어느 프로토콜로도 자체 엔드포인트에서 Kimi Code 세션을 실행해 보지 않았으므로, 위 curl 요청으로 확인하고 첫 세션을 테스트로 삼으세요.