Kimi Code / Kimi K3 설치 및 설정
Kimi Code는 소프트웨어 개발 워크플로를 위해 설계되었으며, 프로그래밍 작업을 빠르고 안정적으로 지원합니다. 이 가이드에서는 공식 Kimi Code CLI를 설치하고 I Code Easy API Key로 kimi-k3에 연결하는 방법을 설명합니다.
Kimi Code CLI와 Claude Code는 서로 다른 클라이언트입니다. Claude Code를 사용한다면 이 페이지 후반의 Claude Code 섹션을 확인하세요.
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
설치 후 새 터미널을 열고 명령을 확인합니다:
kimi --version
설치 프로그램과 제품 소개는 Kimi Code 공식 페이지를 참고하세요.
2. I Code Easy API 설정
현재 Kimi Code는 영구 설정을 ~/.kimi-code/config.toml에 저장합니다. 파일이 없다면 새로 만드세요. 이미 있다면 기존 Provider, MCP, 권한 설정을 덮어쓰지 말고 아래 내용을 병합하며, 최상위 default_model 항목은 하나만 유지하세요.
default_model = "icodeeasy/kimi-k3"
[providers.icodeeasy]
type = "kimi"
base_url = "https://api.icodeeasy.cc/v1"
api_key = "your I Code Easy API key"
[models."icodeeasy/kimi-k3"]
provider = "icodeeasy"
model = "kimi-k3"
max_context_size = 1048576
capabilities = ["thinking", "always_thinking", "image_in", "video_in", "tool_use"]
display_name = "Kimi K3 (I Code Easy)"
support_efforts = ["max"]
default_effort = "max"
macOS / Linux에서는 설정 파일 권한을 제한하세요:
chmod 600 ~/.kimi-code/config.toml
기본 도메인이 느리면 base_url을 https://jp.icodeeasy.cc/v1 또는 https://sg.icodeeasy.cc/v1로 변경할 수 있습니다.
3. 실행 및 확인
프로젝트를 열고 Kimi Code를 실행합니다:
cd your-project
kimi
Kimi Code 안에서 /model을 실행해 Kimi K3 (I Code Easy)가 선택되었는지 확인한 다음 원하는 프로그래밍 작업을 입력하세요.
I Code Easy API Key를 사용할 때는 /login이 필요하지 않습니다. /login은 Kimi 공식 계정 로그인용입니다.
임시 테스트 설정
현재 Kimi Code는 셸에서 일반 KIMI_API_KEY를 export해도 자동으로 읽지 않습니다. config.toml을 수정하지 않고 임시로 테스트하려면 전용 KIMI_MODEL_* 변수를 사용하세요:
export KIMI_MODEL_NAME="kimi-k3"
export KIMI_MODEL_API_KEY="your 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
터미널 세션을 닫으면 이 임시 설정은 사라집니다.
Claude Code에서 Kimi K3 256K 사용
Claude Code에서 Kimi K3 256K를 사용하려면 ~/.bashrc 또는 ~/.zshrc에 다음을 추가하세요:
export ANTHROPIC_AUTH_TOKEN="your I Code Easy API key"
export ANTHROPIC_BASE_URL="https://api.icodeeasy.cc"
export ANTHROPIC_MODEL="kimi-k3"
export ANTHROPIC_SMALL_FAST_MODEL="kimi-k3"
export ANTHROPIC_DEFAULT_SONNET_MODEL="kimi-k3"
export ANTHROPIC_DEFAULT_OPUS_MODEL="kimi-k3"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="kimi-k3"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"
kimi-k3는 Claude Code 호환 모델 이름입니다. 현재 3개의 공식 기본 업스트림은 실제 k3-256k 모델로 매핑합니다. 사용자 배율 0.25에서 입력, 캐시 읽기, 출력의 실효 가격은 각각 MTok당 ¥2.50, ¥0.25, ¥12.50입니다. 공식 풀이 사용할 수 없으면 Kimi K2.7 Code로 자동 전환되며 실제 폴백 모델을 기준으로 과금됩니다.
저장 후 source ~/.bashrc 또는 source ~/.zshrc를 실행하고 claude를 시작하세요. 기본 도메인이 느리면 ANTHROPIC_BASE_URL을 https://jp.icodeeasy.cc 또는 https://sg.icodeeasy.cc로 변경할 수 있습니다.
Windows에서는 PowerShell에 같은 사용자 환경 변수를 설정한 뒤 새 PowerShell 창을 여세요.