AIREITER

如何在 Claude Code 中使用 GLM-5.2（完整配置指南）

最后更新: 2026-07-29 11:06:07

想在 Claude Code 里用上 GLM-5.2，其实大约两分钟就能搞定。Claude Code 可以连接任何兼容 Anthropic Messages API 的服务端，而智谱为 GLM 提供的正是这种接口：把地址指向 z.ai 即可。你可以选一键切换工具，配置最省事，也能随时切回 Claude；也可以直接手动修改配置文件。本文会分别介绍两种方案，覆盖 macOS、Windows 和 Linux，并说明如何切回 Claude。

最快上手：用 CC Switch 一键配置

如果你本来就在多个服务商之间切换，不必手改配置，直接用 CC Switch 更方便。它是开源、MIT 许可的 Windows/macOS/Linux 桌面应用，可统一管理 Claude Code、Codex、Gemini CLI 等命令行工具的服务商配置，省去手动编辑 JSON 的麻烦。

  1. 从 ccswitch.io 或其 GitHub repo 安装 CC Switch。在主窗口右上角点击橙色的 + 按钮，打开 Add Provider，然后选择 Claude Provider 标签页。
  2. 在预设搜索框中输入 zhipu。会出现两个预设：Zhipu GLM（中国大陆端点）和 Zhipu GLM en。如果不在中国大陆，请选择国际端点 Zhipu GLM en。
CC Switch Add New Provider screen with "zhipu" typed in the preset search box, showing the Zhipu GLM and Zhipu GLM en presets under the Claude Provider tab
  1. 向下滚动，将你的 z.ai API 密钥粘贴到 API Key 字段。预设会自动填好其他内容，包括 Anthropic Messages (Native) 格式、ANTHROPIC_AUTH_TOKEN 鉴权字段和基础 URL。
  2. 在 Model Mapping 中，把 Sonnet、Opus、Fable 和 Haiku 各角色请求的模型都设为 glm-5.2。这样无论 Claude Code 调用哪个层级，都会路由到 GLM。若要向 Claude Code 声明某个角色支持百万 token 上下文，可勾选该角色的 1M 选项。保存即可。
CC Switch Edit Provider model-mapping table with Sonnet, Opus, Fable, and Haiku roles all set to glm-5.2, using Anthropic Messages Native format and ANTHROPIC_AUTH_TOKEN
  1. 返回服务商列表，在 Zhipu GLM 条目上点击 Enable。已有的服务商，例如 Claude Official，可以继续保留在列表中，方便之后切回。随后重启 Claude Code，确保它加载新服务商。执行 /status，确认模型显示为 glm-5.2。
CC Switch provider list showing Zhipu GLM with its Enable button, alongside a Claude Official provider to switch back to

相比静态配置，使用这个应用的价值在于：它内置了大多数值得尝试的服务商预设，例如 Kimi、MiniMax、MiMo、Qwen、DeepSeek 等。以后试用新服务商只需选择预设并填入密钥，不必反复改配置；在它们之间切换，或切回 Claude，也只要点几下。这正是下文混合使用工作流的基础。

手动修改 settings.json 配置

如果你希望完全自己配置，或者要在没有图形界面的 CI 机器上部署，可以直接编辑配置文件。

  1. 获取 API 密钥：前往 Z.AI API console。按量付费密钥和 GLM Coding Plan 订阅密钥都可以使用。
  2. 将下面的 env 块合并进 Claude Code 配置文件。请保留已有字段，不要直接覆盖整个文件。各平台的配置内容完全相同，区别只在文件路径：

- macOS / Linux： ~/.claude/settings.json - Windows： %USERPROFILE%\.claude\settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.z.ai/api/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "your_zai_api_key",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5.2",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-5.2",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-5.2",
    "API_TIMEOUT_MS": "3000000"
  }
}
  1. 重启 Claude Code，然后执行 /status。模型行应显示 glm-5.2；如果使用百万 token 版本，则显示 glm-5.2[1m]。若仍显示 Claude 模型，说明配置文件没有被读取，请检查 JSON 语法和文件路径。

如果不想碰配置文件，也可以使用以下两种基于 Shell 的替代方案：

  • macOS / Linux — 在 bash/zsh 中导出环境变量，供单次会话使用，然后启动：
export ANTHROPIC_BASE_URL="https://api.z.ai/api/anthropic"
export ANTHROPIC_AUTH_TOKEN="your_zai_api_key"
export ANTHROPIC_DEFAULT_OPUS_MODEL="glm-5.2"
export ANTHROPIC_DEFAULT_SONNET_MODEL="glm-5.2"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="glm-5.2"
claude

关闭终端后，配置就会恢复为原来的状态。

  • Windows — 在 PowerShell 中设置持久化的用户环境变量，然后重启终端：
setx ANTHROPIC_BASE_URL "https://api.z.ai/api/anthropic"
setx ANTHROPIC_AUTH_TOKEN "your_zai_api_key"
setx ANTHROPIC_DEFAULT_OPUS_MODEL "glm-5.2"
setx ANTHROPIC_DEFAULT_SONNET_MODEL "glm-5.2"
setx ANTHROPIC_DEFAULT_HAIKU_MODEL "glm-5.2"

ANTHROPIC_DEFAULT_* 变量用于重映射 Claude Code 的模型角色，包括 Opus、Sonnet 和 Haiku；新版还加入了 Fable 角色，CC Switch 同样提供了这一选项。将它们全部设为 glm-5.2，所有请求都会发往 GLM；如果你更希望后台任务兼顾低成本和速度，可以将 Haiku 角色改为 glm-4.5-air。需要完整百万 token 上下文时，使用 glm-5.2[1m]。别忽略较长的 API_TIMEOUT_MS：GLM 的响应通常比 Claude 更慢，默认超时时间可能会中断较长的生成过程。

选哪种接入方式：z.ai 原生接口、代理还是 Coding Plan？

将 GLM-5.2 接入 Claude Code，实际有三种路线，但它们不能简单互换。

z.ai 原生端点（推荐）。即上文的 https://api.z.ai/api/anthropic。它直接兼容 Anthropic 协议，Claude Code 无需中间层即可连接，因此是默认首选。

协议转换代理。另一些托管方，例如 Fireworks、NVIDIA NIM 或自托管权重，可能通过 OpenAI 兼容 API 提供 GLM-5.2；Claude Code 无法直接读取这类接口，需要代理转换协议。claude-code-router 可以处理这件事。只有当你已经在这些平台拥有余额或硬件时，这条路线才值得考虑。

GLM Coding Plan 订阅。这是固定月费方案，根据 z.ai's subscribe page，价格从 $18/month 起。它使用同一个 z.ai 端点，但按固定费用计费，而不是按 token 计费。如果你每天都在 Claude Code 中编码，订阅通常比按量付费更便宜、成本也更可预测；可根据自己的月度 token 消耗计算盈亏平衡点。使用量波动较大时，按量付费更合适。

在 GLM-5.2 与 Claude 之间切换

Claude Code 同一时间只能启用一个服务商，因此你需要的是切换，而非为不同任务拆分模型槽位：日常的大量任务交给 GLM-5.2；遇到架构设计、安全敏感代码或代码审查时，再通过 CC Switch 启用 Claude Official 服务商。Claude 一侧可以使用任何兼容 Anthropic 的端点，例如你的 Anthropic 账号，或 AIReiter 这类中继服务，它只是多个选择之一。若想按每次请求自动在不同服务商之间路由，可使用 claude-code-router 这类网关分发请求。

常见问题排查

现象可能原因解决方法
/status 仍显示 Claude 模型未加载 settings.json检查 JSON 是否有效；确认编辑的是 ~/.claude/settings.json；重启 Claude Code
出现 model not found 错误模型 ID 错误，且区分大小写请严格使用 glm-5.2、glm-5.2[1m] 或 glm-4.5-air
401 / authentication failed密钥与端点不匹配不要将 OpenRouter 密钥配合 z.ai URL 使用；必要时重新生成密钥
长输出被中断超时时间过短将 API_TIMEOUT_MS 设为较高数值，例如 3000000
工具调用失败或陷入循环工具 JSON 格式不正确减少并行子代理数量；重试；简化指令

常见问答

在 Claude Code 中使用 GLM-5.2 免费吗？

并非无限免费，不过 z.ai 曾为 GLM-5.2 提供限时免费窗口，Coding Plan 则从 $18/month 起。即使按完整按量费率计算，也就是每百万 token $1.40 / $4.40，轻度使用只需几美分。

GLM-5.2 在 Claude Code 中支持 1M token 上下文吗？

支持。将 ANTHROPIC_DEFAULT_* 变量中的模型 ID 从 glm-5.2 改为 glm-5.2[1m]，Claude Code 就会使用百万 token 上下文窗口。

在 Claude Code 里编程，GLM-5.2 还是 Claude 更好？

对于常规、连续的代码修改，GLM-5.2 的价格优势使它成为更理性的默认选择。面对多步骤架构设计、安全敏感任务和高并发子代理工作流，Claude 往往更有优势。配置好切换后，不必二选一，可以让各自处理最擅长的任务。

除了 Claude Code，还能在其他工具中使用 GLM-5.2 吗？

可以。同一套 z.ai 端点和密钥也适用于其他智能体 CLI 工具：OpenCode、Cline 和 Kilo Code 都支持自定义基础 URL，CC Switch 也为其中多个工具提供了预设管理。

要在 Claude Code 中使用 GLM-5.2，是否必须订阅付费 Claude？

不需要。Claude Code 只是客户端；将其指向 z.ai 后，费用由 z.ai 计费，而非 Anthropic。只有在保留 Claude 作为可切换服务商时，才需要 Claude 账号。

在 CC Switch 中切换服务商后，需要重启 Claude Code 吗？

根据 CC Switch 文档，Claude Code 支持无需重启即可热切换服务商数据，而大多数其他 CLI 工具仍需重启终端或应用。实际使用中，重启 Claude Code 是确认切换生效的可靠方式。

如何在 CC Switch 中切回 Claude（官方登录）？

在预设列表中添加 Claude Official 服务商并启用，然后按 Claude Code 的正常流程完成一次登出 / 登录（OAuth）。之后便可在官方 Claude 登录和 z.ai 等第三方服务商之间自由切换。

CC Switch 免费且安全吗？

是的。它采用 MIT 许可证开源且免费。你的配置存储在本地 SQLite 数据库中，并使用原子写入；其设计原则是尽量少修改各工具自身的配置，因此即便卸载应用，各 CLI 工具仍能正常工作。

延伸阅读