Claude 安装指导：Ubuntu 下 npm 环境变量与 cc-switch 配置 TaoToken 全流程

1. Ubuntu 上装完 Claude Code 却卡在配置先把场景理清如果你在 Ubuntu 上敲完npm install -g anthropic-ai/claude-code终端里能跑出claude --version但一启动就提示区域不支持、或者每次换项目都要手动改一遍 Key 和 Base URL那这篇就是写给你的。Claude Code 本身是个命令行编码助手能读你当前目录的代码、按自然语言改文件、跑测试适合习惯在终端里干活的后端、运维和全栈同学。它默认走 Anthropic 官方通道但国内直连经常连不上而且官方订阅每月约 20 美元对只想先跑通流程的人不友好。我试过在 Ubuntu 22.04 和 24.04 上反复装踩过的坑集中在三块npm 全局路径没进 PATH、环境变量写错文件、以及多套配置之间来回切太麻烦。cc-switch 就是来解决第三块的——它是个配置切换器能把不同供应商的 Key、Base URL、模型名存成多套 profile一键切换。配合 TaoToken 的统一 Key/API 通道你只需要维护一个 Key就能在 Claude Code 里稳定调用。下面按「装 npm → 装 Claude Code → 装 cc-switch → 写配置 → 验证 → 排障」的顺序走一遍命令都能直接复制。2. 前置准备TaoToken 的 Key 与 API 通道怎么拿在动 Claude Code 之前先把通道准备好。TaoToken 在这里扮演的是统一入口你拿到一个 Key配好 Base URLClaude Code 就把它当成 Anthropic 兼容端点来用不用再为每个模型单独申请账号。适合想快速验证、又不想被地区限制卡住的人。第一步打开控制台创建 API Key。地址是https://taotoken.net/console登录后在 API Keys 页面新建一个复制出来形如sk-xxxx的字符串先存到记事本里后面要填进配置文件。注意这个 Key 只显示一次丢了就重新建。第二步确认你要用的模型名。TaoToken 的模型对话页面https://taotoken.net/models里能看到当前可用的模型标识比如glm-4.7这类。Claude Code 的配置里要填ANTHROPIC_DEFAULT_HAIKU_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL等字段把它们统一指向你选的模型即可。第三步记下 API 端点。Base URL 用https://taotoken.net/api注意这里不带任何查询参数直接填这个根路径。如果你后面要写进settings.json或config.toml也是这个值。提示Key 和 Base URL 是两回事Key 放ANTHROPIC_AUTH_TOKENBase URL 放ANTHROPIC_BASE_URL别填反了填反的典型报错是 401 或连接被拒。3. 可复制配置npm 环境变量、settings.json 与 config.toml 骨架3.1 装 npm 并确认全局路径Ubuntu 上先装 npm。用 apt 装最省事sudo apt update sudo apt install -y npm npm version如果npm version报 command not found说明 PATH 没配好。检查一下which npm echo $PATH正常应该输出/usr/bin/npm之类。如果 npm 装在/usr/local/bin但 PATH 里没有编辑~/.bashrc追加一行export PATH/usr/local/bin:$PATH source ~/.bashrc3.2 安装 Claude Codenpm install -g anthropic-ai/claude-code claude --version能打印版本号就说明装好了。如果提示权限不足别用 sudo 硬装先修 npm 全局目录权限mkdir -p ~/.npm-global npm config set prefix ~/.npm-global export PATH$HOME/.npm-global/bin:$PATH source ~/.bashrc npm install -g anthropic-ai/claude-code3.3 安装 cc-switchcc-switch 提供 deb 包去它的 releases 页面下载 Linux 版本然后sudo apt install ./CC-Switch-*.deb装完在应用列表里能找到它命令行也可以直接调。它的作用是管理多套配置 profile你可以在 GUI 里切也可以改它背后的配置文件。3.4 写 settings.json 骨架Claude Code 读取的配置在~/.config/claude/claude.json部分版本是settings.json路径以你本机为准。骨架如下把 Key 和模型名替换成你自己的{ env: { ANTHROPIC_AUTH_TOKEN: sk-你的TaoToken密钥, ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_DEFAULT_HAIKU_MODEL: glm-4.7, ANTHROPIC_DEFAULT_OPUS_MODEL: glm-4.7, ANTHROPIC_DEFAULT_SONNET_MODEL: glm-4.7, ANTHROPIC_MODEL: glm-4.7, ANTHROPIC_REASONING_MODEL: glm-4.7, CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: 1 }, permissions: { allow: [], deny: [] }, hasCompletedOnboarding: true }hasCompletedOnboarding这个字段很关键它跳过首次启动的引导和区域校验。如果你重启后还提示区域不对先回来确认这行在不在。3.5 config.toml 骨架cc-switch 侧cc-switch 用 TOML 存 profile典型结构长这样[[profiles]] name taotoken base_url https://taotoken.net/api api_key sk-你的TaoToken密钥 model glm-4.7 [[profiles]] name backup base_url https://taotoken.net/api api_key sk-另一个密钥 model glm-4.7保存后在 cc-switch 界面里选中taotoken这套它会自动把对应值写进 Claude Code 读的配置。这样你就不用每次手动改 JSON 了。4. 验证请求切换配置后怎么确认真的连通配置写完别急着写代码先验证。第一步重启 Claude Code让它重新读配置claude进去后随便问一句比如「列出当前目录的文件」。如果它能正常返回说明通道通了。更直接的验证是看环境变量有没有被正确加载claude --print-env | grep ANTHROPIC预期能看到ANTHROPIC_BASE_URLhttps://taotoken.net/api和你的模型名。如果 Base URL 是空的说明配置文件路径不对Claude Code 没读到。第二步用 curl 直接打一次 API排除 Claude Code 本身的干扰curl -s https://taotoken.net/api/v1/messages \ -H x-api-key: sk-你的TaoToken密钥 \ -H anthropic-version: 2023-06-01 \ -H content-type: application/json \ -d {model:glm-4.7,max_tokens:64,messages:[{role:user,content:ping}]}预期返回一段 JSON里面有content字段和模型回复。如果返回 401检查 Key返回 404检查 Base URL 后面有没有多写/v1返回超时检查网络能不能到taotoken.net。第三步在 cc-switch 里切到另一套 profile再跑一次上面的 curl确认切换生效。两套配置返回的模型名不同就说明切换链路是通的。5. 本篇常见错排查从 npm 到 cc-switch 的坑报错一claude: command not found。九成是 npm 全局 bin 没进 PATH。跑npm config get prefix看路径然后把它下面的bin加进~/.bashrcsource一下。报错二启动提示区域不支持。先确认hasCompletedOnboarding为true再确认ANTHROPIC_BASE_URL指向的是https://taotoken.net/api而不是官方地址。两个都对还报错就把~/.config/claude/下的缓存清掉重来。报错三401 Unauthorized。Key 错了或者没生效。用第 4 节的 curl 单独测 Key能通就是 Claude Code 配置没读到检查文件路径和 JSON 语法少个逗号也会整份失效。报错四cc-switch 切换后没反应。它写的是它自己那份配置Claude Code 读的是另一份。确认 cc-switch 的输出路径和 Claude Code 的读取路径一致不一致就在 cc-switch 设置里改指向。报错五模型名填错导致 400。ANTHROPIC_DEFAULT_*_MODEL这几个字段要填 TaoToken 支持的模型标识去模型对话页面核对别凭记忆写。注意改完任何配置文件都要重启 Claude Code它不会热加载。重启命令就是退出再claude。6. 接下来怎么走按你的目标选入口如果你只是想把 Claude Code 跑起来、验证模型能不能用直接去模型对话页面https://taotoken.net/models试几条 prompt确认返回质量符合预期再回到终端里干活。如果你打算长期在 Ubuntu 上用 Claude Code 写代码、跑 Agent 任务建议把 cc-switch 的多 profile 用起来一套主用、一套备用Key 轮换时不用改代码。长期编码场景可以直接看 Coding Planhttps://taotoken.net/coding-plan里面有针对持续调用的额度方案。接入过程中如果 Key 或端点出问题先去 API Keys 页面https://taotoken.net/api-keys重新生成一个再对照接入文档https://taotoken.net/doc核对字段名。文档里对ANTHROPIC_*系列变量的说明最全排障时比翻博客快。