Claude Code+GLM 4.5打造编程助手保姆级教程：从零开始配置MCP服务器到TaoToken统一通道

1. 为什么要在 Claude Code 里接 GLM 4.5 和 MCP 服务器Claude Code 是 Anthropic 推出的命令行编程助手能直接读写你本地的代码文件、跑测试、执行 git 操作。GLM 4.5 是智谱推出的模型在 Agentic Coding 类任务上表现不错支持 Anthropic 兼容协议所以可以直接替换 Claude Code 背后的模型通道。MCP 服务器则是给这个助手外挂能力的插件机制——联网搜索、视觉理解、浏览器自动化都靠它。这套组合适合谁零基础但想拥有一个能自己搜资料、自己开浏览器、自己写代码的本地编程助手的人。你不需要会写复杂脚本只要会复制命令、改配置文件就行。我实测下来整条链路分三块Claude Code 客户端、GLM 4.5 模型通道、MCP 服务器。三块里最容易卡住的是 MCP 的注册和联调因为参数写错一个字符就连不上。下面按“先跑通模型、再挂 MCP、最后统一管 Key”的顺序拆。先说清楚一个概念Claude Code 默认走 Anthropic 官方通道我们要做的是把它的ANTHROPIC_BASE_URL指向 GLM 4.5 的兼容端点再把 Key 换成智谱的。这一步做完Claude Code 的所有对话和工具调用都会走 GLM 4.5。MCP 是在这个基础上再加的所以顺序不能反。如果你后面要同时管多个模型比如 GLM 4.5、Claude、其他兼容模型一个个改环境变量会很乱。这时候用 TaoToken 做统一通道一个 Key 管多个模型切换只改一个 Model ID。这也是本篇要重点讲的“统一通道”部分。2. 前置准备Claude Code 安装与 TaoToken 统一通道配置2.1 安装 Claude CodeClaude Code 需要 Node.js 18 以上。先确认版本node -v npm -v然后全局安装npm install -g anthropic-ai/claude-code装完输入claude --version能看到版本号就说明成功了。如果提示命令找不到检查 npm 全局 bin 目录有没有加到 PATH。2.2 为什么用 TaoToken 统一通道直接配智谱的端点也能跑但有两个问题一是 Key 分散在各家平台管理麻烦二是想换模型要改环境变量重启。TaoToken 的做法是提供一个统一的 API 入口你用同一个 Key 就能调不同模型切换只改 Model ID。TaoToken 官网https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI 端点https://taotoken.net/api先去控制台建一个 API Key# 打开控制台创建 Key https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentKey 建好后复制出来形如sk-xxxx。这个 Key 后面既用于 Claude Code也用于 MCP 的鉴权头。2.3 配置环境变量Claude Code 读的是ANTHROPIC_BASE_URL和ANTHROPIC_API_KEY两个变量。我们把它们指向 TaoTokenexport ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_API_KEYsk-你的TaoToken密钥Windows PowerShell 用$env:ANTHROPIC_BASE_URLhttps://taotoken.net/api $env:ANTHROPIC_API_KEYsk-你的TaoToken密钥想持久化就写进~/.bashrc或~/.zshrc。注意 Base URL 后面不要多加/v1Claude Code 会自己拼路径多写会 404。2.4 指定 GLM 4.5 模型Claude Code 通过ANTHROPIC_MODEL指定模型。GLM 4.5 在 TaoToken 上的 Model ID 按控制台里显示的填通常是glm-4.5这类export ANTHROPIC_MODELglm-4.5到这里模型通道就通了。进 Claude Code 输入/status能看到 Base URL 指向 taotoken.net、模型是 glm-4.5就说明配置生效。3. 可复制配置MCP 服务器注册与 settings 片段MCP 服务器有三种挂法命令行claude mcp add、项目级.mcp.json、用户级 settings。我推荐项目级.mcp.json因为可以跟着仓库走团队共享方便。3.1 联网搜索 MCP在项目根目录建.mcp.json{ mcpServers: { web-search-prime: { type: http, url: https://taotoken.net/api/mcp/web_search_prime/mcp, headers: { Authorization: Bearer sk-你的TaoToken密钥 } } } }注意type是httpurl结尾带/mcpAuthorization是Bearer加空格再加 Key。这三处是最容易写错的。3.2 视觉理解 MCP视觉理解 MCP 走的是 npx 启动的本地进程配置里用command和args{ mcpServers: { zai-mcp-server: { command: npx, args: [-y, z_ai/mcp-server], env: { Z_AI_API_KEY: sk-你的TaoToken密钥 } } } }3.3 浏览器自动化 MCPPlaywright MCP 让助手能开浏览器、点按钮、填表单{ mcpServers: { playwright: { command: npx, args: [-y, playwright/mcplatest] } } }3.4 合并成一份完整配置把三个合并到一个.mcp.json{ mcpServers: { web-search-prime: { type: http, url: https://taotoken.net/api/mcp/web_search_prime/mcp, headers: { Authorization: Bearer sk-你的TaoToken密钥 } }, zai-mcp-server: { command: npx, args: [-y, z_ai/mcp-server], env: { Z_AI_API_KEY: sk-你的TaoToken密钥 } }, playwright: { command: npx, args: [-y, playwright/mcplatest] } } }如果你更习惯命令行注册等价写法是claude mcp add --scope user --transport http web-search-prime https://taotoken.net/api/mcp/web_search_prime/mcp --header Authorization: Bearer sk-你的TaoToken密钥 claude mcp add zai-mcp-server --env Z_AI_API_KEYsk-你的TaoToken密钥 -- npx -y z_ai/mcp-server claude mcp add playwright -- npx -y playwright/mcplatest--scope user表示对所有项目生效不加则只对当前项目生效。3.5 三件套对照表不管用哪种方式MCP 和模型接入都离不开这三样缺一不可项目值说明Base URLhttps://taotoken.net/api模型与 MCP 统一入口API Keysk-你的TaoToken密钥控制台创建鉴权用Model IDglm-4.5按控制台显示填4. 验证请求从 /status 到实际跑通 MCP4.1 验证模型通道进 Claude Codeclaude输入/status检查输出里的 Base URL 和 Model。然后发一句用一句话解释什么是 MCP 服务器能正常返回就说明模型通道通了。如果返回的是 Anthropic 官方模型名说明ANTHROPIC_MODEL没生效检查环境变量有没有 export 成功。4.2 验证 MCP 是否加载在 Claude Code 里输入/mcp会列出当前加载的所有 MCP 服务器及其状态。三个都显示 connected 才算成功。如果某个显示 failed看下一节的排错。4.3 验证联网搜索 MCP直接给一个需要联网的任务搜索今天 GitHub Trending 上最热门的三个开源项目总结它们各自解决什么问题助手会自己判断要不要调web-search-prime。你会在输出里看到它发起搜索、拿到结果、再总结。如果它没调 MCP 而是直接编说明 MCP 没连上或者任务描述不够明确。4.4 验证浏览器自动化 MCP打开 https://example.com把页面标题读出来Playwright MCP 会启动一个浏览器实例访问页面返回标题。第一次跑会下载浏览器内核稍等一会。4.5 验证视觉理解 MCP准备一张本地图片然后看一下 ./screenshot.png 里有什么内容视觉 MCP 会读取图片并描述。这一步能过说明三个 MCP 全部联调成功。4.6 组合任务实测把三个 MCP 串起来跑一个真实任务搜索今天最热门的开源项目打开它的 GitHub 页面截图首页然后总结这个项目这条指令会依次触发搜索 MCP、浏览器 MCP、视觉 MCP。跑通这条你的本地编程助手就算完整了。5. 常见报错排查401、local proxy failed、reading choices、OAuth5.1 401 Unauthorized最常见。原因通常是 Key 写错或格式不对。检查三点Key 有没有多余空格Authorization头是不是Bearer加空格再加 KeyKey 是不是在 TaoToken 控制台建的、有没有过期。headers: { Authorization: Bearer sk-你的TaoToken密钥 }如果模型通道报 401检查ANTHROPIC_API_KEY有没有 export 成功用echo $ANTHROPIC_API_KEY确认。5.2 local proxy failed这个报错一般出现在 MCP 走本地进程时比如 npx 启动的zai-mcp-server。原因多是 npx 没装、Node 版本太低、或者网络拉不到包。先手动跑一遍npx -y z_ai/mcp-server看能不能启动。如果卡在下载检查 npm registry 配置。如果报 Node 版本升级到 18 以上。5.3 reading choices 相关报错这类报错通常是模型返回格式和 Claude Code 预期不一致导致的多出现在 Model ID 填错、或者 Base URL 多写了/v1的情况下。检查echo $ANTHROPIC_BASE_URL # 应该是 https://taotoken.net/api结尾不要带斜杠不要带/v1。Model ID 按控制台显示原样填不要自己加前缀。5.4 OAuth 相关报错Claude Code 首次启动可能引导你走 Anthropic 官方 OAuth 登录。如果你已经配了ANTHROPIC_API_KEY它会跳过 OAuth。如果还在报 OAuth 错误说明 Key 没被识别。删掉~/.claude下的凭据缓存再重启rm -rf ~/.claude/credentials.json然后重新进claude确认它读的是环境变量而不是走登录流程。5.5 MCP 显示 failed 但没报错在 Claude Code 里输入/mcp看详细日志。常见原因是.mcp.json的 JSON 格式错了比如多了逗号、少了引号。用下面命令校验cat .mcp.json | python -m json.tool能正常输出说明格式没问题。报错就按提示改。5.6 排错速查表报错大概率原因处理401Key 错/格式错检查 Bearer 空格与 Keylocal proxy failednpx 或 Node 问题手动跑 npx 验证reading choicesBase URL 或 Model ID 错去掉 /v1核对 Model IDOAuthKey 未识别删凭据缓存重启6. 多模型统一管理用 TaoToken 切换 GLM 4.5 与其他模型跑通之后你会发现真正省事的是统一通道。以前换模型要改环境变量、重启 Claude Code现在只改一个 Model ID。6.1 切换模型比如从 GLM 4.5 切到另一个兼容模型export ANTHROPIC_MODEL另一个模型IDBase URL 和 Key 都不用动。这就是统一通道的价值——Key 只有一份模型随便换。6.2 在 Claude Code 里临时切换Claude Code 支持在会话里用/model查看和切换。如果 TaoToken 通道支持多模型这里能直接选。6.3 长期编码与 Agent 场景如果你要长期跑编码任务或者搭 Agent建议用 Coding Plan额度更稳https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content6.4 接入文档与模型对话配置细节看文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content想先在线试模型效果用模型对话https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content6.5 管理 API KeyKey 统一在控制台管理可以建多个、随时吊销https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content6.6 一个实用技巧把.mcp.json里的 Key 换成环境变量引用避免明文提交到仓库headers: { Authorization: Bearer ${TAOTOKEN_API_KEY} }然后在 shell 里 exportTAOTOKEN_API_KEY。这样配置文件可以安全地进 gitKey 留在本地。最后一步把.mcp.json提交前加进.gitignore的例外或者用上面的环境变量写法。跑通之后你会发现真正花时间的不是配置而是想清楚让助手干什么。