Kimi Code 설정: API Key, K3.1 Pro와 Claude Code

Kimi Code CLI에서 I Code Easy API Key를 쓰려면 ~/.kimi-code/config.toml에 키와 /v1이 포함된 URL을 저장하고 k3.1-pro를 선택하세요. Claude Code에서는 ANTHROPIC_* 변수를 사용하며 URL에는 도메인만 넣습니다. 두 클라이언트의 설정 형식은 다릅니다.

클라이언트별 설정 경로

회원가입 후 API Keys에서 사이트 키를 복사하고, 접속점 선택에서 Kimi 접속점을 저장하세요. 사이트 API Key와 Kimi 공식 계정은 별도 인증 정보입니다. /login은 공식 계정 로그인용이며 사이트 키를 입력하는 절차가 아닙니다.

1. Kimi Code 설치

macOS / Linux:

curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash

Windows PowerShell:

irm https://code.kimi.com/kimi-code/install.ps1 | iex

Windows에서 Kimi Code를 사용하려면 Git for Windows도 필요합니다. 요구 사항은 공식 설치 문서를 확인하세요.

설치 후 터미널을 다시 열어 버전을 확인하세요. kimi를 찾지 못하면 API 설정을 바꾸기 전에 설치와 PATH부터 확인하세요.

kimi --version

설치 및 업데이트 방법은 Kimi Code 공식 페이지를 참고하세요. 설정을 인식하지 못하면 키를 반복해서 바꾸기 전에 설치 버전과 공식 문서를 비교하세요.

2. I Code Easy API 구성

필요하면 ~/.kimi-code/config.toml을 만드세요. Windows에서는 현재 사용자 홈 디렉터리의 .kimi-code/config.toml입니다. 기존 파일에는 설정을 병합하고 다른 Provider, MCP, 권한 설정은 유지하세요. 최상위 default_model은 TOML 테이블 앞에 하나만 두고, 같은 Provider나 모델 테이블을 중복 추가하지 마세요.

KIMI_CODE_HOME이 설정되어 있으면 설정 디렉터리가 바뀝니다. default_model에는 전송 모델명만 넣는 것이 아니라 icodeeasy/k3.1-pro 같은 모델 테이블 별칭을 넣습니다.

default_model = "icodeeasy/k3.1-pro"

[providers.icodeeasy]
type = "kimi"
base_url = "https://api.icodeeasy.cc/v1"
api_key = "당신의 I Code Easy API Key"

[models."icodeeasy/k3.1-pro"]
provider = "icodeeasy"
model = "k3.1-pro"
max_context_size = 1048576
capabilities = ["thinking", "always_thinking", "image_in", "video_in", "tool_use"]
display_name = "Kimi K3.1 Pro (I Code Easy)"
support_efforts = ["low", "high", "max"]
default_effort = "high"

[models."icodeeasy/k3.1-pro-highspeed"]
provider = "icodeeasy"
model = "k3.1-pro-highspeed"
max_context_size = 1048576
capabilities = ["thinking", "always_thinking", "image_in", "video_in", "tool_use"]
display_name = "Kimi K3.1 Pro Highspeed (I Code Easy)"
support_efforts = ["low", "high", "max"]
default_effort = "high"

[models."icodeeasy/k3"]
provider = "icodeeasy"
model = "k3"
max_context_size = 1048576
capabilities = ["thinking", "tool_use"]
display_name = "Kimi K3 (I Code Easy)"

[models."icodeeasy/k3-256k"]
provider = "icodeeasy"
model = "k3-256k"
max_context_size = 262144
capabilities = ["thinking", "tool_use"]
display_name = "Kimi K3 256K (I Code Easy)"

macOS / Linux에서는 파일 권한을 제한할 수 있습니다:

chmod 600 ~/.kimi-code/config.toml

기본 도메인이 느리면 base_url을 https://jp.icodeeasy.cc/v1 또는 https://sg.icodeeasy.cc/v1로 바꾸세요. /v1을 두 번 추가하지 마세요.

네 모델 선택하기

현재 가격·잔액·사용량은 가격과 사용량 안내, 지원 범위는 모델 목록을 확인하세요. K3와 K3-256K의 이미지·영상 입력은 공개 지원 사항으로 약속하지 않습니다.

이전 이름이 모두 같은 모델을 뜻하지는 않습니다. K2 계열 이전 이름, kimi, kimi-for-coding은 K3.1 Pro로 연결되고, kimi-for-coding-highspeed 같은 고속 별칭은 고속 버전을 선택합니다. kimi-k3와 k3[1m]은 K3, kimi-k3-256k는 K3-256K를 그대로 선택합니다. 네 모델에 대응하는 kimi- 접두사 이름도 각 모델에 대응합니다.

K3-256K가 컨텍스트 한도를 넘으면 기존 방식으로 K3로 업그레이드하며, 해당 요청에는 K3 가격을 적용합니다. 모델 전환 후에는 새 세션을 열어 이전에 압축된 컨텍스트를 이어 쓰지 않는 것이 좋습니다.

임시 테스트 설정

현재 Kimi Code는 일반 KIMI_API_KEY를 자동으로 읽지 않습니다. 임시 시험에는 전용 KIMI_MODEL_* 변수를 쓰세요. 파일 설정과는 별도 경로이므로 어느 쪽을 확인 중인지 먼저 구분하세요.

KIMI_MODEL_NAME을 설정하면 환경 변수 모델이 활성화되고 KIMI_MODEL_API_KEY가 필수입니다. 이 변수들은 파일에 저장되지 않으며 파일의 default_model보다 우선합니다. 명령줄 -m 옵션은 환경 변수 모델보다 우선합니다.

macOS / Linux:

export KIMI_MODEL_NAME="k3.1-pro"
export KIMI_MODEL_API_KEY="당신의 I Code Easy API Key"
export KIMI_MODEL_PROVIDER_TYPE="kimi"
export KIMI_MODEL_BASE_URL="https://api.icodeeasy.cc/v1"
export KIMI_MODEL_MAX_CONTEXT_SIZE="1048576"
export KIMI_MODEL_CAPABILITIES="thinking,always_thinking,image_in,video_in,tool_use"
kimi

Windows PowerShell(현재 세션만):

$env:KIMI_MODEL_NAME="k3.1-pro"
$env:KIMI_MODEL_API_KEY="당신의 I Code Easy API Key"
$env:KIMI_MODEL_PROVIDER_TYPE="kimi"
$env:KIMI_MODEL_BASE_URL="https://api.icodeeasy.cc/v1"
$env:KIMI_MODEL_MAX_CONTEXT_SIZE="1048576"
$env:KIMI_MODEL_CAPABILITIES="thinking,always_thinking,image_in,video_in,tool_use"
kimi

고속 버전을 시험하려면 KIMI_MODEL_NAME을 k3.1-pro-highspeed로 바꾸세요. 이 터미널을 닫으면 여기서 설정한 변수는 사라집니다. 사용자 환경 변수나 시작 스크립트에 저장했던 값은 별도로 정리해야 합니다. TOML 설정은 임시 변수가 없는 새 터미널에서 확인하세요.

3. 시작 및 확인

프로젝트 디렉터리에서 실행하세요:

cd your-project-directory
kimi

화면에서 /model을 실행해 Kimi K3.1 Pro (I Code Easy) 또는 원하는 등급을 확인하세요. 버전 번호나 모델 목록만 표시된 것으로 API 호출 성공을 판단할 수는 없습니다.

처음에는 “연결 성공이라고만 답해 줘” 같은 간단한 메시지를 보내세요. 답변을 받은 뒤 프로젝트 읽기나 수정을 요청하세요. 요청 로그에서 상태와 실제 모델을, 사용량 내역에서 사용량과 요금을 확인하세요. 문제 해결용 스크린샷에서는 키를 가리세요.

Claude Code에서 Kimi K3.1 Pro 사용

일반 설치·설정은 Claude Code 안내를 참고하세요. macOS / Linux에서는 사용하는 셸의 ~/.bashrc 또는 ~/.zshrc에 다음을 추가할 수 있습니다:

export ANTHROPIC_AUTH_TOKEN="당신의 I Code Easy API Key"
export ANTHROPIC_BASE_URL="https://api.icodeeasy.cc"
export ANTHROPIC_MODEL="k3.1-pro"
export ANTHROPIC_SMALL_FAST_MODEL="k3.1-pro"
export ANTHROPIC_DEFAULT_SONNET_MODEL="k3.1-pro"
export ANTHROPIC_DEFAULT_OPUS_MODEL="k3.1-pro"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="k3.1-pro"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"

저장한 후 source ~/.bashrc 또는 source ~/.zshrc를 실행하고 claude를 시작하세요. ANTHROPIC_BASE_URL에는 도메인만 넣습니다. 대체 주소는 https://jp.icodeeasy.cc와 https://sg.icodeeasy.cc입니다. 모델 변경 후에는 새 세션을 여세요.

Windows PowerShell에서는 같은 변수를 $env:변수명="값" 형식으로 설정하고 그 창에서 claude를 실행하세요. 사용자 수준 영구 변수를 저장했다면 PowerShell을 다시 열어야 하며 실행 중인 클라이언트에는 자동 반영되지 않습니다. Bash의 export를 그대로 PowerShell에 붙이지 마세요.

$env:ANTHROPIC_AUTH_TOKEN="당신의 I Code Easy API Key"
$env:ANTHROPIC_BASE_URL="https://api.icodeeasy.cc"
$env:ANTHROPIC_MODEL="k3.1-pro"
$env:ANTHROPIC_SMALL_FAST_MODEL="k3.1-pro"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="k3.1-pro"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL="k3.1-pro"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="k3.1-pro"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"
claude

401, 모델 미반영, URL 오류 해결

다른 클라이언트 설정

Claude Code · GLM 설정 · 가격·잔액·사용량 · 모델 기능 목록

공식 참고 자료

• Kimi Code: 설정 파일
• Kimi Code: 환경 변수