GLM-4.7 + Claude Code 完整配置教程（含 MCP 功能）

本教程严格依据智谱官方文档整理，涵盖 Claude Code 安装、GLM-4.7 模型配置、联网搜索 MCP、网页读取 MCP、视觉理解 MCP 的完整配置流程，适用于 Windows / macOS / Linux 用户。

---

一、前提条件

1. 系统环境

   • 安装 Node.js ≥ v18.0.0（官网下载）
   • Windows 用户额外安装 Git for Windows

2. 账号与权限

   • 注册 智谱开放平台 账号cdcd
   • 订阅 GLM Coding Plan（Lite / Pro / Max 套餐）
   • 在 API Key 管理页 创建 API Key，并妥善保管

⚠️ 注意：编码套餐的请求地址和不使用套餐的地址是不一样的
使用 GLM Coding Plan 时，必须通过 专属网关地址 https://open.bigmodel.cn/api/anthropic 或者https://open.bigmodel.cn/api/coding/paas/v4 发起请求。若使用普通 GLM API 地址（如 https://open.bigmodel.cn/api/paas/v4/chat/completions），将无法享受套餐计费优惠，且可能因认证方式不同导致调用失败。

---

二、安装 Claude Code

在终端执行：

npm install -g @anthropic-ai/claude-code

验证安装：

claude --version

若输出版本号（如 2.0.14），表示安装成功。

注意：若遇权限问题，请使用 sudo（macOS/Linux）或以管理员身份运行命令提示符（Windows）。

---

三、配置 GLM-4.7 模型

方法一：自动化脚本（仅限 macOS / Linux）

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

脚本自动写入 ~/.claude/settings.json，无需手动操作。

方法二：手动配置（全平台通用）

编辑或创建文件：
~/.claude/settings.json

填入以下内容（替换 your_zhipu_api_key 为实际 API Key）：

{
  "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
  }
}

重要：配置完成后，必须重新打开新终端窗口，使环境生效。

---

Windos可直接配置到环境变量中

四、模型版本说明

• 默认模型映射（由服务端自动管理）：

  • ANTHROPIC_DEFAULT_OPUS_MODEL → GLM-4.7
  • ANTHROPIC_DEFAULT_SONNET_MODEL → GLM-4.7
  • ANTHROPIC_DEFAULT_HAIKU_MODEL → GLM-4.5-Air

• 不建议手动固定模型，否则无法自动升级到未来新版本（如 GLM-4.7）。

• 如需恢复自动更新：删除 settings.json 中的模型相关 env 字段即可。

• 验证当前模型：启动 Claude Code 后输入 /status 查看。

---

五、配置 MCP 扩展功能

所有 MCP 功能需在已配置 GLM Coding Plan 的基础上启用。

（1）联网搜索 MCP（webSearchPrime）

配置方式（任选其一）

一键安装：

claude mcp add -s user -t http web-search-prime https://open.bigmodel.cn/api/mcp/web_search_prime/mcp --header "Authorization: Bearer your_api_key"

或手动配置（追加到 ~/.claude/settings.json 的顶层对象）：

{
  "mcpServers": {
    "web-search-prime": {
      "type": "http",
      "url": "https://open.bigmodel.cn/api/mcp/web_search_prime/mcp",
      "headers": {
        "Authorization": "Bearer your_api_key"
      }
    }
  }
}

使用示例

在 Claude Code 对话中直接说：

• “帮我搜索最新的 AI 技术发展”
• “查找 Python 异步编程的最佳实践”

---

（2）网页读取 MCP（webReader）

配置方式

一键安装：

claude mcp add -s user -t http web-reader https://open.bigmodel.cn/api/mcp/web_reader/mcp --header "Authorization: Bearer your_api_key"

或手动配置：

{
  "mcpServers": {
    "web-reader": {
      "type": "http",
      "url": "https://open.bigmodel.cn/api/mcp/web_reader/mcp",
      "headers": {
        "Authorization": "Bearer your_api_key"
      }
    }
  }
}

典型场景

• 自动解析 API 文档并生成摘要
• 提取 GitHub 项目 README 核心信息
• 构建团队技术知识库

---

（3）视觉理解 MCP（image_analysis / video_analysis）

此 MCP 为 本地服务，需 Node.js ≥ v18

配置方式

一键安装：

claude mcp add -s user zai-mcp-server --env Z_AI_API_KEY=your_api_key -- npx -y "@z_ai/mcp-server"

Windows 用户注意：若在 PowerShell 中报 -y 错误，请改用 CMD 执行。

或手动配置：

{
  "mcpServers": {
    "zai-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@z_ai/mcp-server"],
      "env": {
        "Z_AI_API_KEY": "your_api_key",
        "Z_AI_MODE": "ZHIPU"
      }
    }
  }
}

使用方法

1. 将图片（如 demo.png）放入当前工作目录

2. 在 Claude Code 中输入：

   What does demo.png describe?
   

   或

   hi describe this chart.jpg
   

禁止直接粘贴图片！否则客户端会绕过 MCP 直接调用模型，无法使用视觉理解能力。

---

六、MCP 使用额度说明

套餐	搜索 + 网页读取次数/月	视觉理解资源池
Lite	100 次	5 小时 prompt，超限后 5 小时恢复
Pro	1,000 次	同上
Max	4,000 次	同上

搜索 MCP 与网页读取 MCP 共享额度；视觉理解 MCP 独立计费。

---

七、故障排查

1. 配置不生效

• 关闭所有 Claude Code 进程
• 新建终端窗口再启动
• 检查 settings.json 是否为合法 JSON（可用 JSONLint 验证）
• 如仍无效，删除 ~/.claude/settings.json 后重配

2. API Key 无效

• 确认密钥复制完整（无多余空格）
• 确认密钥已在平台激活
• 确认账户有足够余额

3. MCP 连接失败

• 检查网络与防火墙

• 验证 URL 是否正确（见各 MCP 文档）

• 视觉 MCP 可本地测试：

  Z_AI_API_KEY=your_api_key npx -y @z_ai/mcp-server
  

4. 卸载旧 MCP（重装前必做）

claude mcp list
claude mcp remove <server-name>

---

八、推荐版本与升级

• 已验证版本：Claude Code 2.0.14

• 查看版本：

  claude --version
  

• 升级到最新版：

  claude update
  

---

九、开始使用

进入项目目录，运行：

claude

首次启动时：

• 确认使用 API Key（选 Yes）
• 授权访问当前文件夹

即可开始使用 GLM-4.7 + MCP 全功能 的智能编码体验！

---

本教程内容完全基于以下官方文档：

• https://docs.bigmodel.cn/cn/coding-plan/tool/claude
• https://docs.bigmodel.cn/cn/coding-plan/mcp/vision-mcp-server
• https://docs.bigmodel.cn/cn/coding-plan/mcp/search-mcp-server
• https://docs.bigmodel.cn/cn/coding-plan/mcp/reader-mcp-server

项目地址

Claude Code: https://github.com/anthropics/claude-code