1. 为什么要在 Claude Code 里接智谱 GLM-5.2Claude Code 是 Anthropic 推出的终端 AI 编程工具它能在命令行里直接读写项目文件、跑测试、改 bug交互方式比网页版更贴近真实开发流。但它默认走 Anthropic 官方通道对国内开发者来说网络和计费都不太顺手。智谱 GLM-5.2 是国产模型里代码能力比较能打的一个支持长上下文中文注释和国内技术栈理解也更自然。把两者接起来你就能在终端里用国产模型做代码补全、重构和排障成本可控延迟也低。这篇面向的是已经在用或准备用 Claude Code 的开发者尤其是想用国产模型替代默认通道的人。我会给出完整的 settings.json 骨架、APIKey 环境变量写法以及启动后验证模型连通性的具体命令和预期输出。整个过程不需要你改 Claude Code 源码只靠配置文件和几个环境变量就能跑通。需要说明的是Claude Code 本身支持通过ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN这类环境变量指向兼容 Anthropic 协议的网关。TaoToken 提供了这样的接入层把请求转发到智谱 GLM-5.2。你只需要拿到一个可用的 APIKey填进配置就能在终端里用上 GLM-5.2。2. 前置准备TaoToken 账号与 APIKey在动手改配置之前先把两样东西准备好Claude Code 本体以及一个能调用 GLM-5.2 的 APIKey。Claude Code 的安装方式取决于你的系统。macOS 和 Linux 下推荐用 npm 全局安装Windows 建议在 WSL2 里操作避免路径和权限问题。命令如下npm install -g anthropic-ai/claude-code装完后执行claude --version能打印版本号就说明二进制已经就位。如果提示找不到命令检查 npm 全局 bin 目录是否在 PATH 里。接下来是 APIKey。你可以到 TaoToken 的控制台创建一个密钥用于后续的模型调用。创建时建议单独建一个 key命名成claude-code-glm之类方便日后按项目区分用量。拿到 key 后先复制到剪贴板后面写进环境变量。注意APIKey 只显示一次创建后立刻保存。不要把它硬编码进会提交到 Git 的配置文件里用环境变量或本地.env隔离。TaoToken 的接入文档里有针对 Claude Code 的配置说明遇到协议字段不确定时可以对照查阅。控制台地址和文档入口我会在最后一节统一给出这里你先记住key 拿到手Claude Code 装好就可以进入配置环节。3. settings.json 可复制骨架Claude Code 读取配置的优先级是项目级.claude/settings.json 用户级~/.claude/settings.json。项目级适合团队共享用户级适合个人全局默认。我建议先配用户级跑通后再按项目覆盖。用户级配置文件的路径macOS / Linux~/.claude/settings.jsonWindowsWSL2~/.claude/settings.json如果.claude目录不存在先创建mkdir -p ~/.claude然后写入下面这个骨架。注意env块里的三个变量是核心ANTHROPIC_BASE_URL指向 TaoToken 的 API 入口ANTHROPIC_AUTH_TOKEN填你的 keyANTHROPIC_MODEL指定模型名。{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: sk-你的TaoToken密钥, ANTHROPIC_MODEL: glm-5.2, ANTHROPIC_SMALL_FAST_MODEL: glm-5.2 }, permissions: { allow: [ Read, Write, Bash(npm run *), Bash(git status), Bash(git diff *) ], deny: [] }, model: glm-5.2 }几个字段解释一下。ANTHROPIC_BASE_URL不要带末尾斜杠否则部分版本会拼出双斜杠导致 404。ANTHROPIC_AUTH_TOKEN就是你的 APIKeyClaude Code 会把它作为 Bearer token 放进请求头。ANTHROPIC_MODEL和顶层model都写glm-5.2前者影响请求体里的模型字段后者影响 CLI 启动时的默认选择两个都写避免版本差异。permissions.allow是白名单控制 Claude Code 能自动执行哪些操作。上面给的是一组保守配置允许读文件、写文件、跑 npm 脚本和只读的 git 命令。你可以按项目需要增删比如加上Bash(pytest *)让它能跑测试。deny留空表示没有额外禁止项但白名单之外的操作仍会弹确认。如果你不想把 key 写进 JSON可以把ANTHROPIC_AUTH_TOKEN从env块里删掉改用 shell 环境变量注入。这样配置文件可以安全提交到仓库。写法在下一节展开。4. APIKey 环境变量写法与启动把密钥放在 shell 环境里比写死在 JSON 里更安全也方便在不同项目间切换 key。macOS / Linux 下编辑~/.zshrc或~/.bashrc追加export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_AUTH_TOKENsk-你的TaoToken密钥 export ANTHROPIC_MODELglm-5.2保存后执行source ~/.zshrc让配置生效。Windows 下如果在 PowerShell 里用可以写进$PROFILE$env:ANTHROPIC_BASE_URL https://taotoken.net/api $env:ANTHROPIC_AUTH_TOKEN sk-你的TaoToken密钥 $env:ANTHROPIC_MODEL glm-5.2环境变量和 settings.json 同时存在时Claude Code 一般以 settings.json 的env块为准。所以如果你用了环境变量方案记得把 JSON 里的ANTHROPIC_AUTH_TOKEN删掉只保留ANTHROPIC_BASE_URL和模型名避免两处冲突。配置就绪后进入你的项目目录启动cd ~/projects/my-app claude第一次启动会看到欢迎界面和当前模型信息。如果模型显示为glm-5.2说明配置已经被读取。此时你可以直接输入自然语言指令比如「帮我看看 src/utils/date.ts 里有没有时区处理的 bug」它会读取文件并给出分析。提示如果启动时报Invalid API key或401先确认 key 没有多余空格再确认ANTHROPIC_BASE_URL没有拼错。环境变量方案下用echo $ANTHROPIC_AUTH_TOKEN检查是否真的注入成功。5. 验证请求与预期输出配置写完不代表通了得实际发一次请求确认链路。Claude Code 没有单独的 ping 命令但你可以用一次最小交互来验证。启动claude后输入一句最简单的指令只回复两个字通了如果模型正常返回「通了」说明 base URL、token、模型名三者都对。如果返回的是报错往下看排查章节。更严格的验证方式是直接用 curl 打 TaoToken 的 API绕过 Claude Code 看网关本身是否可用。命令如下curl -s https://taotoken.net/api/v1/messages \ -H Authorization: Bearer sk-你的TaoToken密钥 \ -H Content-Type: application/json \ -H anthropic-version: 2023-06-01 \ -d { model: glm-5.2, max_tokens: 64, messages: [ {role: user, content: 用一句话说明什么是递归} ] }预期返回是一段 JSON结构里包含content数组第一项的text字段就是模型输出。如果看到type: error错误信息会写在error.message里常见的是invalid_api_key或model_not_found。这个 curl 能通Claude Code 基本就没问题curl 不通问题在 key 或网关侧跟 Claude Code 配置无关。实测下来GLM-5.2 在代码解释和重构建议上响应比较快长文件分析时上下文保持也稳。你可以拿一个真实的小项目试让它读package.json并总结依赖或者让它给某个函数补单元测试。能连续完成两三轮交互就说明配置稳定了。6. 本篇常见错排查配置过程中最容易踩的坑集中在几类我按出现频率排一下。第一类是 401 未授权。表现是启动后任何指令都返回authentication_error。原因通常是 key 复制时带了换行或空格或者环境变量没生效。排查方法echo $ANTHROPIC_AUTH_TOKEN | wc -c看长度是否和 key 一致多出来的字符就是问题。settings.json 方案下用cat ~/.claude/settings.json | python -m json.tool确认 JSON 合法且 token 字段完整。第二类是 404 或not_found。多半是ANTHROPIC_BASE_URL写错比如末尾多了斜杠、漏了/api或者误填成官网首页地址。正确值就是https://taotoken.net/api不要带路径后缀。Claude Code 会在这个 base 上拼/v1/messages所以 base 本身不能包含/v1。第三类是模型名不匹配。如果你填了glm-5.2但网关侧实际注册名不同会返回model_not_found。确认模型标识的方法是查 TaoToken 的模型列表或接入文档以文档里写的为准。ANTHROPIC_MODEL和顶层model两处要一致不一致时以请求体里的为准容易出现「CLI 显示一个模型、实际调用另一个」的迷惑现象。第四类是权限弹窗卡住。Claude Code 默认对写文件和执行命令会弹确认如果你在非交互环境比如脚本里调用会一直等待。解决办法是在permissions.allow里显式放行需要的操作或者启动时加--dangerously-skip-permissions仅限你完全信任的本地项目别在共享环境用。第五类是 WSL2 下路径问题。Windows 用户如果在 WSL 里装 Claude Code项目路径要用 Linux 风格/home/user/project不要用/mnt/c/...否则文件监听和 git 操作会变慢甚至失败。把项目放在 WSL 原生文件系统里最稳。7. 接入入口与后续建议配置跑通之后日常使用就是cd到项目、敲claude、用自然语言下指令。如果你要长期在多个项目里用 GLM-5.2 做编码和 Agent 任务建议到 TaoToken 控制台开一个专门的 Coding Plan按项目维度管理用量避免和别的调用混在一起。密钥管理在 API Keys 页面接入细节和字段说明看接入文档想先试模型效果可以直接用模型对话页面发几条指令感受一下。控制台与密钥管理https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentclaude_code_glm52接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentclaude_code_glm52模型对话体验https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentclaude_code_glm52Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentclaude_code_glm52最后给一个实用习惯把~/.claude/settings.json纳入你的 dotfiles 管理但 key 用环境变量注入这样换机器时配置能一键同步密钥不会跟着仓库走。项目级的.claude/settings.json可以提交用来固化团队统一的权限白名单和模型选择新人 clone 下来就能用同一套规则。
