Claude Code 接入 GLM-4.7 模型：settings.json 配置骨架与连通性验证

1. 为什么要在 Claude Code 里接 GLM-4.7Claude Code 是 Anthropic 推出的命令行编程助手能在终端里直接读写文件、跑命令、改代码。它默认走 Anthropic 官方模型但很多人希望换成 GLM-4.7——一方面 GLM-4.7 在代码补全、长上下文理解上表现不错另一方面通过统一 API 通道接入后一个 Key 就能同时驱动对话、编码、Agent 等多种场景省去反复切换账号的麻烦。这篇面向已经装好 Node.js 的开发者聚焦一件事用 settings.json 把 Claude Code 指向 GLM-4.7并跑通一次最小对话请求。我会给出可直接复制的配置骨架、API Key 的填写位置、连通性验证命令以及 MCP 配置该预留在哪里。整个过程不需要改 Claude Code 源码全部靠环境变量和配置文件完成。适合谁看本地已有 Node.js 18 环境、用过 npm 全局安装、想在 Claude Code 里用上 GLM-4.7 的同学。如果你还没装 Node.js先去官网装 LTS 版本node -v能打印版本号再往下走。2. 前置准备Node.js 环境与 TaoToken 通道2.1 确认 Node.js 与 npm 可用Claude Code 是 npm 包先确认环境node -v npm -v实测 Node.js 18 以上都能跑20 LTS 更稳。如果npm -v报错多半是 Node 没装好或 PATH 没配重装一次即可。2.2 安装 Claude Codenpm install -g anthropic-ai/claude-code装完验证claude --version能打印版本号就说明 CLI 就位。第一次运行claude会引导你登录这里先别急着登 Anthropic 账号因为我们后面要用环境变量把它指向 GLM-4.7。2.3 准备 TaoToken 的 API KeyGLM-4.7 通过统一 API 通道调用你需要一个可用的 API Key。到控制台创建控制台入口https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewriteAPI Key 管理https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite创建后复制那串sk-开头的 Key先存到本地临时文件或密码管理器后面要填进 settings.json。注意别把 Key 提交到 Git 仓库这是最常见的泄露途径。提示API 基础地址是https://taotoken.net/api配置里会用到不要多加斜杠或路径后缀。3. 可复制的 settings.json 配置骨架3.1 找到配置文件位置Claude Code 的用户级配置在用户目录下的.claude/settings.json。各平台路径平台路径macOS / Linux~/.claude/settings.jsonWindowsC:\Users\你的用户名\.claude\settings.json如果.claude目录或 settings.json 不存在手动创建即可。这个文件是 JSON 格式Claude Code 启动时会读取。3.2 完整配置骨架把下面这段复制进 settings.json把sk-你的Key替换成上一步拿到的真实 Key{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: sk-你的Key, ANTHROPIC_DEFAULT_HAIKU_MODEL: glm-4.7, ANTHROPIC_DEFAULT_SONNET_MODEL: glm-4.7, ANTHROPIC_DEFAULT_OPUS_MODEL: glm-4.7 }, language: chinese }逐项说明ANTHROPIC_BASE_URL把请求指向统一 API 通道而不是 Anthropic 官方地址。ANTHROPIC_AUTH_TOKEN你的 API Key鉴权靠它。三个ANTHROPIC_DEFAULT_*_MODELClaude Code 内部按 Haiku/Sonnet/Opus 三档调用模型全部映射到glm-4.7这样无论它选哪档都走 GLM-4.7。language设为chinese让生成结果默认用中文省得每次手动要求。注意JSON 不支持注释复制时别把说明文字带进去否则解析会失败。3.3 关于模型名的写法模型名要和你账号下可用的名称一致。如果glm-4.7报「模型不存在」先到模型列表确认当前可用的准确标识再回填。三个档位也可以填不同模型比如 Haiku 档用更轻量的版本省钱Sonnet/Opus 档用 glm-4.7 保质量ANTHROPIC_DEFAULT_HAIKU_MODEL: glm-4.7-air, ANTHROPIC_DEFAULT_SONNET_MODEL: glm-4.7, ANTHROPIC_DEFAULT_OPUS_MODEL: glm-4.7具体有哪些模型可查文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite4. 连通性验证跑一次最小对话请求4.1 用 claude 命令直接验证配置保存后在终端里跑一个非交互式请求看模型是否响应claude -p 用一句话说明什么是递归-p是 print 模式执行完直接输出结果退出。如果配置正确你会看到 GLM-4.7 返回的中文回答。这一步能同时验证三件事Base URL 通不通、Key 有没有效、模型名对不对。4.2 进入交互模式确认再跑一次交互模式claude进去后随便问一句「帮我写一个 Python 快排」观察它是否正常调用工具、读写文件。如果回答是中文、能正常执行说明整条链路打通。4.3 用 curl 单独验证 API 通道如果claude命令报错先用 curl 排除是配置问题还是通道问题curl https://taotoken.net/api/v1/messages \ -H Content-Type: application/json \ -H x-api-key: sk-你的Key \ -H anthropic-version: 2023-06-01 \ -d { model: glm-4.7, max_tokens: 64, messages: [{role: user, content: ping}] }返回里带content字段就说明通道和 Key 都没问题那问题就出在 Claude Code 的配置读取上。想直接在网页里试模型可以用模型对话页https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite4.4 成功结果长什么样正常返回类似{ id: msg_xxx, type: message, role: assistant, content: [{type: text, text: pong}], model: glm-4.7 }看到model字段是 glm-4.7、content有文本就代表连通性验证通过。5. 本篇常见报错排查5.1 401 / invalid api key最常见。原因通常是 Key 复制时带了空格、换行或者填错了字段。检查ANTHROPIC_AUTH_TOKEN的值是否完整、有没有多余引号。另外确认 Key 没被禁用或额度耗尽。5.2 404 / model not found模型名写错或账号下没有该模型权限。把三个ANTHROPIC_DEFAULT_*_MODEL统一改成确认可用的名称再重试。注意大小写和连字符glm-4.7和GLM-4.7在某些接口下不等价。5.3 settings.json 解析失败JSON 语法错误比如多了逗号、少了引号、带了注释。用编辑器格式化一下或跑node -e JSON.parse(require(fs).readFileSync(process.env.HOME/.claude/settings.json))检查语法。5.4 改了配置不生效Claude Code 只在启动时读配置。改完 settings.json 要退出重进。如果还不行检查是不是有项目级的.claude/settings.json覆盖了用户级配置——项目级优先级更高。5.5 MCP 配置预留位置MCPModel Context Protocol让 Claude Code 连接外部工具。全局 MCP 配置放在用户目录的.claude.json里和.claude目录同级第一层的mcpServers字段{ mcpServers: { your-server: { command: npx, args: [-y, your-mcp-package] } } }配完重启 Claude Code用下面命令查状态claude mcp list显示connected就生效了。MCP 的具体 server 按需添加初期可以先留空等有明确需求再配。5.6 中文输出不稳定language设了chinese仍偶尔出英文多半是提示词里带了英文上下文。可以在项目根目录放一个CLAUDE.md写明「始终用中文回复」Claude Code 会优先读它。6. 后续怎么用起来配置跑通只是起点。日常编码时Claude Code 会按你映射的模型档位调用 GLM-4.7长任务、多文件重构都能扛。如果你要长期跑编码 Agent、批量改仓库建议用 Coding Plan 把额度固定下来避免按次计费波动https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite接入文档里有更细的参数说明和模型清单遇到模型名、上下文长度、并发限制的问题先翻它https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite我自己的习惯是settings.json 里三个档位全填 glm-4.7项目里放一个 CLAUDE.md 约束中文和代码风格MCP 只装真正高频用的那一两个。配置越简单出问题时越好定位。