【保姆级教程】Claude Code本地安装与配置国产智谱模型：把settings改到TaoToken

1. 为什么要在 Claude Code 里接入国产智谱模型Claude Code 是 Anthropic 推出的终端 AI 编程助手它最大的特点是直接跑在你的命令行里能读项目文件、改代码、跑测试交互方式比网页版更贴近真实开发流。但很多人装完之后卡在第一步默认走官方通道账号、计费、网络环境都可能让新手劝退。这时候把底层模型换成国产智谱 GLM 系列就是一个很实际的选择——中文理解好、调用成本可控、国内直连稳定。我自己在几个项目里都试过这套组合Claude Code 负责终端交互和文件操作智谱 GLM 负责推理和代码生成。核心改动其实只有一个文件settings.json。你不需要改 Claude Code 的源码也不用装额外插件只要把ANTHROPIC_BASE_URL和几个模型 ID 指向智谱的 Anthropic 兼容端点重启终端就能用。这篇教程面向的是已经装好 Claude Code、想换成国产模型的开发者。我会从安装验证讲起然后给出可直接复制的settings.json片段、环境变量写法再演示一次真实对话请求验证模型是否生效最后把 401 报错的排查路径拆开讲清楚。如果你还想用统一 Key 管理多个模型通道我也会提到怎么通过 TaoToken 这类聚合入口来简化配置。先明确一个概念Claude Code 本身是一个客户端它通过 Anthropic 风格的 API 协议和后端模型通信。智谱开放平台提供了兼容 Anthropic 协议的端点所以只要把 Base URL 换掉Claude Code 就会把请求发给智谱。模型 ID 也要对应替换否则会出现「模型不存在」或「reading choices」之类的解析错误。适合谁看已经会用 npm 装全局包、能看懂 JSON 配置、想在终端里用国产模型写代码的开发者。如果你还没装 Claude Code下面第一节会带你走一遍安装和验证。2. 安装 Claude Code 并验证本地环境是否就绪安装本身不复杂但环境不对会埋坑。Claude Code 依赖 Node.js 运行时建议 18.0 或更高版本同时需要 Git 用于部分项目操作。先在终端确认版本node -v npm -v git --version如果 Node 版本低于 18先去官网升级。确认无误后用 npm 全局安装 Claude Code 核心组件npm install -g anthropic-ai/claude-code国内网络下 npm 下载可能偏慢可以临时切换镜像源加速npm config set registry https://registry.npmmirror.com安装完成后验证是否装好claude --version终端返回一串版本号比如1.x.x说明核心组件已经就绪。如果提示command not found大概率是 npm 全局 bin 目录没进 PATH。用下面命令查看全局路径npm config get prefix把这个路径下的bin目录Windows 是根目录加到系统环境变量 PATH 里重开终端再试。首次启动 Claude Code 时会有几个初始化界面主题设置直接回车选默认安全指南回车跳过工作区信任确认选Yes, I trust this folder。这些只影响交互体验不影响后面的模型配置。这里有个容易忽略的点Claude Code 的配置文件默认放在用户目录下的.claude文件夹里。Windows 路径是C:\Users\{你的用户名}\.claude\macOS/Linux 是~/.claude/。如果这个目录不存在首次启动后会自动生成。后面我们要改的settings.json就在这个目录里。你可以先用ls ~/.claude或dir %USERPROFILE%\.claude确认一下。环境验证通过后先别急着配智谱建议用默认配置跑一次claude看看能不能正常进入交互界面。能进说明客户端没问题接下来才是换模型的事。3. 用 settings.json 把模型切到智谱 GLM这是整篇教程的核心步骤。Claude Code 读取settings.json里的env字段来覆盖默认环境变量我们只要把 Anthropic 的 Base URL 和模型 ID 换成智谱的即可。先打开配置文件。Windowsnotepad C:\Users\{你的用户名}\.claude\settings.jsonmacOS/Linuxnano ~/.claude/settings.json如果文件不存在就手动新建一个。把下面这段 JSON 复制进去注意把your_zhipu_api_key替换成你在智谱开放平台申请的真实 Key{ env: { ANTHROPIC_BASE_URL: https://open.bigmodel.cn/api/anthropic, ANTHROPIC_AUTH_TOKEN: your_zhipu_api_key, ANTHROPIC_DEFAULT_HAIKU_MODEL: glm-4.5-air, ANTHROPIC_DEFAULT_SONNET_MODEL: glm-5-turbo, ANTHROPIC_DEFAULT_OPUS_MODEL: glm-5.1 } }这里几个字段的作用要理解清楚不然排错时会懵字段作用说明ANTHROPIC_BASE_URL请求端点指向智谱的 Anthropic 兼容地址ANTHROPIC_AUTH_TOKEN鉴权令牌填智谱 API KeyANTHROPIC_DEFAULT_HAIKU_MODEL轻量模型对应快速任务如 glm-4.5-airANTHROPIC_DEFAULT_SONNET_MODEL主力模型日常编码主力如 glm-5-turboANTHROPIC_DEFAULT_OPUS_MODEL高能力模型复杂推理如 glm-5.1Claude Code 内部会按任务复杂度选择 Haiku/Sonnet/Opus 三档所以三个模型 ID 都要填否则某些场景会回落到默认值导致报错。如果你不想改文件也可以用环境变量方式临时覆盖。macOS/Linuxexport ANTHROPIC_BASE_URLhttps://open.bigmodel.cn/api/anthropic export ANTHROPIC_AUTH_TOKENyour_zhipu_api_key export ANTHROPIC_DEFAULT_SONNET_MODELglm-5-turboWindows PowerShell$env:ANTHROPIC_BASE_URLhttps://open.bigmodel.cn/api/anthropic $env:ANTHROPIC_AUTH_TOKENyour_zhipu_api_key $env:ANTHROPIC_DEFAULT_SONNET_MODELglm-5-turbo环境变量的优先级高于settings.json适合临时测试。但长期使用建议写进settings.json避免每次开终端都要重设。另外提一个统一管理的思路如果你同时用多个模型通道Key 和 Base URL 分散在各处会很乱。TaoToken 提供了统一的 API 通道和 Key 管理入口你可以把智谱、其他国产模型都挂在同一个 Key 下Claude Code 里只配一个 Base URL 就行。具体接入方式在官方文档里有说明地址是 https://taotoken.net/api 配置逻辑和上面完全一致只是把ANTHROPIC_BASE_URL换成对应端点。保存文件后完全退出当前终端再重新打开让配置生效。下一步我们发一个真实请求验证。4. 发一次对话请求验证智谱模型是否生效配置改完不代表生效必须实际发一次请求。最直接的方式是进入 Claude Code 交互界面问一个能暴露模型身份的问题。重新打开终端进入任意项目目录输入claude进入交互界面后输入你是什么模型请用一句话回答并说明你的训练方。如果配置正确返回内容会体现智谱 GLM 的特征而不是 Anthropic 的 Claude。你也可以用非交互模式一次性验证claude -p 用 Python 写一个快速排序函数并解释时间复杂度-p参数表示单次提问后退出适合脚本化验证。正常返回代码和解释说明请求已经打到智谱端点。再做一个更严格的验证故意传一个不存在的模型 ID看报错信息里是否出现智谱相关的字样。比如临时把ANTHROPIC_DEFAULT_SONNET_MODEL改成glm-not-exist重启后提问如果报错提到模型不存在且来源是智谱端点说明 Base URL 已经生效。验证成功后你可以正常使用这些能力让 Claude Code 读当前目录的代码文件、生成单元测试、重构函数、解释报错。它和默认配置下的使用方式完全一样区别只是后端换成了国产模型。这里有个细节Claude Code 会在项目目录下维护会话上下文切换模型后建议新开一个会话避免旧上下文里的模型标识干扰。退出用/exit或 CtrlC。如果你在验证时遇到返回为空、卡住、或者报reading choices之类的解析错误先别怀疑配置写错大概率是模型 ID 和端点不匹配。下一节把常见报错逐个拆开。5. 常见报错排查401、local proxy failed 与 reading choices配置阶段最容易撞上的就是这几类报错我按出现频率排一下每个都给出定位路径。401 Unauthorized这是鉴权失败九成是 Key 的问题。先确认ANTHROPIC_AUTH_TOKEN填的是智谱开放平台的真实 Key不是占位符。然后检查 Key 是否过期、是否被禁用、额度是否用完。还有一个隐蔽原因Key 前后多了空格或换行JSON 里字符串带空格会导致鉴权失败。用下面命令检查文件内容cat ~/.claude/settings.json确认ANTHROPIC_AUTH_TOKEN的值干净。如果同时设了环境变量环境变量会覆盖文件配置用echo $ANTHROPIC_AUTH_TOKEN看看有没有旧值残留。local proxy failed / connection refused这类报错说明请求根本没发出去卡在本地网络层。常见原因是系统里还留着旧的代理环境变量比如ALL_PROXY、HTTPS_PROXY指向了一个已经关闭的本地端口。检查echo $ALL_PROXY echo $HTTPS_PROXY如果有值且端口没在监听清掉unset ALL_PROXY unset HTTPS_PROXYWindows 下在「环境变量」里删掉对应的用户变量重开终端。注意智谱端点是国内直连不需要任何代理留着反而添乱。reading choices / unexpected token这是响应解析失败通常是 Base URL 或模型 ID 不对。Claude Code 期望 Anthropic 格式的响应如果端点返回的是 OpenAI 格式就会在解析choices字段时报错。确认ANTHROPIC_BASE_URL填的是https://open.bigmodel.cn/api/anthropic结尾的/anthropic不能少。模型 ID 也要和智谱文档里的一致写错会返回错误结构。OAuth / login required如果 Claude Code 提示要登录 Anthropic 账号说明它没读到你的settings.json。检查文件路径是否正确、JSON 是否合法可以用在线 JSON 校验器过一遍、终端是否重启过。JSON 里多一个逗号都会导致整个文件被忽略。模型不生效还是走默认用claude --version确认客户端版本老版本可能不支持某些环境变量字段。另外确认没有多个settings.json冲突比如项目目录下也有一个.claude/settings.json项目级配置会覆盖用户级。排查顺序建议先看报错关键词401 查 Keyconnection 查代理choices 查端点login 查文件路径。大部分问题都能在这四步里定位。6. 长期使用与多模型管理的配置建议跑通之后日常使用还有几个优化点值得做。第一把配置纳入版本管理。settings.json里含 Key不要直接提交到公开仓库。可以建一个settings.example.json放模板真实文件加进.gitignore。团队协作时每人填自己的 Key。第二多模型切换用统一入口。如果你既用智谱又用其他国产模型每个都改settings.json很麻烦。TaoToken 的 API 通道可以把多个模型挂在同一个 Key 下Claude Code 里只配一个 Base URL切换模型只改模型 ID。接入文档在 https://taotoken.net/api 配置方式和本文一致。第三长期编码或跑 Agent 任务建议用 Coding Plan 这类套餐控制成本。终端 AI 助手的 token 消耗比网页对话高因为每次都要带上下文。你可以先在模型对话里试好提示词再放到 Claude Code 里跑批量任务。第四定期检查 Key 额度。智谱开放平台有用量面板设置告警阈值避免跑到一半额度耗尽导致 401。第五备份~/.claude/目录。里面除了settings.json还有会话历史和项目信任记录换机器时直接拷过去能省很多重新配置的时间。最后给一个实用技巧把常用验证命令写成脚本。比如check-claude.sh#!/bin/bash echo Node: $(node -v) echo Claude: $(claude --version) echo Base URL: $(grep ANTHROPIC_BASE_URL ~/.claude/settings.json) claude -p 回复 OK 表示连接正常每次改完配置跑一遍几秒钟就能确认环境是否健康。这套组合我用了几个月稳定性没问题关键是把配置一次写对后面基本不用再动。