Linux保姆级教程 | 手把手教你部署Claude Code，终端编程起飞！

1. 为什么要在 Linux 终端里跑 Claude Code如果你平时写代码主要靠 SSH 连服务器或者习惯在 tmux 里开好几个窗口来回切那 Claude Code 这种能在终端里直接读项目、改文件、跑命令的 AI 编程助手会比网页版顺手很多。它不是一个简单的聊天框而是一个能理解你当前目录结构、能帮你执行 shell 命令的智能体。你可以在项目根目录敲一句“帮我看看这个报错”它会自己去翻日志、定位文件、给出修改方案甚至直接动手改。这篇教程面向刚接触终端编程的开发者目标很明确在 Linux 环境下把 Claude Code 完整跑起来。我会从 Node.js 环境准备开始一路写到 settings.json 和 config.toml 的骨架配置最后给出终端启动和连通性验证的具体动作。整个过程你都可以直接复制命令跟做不需要提前懂太多底层原理。需要提前说明的是Claude Code 本身是一个客户端工具它需要调用大模型 API 才能工作。国内开发者直接连官方接口往往会遇到网络和支付上的麻烦所以我会用 TaoToken 作为 API 接入层来演示配置。TaoToken 提供兼容 Anthropic 协议的接口你只需要把 base_url 和 key 填对Claude Code 就能正常对话和写代码。官网地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 后面配置里会反复用到它的 API 地址。2. 前置准备Node.js、NPM 与 TaoToken 接入信息Claude Code 是基于 Node.js 运行的所以第一步是把 Node 环境装好。官方要求 Node.js 版本大于等于 18我建议直接上 20.x 或 22.x兼容性更稳。如果你用的是 Ubuntu 20.04 以上或者 CentOS 8 以上下面的命令可以直接跑。先更新系统包并安装必要依赖sudo apt update sudo apt upgrade -y sudo apt install -y curl wget gnupg ca-certificates接着添加 NodeSource 仓库并安装 Node.js 20.xcurl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - sudo apt install -y nodejs装完后一定要验证版本这一步别跳过node -v npm -v正常输出类似v20.19.4和10.9.2。如果 node 命令找不到说明仓库没配好回头检查上一条 curl 命令有没有报错。Node 就绪后去 TaoToken 控制台创建一个 API Key。地址是 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 登录后点新建密钥复制那串以sk-开头的字符串。这个 Key 就是你后面填进配置文件里的凭证不要泄露到公开仓库。TaoToken 的 API 基础地址是https://taotoken.net/api注意这个地址后面不加任何 UTM 参数配置时原样填入即可。它兼容 Anthropic 的接口格式所以 Claude Code 不需要额外改代码只要把环境变量指向它就行。3. 安装 Claude Code 并写第一份 settings.json安装 Claude Code 有两种方式我推荐用 NPM 全局安装因为路径管理更清晰升级也方便。npm install -g anthropic-ai/claude-code如果下载速度慢可以临时指定国内镜像源npm install -g anthropic-ai/claude-code --registryhttps://registry.npmmirror.com装完后验证claude --version能输出版本号就说明二进制已经就位。如果提示command not found多半是 npm 全局 bin 目录没进 PATH可以用npm config get prefix看一下路径然后把它加到~/.bashrc里。接下来创建配置目录和 settings.jsonmkdir -p ~/.claude vim ~/.claude/settings.json把下面这份骨架配置写进去注意把sk-你的TaoToken密钥替换成你刚才复制的真实 Key{ env: { ANTHROPIC_AUTH_TOKEN: sk-你的TaoToken密钥, ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_MODEL: claude-sonnet-4-20250514 } }这里解释一下三个字段。ANTHROPIC_AUTH_TOKEN放你的 TaoToken KeyANTHROPIC_BASE_URL指向 TaoToken 的 API 入口这样请求就不会打到官方地址ANTHROPIC_MODEL指定默认模型你可以根据 TaoToken 控制台里支持的模型列表来换。写完后保存退出。还有一份 config.toml 用来控制客户端行为路径在~/.claude/config.toml。如果你之前没这个文件新建一个vim ~/.claude/config.toml写入以下内容[core] hasCompletedOnboarding true theme dark [permissions] allow_file_write true allow_shell_exec falsehasCompletedOnboarding true的作用是跳过首次启动的引导流程直接进终端界面。allow_shell_exec我先设成 false意思是 AI 可以改文件但不能自动执行 shell 命令等你熟悉了再打开避免误操作。4. 启动 Claude Code 并验证连通性配置写完后进入你的项目目录启动cd ~/my-project claude如果一切正常你会看到终端里出现一个带输入框的交互界面。这时候先别急着让它改代码做一次连通性验证在输入框里敲一句“你好请用一句话介绍你自己”回车。如果配置正确几秒内就会返回模型回复。如果卡住不动或者报错说明 API 链路有问题先看下一节的排查清单。验证通过后建议立刻执行一个初始化命令/init这个命令会让 Claude Code 扫描当前项目结构生成一个CLAUDE.md记忆文件。之后每次对话它都会读取这个文件记住你的项目规范、目录约定和技术栈。你可以手动编辑CLAUDE.md写上“不要修改 test 目录”“提交信息用 feat: 前缀”这类规则团队协作时把它提交到 Git 仓库所有人共享同一套 AI 开发规范。再试一个实际动作让它读一个文件并解释请阅读 src/main.py用三句话说明它的主要逻辑不要修改任何文件。观察它是否能正确读取文件内容并给出回答。这一步能同时验证文件读取权限和模型响应是否正常。5. 本篇常见报错与排查清单报错一command not found: claude这是 PATH 问题。NPM 全局安装的二进制通常在$(npm config get prefix)/bin下。执行export PATH$(npm config get prefix)/bin:$PATH echo export PATH$(npm config get prefix)/bin:$PATH ~/.bashrc source ~/.bashrc然后重新敲claude --version验证。报错二启动后一直转圈没有回复先检查~/.claude/settings.json的 JSON 格式是否合法多一个逗号都会导致解析失败。可以用python3 -m json.tool ~/.claude/settings.json来校验。确认ANTHROPIC_BASE_URL填的是https://taotoken.net/api末尾不要带斜杠。然后确认 Key 没有多余空格。报错三ERR_BAD_REQUEST或 401通常是 Key 无效或额度不足。去 TaoToken 控制台 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 检查密钥状态和余额。如果刚创建 Key等一两分钟再试有时候有缓存延迟。报错四低配服务器安装到一半卡死1G 或 2G 内存的机器在 npm 安装时容易 OOM。先加一个 2G 的 swapsudo fallocate -l 2G /swapfile sudo chmod 600 /swapfile sudo mkswap /swapfile sudo swapon /swapfile然后重新执行安装命令。装完后可以用sudo swapoff /swapfile关掉但低配机器建议长期保留。报错五对话变长后响应很慢输入/compact让客户端压缩上下文或者/clear直接清空重开。长期项目建议定期用/init更新CLAUDE.md把重要约定固化下来减少每次对话的上下文负担。6. 把终端编程工作流固定下来跑通之后你可以把 Claude Code 嵌进日常开发习惯里。我的做法是在项目根目录放一个CLAUDE.md里面写清楚构建命令、测试命令、代码风格和禁止事项。每次开新会话它都会先读这个文件省去重复交代背景的功夫。如果你需要长期在多个项目里高频使用可以了解一下 TaoToken 的 Coding Plan地址是 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 它针对编码场景做了额度优化比按量计费更适合每天写代码的人。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 里面列出了兼容的模型和参数说明换模型时对照着改ANTHROPIC_MODEL就行。终端编程的爽点在于你不用离开键盘就能完成读代码、改代码、跑测试的闭环。Claude Code 把这个闭环里的 AI 部分补上了而 TaoToken 解决了国内访问和支付的最后一公里。先把上面这份配置跑通后面再慢慢调权限和模型工作流会越来越顺。