1. Ubuntu 20.04 上 claude-code 装不上、连不通到底卡在哪如果你在 Ubuntu 20.04 上敲npm install -g anthropic-ai/claude-code大概率会遇到两类问题一是系统里预装的 node 版本太老Ubuntu 20.04 默认源里还是 node 10 或 12npm 直接报引擎不兼容二是装完之后运行claude终端提示网络连接失败因为 claude-code 默认要连 Anthropic 官方端点而国内网络环境下这个请求走不通。这篇要解决的就是这条完整链路在 Ubuntu 20.04 上把 node 升到 22、用 npm 全局装好 claude-code、再通过 TaoToken 的统一 Key 把请求转发到 deepseek v4 pro最后用一条 curl 命令确认配置真的生效了。适合谁适合手里有一台 Ubuntu 20.04 开发机、想用 claude-code 这个终端 Agent 工具、但不想折腾网络环境、希望一个 Key 就能切换模型的开发者。我试过在一台老笔记本上从零走一遍踩的坑主要集中在 node 版本、npm 全局路径、以及 settings.json 和环境变量谁覆盖谁这三处。下面按顺序拆开讲每一步都给可复制的命令。2. 前置准备node 22 npm 全局目录 TaoToken 统一 Key2.1 先确认并清理旧 nodeUbuntu 20.04 自带的 node 版本通常低于 claude-code 要求的 V18。先看一眼node --version npm --version如果输出是 v10 或 v12 这种直接卸干净再装sudo apt remove --purge nodejs npm sudo apt autoremove2.2 用 NodeSource 装 node 22curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt-get install -y nodejs node --version npm --version正常会看到v22.x.x和10.x.x。node 版本这一步不能省低于 18 装 claude-code 会直接失败。2.3 配置 npm 全局目录避免 sudo 装包为了不每次装全局包都加 sudo把全局前缀指到用户目录mkdir -p ~/.npm-global npm config set prefix $HOME/.npm-global echo export PATH$HOME/.npm-global/bin:$PATH ~/.bashrc source ~/.bashrc2.4 拿 TaoToken 统一 KeyTaoToken 在这里的角色是一个统一的 API 通道你只需要在它那边生成一个 Keyclaude-code 通过这个 Key 把请求发出去后端再路由到 deepseek v4 pro。这样你就不用为每个模型单独维护一套环境变量。操作路径是登录官网 → 进控制台 → 创建 API Key。地址如下官网入口https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content控制台建 Keyhttps://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI Keys 管理页https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentKey 拿到后先放一边下一步配置要用。API 基础地址统一用https://taotoken.net/api这个地址不加任何查询参数。3. 可复制配置环境变量 settings.json 骨架 CC Switch 切换3.1 安装 claude-codenpm install -g anthropic-ai/claude-code claude --version能打印出版本号就说明装好了。3.2 环境变量写法claude-code 读取的是ANTHROPIC_前缀的几个变量。把 base url 指向 TaoTokentoken 填你刚建的 Keyecho export ANTHROPIC_BASE_URLhttps://taotoken.net/api ~/.bashrc echo export ANTHROPIC_AUTH_TOKENsk-你的TaoToken密钥 ~/.bashrc echo export ANTHROPIC_MODELdeepseek-v4-pro ~/.bashrc source ~/.bashrc注意ANTHROPIC_BASE_URL后面不要带斜杠也不要拼/v1之类的路径claude-code 会自己补。3.3 settings.json 骨架环境变量是全局的但 claude-code 还支持在~/.claude/settings.json里按模型档位分别指定。这样你可以主模型用便宜的 flashopus 档位用 pro兼顾成本和效果{ theme: dark, env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: sk-你的TaoToken密钥, ANTHROPIC_MODEL: deepseek-v4-flash, ANTHROPIC_DEFAULT_OPUS_MODEL: deepseek-v4-pro, ANTHROPIC_DEFAULT_SONNET_MODEL: deepseek-v4-flash, ANTHROPIC_DEFAULT_HAIKU_MODEL: deepseek-v4-flash } }用 nano 编辑nano ~/.claude/settings.json保存后退出。这里有个优先级要记住settings.json 里的env会覆盖 shell 里同名的环境变量。所以如果你两边都配了以 settings.json 为准。配好之后之前临时写进.bashrc的那几行可以按需删掉避免以后自己看混。3.4 CC Switch 切换动作claude-code 里切换模型不用改文件直接在会话里用斜杠命令/model会弹出一个列表列出 Default、Opus、Sonnet、Haiku 四个档位对应的实际模型。选一个回车即可这个切换只对当前会话生效。想让它成为新会话的默认在列表里按d键设为默认。如果你装了 CC Switch 这类配置切换工具它的作用就是帮你在多套 settings.json 之间快速切换比如一套指向 deepseek、一套指向别的模型。核心还是改~/.claude/settings.json里的env块工具只是把这个动作图形化了。4. 验证请求一条 curl 确认已指向 deepseek v4 pro配置写完别急着开对话先用 curl 打一发确认 Key 和地址是通的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: deepseek-v4-pro, max_tokens: 64, messages: [{role: user, content: 只回复两个字通了}] }返回体里能看到content字段带文字就说明通道没问题。如果返回 401是 Key 错了返回 404多半是 base url 拼错了路径。curl 通了之后启动 claude-codeclaude首次启动会让你选主题随便选一个。进去之后敲/model如果列表里显示的档位对应的是 deepseek-v4-pro 和 deepseek-v4-flash说明 settings.json 生效了。再随便问一句「帮我写个 hello world 的 python 函数」能正常流式返回整条链路就跑通了。5. 本篇常见错排查5.1 npm 报 engine 不兼容现象装 claude-code 时提示Unsupported engine要求 node 18。原因就是旧 node 没卸干净或者 PATH 里还指向老版本。用which node和node --version双重确认必要时重开一个终端。5.2 claude 命令找不到装完npm install -g后敲claude提示 command not found。九成是~/.npm-global/bin没进 PATH。检查echo $PATH | grep npm-global没有就重新source ~/.bashrc或者确认那行 export 写对了。5.3 运行 claude 报网络错误如果 base url 还是默认的 Anthropic 官方地址国内环境会连不上。确认ANTHROPIC_BASE_URL已经改成https://taotoken.net/api并且 settings.json 里没有把它覆盖回官方地址。5.4 模型没生效还是默认模型最常见的原因是 settings.json 和环境变量冲突。记住 settings.json 优先级更高。用cat ~/.claude/settings.json看一眼实际内容再在会话里/model核对。改完 settings.json 要重启 claude 才生效。5.5 401 / 403 鉴权失败Key 复制时带了空格或者用了别的平台的 Key。TaoToken 的 Key 以sk-开头重新去 API Keys 页面复制一次注意别把换行符带进去。6. 后续怎么用模型对话、Coding Plan 与接入文档链路跑通之后日常使用分几个方向。想快速验证某个模型回答质量直接开模型对话页面试模型对话https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content如果你打算把 claude-code 长期当编码助手用或者要接 Agent 跑自动化任务建议看 Coding Plan按用量规划比单次调用更划算Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content接入过程中遇到参数、路径、鉴权细节问题直接翻接入文档里面把 base url、请求头、模型名都列清楚了接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content另外如果你用的是 ClaudeCodeAnthropic 这套兼容协议配置方式和本篇一致参考ClaudeCodeAnthropichttps://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content最后给个实用建议把~/.claude/settings.json纳入你的 dotfiles 管理换机器时直接同步过去省得每次重配。Key 别硬编码进 git 仓库用环境变量注入或者本地单独存一份。