智谱国际版(国内可直连) GLM-5.1 接入 Claude Code 指南

Claude Code

在 Claude Code 中使用 GLM Coding Plan 的方法

Claude Code 是一款运行在终端中的代理式编程工具，它能够理解你的代码库，并通过自然语言命令帮助你更高效地编码：执行日常任务、解释复杂代码，以及处理 Git 工作流。

提示

搭配 GLM Coding Plan 使用时，Claude Code 会更强大------以更低的成本获得 3 倍使用量。借助更多 token 和稳定可靠的服务，更快编写代码、更聪明地调试，并无缝管理工作流。
提示

成功配置订阅后，系统会默认应用服务器端模型映射：你在界面中看到的是 Claude 模型，但实际使用的是 GLM 模型。

你也可以手动调整模型映射（不推荐），详情见 FAQ 中的"如何切换正在使用的模型"部分。

第 1 步：安装 Claude Code

推荐安装方式

前置条件：

• Node.js 18 或更高版本

• 对于 macOS，请使用 nvm 安装 Node.js；如果直接安装软件包，可能会遇到权限问题

• 对于 Windows，请额外安装 Git for Windows

  # 安装 Claude Code
  npm install -g @anthropic-ai/claude-code
  
  # 进入你的项目目录
  cd your-awesome-project
  
  # 完成
  claude

Cursor 引导安装方式

如果你不熟悉 npm，但安装了 Cursor，可以在 Cursor 中输入下面的命令，Cursor 会引导你完成 Claude Code 的安装。

https://docs.anthropic.com/en/docs/claude-code/overview Help me install Claude Code

注意 ：如果 macOS 用户在安装过程中遇到权限问题，请使用 nvm 安装 Node.js。

第 2 步：配置 GLM Coding Plan

步骤 1：获取 API Key

• 访问 Z.AI Open Platform，注册或登录。
• 在 API Keys 管理页面创建一个 API Key。
• 复制你的 API Key 备用。

步骤 2：配置环境变量

在 macOS / Linux 或 Windows 中，使用以下任一方法设置环境变量：

提示
注意：某些设置环境变量的命令执行时不会显示任何输出------只要没有报错，这就是正常现象。

自动化 Coding Tool Helper

Coding Tool Helper 是一个编码工具辅助程序，可将 GLM Coding Plan 快速加载到你喜欢的编码工具中。安装并运行后，按照屏幕提示即可自动安装工具、配置方案并管理 MCP 服务器。

# 在终端中直接运行 Coding Tool Helper
npx @z_ai/coding-helper

更多详情请参阅 Coding Tool Helper 文档。

自动化脚本

只需在终端中运行以下命令。

注意：仅支持 macOS / Linux 环境，此方法不支持 Windows。

curl -O "https://cdn.bigmodel.cn/install/claude_code_zai_env.sh" && bash ./claude_code_zai_env.sh

该脚本会自动修改 ~/.claude/settings.json，配置以下环境变量（你无需手动编辑）：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your_zai_api_key",
    "ANTHROPIC_BASE_URL": "https://api.z.ai/api/anthropic",
    "API_TIMEOUT_MS": "3000000"
  }
}

手动配置

如果你之前已经为 Claude Code 配置过环境变量，也可以按如下方式手动配置。配置完成后，需要打开一个新窗口才能生效。

macOS & Linux

# 编辑 Claude Code 配置文件 `~/.claude/settings.json`
# 添加或修改 env 中的 ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN 字段
# 注意：将 `your_zai_api_key` 替换为你在上一步中获取到的 API Key

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your_zai_api_key",
    "ANTHROPIC_BASE_URL": "https://api.z.ai/api/anthropic",
    "API_TIMEOUT_MS": "3000000"
  }
}

Windows Cmd

# 在 Cmd 中运行以下命令
# 注意：将 `your_zai_api_key` 替换为你在上一步中获取到的 API Key

setx ANTHROPIC_AUTH_TOKEN your_zai_api_key
setx ANTHROPIC_BASE_URL https://api.z.ai/api/anthropic

Windows PowerShell

# 在 PowerShell 中运行以下命令
# 注意：将 `your_zai_api_key` 替换为你在上一步中获取到的 API Key

[System.Environment]::SetEnvironmentVariable('ANTHROPIC_AUTH_TOKEN', 'your_zai_api_key', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://api.z.ai/api/anthropic', 'User')

第 3 步：开始使用 Claude Code

配置完成后，你就可以在终端或 cmd 中开始使用 Claude Code：

cd your-project-directory
claude

如果出现 "Do you want to use this API key" 提示，请选择 "Yes"。

启动后，请按下图所示授予 Claude Code 访问你文件夹中文件的权限：

现在你就可以使用 Claude Code 进行开发了！

---

常见问题

如何切换正在使用的模型

检查项

Claude Code 内部模型环境变量与 GLM 模型之间的映射关系，默认配置如下：

• ANTHROPIC_DEFAULT_OPUS_MODEL: GLM-4.7
• ANTHROPIC_DEFAULT_SONNET_MODEL: GLM-4.7
• ANTHROPIC_DEFAULT_HAIKU_MODEL: GLM-4.5-Air
  注意

注意：Max 用户如果要使用 GLM-5.1，需要在自定义配置中（例如 Claude Code 的 ~/.claude/settings.json）手动将模型改为 "glm-5.1"。

如果需要调整，你可以直接修改配置文件（例如 Claude Code 中的 ~/.claude/settings.json）来切换到其他模型。

注意

通常不建议手动调整模型映射，因为将模型映射写死后，在 GLM Coding Plan 模型更新时，不便于自动切换到最新模型。
注意

如果你想使用最新的默认映射（适用于已经配置过旧模型映射的用户），只需删除 settings.json 中的模型映射配置，Claude Code 会自动使用最新默认模型。

1. 在 ~/.claude/settings.json 中配置以下内容：

{
  "env": {
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.5-air",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-4.7",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-4.7"
  }
}

注意

注意：Max 用户如果要使用 GLM-5.1，需要在自定义配置中（例如 Claude Code 的 ~/.claude/settings.json）手动将模型改为 "glm-5.1"。

2. 打开一个新的终端窗口并运行 claude 启动 Claude Code，输入 /status 查看当前模型状态。

Vision / Search / Reader MCP

请参阅 Vision MCP Server、Search MCP Server 和 Web Reader MCP Server 文档；完成配置后，你就可以在 Claude Code 中使用它们。

手动配置不生效

如果你手动修改了 ~/.claude/settings.json 配置文件，但发现更改没有生效，请参考以下排查步骤：

• 关闭所有 Claude Code 窗口，打开一个新的命令行窗口，然后再次运行 claude 启动。
• 如果问题仍然存在，尝试删除 ~/.claude/settings.json 文件，然后重新配置环境变量；Claude Code 会自动生成一个新的配置文件。
• 确认配置文件的 JSON 格式正确，检查变量名，并确保没有缺少或多余的逗号；你可以使用在线 JSON 校验工具进行检查。

推荐的 Claude Code 版本

我们建议使用最新版本的 Claude Code。你可以通过以下命令查看当前版本并进行升级：

我们已经验证 Claude Code 2.0.14 及其他版本的兼容性。

# 查看当前版本
claude --version

2.0.14 (Claude Code)

# 升级到最新版本
claude update