DevTk.AI
Kimi K3Claude Code月之暗面AI 编程Kimi API

Claude Code 接入 Kimi K3 教程:官方配置与成本对比(2026)

按 Kimi 官方文档,用 Moonshot 的 Anthropic 兼容接口让 Claude Code 跑在 Kimi K3 上:settings.json 完整配置、每个变量的作用、接入后的变化,以及和 Claude Opus 5.5、Sonnet 5.5 的月度成本对比。

作者 发布于 12 分钟阅读

月之暗面(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_URLKimi 端点请求发到 Anthropic,鉴权失败
ANTHROPIC_AUTH_TOKENKimi API Key401 错误
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.510M × $4.00 = $40.0090M × $0.20 = $18.002M × $20.00 = $40.00$98.00
Kimi K310M × $3.00 = $30.0090M × $0.30 = $27.002M × $15.00 = $30.00$87.00
Kimi K3.1 Pro10M × $2.00 = $20.0090M × $0.20 = $18.002M × $10.00 = $20.00$58.00
Claude Sonnet 5.510M × $2.00 = $20.0090M × $0.10 = $9.002M × $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

相关阅读

下一步

相关文章