Claude Code 在 Linux(Ubuntu) 上的完整安装部署指南（npm安装）-171主机测评

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

前言

许多用户的生产环境是 Ubuntu。无论你是做后端、DevOps、AI 研发还是自建云端环境，Linux(Ubuntu) 才是最主流、最可靠、最干净的部署系统。

相比 Windows，Linux 的优势：

环境更纯净，依赖冲突更少
更适合长时间运行和自动化脚本
云服务器多数为 Ubuntu/Debian
利于 Docker 协作

步骤 1：更新系统环境

适用于 Ubuntu 20.04/22.04/24.04。

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

步骤 4：安装 Claude Code CLI

通过 npm 全局安装：

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

验证安装：

claude –version

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

创建配置文件目录

mkdir -p ~/.claude

编辑 settings.json

nano ~/.claude/settings.json

配置内容示例

{
"env": {
"ANTHROPIC_AUTH_TOKEN": "your-api-key-here",
"ANTHROPIC_BASE_URL": "https://api.anthropic.com",
"API_TIMEOUT_MS": "600000",
"ANTHROPIC_MODEL": "claude-sonnet-4-6"
}
}

将 ANTHROPIC_AUTH_TOKEN 替换为自己的 API Key。
保存：Ctrl+O → Enter；退出：Ctrl+X。

步骤 6：首次运行

在任意项目目录执行：

claude

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

总结

完成以上步骤后，你已经完成了从系统更新、依赖安装、CLI 部署到配置 settings.json 的全套部署流程。无论是在云服务器还是本地桌面环境，都可以顺利使用 Claude Code。

进阶方向

VSCode Remote 远程开发集成
Docker 容器化部署
自动化安装脚本

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