1. 为什么要在 Linux 服务器上跑 Claude CodeClaude Code 是 Anthropic 推出的终端 AI 编程助手它不是一个网页聊天框而是直接跑在你项目目录里的命令行工具能读文件、改代码、执行命令。对经常在 Linux 服务器上写代码的人来说把它装在远程主机上再用本地 VS Code 通过 SSH 连过去就能实现「本地编辑、远程运行」的顺手体验代码和依赖都在服务器上AI 也在服务器上干活本地只负责显示和敲键盘。但真动手时坑往往不在 Claude Code 本身而在环境Node.js 版本不对、nvm 没加载、全局包装到了另一个 Node 版本下、API 通道没配好导致claude一启动就报鉴权错误。这篇就按「Linux 装 Claude Code → 接入 TaoToken 统一 API 通道 → VS Code SSH 远程访问 → 验证请求成功」这条线走一遍每一步都给可复制的命令和配置骨架目标是你照着敲完能在远程 Linux 主机上跑通 Claude Code 并确认 API 调用正常。适合谁看手上有一台 Linux 服务器云主机、实验室机器、公司开发机都行平时用 VS Code想把这套 AI 编程流程固定下来的人。全程在普通用户下操作不建议用 root 装避免后面权限和路径一团乱。2. 前置准备Node.js 环境与 TaoToken 通道Claude Code 是 npm 包所以第一件事是把 Node.js 装对。我建议用 nvm 管理版本因为 Claude Code 对 Node 版本有要求用 nvm 切换最省心。先确认你当前 shell 里没有 conda 的 base 环境干扰有的话先退出conda deactivate然后一次性把 nvm 装好并加载。下面这段可以整段复制执行export NVM_DIR$HOME/.nvm if [ ! -s $NVM_DIR/nvm.sh ]; then curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash fi source $NVM_DIR/nvm.sh nvm --version如果curl提示 command not found换成 wgetwget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bashnvm 加载成功后装 Node.js 24 并设为默认nvm install 24 nvm use 24 nvm alias default 24 node --version npm --version which node正常会看到v24.x.x和对应的 npm 版本。这里有个容易忽略的点nvm 的全局 npm 包是按 Node 版本分开存的。如果你之前用 Node 22 装过 Claude Code切到 24 后要重新装一遍否则claude命令可能找不到。接着装 GitDebian/Ubuntu 系一条命令sudo apt-get install -y git git --version然后装 Claude Code 本体npm install -g anthropic-ai/claude-code claude --version能打印出版本号说明 CLI 装好了。接下来是接入 TaoToken 统一 API 通道。TaoToken 提供兼容 Anthropic 接口的调用方式你需要在控制台创建一个 API Key然后把它写进环境变量。先拿 Key访问 TaoToken API Keys 页面新建一个令牌并复制出来。注意API Key 只显示一次复制后妥善保存不要提交到 Git 仓库里。3. 可复制配置settings.json 与 config.toml 骨架环境变量和配置文件分两层一层是 shell 级别的环境变量让claude命令知道往哪发请求另一层是 Claude Code 自己的配置文件方便 VS Code 远程会话读取。先配 shell 环境变量编辑~/.bashrcvim ~/.bashrc在文件末尾追加下面几行把 token 换成你自己的export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_AUTH_TOKENsk-你的TaoToken密钥 export ANTHROPIC_MODELclaude-sonnet-4-5保存退出后让它生效source ~/.bashrc echo $ANTHROPIC_BASE_URLANTHROPIC_BASE_URL指向 TaoToken 的 API 地址ANTHROPIC_AUTH_TOKEN放你的密钥ANTHROPIC_MODEL指定默认模型。模型名按你账号里可用的填不确定就先留一个通用款后面在对话里也能切。然后是 Claude Code 的配置文件。创建目录并写入settings.jsonmkdir -p ~/.claude vim ~/.claude/settings.json内容骨架如下{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: sk-你的TaoToken密钥, ANTHROPIC_MODEL: claude-sonnet-4-5 }, permissions: { allow: [], deny: [] } }如果你更习惯用 TOML 风格的配置部分工具链会读config.toml可以再放一份[env] ANTHROPIC_BASE_URL https://taotoken.net/api ANTHROPIC_AUTH_TOKEN sk-你的TaoToken密钥 ANTHROPIC_MODEL claude-sonnet-4-5两个文件里的密钥保持一致。permissions先留空等实际用起来再按需放开别一上来就全允许。配置项作用示例值ANTHROPIC_BASE_URLAPI 请求地址https://taotoken.net/apiANTHROPIC_AUTH_TOKEN鉴权密钥sk-xxxxANTHROPIC_MODEL默认模型claude-sonnet-4-5settings.jsonClaude Code 读取的配置~/.claude/settings.json配完这些Claude Code 就知道该走 TaoToken 通道了。想确认通道和模型是否可用可以先用 TaoToken 模型对话 发一条消息试试能正常回复说明 Key 和通道没问题再回到终端跑 CLI。4. VS Code SSH 远程连接与验证请求本地 VS Code 装好 Remote - SSH 扩展后按F1输入Remote-SSH: Connect to Host填你的服务器地址例如user192.168.1.10。首次连接会写~/.ssh/config建议手动补一段更清晰的配置Host myserver HostName 192.168.1.10 User yourname Port 22 IdentityFile ~/.ssh/id_rsa连上后VS Code 左下角会显示SSH: myserver此时打开的终端就是远程服务器的 shell。因为环境变量写在~/.bashrc里远程终端会自动加载claude命令可以直接用。在 VS Code 的远程终端里启动 Claude Codecd ~/your-project claude第一次启动会做一些初始化然后进入交互界面。你可以直接问一句「这个项目是做什么的」如果它能读取目录并给出回答说明 API 调用已经通了。想更明确地验证请求可以在项目里让它执行一个只读操作比如claude -p 列出当前目录下的文件并说明用途-p是一次性执行模式适合脚本化验证。返回正常文本就说明从 Linux 主机到 TaoToken 的整条链路是通的。如果你打算长期在服务器上跑编码任务或 Agent 流程可以了解下 TaoToken Coding Plan按用量规划更省心。接入过程中遇到鉴权或路径问题对照 接入文档 排查会快很多。5. 本篇常见报错排查报错一claude: command not found多半是 nvm 没加载或者全局包装在了另一个 Node 版本下。先执行export NVM_DIR$HOME/.nvm source $NVM_DIR/nvm.sh nvm use 24 which claude如果which claude为空重新装一次npm install -g anthropic-ai/claude-code。报错二启动后提示鉴权失败或 401检查ANTHROPIC_AUTH_TOKEN是否复制完整有没有多余空格。用下面命令确认echo $ANTHROPIC_AUTH_TOKEN | head -c 10再确认ANTHROPIC_BASE_URL是https://taotoken.net/api不要多写斜杠或路径。报错三VS Code 远程终端里环境变量不生效VS Code 的远程终端默认读~/.bashrc但如果你用的是 zsh就要写进~/.zshrc。确认当前 shellecho $SHELL然后对应修改配置文件并source一次。报错四nvm: command not found每次重连都出现说明 nvm 的加载语句没写进 shell 配置。把这两行加到~/.bashrc末尾export NVM_DIR$HOME/.nvm [ -s $NVM_DIR/nvm.sh ] \. $NVM_DIR/nvm.sh报错五模型名不被识别ANTHROPIC_MODEL填的模型要在你账号可用范围内。不确定就先删掉这一行让 Claude Code 用默认模型跑通后再指定。排查时记住一个顺序先确认node和claude命令能找到再确认环境变量最后确认网络请求。大部分问题都出在前两步。6. 把这条链路固定下来跑通之后建议把~/.bashrc里的环境变量和~/.claude/settings.json当成项目基础设施来维护换服务器时直接复制这两处即可。密钥不要硬编码进项目仓库用环境变量或单独的配置文件管理。VS Code 这边把常用的 SSH Host 写进~/.ssh/config以后一键连接远程终端里claude随开随用。如果你还想在浏览器里快速验证模型效果TaoToken 模型对话 是个轻量入口需要新建或轮换密钥时去 API Keys 操作。整套流程的核心就一句话Node 装对、环境变量配对、SSH 连上剩下的交给 Claude Code 在服务器上干活。