Claude Code 接入国产模型:DeepSeek、Kimi、GLM 配置教程
DeepSeek、Kimi(月之暗面)和智谱 GLM 都官方提供了兼容 Anthropic Messages API 的端点。原理一样:用 ANTHROPIC_BASE_URL 把 Claude Code 的请求指向国产模型,用 ANTHROPIC_AUTH_TOKEN 填对应平台的 API Key,再用几个模型变量把 Claude Code 内部的 Opus/Sonnet/Haiku 档位映射到国产模型。以下配置均摘自各家官方文档(2026 年 10 月查阅),模型名更新很快,使用前请再核对一遍。
通用:两种写法
- 终端临时变量:
export后在同一个终端运行claude,只对当前会话生效。 - 写入配置文件:放进
~/.claude/settings.json的env字段,长期生效。注意 settings.json 里的同名变量会覆盖终端 export 的值;文件里是明文密钥,不要提交到 git。
只配一部分模型变量的话,Claude Code 的后台摘要、子代理等场景可能会静默失败(Kimi 文档特别提醒了这一点),建议把各档位都配上。
DeepSeek
端点 https://api.deepseek.com/anthropic。官方给出的 Linux / macOS 配置:
export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=<你的 DeepSeek API Key>
export ANTHROPIC_MODEL=deepseek-flash[1m]
export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-flash[1m]
export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-flash[1m]
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-flash
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-flash
export CLAUDE_CODE_EFFORT_LEVEL=max
claude DeepSeek 还会自动映射 Claude 模型名:claude-opus* 映射到 deepseek-v4-pro(按 V4 Pro 计费),claude-sonnet*、claude-haiku* 映射到 deepseek-flash。兼容层会忽略 cache_control、mcp_servers 等字段,不支持 document 类型消息。Windows PowerShell 用 $env:变量名="值" 的写法。
Kimi(Moonshot 开放平台)
端点 https://api.moonshot.cn/anthropic,Key 在 Kimi 开放平台创建。官方示例(写入 ~/.claude/settings.json):
{
"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-k2.7-code",
"CLAUDE_CODE_SUBAGENT_MODEL": "kimi-k3[1m]",
"CLAUDE_CODE_AUTO_COMPACT_WINDOW": "1000000",
"CLAUDE_CODE_EFFORT_LEVEL": "max"
}
} 注意:
kimi-k2.7-code强制开启思考,需在 Claude Code 里开启 Thinking(macOSOption+T,Windows/LinuxAlt+T),否则会返回400 invalid thinking。- 如果你买的是 Kimi Code 会员,用的是另一套端点
https://api.kimi.com/coding/,密钥变量是ANTHROPIC_API_KEY,模型名也不同(如k3-256k、kimi-for-coding)。两套平台的 Key 不互通,混用会报 401。 - 之前配置过
ANTHROPIC_API_KEY的,用开放平台时要删掉,避免与ANTHROPIC_AUTH_TOKEN冲突。
智谱 GLM(GLM Coding Plan)
端点 https://open.bigmodel.cn/api/anthropic。智谱提供了自动化助手 npx @z_ai/coding-helper,也可以手动写入 ~/.claude/settings.json:
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
"ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.7",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-5.2[1m]",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5.2[1m]",
"CLAUDE_CODE_AUTO_COMPACT_WINDOW": "1000000",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1,
"API_TIMEOUT_MS": "3000000"
}
} 智谱文档说明:不设置模型变量时默认由服务端映射到 GLM-4.7;要用 1M 上下文需在模型名后加 [1m] 并设置 CLAUDE_CODE_AUTO_COMPACT_WINDOW。个人套餐、团队套餐与标准 API 的 Key 分开管理、互不通用。修改配置后需重新打开终端。
验证与常见错误
- 启动后输入
/status,确认 Base URL 和 Model 是你配置的值。 - 401 鉴权失败:Key 填错,或 Key 与端点不属于同一平台(Kimi 开放平台 vs Kimi Code、智谱个人套餐 vs 标准 API)。
- 模型不存在:模型变量没配全,Claude Code 用默认的 Claude 模型名去请求;或者 Claude Code 版本太旧不识别
[1m]后缀,执行claude update升级。 - 改了 settings.json 不生效:关掉所有 Claude Code 窗口,新开终端再运行;检查 JSON 逗号是否正确。