ARTICLE · INTELLIGENCE

战地情报 · 详情页

来自尧图项目组的一线实战观察与深度解析

把 Claude Code 的 ANTHROPIC_BASE_URL 改到 TaoToken 后,智谱 GLM 直接可用

把 Claude Code 的 ANTHROPIC_BASE_URL 改到 TaoToken 后,智谱 GLM 直接可用 1. 为什么要把 Claude Code 的 Base URL 换掉Claude Code 是 Anthropic 官方出的命令行编程助手能读你本地代码、改文件、跑命令用起来像给终端塞了个会写代码的搭档。但它默认连的是 Anthropic 官方接口国内直连基本没戏而且官方账号和计费对多数人也不友好。于是社区里流行一个做法把ANTHROPIC_BASE_URL指向国内某个兼容 Anthropic 协议的网关让 Claude Code 以为自己在跟官方说话实际背后跑的是国产大模型。原文的思路是直接填智谱的地址https://open.bigmodel.cn/api/anthropic用智谱的 Key 跑 GLM。这招能用但有个麻烦你每换一家模型DeepSeek、Qwen、Kimi就得重新申请 Key、重新改 Base URL、重新配一遍 settings.json。用久了会发现光管理这些 Key 就够烦的。所以这篇要做的改动很明确把「获取智谱 Key」和「改 settings.json」这两步换成先到 TaoToken 注册、创建一个 Key然后把ANTHROPIC_BASE_URL统一改成https://taotoken.net/api注意结尾不要加/v1ANTHROPIC_AUTH_TOKEN填刚创建的 TaoToken Key。这样 Claude Code 统一走 TaoToken 网关同一个 Key 既能跑智谱 GLM也能切到 DeepSeek、Qwen 等国内模型不用再为每家单独申请和换地址。适合谁看已经在用或准备装 Claude Code 的开发者手上有一堆国产模型 Key、想统一管理的以及被官方接口折腾过、想找个稳定入口的人。下面从安装讲到配置再到验证和排错跟着做就行。2. 前置准备Node 环境与 TaoToken Key2.1 装 Node 并确认版本Claude Code 是 npm 包先得有 Node。版本要大于 18推荐 v20 稳定版。装完在终端确认一下node -v npm -v如果版本低于 18去 Node 官网下新的 LTS 包覆盖安装即可。国内网络下 npm 拉包容易慢先切个源npm config set registry https://registry.npmmirror.com/ npm get registry第二条命令会回显当前源地址确认切成功再往下。2.2 安装 Claude Code用 npm 全局装最新版npm i -g anthropic-ai/claude-codelatest装完输入claude检测claude能出现交互界面就说明装上了。如果第一次运行卡在初始化、让你登录官方账号先别管我们后面用环境变量绕过。Windows 上如果提示找不到可执行文件多半是 exe 没装好可以补一条winget install Anthropic.ClaudeCode然后把下载好的 exe 复制到 Node 安装目录下的bin文件夹里再运行claude。2.3 创建 TaoToken Key打开 TaoToken 官网注册账号https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content登录后进控制台创建 API Key入口在这里https://taotoken.net/consoleKey 的创建和管理页面https://taotoken.net/api-keys创建完把 Key 复制出来形如sk-xxxx先存到记事本下一步要填进配置文件。这个 Key 就是后面 Claude Code 的ANTHROPIC_AUTH_TOKEN一个 Key 通吃多家模型不用再分别去智谱、DeepSeek 申请。注意Key 只在创建时完整显示一次关掉页面就看不到了务必先复制保存。丢了就重新建一个。3. 改 settings.json把 Base URL 指向 TaoToken3.1 找到配置文件位置Claude Code 的配置目录在用户主目录下的.claude文件夹。Windows 上按Win R输入%userprofile%\.claude回车就能打开这个目录。里面如果有settings.json就直接编辑没有就新建一个同名文件。macOS 和 Linux 对应路径是~/.claude/settings.json。3.2 写入配置内容把下面这段完整替换进settings.json{ env: { ANTHROPIC_AUTH_TOKEN: 你的 TaoToken Key, ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_DEFAULT_HAIKU_MODEL: glm-4.5-air, ANTHROPIC_DEFAULT_SONNET_MODEL: glm-5-turbo, ANTHROPIC_DEFAULT_OPUS_MODEL: glm-5.1 }, includeCoAuthoredBy: false }几个关键点说清楚ANTHROPIC_BASE_URL填https://taotoken.net/api结尾不要加/v1。加了会导致请求路径拼错报 404 或连接异常这是最常见的坑。ANTHROPIC_AUTH_TOKEN填你刚在 TaoToken 创建的 Key替换掉你的 TaoToken Key这几个字引号保留。后面三个ANTHROPIC_DEFAULT_*_MODEL是给 Claude Code 内部不同档位指定模型。Claude Code 会按任务复杂度调用 Haiku、Sonnet、Opus 三档这里分别映射到 GLM 的不同型号。想换 DeepSeek 或 Qwen改这三个值就行Base URL 和 Key 都不用动。3.3 模型名怎么填不同模型的标识符不一样填错了会报模型不存在。常见对应关系参考档位作用可填示例HAIKU轻量快速任务glm-4.5-airSONNET日常主力glm-5-turboOPUS复杂推理glm-5.1想切到别的模型把对应档位的值换成目标模型标识即可。具体支持哪些模型名可以在 TaoToken 的模型对话页确认https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite保存文件后重新运行claude配置就生效了。4. 验证请求确认真的走通了4.1 命令行验证重新打开终端运行claude进入交互界面后随便问一句比如「用 Python 写个快速排序」。如果模型正常返回代码说明 Base URL 和 Key 都通了。第一次运行如果还弹官方登录检查settings.json是否保存成功、路径是否放对。4.2 用 curl 单独测网关想更直接地确认网关通不通可以绕过 Claude Code直接打接口curl https://taotoken.net/api/v1/messages \ -H Content-Type: application/json \ -H x-api-key: 你的 TaoToken Key \ -H anthropic-version: 2023-06-01 \ -d { model: glm-4.5-air, max_tokens: 100, messages: [{role: user, content: 你好回一句话}] }注意这里 curl 的路径带了/v1/messages而settings.json里的 Base URL 不带/v1——这是两回事。Claude Code 会自己在 Base URL 后面拼/v1/messages所以配置里不能重复加。curl 是手动拼完整路径所以要带上。返回里有content字段和文本内容就说明 Key 有效、网关正常。4.3 在 VSCode 里用VSCode 插件市场搜 Claude Code 装上配置和命令行共用同一份settings.json。装好后点插件图标打开 agent 面板在对话框输入需求即可。如果插件读不到配置重启一次 VSCode。5. 本篇常见错误排查5.1 Base URL 多写了 /v1现象请求报 404或提示路径不存在。原因settings.json里填了https://taotoken.net/api/v1。Claude Code 会再拼一次/v1/messages变成/api/v1/v1/messages。改回https://taotoken.net/api即可。5.2 Key 无效或没余额现象返回 401 或鉴权失败。检查ANTHROPIC_AUTH_TOKEN是否复制完整、有没有多余空格。Key 只在创建时显示一次如果当时没存去 api-keys 页面重新建一个。另外确认账户有可用额度。5.3 npm 装完 claude 命令找不到现象终端提示claude不是内部或外部命令。多半是全局 bin 目录没进 PATH或 exe 没装成功。用winget install Anthropic.ClaudeCode补装 exe再把它复制到 Node 安装路径的bin文件夹下。用npm root -g可以查到全局包位置。5.4 初始化卡住、反复要求登录现象运行claude一直停在登录引导。这是首次运行的 onboarding 没跳过。可以手动改.claude.json标记完成状态powershell -Command $f%USERPROFILE%\.claude.json;$jGet-Content $f|ConvertFrom-Json;$j|Add-Member -NotePropertyName hasCompletedOnboarding -NotePropertyValue $true -Force;$j|ConvertTo-Json|Set-Content $f执行后再运行claude出现选择时回车选 Yes。5.5 模型名报不存在现象提示 model not found。检查三个ANTHROPIC_DEFAULT_*_MODEL的值是否拼写正确、是否是网关支持的模型标识。不确定就去模型对话页核对当前可用模型名。5.6 改了配置不生效现象改完settings.json还是走旧地址。Claude Code 启动时读配置改完必须退出重开。另外确认改的是%userprofile%\.claude\settings.json不是项目目录下的其他文件。6. 统一网关后的日常用法与入口配置改完之后日常就省心了一个 TaoToken Key 放在settings.json里想换模型只改那三个模型名Base URL 和 Key 都不动。跑智谱 GLM 用默认配置想试 DeepSeek 或 Qwen 就把档位值换掉重启claude即可。不用再为每家单独申请 Key、单独记地址。如果你长期用 Claude Code 写代码、跑 Agent 任务可以看下 Coding Plan按用量规划更划算https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite想先确认某个模型能不能用、效果如何直接在模型对话页试https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewriteKey 的创建和管理都在控制台https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite接入过程中遇到路径、鉴权、模型名的问题对照接入文档查最快https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite最后提醒一句settings.json里的 Base URL 永远是https://taotoken.net/api不带/v1curl 手动测的时候才带/v1/messages。这个区别记牢能省掉一大半排错时间。
RELATED READING

延伸阅读

更多一线实战笔记与深度复盘,助您持续精进