接入 Claude Code
将智谱最新 GLM-4.7 系列模型集成到 Claude Code 的方法
智谱模型 GLM-4.7 可以通过一个兼容 Anthropic API 的端点与 Claude Code 集成。这意味着可以让 Claude Code 与 GLM-4.7 通信,而不需要修改 Claude Code 的任何代码。
Claude Code 玩转新体验:20 元起解锁 GLM Coding 包月,3倍用量,1/7价格,独家升级支持联网搜索&多模态理解,响应更快,调用更稳。限时羊毛价,立即订阅!套餐专属 视觉理解 MCP Server 、 网络搜索 MCP Server 、 网页读取 MCP Server 让您的 Code Agent 拥有搜索与视觉。
在 2025-12-22 日期前已使用的用户请注意:
GLM Coding Plan 的默认模型已升级至 GLM-4.7,使用最新配置方式的用户无感知升级。
但若您之前在 settings.json 中配置过 GLM-4.5 的固定模型映射,请参考下方「常见问题」章节中的「如何切换使用模型」进行调整,以确保使用最新的 GLM-4.7 模型。
步骤一:安装 Claude Code
-
推荐安装方式
-
Cursor 引导安装方式
前提条件:
- 您需要安装 Node.js 18 或更新版本环境
- Windows 用户还需安装 Git for Windows
进入命令行界面,安装 Claude Code
npm install -g @anthropic-ai/claude-code
运行如下命令,查看安装结果,若显示版本号则表示安装成功
claude --version
注意 :如果您在安装过程中遇到权限问题,请尝试使用 sudo(MacOS/Linux)或以管理员身份运行命令提示符(Windows)重新执行安装命令。
安装成功后,还需后续步骤,若您直接使用 claude 命令启动,可能由于网络或地区限制无法使用。
步骤二:配置 GLM Coding Plan
1
注册账号
访问 智谱开放平台,点击右上角的「注册/登录」按钮,按照提示完成账号注册流程。
2
获取API Key
登录后,在个人中心页面,点击 API Keys,创建一个新的 API Key。
请妥善保管您的 API Key,不要泄露给他人,也不要直接硬编码在代码中。
3
配置环境变量
通过在 MacOS、Linux 或 Windows 中使用以下一种方式设置环境变量:
注意 :设置环境变量时,有些命令不会返回任何输出。这是正常的,只要没有报错即代表成功。
注意:选择以下适合您操作系统的一种方式进行配置即可。
-
方式一:自动化脚本(支持 MacOS Linux)
-
方式二:手动配置(支持 Windows MacOS Linux)
在终端或 IDE 中运行以下命令即可
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
}
}
配置成功后,请确保重新打开一个新的终端窗口,以便环境配置生效。
步骤三:开始使用 Claude Code配置完成后,进入一个您的代码工作目录,在终端中执行 claude 命令即可开始使用 Claude Code
若遇到「Do you want to use this API key」选择 Yes 即可
启动后选择信任 Claude Code 访问文件夹里的文件,如下:

完毕!现在就可以正常使用 Claude Code 进行开发了。
对话/规划/代码编写/复杂推理等主场景时默认使用模型均为 GLM-4.7,Claude code 会在部分轻量任务时自动路由到 GLM-4.5-Air,这也是我们推荐的使用方式,兼顾性能、速度与价格,暂不支持其它模型(如 GLM-4.5-X/AirX/Flash 等)。
以下为简单示例:Case 1:根据提示信息创建网页


Case 2:生成一个打地鼠游戏



Case 3:生成一个日蚀动效Prompt:帮我生成日蚀过程的动态特效,尽量采用苹果手机的风格


常见问题
如何切换使用模型Claude Code 内部模型环境变量与 GLM 模型对应关系,默认配置如下:
ANTHROPIC_DEFAULT_OPUS_MODEL:GLM-4.7ANTHROPIC_DEFAULT_SONNET_MODEL:GLM-4.7ANTHROPIC_DEFAULT_HAIKU_MODEL:GLM-4.5-Air
如有调整诉求,可直接通过调整配置文件的方式(位于 ~/.claude/settings.json)来调整到其他模型
一般不建议您手动调整模型映射,因为硬编码模型映射后,当 GLM Coding Plan 的模型更新升级时,不方便您自动更新到最新模型。
若您想使用最新默认映射(针对老用户已配置旧模型映射的情况),删除 settings.json 中的模型映射配置即可,Claude Code 会自动使用最新的默认模型。
-
手动修改配置文件
~/.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"
}
} -
启动一个新的命令行窗口,运行
claude启动 Claude Code,在 Claude Code 中输入/status确认模型状态:

视觉和搜索 MCP 服务器参考 视觉MCP服务器 和 搜索MCP服务器 文档,配置完成后即可在 Claude Code 中使用。
手工修改配置不生效若您手动修改了 ~/.claude/settings.json 配置文件,但发现配置没有生效,参考如下排查。
- 关闭所有 Claude Code 窗口,重新打开一个新的命令行窗口,再次运行
claude启动。 - 如果问题仍然存在,您可以尝试删除
~/.claude/settings.json文件,然后重新配置环境变量,Claude Code 会自动生成一个新的配置文件。 - 确认配置文件的 JSON 格式是否正确,检查变量名称和不能少逗号或多逗号,可以使用在线 JSON 校验工具进行检查。
推荐的 Claude Code 版本建议使用最新版本的 Claude Code,您可以通过以下命令检查当前版本和升级:
我们在 Claude Code 2.0.14 等版本验证 OK。
# 检查当前版本
claude --version
2.0.14 (Claude Code)
# 升级到最新版本
claude update