Claude Code 接入国产模型教程:GLM/DeepSeek/Kimi(2026)
很多人喜欢 Claude Code 的终端体验,却卡在国内直连难、官方订阅贵这两道坎上。其实你不必换工具——Claude Code 接入国产模型只需要改两三个环境变量,把请求指向智谱 GLM、DeepSeek、Kimi 等提供的「Anthropic 兼容端点」,原本的命令、工作流、子代理一行代码都不用动。这篇教程把三家的配置、验证方法和选型一次讲清。
原理:为什么 Claude Code 能换成国产模型
Claude Code 通过两个环境变量决定「把请求发到哪、用什么密钥」:ANTHROPIC_BASE_URL(接口地址)和 ANTHROPIC_AUTH_TOKEN(密钥)。国产模型厂商纷纷上线了与 Anthropic Messages API 完全兼容的端点,只要把 BASE_URL 指过去、换上自家的 API Key,Claude Code 就会把它当成 Anthropic 官方接口来调用,模型却是国产的。
兼容端点 ≠ 官方 API
这里用的是各厂商「Anthropic 兼容」端点(路径通常带 /anthropic),不是它们给自家 SDK 用的 OpenAI 风格端点。两者地址不同,别填错。
准备工作
- 已安装 Node.js 18+,并装好 Claude Code(npm install -g @anthropic-ai/claude-code)
- 在目标厂商平台注册并创建 API Key:智谱 open.bigmodel.cn、DeepSeek platform.deepseek.com、Kimi platform.moonshot.cn
- 知道自己的配置文件位置:用户级配置是 ~/.claude/settings.json(Windows 在 C:\Users\你的用户名\.claude\settings.json)
两种配置方式
方式一是写进 settings.json,长期固定、跨会话生效;方式二是临时设环境变量,适合在不同模型间快速切换。两者任选其一即可,settings.json 更省心。
方式一:写进 ~/.claude/settings.json(推荐)
{
"env": {
"ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
"ANTHROPIC_AUTH_TOKEN": "你的智谱_API_KEY",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-4.6",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-4.6"
}
}方式二:临时设环境变量
# macOS / Linux
export ANTHROPIC_BASE_URL=https://open.bigmodel.cn/api/anthropic
export ANTHROPIC_AUTH_TOKEN=你的智谱_API_KEY
claude# Windows PowerShell(仅当前窗口有效)
$env:ANTHROPIC_BASE_URL="https://open.bigmodel.cn/api/anthropic"
$env:ANTHROPIC_AUTH_TOKEN="你的智谱_API_KEY"
claude三家的具体参数
| 厂商 | ANTHROPIC_BASE_URL | 推荐模型 | 密钥申请 |
|---|---|---|---|
| 智谱 GLM | https://open.bigmodel.cn/api/anthropic | glm-4.6 | open.bigmodel.cn |
| DeepSeek | https://api.deepseek.com/anthropic | 自动映射(见下) | platform.deepseek.com |
| Kimi(Moonshot) | https://api.moonshot.cn/anthropic | kimi-k2.7-code | platform.moonshot.cn |
DeepSeek 的特殊点:自动映射模型
DeepSeek 的 Anthropic 兼容端点会按 Claude 的模型档位自动映射——claude-opus 走 deepseek-v4-pro,claude-sonnet / claude-haiku 走 deepseek-v4-flash。所以接 DeepSeek 时一般不用手动指定 ANTHROPIC_MODEL,配好 BASE_URL 和密钥即可。
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
"ANTHROPIC_AUTH_TOKEN": "你的DeepSeek_API_KEY"
}
}deepseek-chat / deepseek-reasoner 即将下线
DeepSeek 官方公告这两个旧模型名将于 2026 年 7 月 24 日停用,分别对应 deepseek-v4-flash 的非思考 / 思考模式。新接入直接用上面的自动映射方式即可,别再硬写旧模型名。
验证是否生效
配置完重新打开终端运行 claude,进入会话后用 /status 查看当前接口地址,或直接问它「你现在用的是什么模型」。如果地址变成了你填的国产端点、回答里出现 GLM / DeepSeek / Kimi 字样,就说明切换成功。
claude
# 进入会话后输入:
/status
# 或者直接问:你现在运行在什么模型上?GLM、DeepSeek、Kimi 怎么选
| 模型 | 适合场景 | 体感 |
|---|---|---|
| GLM-4.6(智谱) | 日常写码、改 Bug、综合任务 | 工具调用稳定,和 Claude Code 配合度高,常被当作首选平替 |
| DeepSeek | 预算敏感、长任务、批量改造 | 价格低、上下文长,官方端点对 Claude Code 适配完整 |
| Kimi K2.7(Moonshot) | 代码专项、长上下文阅读 | 代码模型针对性强,长文本理解是强项 |
先小后大
建议先用一个简单需求(比如让它改个函数)跑通流程,确认计费、网络、工具调用都正常,再放手交给它做大改造。不同模型的工具调用习惯略有差异,磨合一下手感更顺。
常见坑
- BASE_URL 填错路径:注意要带 /anthropic 后缀,且各家路径不同(智谱是 /api/anthropic,DeepSeek/Kimi 是 /anthropic)。
- 密钥变量名用混:国产端点用 ANTHROPIC_AUTH_TOKEN,不要和官方的 ANTHROPIC_API_KEY 同时设置,容易互相覆盖。
- settings.json 和环境变量同时配:两边都设会以环境变量优先,排查时先确认没有残留的 export。
- 模型名过期:glm-4.6、kimi-k2.7-code 这类型号会随版本更新,报错「模型不存在」时去官方文档查最新型号名。
把 Claude Code 接到国产模型,是国内开发者降本增效最实在的一步。如果你想从「会配置」进阶到「真正用 AI 把项目从想法做到上线」,IMAI 的系统课把工具配置、提示词工程、终端 AI 编程工作流串成一条完整路径,配合视频实操和可复制的提示词,少走弯路。
想系统学会用 AI 编程,从入门到做出真实产品?
查看系统课程