本教程严格依据智谱官方文档整理,涵盖 Claude Code 安装、GLM-4.7 模型配置、联网搜索 MCP、网页读取 MCP、视觉理解 MCP 的完整配置流程,适用于 Windows / macOS / Linux 用户。
- 系统环境
- 安装 Node.js ≥ v18.0.0(官网下载)
- Windows 用户额外安装 Git for Windows
- 账号与权限
- 注册 智谱开放平台 账号cdcd
- 订阅 GLM Coding Plan(Lite / Pro / Max 套餐)
- 在 API Key 管理页 创建 API Key,并妥善保管
⚠️ 注意:编码套餐的请求地址和不使用套餐的地址是不一样的
使用 GLM Coding Plan 时,必须通过 专属网关地址 或者 发起请求。若使用普通 GLM API 地址(如 ),将无法享受套餐计费优惠,且可能因认证方式不同导致调用失败。
在终端执行:
验证安装:
若输出版本号(如 ),表示安装成功。
注意:若遇权限问题,请使用 (macOS/Linux)或以管理员身份运行命令提示符(Windows)。
方法一:自动化脚本(仅限 macOS / Linux)
脚本自动写入 ,无需手动操作。
方法二:手动配置(全平台通用)
填入以下内容(替换 为实际 API Key):
重要:配置完成后,必须重新打开新终端窗口,使环境生效。
Windos可直接配置到环境变量中
- 默认模型映射(由服务端自动管理):
- →
- →
- →
- 不建议手动固定模型,否则无法自动升级到未来新版本(如 GLM-4.7)。
- 如需恢复自动更新:删除 中的模型相关 字段即可。
- 验证当前模型:启动 Claude Code 后输入 查看。
所有 MCP 功能需在已配置 GLM Coding Plan 的基础上启用。
(1)联网搜索 MCP()
配置方式(任选其一)
一键安装:
或手动配置(追加到 的顶层对象):
使用示例
在 Claude Code 对话中直接说:
- “帮我搜索最新的 AI 技术发展”
- “查找 Python 异步编程的**实践”
(2)网页读取 MCP()
配置方式
一键安装:
或手动配置:
典型场景
- 自动解析 API 文档并生成摘要
- 提取 GitHub 项目 README 核心信息
- 构建团队技术知识库
(3)视觉理解 MCP( / )
此 MCP 为 本地服务,需 Node.js ≥ v18
配置方式
一键安装:
Windows 用户注意:若在 PowerShell 中报 错误,请改用 CMD 执行。
或手动配置:
使用方法
- 将图片(如 )放入当前工作目录
- 在 Claude Code 中输入:
或
禁止直接粘贴图片!否则客户端会绕过 MCP 直接调用模型,无法使用视觉理解能力。
搜索 MCP 与网页读取 MCP 共享额度;视觉理解 MCP 独立计费。
1. 配置不生效
- 关闭所有 Claude Code 进程
- 新建终端窗口再启动
- 检查 是否为合法 JSON(可用 JSONLint 验证)
- 如仍无效,删除 后重配
2. API Key 无效
- 确认密钥复制完整(无多余空格)
- 确认密钥已在平台激活
- 确认账户有足够余额
3. MCP 连接失败
- 检查网络与防火墙
- 验证 URL 是否正确(见各 MCP 文档)
- 视觉 MCP 可本地测试:
4. 卸载旧 MCP(重装前必做)
- 已验证版本:Claude Code
- 查看版本:
- 升级到最新版:
进入项目目录,运行:
首次启动时:
- 确认使用 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
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/223597.html