설정 후 Claude Code의 메인 대화, 백그라운드 작업, 서브 에이전트가 모두 Kimi K3를 사용합니다.
토큰 준비
대시보드 → 토큰 관리에서 sk-4ai-... Token을 생성합니다. Claude Code에는 4AICode Token만 필요합니다.
영구 설정(권장)
~/.claude/settings.json을 열고 env에 다음을 추가합니다. 기존 Claude Code 설정이 있으면 유지하고 env만 병합하세요.
{
"env": {
"ANTHROPIC_BASE_URL": "https://relay.4aicode.com",
"ANTHROPIC_AUTH_TOKEN": "sk-4ai-xxxxxxxxxxxxxxxx",
"ANTHROPIC_MODEL": "kimi-k3",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "kimi-k3",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "kimi-k3",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "kimi-k3",
"ANTHROPIC_DEFAULT_FABLE_MODEL": "kimi-k3",
"CLAUDE_CODE_SUBAGENT_MODEL": "kimi-k3",
"ENABLE_TOOL_SEARCH": "false",
"CLAUDE_CODE_AUTO_COMPACT_WINDOW": "1048576",
"CLAUDE_CODE_EFFORT_LEVEL": "max"
}
}
예시 Token을 본인 4AICode Token으로 바꾸세요. 저장 후 Claude Code를 완전히 종료했다가 다시 여세요.
settings.json에 Token이 평문으로 들어갑니다. 안전하게 보관하고 Git 커밋에서 제외하세요.
임시 설정
현재 터미널 창에만 적용되며, 먼저 체험할 때 적합합니다.
export ANTHROPIC_BASE_URL="https://relay.4aicode.com"
export ANTHROPIC_AUTH_TOKEN="sk-4ai-xxxxxxxxxxxxxxxx"
export ANTHROPIC_MODEL="kimi-k3"
export ANTHROPIC_DEFAULT_OPUS_MODEL="kimi-k3"
export ANTHROPIC_DEFAULT_SONNET_MODEL="kimi-k3"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="kimi-k3"
export ANTHROPIC_DEFAULT_FABLE_MODEL="kimi-k3"
export CLAUDE_CODE_SUBAGENT_MODEL="kimi-k3"
export ENABLE_TOOL_SEARCH="false"
export CLAUDE_CODE_AUTO_COMPACT_WINDOW="1048576"
export CLAUDE_CODE_EFFORT_LEVEL="max"
claude
예시의 모든 모델 변수를 유지하세요. Claude Code는 메인 대화, 요약, 서브 에이전트 등 시나리오마다 다른 모델 변수를 사용합니다.
설정 확인
Claude Code를 시작하고 입력:
/status
Base URL이 https://relay.4aicode.com, Model이 kimi-k3인지 확인한 뒤 메시지를 보내 테스트하세요.
Claude Code /model 메뉴는 주로 내장 Claude 모델을 표시합니다. 실제 Kimi K3 설정은 /status를 참고하세요.
문제 해결
| 문제 | 해결 |
|---|---|
| 401 또는 잘못된 Token | 토큰 페이지에서 확인 또는 재생성 |
| Model not found | 모든 모델 변수를 kimi-k3로; 모델명에 [1m] 접미사 없어야 함 |
| 메인은 되는데 백그라운드 실패 | Haiku, Fable, CLAUDE_CODE_SUBAGENT_MODEL 포함 여부 확인 |
| Tool Search·도구 호출 이상 | ENABLE_TOOL_SEARCH가 false인지 확인 |
| 변경이 반영 안 됨 | settings.json이 터미널 동명 환경 변수를 덮어씀. 저장 후 Claude Code 완전 재시작 |
이 설정 방법은 공식 Kimi Claude Code 가이드를 기반으로 합니다. 표준 Claude·ChatGPT 모델 설정은 Claude 설정을 참고하세요.