Claude Code 接 GLM 完整教程
Claude Code 说的是 Anthropic 的协议,智谱提供了一个 Anthropic 格式的接口(https://open.bigmodel.cn/api/anthropic),手动接入要自己改 ~/.claude/settings.json 里的 env。用 Magpie 只要两条命令:添加智谱 key,再把 Claude Code 指向 zhipu/glm-5.3。这篇还讲清楚最容易踩的坑:智谱的几类 key 互不通用。
命令取自 Magpie 官网的命令行示例,接口信息引自智谱官方文档;核对于 2026-10-27。
两条命令,加一条确认
magpie provider add zhipu 你的key # 添加智谱供应商(id 是 zhipu)
magpie claude zhipu/glm-5.3 # 把 Claude Code 指向 GLM-5.3
magpie ls # 确认 Claude Code 当前用的模型
切换后,下一个 Claude Code 会话开始使用 GLM。先看下面「先确认你的 key 是哪一类」,能少走弯路。
开始之前
- Magpie 已安装。终端里运行
magpie ls,能列出本机的 Agent 就说明装好了。还没装?先看安装教程(英文)。 - Claude Code 已安装。如果
magpie ls的列表里没有它,先启动一次 Claude Code,让它写出自己的配置文件,再重新运行magpie ls——Magpie 只显示已安装或已配置的 Agent。 - 一个智谱 API key。注意智谱有几类 key,互不通用,见下面「先确认你的 key 是哪一类」。
智谱的 Anthropic 格式接口是怎么回事
Claude Code 只会说 Anthropic 的协议。智谱官方文档(在 Claude Code 中使用 GLM Coding Plan 的方法)给出的手动接入办法是:把 ANTHROPIC_BASE_URL 指向智谱的 Anthropic 格式接口 https://open.bigmodel.cn/api/anthropic,把 key 放进 ANTHROPIC_AUTH_TOKEN,再用 ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL、ANTHROPIC_DEFAULT_HAIKU_MODEL 指定 opus、sonnet、haiku 三个别名对应哪个 GLM 模型——这些都写在 ~/.claude/settings.json 的 env 里。
用 Magpie 时这一层由 Magpie 接管:智谱是内置预设,预设里记着智谱的接口地址和支持的接口类型;Claude Code 只指向本机网关 127.0.0.1:3425,由网关转发给智谱,必要时在 OpenAI 与 Anthropic 协议之间互译。想知道 Magpie 对智谱实际走通了哪些接口,运行 magpie provider test zhipu。
先确认你的 key 是哪一类
智谱文档写明:个人套餐、团队套餐和「模型标准 API」的 API Key 已分开管理,三种产品的 key 互不通用。动手之前先弄清你手里的是哪一种:
- 标准 API 的 key:直接按下面四步走,用内置的
zhipu预设。 - 编程套餐(个人 / 团队)的 key:也先照四步试。如果
magpie provider test zhipu不通,先排除 key 粘贴错误;确认没问题后,很可能是 key 类型和预设的接口地址不匹配。这时可以按配置指南(英文)里 Custom and relay providers 一节,新建一个自定义供应商,用anthropic=指向智谱文档给 Claude Code 的地址:
magpie provider add "Zhipu Plan" anthropic=https://open.bigmodel.cn/api/anthropic key=你的套餐key models=智谱文档里的模型名
magpie providers # 查看新供应商的 id,之后用 magpie claude 供应商id/模型名 切换
自定义供应商的写法取自配置指南;models= 填你的套餐可用的模型名,以智谱文档为准。这是按文档推导的做法,请以 magpie provider test 的实际结果为准。
四步操作
-
添加智谱供应商
magpie provider add zhipu 你的keyGLM 在 Magpie 里是内置预设,供应商 id 叫
zhipu,只需要提供 key。添加之后验证一下:magpie providers # 已添加的供应商、key、可用模型、谁在用 magpie provider test zhipu # 每种 API 各发一次小请求,并报告延迟key 必须在 Magpie 里添加。Magpie 不会读取 shell 里 export 的ANTHROPIC_API_KEY、OPENAI_API_KEY等环境变量——这是刻意的设计。 -
确认有哪些 GLM 模型
magpie provider models zhipu # 重新向厂商拉取模型列表 magpie models # 所有 Agent 能选到的模型目录下面用官网示例里的
glm-5.3。智谱文档的不同页面可能写着不同的版本号,以你这里列出的、账户实际可用的为准。 -
把 Claude Code 指向 GLM
magpie claude zhipu/glm-5.3模型统一写成
供应商/模型。Magpie 只改写 Claude Code 配置里需要改的那几个字段,其余内容原样保留,详见下面的「它到底改了什么」。 -
确认并开始用
magpie ls # 每个 Agent 以及它当前用的模型看到 Claude Code 用的是 GLM 之后,新开一个 Claude Code 会话,它就跑在 GLM 上了——官方的说法是「下一个会话使用它」。
它到底改了什么
这几步涉及的文件主要是两个:
| 文件 | 内容 |
|---|---|
~/.config/magpie/providers.json | Magpie 自己的状态:你添加的供应商、key、每个供应商暴露哪些模型。第 1 步写入这里。 |
~/.claude/settings.json | Claude Code 的配置。第 3 步只改 Magpie 文档列出的字段:provider、model,以及 opus / sonnet / haiku / fable 这几个模型别名。注释、键顺序和缩进原样保留,写入是原子操作。 |
Windows 上 Claude Code 的配置在用户目录下的 .claude\settings.json。
Claude Code 的配置里不会出现 智谱 的 key,也不会出现 智谱 的接口地址:它只保存要用的模型和本机网关地址 http://127.0.0.1:3425/v1,真正的 key 在 Magpie 手里,请求由网关转发。
关于「模型别名」
Claude Code 用 opus、sonnet、haiku 这几个别名来选不同档位的模型。Magpie 官网的说法是:Kimi、GLM 或 GPT 可以放在这三个别名后面。具体每个别名被写成了什么,以你机器上的文件为准——切换前后各对比一次最直观:
macOS / Linux
cp ~/.claude/settings.json ~/claude-settings.before.json # 切换前先备份
magpie claude zhipu/glm-5.3
diff ~/claude-settings.before.json ~/.claude/settings.json # 看 Magpie 实际改了哪几行
Windows(命令提示符)
copy %USERPROFILE%\.claude\settings.json %USERPROFILE%\claude-settings.before.json
magpie claude zhipu/glm-5.3
fc %USERPROFILE%\claude-settings.before.json %USERPROFILE%\.claude\settings.json
对比输出里如果出现 token 或 key,贴到论坛或群里之前先打码。
~/.claude/settings.json 的 env(ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN 等),切换前先备份,切换后用上面的对比确认文件里没有残留的旧地址或旧 key。Magpie 只改它负责的字段,你手动加的其他键需要自己确认。回滚:怎么退回原来的模型
切换只是改配置,随时能退回。三种办法,从省事到保险:
办法一:在应用里选回原生模型
在 Magpie 的菜单栏应用里,点 Claude Code 当前显示的模型,选回它原生的模型。官网的说法是:选回原生模型,Magpie 会把文件恢复成切换之前的样子。
办法二:先存一个 Profile,用命令一次性恢复
magpie save before-glm # 切换之前执行:把所有 Agent 当前的设置存成一个方案
# …… 用了一阵之后想退回:
magpie use before-glm # 一次性把所有 Agent 恢复成当时的样子
Profile 保存的是执行 save 那一刻所有 Agent 的设置,所以一定要在切换之前存;每次实验换一个名字,别把最初的快照覆盖掉。
办法三:手动恢复备份
按上一节的方法,切换前把 settings.json 备份一份;要退回时把备份拷回原位就行。
想彻底删掉 智谱 这个供应商:先用上面任一办法退回,再执行 magpie provider rm zhipu。
常见问题
为什么命令里是 zhipu,而不是 glm?
GLM 由智谱(Zhipu)提供,Magpie 里这家供应商的 id 是 zhipu:添加 key 用 magpie provider add zhipu 你的key,模型写成 zhipu/glm-5.3。不确定 id 时运行 magpie presets 查看所有预设。
智谱的 Anthropic 格式接口地址是什么?要自己填吗?
智谱官方文档给 Claude Code 的地址是 https://open.bigmodel.cn/api/anthropic。用 zhipu 预设时不用自己填,预设里记着智谱的接口地址;只有走自定义供应商时,才需要用 anthropic= 指过去。
编程套餐的 key 能用吗?
智谱文档说明三类 key 互不通用。先用 zhipu 预设跑一次 magpie provider test zhipu;不通的话,按上文改用自定义供应商,把 anthropic= 指向智谱文档给的地址。
切换之后 Claude Code 还是原来的模型怎么办?
先确认 magpie ls 里 Claude Code 对应的已经是 GLM。官方说明切换后由「下一个会话」使用新配置,所以退出当前会话、新开一个再试。如果 magpie ls 里根本没有 Claude Code,说明 Magpie 还没发现它:先启动一次 Claude Code 让它写出配置文件,再重新打开 Magpie。
我之前手动配过智谱的 env,会冲突吗?
Magpie 只改它负责的字段,不会替你判断手动加的其他键该不该留。切换前先备份,切换后用上文的对比确认文件里没有残留的旧地址或旧 key,需要的话手动删掉。
提示找不到 glm-5.3 怎么办?
运行 magpie provider models zhipu,改用列表里实际存在的模型名。官网示例用的是 glm-5.3;智谱文档的不同页面可能写着不同的版本号,以你的账户实际可用的为准。
下一步
magpie provider models 的输出和各厂商官网为准。