logo

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

最后更新: 2026-07-15 09:29:50

你今天就可以在 Claude Code 中运行 GLM-5.2，设置大约只需两分钟。Claude Code 可以与任何支持 Anthropic Messages API 的端点通信，而智谱为 GLM 提供的正是这一能力——只需把 Claude Code 指向 z.ai，就完成了。进入方式有两种：一个一键切换器应用（最简单，而且它允许你随时切回 Claude），或者手动编辑配置文件。本指南将涵盖这两种方法，适用于 macOS、Windows 和 Linux，并说明在需要时如何切回 Claude。

最快的方法：CC Switch

如果你已经在同时使用多个提供商，那就跳过手动配置，改用 CC Switch（开源，MIT 许可，支持 Windows/macOS/Linux）。它是一款桌面应用，可管理 Claude Code、Codex、Gemini CLI 以及其他一些 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

3. 向下滚动，并将你的 z.ai API key 粘贴到 API Key 字段中。预设会自动填充其余部分：Anthropic Messages (Native) 格式、ANTHROPIC_AUTH_TOKEN 身份验证字段，以及 base URL。

4. 在 Model Mapping 中，将每个角色所请求的模型——Sonnet、Opus、Fable 和 Haiku——都设置为 glm-5.2，这样无论 Claude Code 调用的是哪个层级，每个请求都会路由到 GLM。勾选某个角色上的 1M 复选框，向 Claude Code 声明百万 token 上下文。保存。

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

5. 返回提供商列表，在 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 进行手动设置

更喜欢自己配置，还是使用没有 GUI 的 CI 机器进行设置？直接编辑该文件。

1. 从Z.AI API 控制台获取 API key。按需付费 key 或 GLM Coding Plan 订阅 key 都可以。2. 将此 env 块合并到你的 Claude Code 设置文件中（保留任何已有的 key — 不要覆盖整个文件）。该块在所有平台上都相同；不同的只是路径：- 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"
  }
}

3. 重启 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。使用 glm-5.2[1m] 可获得完整的一百万 token 窗口。较长的 API_TIMEOUT_MS 比看起来更重要：GLM 的响应通常比 Claude 的更慢，而默认超时会截断较长的生成。

选择哪条路线：z.ai 原生、代理，还是 Coding Plan？

将 GLM-5.2 接入 Claude Code 的三种实用方式，而且它们并不可以互换。

z.ai 原生端点（推荐）。 上面的 https://api.z.ai/api/anthropic URL。它支持 Anthropic 协议，因此 Claude Code 无需中间件即可连接——这是默认选择。

一个翻译代理。 其他主机（Fireworks、NVIDIA NIM、自托管权重）通过 OpenAI-compatible API 提供 GLM-5.2，而 Claude Code 无法直接读取，因此它们需要一个用于转换格式的代理。claude-code-router 可以处理这个问题。只有当你已经在这些平台中的某一个上拥有 credits 或硬件时才值得这样做。

GLM 编码计划订阅。 一项固定月费计划（每月起价 $18，见 z.ai 的订阅页面），使用相同的 z.ai endpoint，但按固定费用计费，而不是按 token 计费。如果你每天都在 Claude Code 中编程，订阅通常比按 token 计费更便宜，也更可预测；请根据你每月的 token 支出算一算，找到盈亏平衡点。如果你的使用量波动较大，按需付费更划算。

在 GLM-5.2 和 Claude 之间切换

Claude Code 一次只使用一个活动提供商，因此你需要进行*切换*，而不是拆分配额：日常大量任务运行 GLM-5.2；当你需要 Claude 处理架构、安全敏感代码或审查时，在 CC Switch 中启用你的 Claude Official provider。Claude 侧任何兼容 Anthropic 的 endpoint 都可以使用——你的 Anthropic account，或者像 AIReiter 这样的 relay，它只是几个选项之一。若要在不同 provider 之间按请求自动路由，可使用像 claude-code-router 这样的 gateway 来处理分发。

故障排除

症状

可能原因

修复方法

/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 / 认证失败

密钥/端点不匹配

不要将 OpenRouter 密钥与 z.ai URL 配对；如有需要请重新生成密钥

长输出被截断

超时时间太低

将 API_TIMEOUT_MS 设得更高（例如 3000000）

工具调用失败或循环

工具 JSON 格式错误

减少并行子代理；重试；简化指令

常见问题

Claude Code 中的 GLM-5.2 是免费的吗？

不过并非无限开放，z.ai 曾在 GLM-5.2 上推出限时免费窗口，而 Coding Plan 起价为每月 $18。即使按完整的按用量计费费率（每百万 $1.40 / $4.40），轻度使用的费用也只是几美分。

GLM-5.2 是否支持 Claude Code 中的 1M token 上下文？

是。将你的 ANTHROPIC_DEFAULT_* 变量中的模型 ID 设置为 glm-5.2[1m]，而不是 glm-5.2，Claude Code 就会使用百万 token 窗口。

在 Claude Code 中，GLM-5.2 和 Claude 哪个更适合编程？

对于常规的顺序编辑，价格差异使 GLM-5.2 成为理性的默认选择。Claude 往往在多步骤架构设计、安全敏感工作以及高并发子代理工作流中更具优势。切换设置让你可以在各自最擅长的场景中使用它们，而不是只选一个。

我可以在 Claude Code 之外的其他工具中使用 GLM-5.2 吗？

是的。相同的 z.ai 端点和密钥也可用于其他 agentic CLI——OpenCode、Cline 和 Kilo Code 都支持自定义 base URL，而 CC Switch 可管理其中多个工具的预设。

我需要付费的 Claude 订阅才能在 Claude Code 中使用 GLM-5.2 吗？

不会。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 也能正常继续工作。

相关阅读