Claude Code 在 Linux(Ubuntu) 上的完整安装部署指南

✅ 逐步安装命令（复制即用）

以下步骤适用于 Ubuntu 20.04 / 22.04 / 24.04（云服务器、本地桌面版均可）。

步骤 1：更新系统环境（强烈建议先执行）

sudo apt update && sudo apt upgrade -y

步骤 2：安装 Node.js

推荐使用 NodeSource 官方源安装最新 LTS。

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

检查版本：

node -v
npm -v

步骤 3：安装 Git

sudo apt install -y git
git --version

步骤 4：安装 Claude Code CLI

npm install -g @anthropic-ai/claude-code

检查是否安装成功：

claude --version

步骤 5：配置 Claude Code 的环境变量（核心步骤）

① 打开配置文件

mkdir -p ~/.claude
nano ~/.claude/settings.json

② 填写 Claude Code 配置

请将 API Key 替换成自己的，并根据实际使用的服务调整 ANTHROPIC_BASE_URL。

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-xxx",
    "ANTHROPIC_BASE_URL": "https://api.anthropic.com",
    "API_TIMEOUT_MS": "3000000",
    "ANTHROPIC_MODEL": "claude-3-5-sonnet-latest"
  }
}

保存：Ctrl + O → 回车，退出：Ctrl + X

③ 获取 API Key

请前往您的 AI 服务提供商控制台注册账号并创建 API Token。确保拥有足够的额度以支持模型调用。

步骤 6：首次运行 Claude Code（本地模式）

在任意项目目录执行：

claude

第一次运行会自动加载模型配置，看到命令行提示符即可开始使用。

✅ 总结

至此，Claude Code 在 Ubuntu 环境下的完整部署流程已经结束。从系统更新、依赖安装、CLI 部署到配置 settings.json，你已经具备在 Linux 系统中独立运行 Claude Code 的全部能力。无论是在云服务器进行长期后台运行，还是在本地桌面版执行即时开发，都能获得稳定可靠的体验。后续可进一步实践 VSCode Remote、Docker 化部署等进阶玩法，构建高效的 AI 开发体系。