在 Linux 环境下，尤其是 Ubuntu 服务器中，Claude Code 的部署通常比 Windows 更稳定且依赖冲突更少。无论是云端生产环境还是本地开发，遵循以下流程即可快速构建可用的 AI 编程辅助工具。
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
部分操作可能需要 Git 支持：
sudo apt install -y git
4. 安装 Claude Code CLI
通过 npm 全局安装官方 CLI 工具：
npm install -g @anthropic-ai/claude-code
验证安装是否成功：
claude --version
5. 配置环境变量
这是核心步骤。需要在用户目录下创建配置文件以指定 API Key 及其他参数。
① 创建配置目录与文件
mkdir -p ~/.claude
nano ~/.claude/settings.json
② 编辑配置文件
将以下内容填入文件中，注意替换 ANTHROPIC_AUTH_TOKEN 为你自己的密钥。若使用代理或特定网关，可配置 ANTHROPIC_BASE_URL。
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "sk-your-api-key-here",
"ANTHROPIC_BASE_URL": "https://api.anthropic.com",
"API_TIMEOUT_MS": "3000000",
"ANTHROPIC_MODEL": "claude-3-5-sonnet-latest"
}
}
保存退出（Nano 编辑器按 Ctrl + O 回车保存，Ctrl + X 退出）。
③ 获取 API Key
请前往官方或授权平台注册账号并生成 API Token。在配置模型名称时，可根据实际支持的模型列表进行调整。
6. 首次运行
进入任意项目目录，直接执行命令即可启动交互模式：
claude
首次运行时会自动加载配置，看到命令行提示符后即可开始输入指令进行代码编写或分析。