如何把 Kimi K3 接入 Claude Code

相比 Cursor 的自定义 endpoint 路径，Claude Code 是目前 Kimi 官方给出明确接入文档的方案。

这套接入方式使用 Kimi 提供的 Anthropic 兼容地址，Claude Code 连接这个地址后，实际使用的模型是 Kimi K3。下面的配置值来自 Kimi 官方文档，并补充了几个容易排查问题的验证步骤。

安装 Claude Code

先用 npm 安装 Claude Code：

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

然后去 Kimi 开放平台创建一个 API Key。

当前终端会话配置

如果只想先在当前终端里测试，启动 Claude Code 前导出这些环境变量：

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

把 YOUR_MOONSHOT_API_KEY 换成你自己的 Kimi API Key。

这里有两项不要漏：

ENABLE_TOOL_SEARCH="false"：Kimi 官方文档说明这条接入路径不支持 tool search。
CLAUDE_CODE_AUTO_COMPACT_WINDOW="1048576"：对应 Kimi K3 的一百万 token 上下文窗口。

写入长期配置

如果不想每次都 export，可以把配置写进 Claude Code 的设置文件：

{
  "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"
  }
}

文件路径是：

~/.claude/settings.json

Kimi 官方文档提醒过：这个文件里的 env 会覆盖终端里 export 的环境变量。它也会以明文保存 API Key，所以不要把它提交到代码仓库里。

改完后，重启 Claude Code。

验证是否生效

进入 Claude Code 后运行：

/status

确认 base URL 是：

https://api.moonshot.ai/anthropic

并确认模型是：

kimi-k3[1m]

Kimi 官方文档还提到，/model 不一定会显示 Kimi 模型列表；判断是否接入成功时，优先看 /status。

常见问题

如果 Claude Code 还是走了别的 provider，先检查 ~/.claude/settings.json，因为它会覆盖终端环境变量。

如果认证失败，重新创建一个 Kimi API Key，再确认粘贴时没有多余空格。

如果上下文过早 compact，检查 CLAUDE_CODE_AUTO_COMPACT_WINDOW 是否是 1048576。

如果出现 tool search 相关错误，检查 ENABLE_TOOL_SEARCH 是否是 false。