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 是哪一类」,能少走弯路。

本页目录
  1. 开始之前
  2. 智谱的 Anthropic 格式接口是怎么回事
  3. 先确认你的 key 是哪一类
  4. 四步操作
  5. 它到底改了什么
  6. 回滚:怎么退回原来的模型
  7. 常见问题

开始之前

智谱的 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 互不通用。动手之前先弄清你手里的是哪一种:

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 的实际结果为准。

四步操作

  1. 添加智谱供应商

    magpie provider add zhipu 你的key

    GLM 在 Magpie 里是内置预设,供应商 id 叫 zhipu,只需要提供 key。添加之后验证一下:

    magpie providers              # 已添加的供应商、key、可用模型、谁在用
    magpie provider test zhipu    # 每种 API 各发一次小请求,并报告延迟
    key 必须在 Magpie 里添加。Magpie 不会读取 shell 里 export 的 ANTHROPIC_API_KEY、OPENAI_API_KEY 等环境变量——这是刻意的设计。
  2. 确认有哪些 GLM 模型

    magpie provider models zhipu   # 重新向厂商拉取模型列表
    magpie models                  # 所有 Agent 能选到的模型目录

    下面用官网示例里的 glm-5.3。智谱文档的不同页面可能写着不同的版本号,以你这里列出的、账户实际可用的为准。

  3. 把 Claude Code 指向 GLM

    magpie claude zhipu/glm-5.3

    模型统一写成 供应商/模型。Magpie 只改写 Claude Code 配置里需要改的那几个字段,其余内容原样保留,详见下面的「它到底改了什么」。

  4. 确认并开始用

    magpie ls   # 每个 Agent 以及它当前用的模型

    看到 Claude Code 用的是 GLM 之后,新开一个 Claude Code 会话,它就跑在 GLM 上了——官方的说法是「下一个会话使用它」。

它到底改了什么

这几步涉及的文件主要是两个:

文件内容
~/.config/magpie/providers.jsonMagpie 自己的状态:你添加的供应商、key、每个供应商暴露哪些模型。第 1 步写入这里。
~/.claude/settings.jsonClaude 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;智谱文档的不同页面可能写着不同的版本号,以你的账户实际可用的为准。

下一步

查看全部中文教程 →

usemagpie.co 是 Magpie 的非官方第三方中文指南,与项目作者 yetone 没有隶属关系。Magpie 是 MIT 协议的开源项目,官网是 usemagpie.ai,官方安装包发布在 GitHub Releases。本文的命令取自官网的命令行示例和本站的配置指南,模型名与价格类信息核对于 2026-10-27,之后版本可能变化——请以 magpie provider models 的输出和各厂商官网为准。