1. 国内开发环境里 Claude Code 到底卡在哪Claude Code 是 Anthropic 推出的命令行智能体工具它和普通聊天式 AI 最大的区别在于它能直接读取你本地整个项目目录理解真实的代码结构然后执行多文件修改、跑测试、提交 git。对前端、后端、AI 应用开发者来说这相当于把一个能动手改代码的助手放进了终端。但国内开发者第一次装它几乎都会在同一个地方卡住——默认登录流程要求 Anthropic 账号而账号注册和网络访问这两道门槛让很多人还没摸到工具就放弃了。我试过的完整路径是这样的先用 Node.js 把运行环境铺好再用 CC-Switch 这个配置管理工具把模型供应商切到国内可用的 GLM最后在 VS Code 里把 Claude Code 跑起来。整条链路不需要碰 Anthropic 官方登录配置一次之后切换模型也就是点一下的事。这篇文章会把每一步的命令、配置文件片段、验证请求都写清楚你照着做就能在本地复现一套可用的环境。适合谁看已经在用 VS Code 写代码、想试试 CLI 智能体但被登录卡住的开发者手里有智谱 GLM API Key、想把它接进 Claude Code 的人以及需要频繁在多个模型供应商之间切换、不想每次手动改配置的团队。下面从 Node.js 开始一步步来。2. Node.js 与 CC-Switch 前置准备npm 全局安装报错怎么解Claude Code 本身是一个 npm 包所以第一步是把 Node.js 装好。Node.js 是基于 Chrome V8 引擎的 JavaScript 运行环境自带 npm 包管理器。去 nodejs.org 下载 LTS 版本Windows 下双击 msi 一路下一步即可安装完在终端输入node -v和npm -v能看到版本号就说明成功了。真正容易出问题的是 Windows 上的 PowerShell 执行策略。npm 在运行脚本时会调用.ps1文件而 PowerShell 默认策略是 Restricted会直接拦下来报错类似「无法加载文件因为在此系统上禁止运行脚本」。解决办法是改执行策略# 查看当前策略 Get-ExecutionPolicy # 改成 RemoteSigned本地脚本可运行远程脚本需签名 Set-ExecutionPolicy RemoteSigned -Scope CurrentUser # 确认修改生效 Get-ExecutionPolicy-Scope CurrentUser只影响当前用户不需要管理员权限比全局改更稳妥。改完再跑npm --version验证一下。接下来装 CC-Switch。它是一个跨平台桌面应用用来统一管理 Claude Code、Codex、Gemini CLI、OpenCode 这几个 CLI 工具的 API Provider、MCP 服务和 Skills 配置。核心价值就是解决「换模型要手动改一堆配置文件」的麻烦。去它的 GitHub Releases 页面下载对应系统的安装包Windows 选.msi双击安装选个非系统盘路径就行。装完 CC-Switch 先别急着配把 Claude Code 本体也装上npm install -g anthropic-ai/claude-code安装完成后输入claude能看到终端界面就说明 CLI 就位了。但这时候它还会要求登录 Anthropic 账号先别登我们走 CC-Switch 这条路绕过它。VS Code 的安装这里不展开官网下载安装即可重点是后面把 Claude Code 集成进去。3. 可复制配置CC-Switch 接入 GLM 与 settings.json 片段这一节是整篇的核心配置对了后面就顺了。先去智谱 AI 开放平台拿到 API Key登录后进控制台左侧菜单找「API Keys」点添加命名后复制那串 Key。格式大概是一长串字符保存好。打开 CC-Switch点「添加新的供应商」供应商类型选「Zhipu GLM」把刚才复制的 Key 粘进去。CC-Switch 会自动帮你写入 Claude Code 的配置文件。这里要理解它到底改了什么不然出问题没法排查。Claude Code 读取的配置在用户目录下的.claude/settings.jsonWindows 路径是C:\Users\你的用户名\.claude\settings.jsonmacOS/Linux 是~/.claude/settings.json。一个可用的 settings.json 结构长这样你可以直接对照检查{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: 你的API Key, ANTHROPIC_MODEL: glm-4.6, ANTHROPIC_SMALL_FAST_MODEL: glm-4.6 } }三个关键字段必须齐全也就是常说的三件套Base URL 指向请求入口Key 做鉴权Model ID 指定用哪个模型。少任何一个都会在请求时报错。如果你用 CC-Switch 的图形界面它会在你选完供应商后自动填好这些但建议你打开 settings.json 亲眼确认一遍尤其是 Model ID 有没有写对。CC-Switch 还支持配置 MCP 服务。MCP 是模型上下文协议让 Claude Code 能调用外部工具。在 CC-Switch 的 MCP 面板里可以添加服务配置会同步到 Claude Code 的 MCP 配置文件里。如果你暂时用不到外部工具这一步可以先跳过等基础对话跑通再加。配置写完后CC-Switch 界面上会显示当前激活的供应商。切换供应商就是在这里点一下它会重写 settings.json不用你手动改。这就是它比手动维护配置文件省事的地方。4. 验证请求在 VS Code 里跑通第一次对话配置写完必须验证不然你不知道是配置错了还是网络问题。最直接的方式是在终端里跑一次请求。打开终端确保当前目录是某个代码项目然后输入claude如果配置正确它会跳过 Anthropic 登录直接进入对话界面。输入一句「帮我看看当前目录下有哪些文件」看它能不能正常返回。能返回就说明 Base URL、Key、Model 三件套都通了。再进一步用 curl 直接打一次 API排除 CLI 层面的干扰curl https://taotoken.net/api/v1/messages \ -H Content-Type: application/json \ -H x-api-key: 你的API Key \ -H anthropic-version: 2023-06-01 \ -d { model: glm-4.6, max_tokens: 100, messages: [{role: user, content: 说一句你好}] }返回里能看到content字段和模型输出就证明请求链路完全通了。这一步能帮你区分问题出在 CLI 配置还是 API 本身。VS Code 集成方面Claude Code 装好后 VS Code 侧边栏会多出一个图标。点开它如果之前 CC-Switch 已经配好它会直接进入对话不再弹登录。你可以在 VS Code 里选中一段代码让 Claude Code 解释或重构它会读取当前文件上下文来回答。实测下来这种「编辑器 CLI 智能体」的组合比纯终端好用因为你能一边看代码一边让它改。验证通过后建议把这次成功的配置在 CC-Switch 里存成一个 profile以后换模型直接切 profile不用重新填 Key。5. 常见报错排查401、local proxy failed 与 reading choices配置过程中最容易撞上的几个报错这里逐个拆。401 UnauthorizedKey 错了或者没生效。先检查 settings.json 里的ANTHROPIC_AUTH_TOKEN有没有多余空格再确认这个 Key 在智谱平台是启用状态。如果 Key 没问题看 Base URL 是不是写成了带/v1的完整路径——有些配置要求 Base URL 只到域名路径由客户端自己拼写多了会 404 或 401。local proxy failed / connection refused通常是 Base URL 填错或者本地有残留的代理配置在拦截请求。检查环境变量里有没有HTTP_PROXY、HTTPS_PROXY这类设置有的话先清掉再试。另外确认ANTHROPIC_BASE_URL是https://taotoken.net/api不要自己加端口或路径。reading choices 报错这个一般出现在响应格式不符合预期时比如模型返回的不是标准 messages 结构。先确认 Model ID 写的是平台支持的模型名别写成gpt-4这种不存在的。如果 Model ID 对但还是报用第 4 节的 curl 单独测一次看原始返回是什么。OAuth 相关报错说明 Claude Code 还在尝试走官方登录流程没读到你的 settings.json。检查配置文件路径对不对Windows 是C:\Users\用户名\.claude\settings.json注意.claude前面有个点。文件不存在就手动建一个把第 3 节的 JSON 填进去。CC-Switch 切换后不生效CC-Switch 改的是同一个 settings.json切换后需要重启 Claude Code 进程才会重新读取。关掉终端重新claude一次即可。如果还不生效打开 settings.json 看内容有没有被正确写入。排查顺序建议先 curl 测 API通了再测 CLI最后测 VS Code 集成。这样能把问题范围一层层缩小不用瞎猜。6. 后续怎么用模型对话、Coding Plan 与接入文档环境跑通之后日常使用有几个方向可以深入。想快速验证某个模型效果可以直接用模型对话页面试不用每次都开终端。地址是 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 选好模型输入问题就能看返回适合对比不同模型的表现。如果你打算长期用 Claude Code 做编码和 Agent 任务Coding Plan 会更划算入口在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 适合高频调用场景。API Key 的管理和新建在控制台 https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 可以给不同项目建不同的 Key 方便追踪用量。完整的接入参数和字段说明看文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 遇到配置字段不确定时以文档为准。最后说个实用技巧把 settings.json 和 CC-Switch 的配置一起纳入你的 dotfiles 管理换电脑时直接同步过去省得重新配一遍。Model ID 会随平台更新隔段时间回文档确认一下当前可用的模型名避免因为模型下线导致请求失败。