Kimi Claude Code

상위 문서: ← Kimi Integrations 출처: Kimi API Platform 공식 문서 — Use Kimi in Claude Code 한글화 (2026-07-22) 공급사: Moonshot AI (月之暗面)

Claude Code는 Anthropic의 프로그래밍 에이전트 제품입니다. 이 가이드는 환경 변수를 통해 Claude Code의 모델 요청을 Kimi API로 전달하는 일반적인 통합 방식을 설명합니다.

1. Claude Code 설치

이미 설치된 경우 건너뜁니다. 없으면:

npm install -g @anthropic-ai/claude-code

Node.js가 없는 경우 — macOS/Linux:

curl -fsSL https://fnm.vercel.app/install | bash
fnm install 24.3.0
fnm default 24.3.0
fnm use 24.3.0

Windows (PowerShell):

winget install OpenJS.NodeJS
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

Node.js 설치 후 한 번 초기화:

node --eval "
    const fs = require('fs');
    const path = require('path');
    const os = require('os');
    const homeDir = os.homedir();
    const filePath = path.join(homeDir, '.claude.json');
    if (fs.existsSync(filePath)) {
        const content = JSON.parse(fs.readFileSync(filePath, 'utf-8'));
        fs.writeFileSync(filePath, JSON.stringify({ ...content, hasCompletedOnboarding: true }, null, 2), 'utf-8');
    } else {
        fs.writeFileSync(filePath, JSON.stringify({ hasCompletedOnboarding: true }, null, 2), 'utf-8');
    }"

신규 설치가 아닌 경우 — ~/.claude/settings.json의 env 필드에 ANTHROPIC_* 변수가 남아 있으면 터미널 변수를 덮어써서 새 설정이 무효화될 수 있습니다. 다음 스크립트로 정리:

node --eval "
    const fs = require('fs');
    const path = require('path');
    const os = require('os');
    const settingsPath = path.join(os.homedir(), '.claude', 'settings.json');
    if (fs.existsSync(settingsPath)) {
        const content = JSON.parse(fs.readFileSync(settingsPath, 'utf-8'));
        if (content && typeof content === 'object' && content.env && typeof content.env === 'object') {
            for (const key of [
                'ANTHROPIC_BASE_URL', 'ANTHROPIC_API_KEY', 'ANTHROPIC_AUTH_TOKEN',
                'ANTHROPIC_MODEL', 'ANTHROPIC_SMALL_FAST_MODEL', 'CLAUDE_CODE_SUBAGENT_MODEL',
                'ANTHROPIC_DEFAULT_OPUS_MODEL', 'ANTHROPIC_DEFAULT_OPUS_MODEL_NAME',
                'ANTHROPIC_DEFAULT_SONNET_MODEL', 'ANTHROPIC_DEFAULT_SONNET_MODEL_NAME',
                'ANTHROPIC_DEFAULT_HAIKU_MODEL', 'ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME',
                'ANTHROPIC_DEFAULT_FABLE_MODEL', 'ANTHROPIC_DEFAULT_FABLE_MODEL_NAME',
                'ENABLE_TOOL_SEARCH', 'CLAUDE_CODE_AUTO_COMPACT_WINDOW', 'CLAUDE_CODE_EFFORT_LEVEL',
            ]) { delete content.env[key]; }
            fs.writeFileSync(settingsPath, JSON.stringify(content, null, 2), 'utf-8');
        }
    }"

또한 ~/.zshrc, ~/.bashrc 등 셸 설정 파일에 남은 ANTHROPIC_* export를 확인해 제거하세요.

2. Kimi API Key 발급

Kimi Open Platform에 접속해 API Key를 생성합니다(기본 프로젝트 선택). 아래 예제의 YOUR_MOONSHOT_API_KEY 자리에 사용하세요.

3. 환경 변수 설정

아래 두 방법 중 하나만 선택하세요. Method 1은 즉시 적용되지만 현재 터미널 세션에만, Method 2는 설정 파일에 기록되어 영구적입니다.

Method 1: 터미널 환경 변수 (현재 세션만)

macOS/Linux:

export ANTHROPIC_BASE_URL="https://api.moonshot.ai/anthropic"
export ANTHROPIC_AUTH_TOKEN="${YOUR_MOONSHOT_API_KEY}"
export ANTHROPIC_MODEL="kimi-k3[1m]"
export ANTHROPIC_DEFAULT_OPUS_MODEL="kimi-k3[1m]"
export ANTHROPIC_DEFAULT_SONNET_MODEL="kimi-k3[1m]"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="kimi-k3[1m]"
export ANTHROPIC_DEFAULT_FABLE_MODEL="kimi-k3[1m]"
export CLAUDE_CODE_SUBAGENT_MODEL="kimi-k3[1m]"
export ENABLE_TOOL_SEARCH="false"
export CLAUDE_CODE_AUTO_COMPACT_WINDOW="1048576"
export CLAUDE_CODE_EFFORT_LEVEL="max"
claude

Windows (PowerShell):

$env:ANTHROPIC_BASE_URL="https://api.moonshot.ai/anthropic";
$env:ANTHROPIC_AUTH_TOKEN="YOUR_MOONSHOT_API_KEY"
$env:ANTHROPIC_MODEL="kimi-k3[1m]"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL="kimi-k3[1m]"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="kimi-k3[1m]"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="kimi-k3[1m]"
$env:ANTHROPIC_DEFAULT_FABLE_MODEL="kimi-k3[1m]"
$env:CLAUDE_CODE_SUBAGENT_MODEL="kimi-k3[1m]"
$env:ENABLE_TOOL_SEARCH="false"
$env:CLAUDE_CODE_AUTO_COMPACT_WINDOW="1048576"
$env:CLAUDE_CODE_EFFORT_LEVEL="max"
claude

Method 2: settings.json에 영구 저장

~/.claude/settings.json의 env 필드에 동일한 변수를 기록:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.moonshot.ai/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_MOONSHOT_API_KEY",
    "ANTHROPIC_MODEL": "kimi-k3[1m]",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "kimi-k3[1m]",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "kimi-k3[1m]",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "kimi-k3[1m]",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "kimi-k3[1m]",
    "CLAUDE_CODE_SUBAGENT_MODEL": "kimi-k3[1m]",
    "ENABLE_TOOL_SEARCH": "false",
    "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "1048576",
    "CLAUDE_CODE_EFFORT_LEVEL": "max"
  }
}

settings.json의 env 값은 터미널 export 변수를 덮어씁니다. 이 파일에는 API Key가 평문으로 저장되므로 git에 커밋하지 마세요. 저장 후 Claude Code를 재시작하세요.

변수 레퍼런스

변수	목적	미설정/오설정 시 영향
ANTHROPIC_BASE_URL	Kimi의 Anthropic 호환 엔드포인트로 요청 전달	Anthropic 공식 엔드포인트로 요청 가서 인증 실패
ANTHROPIC_AUTH_TOKEN	Kimi API Key 인증	401 인증 오류
ANTHROPIC_MODEL	메인 대화 모델	모델을 찾을 수 없음 오류
ANTHROPIC_DEFAULT_OPUS_MODEL / ..._SONNET_MODEL / ..._HAIKU_MODEL / ..._FABLE_MODEL	작업 계층별 모델명	해당 계층 작업 실패
CLAUDE_CODE_SUBAGENT_MODEL	서브 에이전트 모델	서브 에이전트 작업 실패/성능 저하
ENABLE_TOOL_SEARCH	Tool Search 기능 토글	Kimi 엔드포인트는 미지원 → false 필수
CLAUDE_CODE_AUTO_COMPACT_WINDOW	자동 컴팩션 트리거 컨텍스트 크기	kimi-k3=1048576 (1M), kimi-k2.7-code=262144 (256K)
CLAUDE_CODE_EFFORT_LEVEL	Claude Code의 reasoning effort	복잡한 작업은 max 권장

4. 모델별 사고(thinking) 동작

모델	사고	비고
kimi-k3 (이 페이지 기본값)	기본 ON	별도 설정 없이 동작
kimi-k2.7-code	항상 ON	Claude Code에서 Tab을 눌러 Thinking ON 상태 유지. OFF면 invalid thinking: only type=enabled is allowed for this model 오류
kimi-k2.6	옵션	사고 OFF로도 동작, 지연 민감 단순 작업에 적합

5. 적용 확인

Claude Code에서 /status를 입력해 다음을 확인합니다:

• Base URL = https://api.moonshot.ai/anthropic
• Model = kimi-k3[1m]

Claude Code의 /model 메뉴는 고정 alias 목록을 보여주므로 Kimi 모델이 표시되지 않습니다. 거기서 전환할 필요는 없습니다. /status에 표시되는 값이 실제로 적용된 설정입니다.

마지막으로 hi 같은 메시지를 보내 정상 응답이 돌아오면 엔드투엔드 설정이 완료된 것입니다.

6. 사고(Thinking) 켜기

kimi-k3는 기본으로 사고합니다. kimi-k2.7-code로 전환했다면 Claude Code에서 Tab을 눌러 "Thinking on" 표시를 확인하세요. OFF 상태에서는 모델이 요청을 거부합니다(400 invalid thinking).

7. 고속 모델로 전환

Kimi K2.7 Code는 일반 버전의 약 5-6배 출력 속도를 가진 고속 변형 kimi-k2.7-code-highspeed를 제공합니다. 속도를 우선시한다면 모든 모델 변수를 kimi-k2.7-code-highspeed로 바꾸세요(명시적 사고 활성화 필요). 자세한 내용은 K2.7 Code 가격 참고.

8. FAQ

• WebSearch 400 invalid thinking / WebFetch unavailable
  • kimi-k2.7-code는 사고가 필수이므로 OFF면 WebSearch 요청이 거절됩니다. Tab으로 사고를 켜거나 kimi-k2.6로 전환. kimi-k3는 영향 없음
  • WebFetch는 현재 엔드포인트에서 미지원. 웹 페이지 내용을 직접 붙여 넣거나 MCP 스크래핑 도구 사용
• 401 인증 오류 — ANTHROPIC_AUTH_TOKEN이 유효한 Kimi API Key인지, 동시에 ANTHROPIC_API_KEY가 설정되어 있지 않은지 확인
• Model not found — 모델 변수 철자 확인 (kimi-k3[1m], 공백·따옴표 없음)
• 백그라운드/서브 에이전트 실패 — ANTHROPIC_DEFAULT_HAIKU_MODEL / ANTHROPIC_DEFAULT_FABLE_MODEL / CLAUDE_CODE_SUBAGENT_MODEL이 비어있으면 발생. 레퍼런스에 따라 채우기
• 설정이 적용되지 않음 — ~/.claude/settings.json의 env 필드 잔여 항목 확인. 새 터미널·재시작 필요
• API Key/엔드포인트 불일치 — ANTHROPIC_BASE_URL이 API Key 발급 플랫폼과 일치하는지 확인
• /login 사용 중 — ANTHROPIC_AUTH_TOKEN이 우선. /logout으로 claude.ai 로그인 제거 가능

---

변경 이력

날짜	변경
2026-07-22	초판 작성 (공식 Claude Code 통합 가이드 한글화)
2026-07-22	제목에 "Kimi" 접두사 추가, 본문 H1 중복 제거