配置 GLM

GLM（智谱 AI）是国内领先的大语言模型之一，中文理解能力出色，支持多种应用场景。

参考文档：https://docs.bigmodel.cn/cn/coding-plan/tool/claude

注册与获取 API

步骤 1：注册智谱 AI 账户

访问 https://bigmodel.cn/
点击“注册”并完成手机号验证
完成实名认证（可获得更多免费额度）

步骤 2：获取免费额度

注册后自动获得 100 万 tokens 免费额度
实名认证后额外获得 400 万 tokens（有效期一个月）
新用户总计可得 500 万 tokens 免费额度
GLM 提供编码套餐，可配合 Claude Code 使用

步骤 3：获取 API Key

登录智谱 AI 开放平台
点击“查看 API Key”或进入“API 管理”
点击“添加新的 Key”或“创建新 Key”
保存生成的 API Key

配置 Claude Code

配置 GLM 到 Claude Code 有三种方式。

方式一：自动化助手（推荐）

Coding Tool Helper 可以快速加载 GLM 编码套餐。

npx @z_ai/coding-helper

完成后会自动处理工具安装、套餐配置与 MCP 服务器管理。

方式二：自动化脚本（macOS/Linux）

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

脚本会修改 ~/.claude/settings.json，写入：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your_zhipu_api_key",
    "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
  }
}

注意：将 your_zhipu_api_key 替换为实际 API Key。

方式三：手动配置

macOS/Linux

编辑 ~/.claude/settings.json：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your_zhipu_api_key",
    "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
  }
}

Windows（Cmd）

setx ANTHROPIC_AUTH_TOKEN your_zhipu_api_key
setx ANTHROPIC_BASE_URL https://open.bigmodel.cn/api/anthropic
setx CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 1

Windows（PowerShell）

[System.Environment]::SetEnvironmentVariable('ANTHROPIC_AUTH_TOKEN', 'your_zhipu_api_key', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://open.bigmodel.cn/api/anthropic', 'User')
[System.Environment]::SetEnvironmentVariable('CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC', '1', 'User')

配置完成后关闭所有终端，再打开新终端生效。

测试连接

步骤 1：启动 Claude Code

claude

步骤 2：信任文件夹

首次启动选择 Yes。

步骤 3：发送测试消息

你好，请用一句话介绍一下你自己。

步骤 4：验证结果

回复应流畅自然
响应时间在几秒内
无错误提示

步骤 5：检查模型状态（可选）

/status

GLM 模型介绍

默认模型映射

Claude Opus → GLM-4.7
Claude Sonnet → GLM-4.7
Claude Haiku → GLM-4.5-Air

提示：界面显示 Claude 名称，但实际使用的是 GLM 模型。

GLM-4.7

特点：旗舰模型，综合能力最强
适用场景：复杂任务、深度代码生成

GLM-4.5-Air

特点：轻量级模型，响应速度快
适用场景：快速对话、简单任务

手动切换模型（高级）

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

不建议手动硬编码，避免模型升级后无法自动更新。

常见问题

Q：API Key 泄露了怎么办？ A：立即删除旧密钥并创建新密钥，更新配置。

Q：提示“认证失败”怎么办？ A：检查 API Key、Base URL、终端是否重启、JSON 格式是否正确。

Q：免费额度用完了怎么办？ A：可购买付费套餐或编码套餐。

Q：如何确认配置是否生效？ A：输入 /status 查看模型状态。

Q：配置后没有生效怎么办？ A：关闭所有 Claude Code 窗口，重新打开终端并再次运行 claude，必要时重建配置文件。

Q：GLM 的中文能力如何？ A：GLM 中文理解能力优秀，适合中文用户。

Q：一个 API Key 可以多项目使用吗？ A：可以，但建议按项目创建不同 Key。

Q：推荐使用哪个版本的 Claude Code？ A：建议使用最新版本，可用以下命令检查或升级：

# 检查当前版本
claude --version

# 升级到最新版本
claude update

Q：如何切换不同的 GLM 模型？ A：可编辑 ~/.claude/settings.json 的模型映射变量，但一般不建议手动调整。

Q：配置文件修改后不生效怎么办？ A：确认 JSON 格式正确并重启终端，必要时删除配置文件重新配置。

配置 GLM

On this page