Kimi Code API 키 설정

Kimi Code API 키: config.toml에 자신의 키 설정

아래 블록을 config.toml에 붙여넣고 자신의 API 키로 바꾸면 Kimi Code에서 Claude 모델을 사용할 수 있습니다. 사용한 만큼 지불하세요.

~/.kimi-code/config.tomltoml
config
# ~/.kimi-code/config.toml
default_model = "aicodewith/claude-haiku-4-5-20251001"

[providers.aicodewith]
type = "openai"
base_url = "https://api.aicodewith.ai/v1"
api_key = "sk-***"

[models."aicodewith/claude-haiku-4-5-20251001"]
provider = "aicodewith"
model = "claude-haiku-4-5-20251001"
max_context_size = 200000

설정 단계

나중에 사용할 터미널을 위해 이 키를 저장하세요

로그인하면 이 명령에 사용자의 키가 포함됩니다. 복사해서 한 번 실행하면 도구가 테스트한 위치에 키를 보관합니다.

bash
mkdir -p "$(dirname "$HOME/.kimi-code/config.toml")"
cat > "$HOME/.kimi-code/config.toml" << 'EOF'
# ~/.kimi-code/config.toml
default_model = "aicodewith/claude-haiku-4-5-20251001"

[providers.aicodewith]
type = "openai"
base_url = "https://api.aicodewith.ai/v1"
api_key = "sk-***"

[models."aicodewith/claude-haiku-4-5-20251001"]
provider = "aicodewith"
model = "claude-haiku-4-5-20251001"
max_context_size = 200000
EOF

로그아웃한 방문자에게는 자리 표시자만 표시됩니다. 로그인하면 키를 채워 드립니다. Sign in · 콘솔에서 키 받기

복사는 명령을 클립보드에 넣을 뿐입니다. 아직 터미널에서 실행하거나 도구 설정에 키를 붙여넣어야 합니다. API 키 받는 방법

이 단계들은 Linux(bash)에서 테스트되었습니다. macOS와 Windows는 아직 테스트되지 않아 목록에 없습니다.

  1. 아직 Kimi Code가 없으신가요? 설치하세요 (설치되어 있으면 건너뛰세요)

    Kimi의 설치 스크립트 curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash를 실행한 다음 kimi --version을 실행하세요. 버전 번호가 나오면 설치된 것입니다.

    curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash로 kimi-code를 설치하세요. ~/.kimi-code/bin/kimi에 설치됩니다. 스크린샷의 KIMI_NO_MODIFY_PATH=1은 테스트 머신에만 해당하며, 필요하지 않습니다. kimi --version은 2.1.1을 출력합니다.
  2. config.toml에 설정을 붙여넣고 API 키를 추가하세요

    ~/.kimi-code/config.toml을 열고, 이 페이지 상단의 블록을 붙여넣은 다음, sk-***를 API 키로 바꾸세요 (API 키 받기). 저장 후 파일에는 api_key = "sk-…" 줄이 있습니다.

    [providers.aicodewith]에서 api_key = "sk-***"를 설정하세요 (마스킹됨)
  3. 새 터미널을 열고 Kimi Code를 테스트하세요

    새 터미널을 열고 kimi -m aicodewith/claude-haiku-4-5-20251001 -p "Reply with exactly: OK"를 실행하세요. • OK가 표시되면 Kimi Code가 API 키를 사용 중인 것입니다.

    확인: 터미널을 닫고 새 터미널을 열어 kimi -m aicodewith/claude-haiku-4-5-20251001 -p "Reply with exactly: OK"를 실행하세요. • OK 응답이 나오면 설정이 완료된 것입니다.
  4. OK가 나오지 않나요? 오류를 확인하세요

    터미널의 오류를 아래의 일반적인 오류와 비교하세요. 각 항목에 원인과 해결 방법이 나와 있습니다.

  5. Kimi Code 모델 전환: 모델 이름 변경

    default_model과 [models."…"] 블록의 모델 이름을 새 Model ID로 바꾸고, 테스트 명령의 -m 뒤에도 같은 이름을 사용하세요. Model ID는 모델 및 가격에 있습니다.

자주 발생하는 오류

오류: 프롬프트 실행 실패: 제공자 "aicodewith"가 config.toml에서 api_key_env = "AICODEWITH_API_KEY"를 선언했지만, 환경 변수가 설정되지 않았거나 비어 있습니다.

표시되는 내용

오류: 프롬프트 실행 실패: 제공자 "aicodewith"가 config.toml에서 api_key_env = "AICODEWITH_API_KEY"를 선언했지만, 환경 변수가 설정되지 않았거나 비어 있습니다.
원인
config.toml에 api_key_env가 있지만 터미널에 AICODEWITH_API_KEY가 설정되어 있지 않습니다
해결 방법
api_key_env 줄을 삭제하고 2단계처럼 api_key = "your key"를 작성하세요

2단계로 돌아가기: config.toml에 구성을 붙여넣기 →

키 미설정: config.toml은 api_key_env = "AICODEWITH_API_KEY"를 사용하고 새 터미널에는 해당 변수가 없습니다. kimi는 제공자 "aicodewith"가 api_key_env …를 선언했지만 환경 변수가 설정되지 않았거나 비어 있다는 오류로 실패합니다.

오류: 프롬프트 실행 실패: provider.auth_error: 401 "请在请求中提供有效的 API Key。"

표시되는 내용

오류: 프롬프트 실행 실패: provider.auth_error: 401 "请在请求中提供有效的 API Key。"
(영어: "요청에 유효한 API 키를 제공하세요.")
원인
api_key 값이 잘못됨
해결 방법
콘솔에서 키를 다시 복사하여 따옴표 안의 값을 바꾸세요

2단계로 돌아가기: config.toml에 구성을 붙여넣기 →

잘못된 키(sk-wrong) 사용 시: 오류: 프롬프트 실행 실패: provider.auth_error: 401 "请在请求中提供有效的 API Key。"

404 "不支持的请求路径" (지원되지 않는 요청 경로)

표시되는 내용

오류: 프롬프트 실행 실패: provider.api_error: 404 "不支持的请求路径,请检查 API 地址是否正确 (request_id: req_1791793075991_6c21900c)"
영어: 프롬프트 실행 실패: 제공자 API 오류 404, 지원되지 않는 요청 경로, API 주소가 올바른지 확인하세요 (request_id: req_1791793075991_6c21900c)
원인
base_url이 "https://api.aicodewith.ai/nope"로 설정됨
해결 방법
base_url을 https://api.aicodewith.ai/v1로 복원하세요.

2단계로 돌아가기: config.toml에 구성을 붙여넣기 →

한 창에 잘못된 구성 줄 base_url = "https://api.aicodewith.ai/nope"가 표시되고, 이어서 kimi -m aicodewith/claude-haiku-4-5-20251001 -p "Reply with exactly: Hello from aicodewith.ai"를 실행합니다. 실제 오류: 프롬프트 실행 실패: provider.api_error: 404 "不支持的请求路径,请检查 API 地址是否正确 (request_id: req_1791793075991_6c21900c)". 영어: 프롬프트 실행 실패: 제공자 API 오류 404, 지원되지 않는 요청 경로, API 주소가 올바른지 확인하세요 (request_id: req_1791793075991_6c21900c). 그 후 base_url을 https://api.aicodewith.ai/v1로 복원했고, 정상 실행에서 Hello from aicodewith.ai가 응답되었습니다.

FAQ

Kimi Code에서 내 API 키를 어떻게 사용하나요?

~/.kimi-code/config.toml의 [providers.aicodewith] 아래에 api_key = "your key"를 작성하고 base_url을 https://api.aicodewith.ai/v1로 설정하세요. 새 터미널에서도 유지됩니다.

export OPENAI_API_KEY가 작동하지 않는 이유는 무엇인가요?

Kimi Code는 OPENAI_API_KEY를 읽지 않습니다. API 키를 구성 파일에 넣으세요.

Kimi Code config.toml은 어디에 있나요?

기본 경로는 ~/.kimi-code/config.toml입니다. KIMI_CODE_HOME으로 데이터 루트를 변경할 수 있습니다.

Kimi Code에서 파일을 편집하지 않고 API 키를 추가할 수 있나요?

예. Kimi Code 내에서 /provider를 입력하거나 터미널에서 kimi provider를 실행한 뒤 안내를 따르세요.

type = "openai"는 무슨 뜻인가요?

Kimi Code는 OpenAI API 형식으로 요청을 보냅니다. AI Code With는 그 형식을 받아들이므로 base_url과 api_key만 설정하면 됩니다.

출처

관련 링크