国产模型接入教程
Claude Code · 模型接入

选择模型供应商

下方展示当前供应商的完整配置,切换后查看对应方案。

配置实操 / macOS · Linux · Windows

Claude Code 接入 GLM Coding Plan

国内套餐 Key、模型映射与 settings.json,分步骤配置并核对用量。

5 个步骤约 9 分钟文档核对 2026-10-29
开始第一步
接入配置示意Anthropic Messages
Claude CodeGLM
MODEL
按套餐支持列表映射
BASE URL
https://open.bigmodel.cn/api/anthropic
AUTH
国内智谱个人或团队编程套餐专属 Key
已安装客户端 模型权限与额度 原配置已备份

配置速查

接口与凭据必须对应同一方案
字段内容注意
Base URLhttps://open.bigmodel.cn/api/anthropic国内平台入口
Key对应编程套餐创建标准 API、个人、团队 Key 不混用
配置用户目录 .claude/settings.json备份后合并 env
01

准备套餐和客户端

先检查 claude --version;未安装可执行 npm install -g @anthropic-ai/claude-code,Windows 还需要 Git for Windows。在智谱国内个人或团队编程套餐页面创建对应 Key,不以标准 API Key 代替。

按官方文档核对,未使用付费 Key 做端到端实测。先在测试项目运行,再核对供应商控制台用量;聊天成功不代表工具调用和全部联网功能都可用。

02

合并配置文件

打开用户目录下 .claude/settings.json 并备份。只合并下面的 env 字段,不覆盖原有权限、MCP 等配置。模型映射依据核对时官方手动示例,套餐不支持时从当前官方模型清单调整。

settings.json
{"env": {
  "ANTHROPIC_AUTH_TOKEN": "YOUR_GLM_CODING_PLAN_KEY",
  "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
  "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-5.3-flash[1m]",
  "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-5.3[1m]",
  "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5.3[1m]",
  "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "1000000",
  "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1,
  "API_TIMEOUT_MS": "3000000"
}}
03

重新启动并检查

退出客户端并重新打开终端,在测试目录运行 claude,用 /status 检查地址和模型。若首次初始化阻挡使用,可按官方文档运行 npx @z_ai/coding-helper;运行前了解其本机配置修改并备份。

04

完成最小验收

核对下方只读任务的文件引用,并检查智谱套餐控制台用量。长超时参数不代表性能承诺;慢请求先用短任务和服务状态排查。

复制到 Claude Code
请只读当前项目:说明启动命令、入口文件和测试命令,每条结论引用实际文件路径;找不到就写未找到。不要修改文件,也不要安装依赖。
05

配置不生效与回退

先检查 JSON 语法,再检查用户级、项目级和终端中的旧地址或 ANTHROPIC_MODEL。恢复备份并移除新增变量后重启。不要追加第二个 env 对象。

TROUBLESHOOTING

卡在哪一步?按错误定位。

401 / 403

凭据、套餐或模型权限不匹配

检查 Key 来源、地域和套餐;检查当前进程是否读取了旧认证。

404

地址或 API 协议不匹配

使用本文对应协议的 Base URL,不手工追加请求路径。

429

额度或调用频率限制

到供应商控制台核对余额、套餐与限流,降低并发后重试。

工具调用失败

文件权限、客户端版本或模型兼容性问题

先确认工作目录,验证一次只读文件任务,再增加其他能力。

完成前,确认这四项

  • 客户端版本可用,原配置已备份
  • 接口地址、Key 和模型属于同一产品方案
  • 只读任务引用了真实文件,并已核对调用用量
  • 没有提交真实 Key,能够还原原配置

官方参考来源

配置依据以下资料整理,验证任务与排查顺序为本站编辑建议。模型和客户端更新后,请重新核对接口与支持范围。

01https://docs.bigmodel.cn/cn/coding-plan/tool/claude
查看其他工具的接入方式