Claude Code 与 GLM-4.6 配置教程：settings.json 骨架与连通性验证

1. 为什么要在 Claude Code 里接 GLM-4.6Claude Code 是 Anthropic 推出的命令行编码助手能在终端里直接读写项目文件、跑测试、改 bug。它默认走 Anthropic 官方接口但接口协议是开放的只要把ANTHROPIC_BASE_URL指向兼容 Anthropic Messages 协议的服务就能换成别的模型来驱动。GLM-4.6 在代码补全、长上下文理解上表现不错中文注释和国内项目语境也更顺手把它接进 Claude Code等于用同一套终端工作流跑一个更贴近本地开发习惯的模型。这篇教程聚焦一件事用settings.json骨架完成 Claude Code 接入 GLM-4.6 的本地配置并逐步验证请求链路是否真的通了。适合已经在用 Claude Code、想换模型但不想重装工具的人也适合第一次配 Claude Code、希望有个清晰骨架照着填的新手。整个过程不碰系统级环境变量的坑配置集中在项目或用户目录下的settings.json里改起来干净、回滚也方便。我试过把配置散在 shell 的export里换项目时经常忘了哪个终端生效、哪个没生效后来统一收进settings.json排查问题时只看一个文件省心很多。下面从骨架结构讲起再到可复制片段、验证动作和常见报错。2. TaoToken 前置拿到可用的 Key 和接入地址Claude Code 要发请求得有两个东西一个兼容 Anthropic 协议的接入地址Base URL一个能通过鉴权的 API Key。TaoToken 提供的就是这两样——它把模型调用统一成 Anthropic 兼容接口你不需要改 Claude Code 的源码只改配置里的地址和 Key 就能切换模型。先到官网了解接入方式https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 然后在控制台创建 API Key。创建入口在 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite Key 管理页在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。生成后先复制保存Key 一般只完整显示一次。接入地址用https://taotoken.net/api这是 Anthropic 兼容端点Claude Code 会把/v1/messages这类请求拼到它后面。如果你要确认模型名怎么写、支持哪些模型标识可以看接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。GLM-4.6 在文档里会有对应的模型标识配置时填那个标识不要凭感觉写。注意Key 属于敏感凭证不要提交到 Git 仓库也不要在截图里露出完整字符串。建议放在settings.json引用的本地文件或环境变量里而不是硬编码进会共享的配置。3. settings.json 骨架与可复制配置Claude Code 读取配置的优先级大致是项目级.claude/settings.json 用户级~/.claude/settings.json。项目级适合团队共享非敏感部分用户级适合放个人 Key。下面这份骨架把结构拆开讲你照着填即可。3.1 骨架结构说明一个能跑通的最小settings.json包含三块env注入给 Claude Code 进程的环境变量、model默认模型、permissions可选控制工具权限。核心是env里的ANTHROPIC_BASE_URL和ANTHROPIC_API_KEYClaude Code 启动时会读它们来决定请求发往哪里、用什么身份。{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-你的Key, ANTHROPIC_MODEL: glm-4.6 }, model: glm-4.6, permissions: { allow: [], deny: [] } }ANTHROPIC_MODEL和顶层model都写模型标识双保险避免某些版本只读其中一个。permissions先留空等验证通了再按需收紧。3.2 用户级配置推荐个人使用把 Key 放用户级所有项目共享不用每个仓库都配一遍。macOS / Linux 下路径是~/.claude/settings.jsonWindows 是C:\Users\你的用户名\.claude\settings.json。如果.claude目录不存在先建目录再建文件。mkdir -p ~/.claude cat ~/.claude/settings.json EOF { env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-你的Key, ANTHROPIC_MODEL: glm-4.6 }, model: glm-4.6 } EOFWindows PowerShell 里可以这样写New-Item -ItemType Directory -Force -Path $env:USERPROFILE\.claude { env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-你的Key, ANTHROPIC_MODEL: glm-4.6 }, model: glm-4.6 } | Set-Content -Encoding UTF8 $env:USERPROFILE\.claude\settings.json3.3 项目级配置团队共享非敏感部分项目级放.claude/settings.json只写地址和模型Key 通过用户级或环境变量补。这样仓库里不出现凭证同事拉下来也能直接用。{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_MODEL: glm-4.6 }, model: glm-4.6 }Key 的优先级如果用户级settings.json里已有ANTHROPIC_API_KEY项目级不写也能生效如果两边都写以更靠近项目的为准。配置改完不需要重启系统但要重开终端或重启 Claude Code 进程因为环境变量在进程启动时读取。4. 验证请求链路从启动到确认模型配置写完不算完得确认请求真的发到了 GLM-4.6而不是悄悄回退到默认模型或报鉴权错。下面按顺序验证。4.1 检查配置是否被读到先确认 Claude Code 能读到你的settings.json。在项目目录下启动cd /path/to/your/project claude如果启动时提示登录方式选 Anthropic Console account 相关选项它会用配置里的 Key 走鉴权跳过官方登录。进入交互界面看到claude提示符说明进程起来了。此时可以输入/status或类似命令查看当前模型和端点不同版本命令略有差异以实际提示为准。4.2 用一次真实请求确认模型最直接的验证是发一条会暴露模型身份的请求。在claude里输入请用一句话说明你是哪个模型并给出你的模型标识。如果返回里出现 GLM-4.6 相关信息说明请求链路通了、模型也切对了。如果返回的是 Claude 官方模型的自我介绍说明ANTHROPIC_MODEL没生效回去检查settings.json里的模型标识是否和文档一致。4.3 用 curl 单独验证端点想排除 Claude Code 本身的干扰可以直接打端点。这一步能确认 Key 和地址本身没问题curl -s https://taotoken.net/api/v1/messages \ -H x-api-key: sk-你的Key \ -H anthropic-version: 2023-06-01 \ -H content-type: application/json \ -d { model: glm-4.6, max_tokens: 64, messages: [{role: user, content: ping}] }返回 JSON 里如果有正常的content字段和文本说明端点、Key、模型三者都对。如果返回 401是 Key 问题返回 404多半是模型标识写错返回 400检查请求体字段。这一步通了Claude Code 里再报错就基本是配置读取的问题而不是链路问题。4.4 确认长上下文与工具调用GLM-4.6 支持较长上下文Claude Code 会用它读多个文件。验证时可以故意让它读一个稍大的文件读取当前目录下的 package.json总结依赖里有哪些和构建相关的包。如果它能正确调用文件读取工具并给出总结说明工具调用链路也正常。这一步过了日常编码场景基本可用。5. 本篇常见错排查配置过程中最容易卡在几个固定位置下面按现象列原因和解法。启动后仍要求官方登录说明ANTHROPIC_API_KEY没被读到。检查settings.json是否在正确路径、JSON 是否合法多余逗号会导致整个文件被忽略。可以用cat ~/.claude/settings.json | python -m json.tool验证格式。报 401 鉴权失败Key 复制时带了空格或换行或者 Key 已失效。重新从 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 复制注意不要带首尾空白。也确认账户额度是否充足。报模型不存在 / 404ANTHROPIC_MODEL或model字段写的标识和文档不一致。去 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 核对 GLM-4.6 的准确标识大小写和连字符都要对上。改了配置没生效环境变量在进程启动时读取改完必须重开终端。如果同时设了系统环境变量和settings.json两者可能冲突建议只保留settings.json一处避免排查时互相干扰。请求超时或连接失败确认ANTHROPIC_BASE_URL是https://taotoken.net/api不要多加/v1或结尾斜杠Claude Code 会自己拼路径。网络层面确认能正常访问该域名。工具调用报权限错permissions里deny拦了需要的工具。先清空deny验证再逐条加回定位是哪条规则过严。6. 后续怎么用得更顺配置通了之后日常使用还有几个能省事的地方。长期在终端里做编码和 Agent 任务的话可以了解 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 它针对持续编码场景做了额度安排比按次调用更适合高频使用。想先在网页里试模型效果、确认 GLM-4.6 的回答风格再决定要不要接进终端可以用模型对话https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite 。如果你用的是 Claude Code 的 Anthropic 兼容模式做深度集成接入文档里有更细的协议说明https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。配置这件事骨架搭对一次后面换模型只是改一个字符串的事。把settings.json当成唯一事实来源别让环境变量和配置文件打架排查成本会低很多。