Claude Code 接入 Kimi K3 教程:官方配置与成本对比(2026)
按 Kimi 官方文档,用 Moonshot 的 Anthropic 兼容接口让 Claude Code 跑在 Kimi K3 上:settings.json 完整配置、每个变量的作用、接入后的变化,以及和 Claude Opus 5.5、Sonnet 5.5 的月度成本对比。
月之暗面(Moonshot AI)官方文档介绍了如何通过 Anthropic 兼容的 Messages API 让 Claude Code 跑在 Kimi K3 上。Claude Code 的界面和用法不变,按 Kimi 的 token 价格付费。
本文按 Kimi 官方文档在 Claude Code 中使用 Kimi(国际版:Use Kimi in Claude Code)整理,核对日期 2026-11-16。价格来自 Kimi 国际版价格页 和 Anthropic 官方价格页,与本站模型数据一致。
谁来支持这套配置: 这是 Moonshot 官方文档写明并支持的接法。Anthropic 的 Claude Code 文档写明 Anthropic 不支持把 Claude Code 路由到非 Claude 模型,遇到问题请查 Kimi 文档。
先看结论
| 配置项 | 值 |
|---|---|
| 端点(国内开放平台的 key) | https://api.moonshot.cn/anthropic |
| 端点(国际版 platform.kimi.ai 的 key) | https://api.moonshot.ai/anthropic |
| key 填在 | ANTHROPIC_AUTH_TOKEN |
| 所有档位的模型 | kimi-k3[1m] |
| 写在哪里 | ~/.claude/settings.json 的 env 字段 |
| 计费 | 从 Kimi API 余额扣费,不使用 Claude 订阅额度 |
key 和端点必须来自同一个平台。国内平台的 key 配国际端点(或反过来)会返回 401。
第一步:安装 Claude Code
Kimi 文档推荐 Anthropic 官方安装脚本:
# macOS 和 Linux
curl -fsSL https://claude.ai/install.sh | bash
# Windows PowerShell
irm https://claude.ai/install.ps1 | iex
也可以用 npm 安装(需要 Node.js 22 及以上):npm install -g @anthropic-ai/claude-code。
如果之前给 Claude Code 配过其他模型,先清理旧配置。~/.claude/settings.json 的 env 字段里残留的 ANTHROPIC_* 会覆盖终端里 export 的变量,~/.zshrc、~/.bashrc 里的旧 export 也会干扰。Kimi 文档里提供了一段 Node.js 清理脚本,只删除端点、凭证和模型相关的键。
第二步:获取 Kimi API Key
国内用户在 Kimi 开放平台 创建 API Key(国际版在 platform.kimi.ai)。
第三步:配置 settings.json
把下面内容写入 ~/.claude/settings.json 的 env 字段,保存后重启 Claude Code。以国内平台为例:
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.moonshot.cn/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]",
"CLAUDE_CODE_AUTO_COMPACT_WINDOW": "1000000",
"CLAUDE_CODE_EFFORT_LEVEL": "max"
}
}
国际版 key 把 ANTHROPIC_BASE_URL 换成 https://api.moonshot.ai/anthropic,其余不变。这个文件里有明文 API Key,不要提交到 git。
Kimi 文档特别强调每个档位都要配。Claude Code 的主对话、后台摘要、子 Agent 用的是不同档位,漏配的那个会悄悄失败:
| 变量 | 作用 | 不配置的后果 |
|---|---|---|
ANTHROPIC_BASE_URL | Kimi 端点 | 请求发到 Anthropic,鉴权失败 |
ANTHROPIC_AUTH_TOKEN | Kimi API Key | 401 错误 |
ANTHROPIC_MODEL | 主对话模型 | 找不到模型 |
ANTHROPIC_DEFAULT_OPUS/SONNET/HAIKU/FABLE_MODEL | 各别名背后的模型 | 对应档位的任务失败 |
CLAUDE_CODE_SUBAGENT_MODEL | 子 Agent 模型 | 子 Agent 失败或效果明显变差 |
CLAUDE_CODE_AUTO_COMPACT_WINDOW | 自动压缩触发点 | 太小会过早丢上下文,太大会超长报错 |
CLAUDE_CODE_EFFORT_LEVEL | 思考强度 | Kimi 建议设为 max |
第四步:确认配置生效
先直接测试 key 和端点(国内平台):
curl https://api.moonshot.cn/anthropic/v1/messages \
--header "Authorization: Bearer $MOONSHOT_API_KEY" \
--header "Content-Type: application/json" \
--data '{"model": "kimi-k3.1-pro", "max_tokens": 1, "messages": [{"role": "user", "content": "hi"}]}'
返回 JSON 说明 key 可用;返回 401 说明 key 错误或与平台不匹配。然后启动 claude,输入 /status:Base URL 应显示你配置的端点,模型显示 kimi-k3[1m]。ANTHROPIC_AUTH_TOKEN 的优先级高于之前 /login 保存的登录态;想清掉旧登录可运行 /logout。
换成 Kimi K3 后有哪些变化
| 方面 | 变化 |
|---|---|
| Claude 订阅 | 请求带的是 Kimi key,Pro/Max/Ultra 额度不会被使用,全部 token 从 Kimi 扣费。 |
| 思考 | K3 始终开启推理并启用 Preserved Thinking,思考强度用 CLAUDE_CODE_EFFORT_LEVEL 设置。 |
| 上下文 | K3 上下文 1,048,576 token,所以用 [1m] 和 1M 自动压缩窗口。 |
| 所有档位同一个模型 | Kimi 示例里所有档位(包括 Haiku 档的后台任务)都用 K3,没有更便宜的”小模型”档。 |
成本:Kimi K3 对比 Claude Code 默认模型
根据 Anthropic 的模型配置文档,Claude Code 在付费套餐和 API 上默认使用 Claude Opus 5.5。订阅不公布 token 额度,所以这里按 API 对 API 比较,使用 Kimi 国际版美元价格。
假设用量: 每月 1 亿(100M)输入 token、200 万(2M)输出 token,90% 输入命中缓存(90M 命中、10M 未命中)。Kimi K3 默认 5 分钟 TTL 的缓存写入价是 $3/M,与输入价相同,所以”未命中”一列已经包含。不计 Anthropic 的缓存写入加价。
| 模型 | 未命中输入 | 缓存命中输入 | 输出 | 每月合计 |
|---|---|---|---|---|
| Claude Opus 5.5 | 10M × $4.00 = $40.00 | 90M × $0.20 = $18.00 | 2M × $20.00 = $40.00 | $98.00 |
| Kimi K3 | 10M × $3.00 = $30.00 | 90M × $0.30 = $27.00 | 2M × $15.00 = $30.00 | $87.00 |
| Kimi K3.1 Pro | 10M × $2.00 = $20.00 | 90M × $0.20 = $18.00 | 2M × $10.00 = $20.00 | $58.00 |
| Claude Sonnet 5.5 | 10M × $2.00 = $20.00 | 90M × $0.10 = $9.00 | 2M × $10.00 = $20.00 | $49.00 |
实话实说:在缓存命中率高的编程场景下,Kimi K3 比 Opus 5.5 只便宜约 11%($87 对 $98),而且比 Sonnet 5.5 更贵——Sonnet 的每一项单价都更低(缓存读取价只有 K3 的三分之一)。换 Kimi K3 的理由主要是你更喜欢这个模型,而不是省钱。想在 Claude Code 里明显省钱,可以看 DeepSeek 或 GLM-5.3 的接法。国内平台按人民币计费,请以 Kimi 开放平台的人民币价格为准。
Kimi 更新的 K3.1 Pro 比 K3 便宜,上面 Kimi 官方的验证命令调用的就是同一端点上的 kimi-k3.1-pro。不过 Kimi 的 Claude Code 文档只写了 kimi-k3[1m] 的配置,用 K3.1 Pro 前请先拿小任务测一下。
常见问题
| 现象 | 处理方法 |
|---|---|
| 401 错误 | 检查 key 是否正确、是否与端点同一平台,并删掉残留的 ANTHROPIC_API_KEY |
| 找不到模型 | 检查每个变量里 kimi-k3[1m] 的拼写,不要有多余空格或引号 |
| 子 Agent 或后台任务报错 | Haiku、Fable 和子 Agent 变量也要配置 |
| 修改不生效 | 清理 settings.json 和 shell 配置里的旧值,然后重启 Claude Code |