Linux 是开发者最主流的工作环境之一，Claude Code 完全支持所有主流发行版。本文覆盖从桌面 Ubuntu 到无 GUI 服务器的完整安装流程。
系统要求
| 要求 | 最低版本 |
|---|---|
| Node.js | 18.x 或更高 |
| npm | 8.x 或更高 |
| 内存 | 4GB（推荐 8GB+） |
| 网络 | 需要访问 claude.ai 或 API |
Ubuntu / Debian 安装
Step 1：安装 Node.js
bash
# 推荐使用 NodeSource 官方仓库（保证版本最新）
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs
# 验证版本
node --version # 应显示 v22.x.x
npm --version # 应显示 10.x.x或使用 nvm（推荐，方便切换版本）：
bash
# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc # 或 ~/.zshrc
# 安装最新 LTS Node.js
nvm install --lts
nvm use --ltsStep 2：安装 Claude Code
bash
npm install -g @anthropic-ai/claude-code
# 验证安装
claude --versionStep 3：首次登录
bash
claude
# 按提示在浏览器完成 OAuth 授权
# 无 GUI 服务器见下方「服务器安装」章节CentOS / RHEL / Fedora 安装
bash
# CentOS/RHEL 8+
curl -fsSL https://rpm.nodesource.com/setup_22.x | sudo bash -
sudo dnf install -y nodejs
# Fedora
sudo dnf install -y nodejs npm
# 安装 Claude Code
npm install -g @anthropic-ai/claude-codeArch Linux / Manjaro 安装
bash
# Arch 自带较新的 Node.js
sudo pacman -S nodejs npm
# 安装 Claude Code
npm install -g @anthropic-ai/claude-code权限问题解决（无 sudo 安装）
如果遇到 EACCES: permission denied 错误：
bash
# 方法一：配置 npm 全局目录到用户空间（推荐）
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
# 重新安装
npm install -g @anthropic-ai/claude-code
# 方法二：使用 nvm（自动避免权限问题）
# 见上方 nvm 安装步骤服务器 / 无 GUI 环境安装
无浏览器的服务器需要用 API Key 登录，不能用 OAuth：
bash
# 设置 API Key 环境变量
export ANTHROPIC_API_KEY="sk-ant-你的密钥"
# 写入 .bashrc 持久化
echo 'export ANTHROPIC_API_KEY="sk-ant-你的密钥"' >> ~/.bashrc
# 直接使用（非交互模式）
claude -p "帮我分析这个文件" < myfile.py
# 或启动交互模式（终端内，无需浏览器）
claudeWSL2（Windows 子系统 Linux）
WSL2 环境下安装与 Ubuntu 相同，但需要注意：
bash
# WSL2 里安装（与 Ubuntu 相同步骤）
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs
npm install -g @anthropic-ai/claude-code
# WSL2 特有：文件路径
# 推荐在 WSL 文件系统内工作（~/ 或 /home/user/）
# 不推荐在 /mnt/c/... 路径下使用（IO 很慢）
cd ~/projects/my-project
claudeDocker 容器内安装
dockerfile
FROM node:22-slim
# 安装 Claude Code
RUN npm install -g @anthropic-ai/claude-code
# 设置 API Key（通过环境变量传入，不要硬编码）
ENV ANTHROPIC_API_KEY=""
WORKDIR /workspacebash
docker run -it -e ANTHROPIC_API_KEY="$ANTHROPIC_API_KEY" -v $(pwd):/workspace my-claude-image claude常见报错解决
报错：node: /lib/x86_64-linux-gnu/libc.so.6: version GLIBC_2.28 not found
系统 glibc 版本太低（CentOS 7 常见）：
bash
# 解决方案：用 nvm 安装兼容版本的 Node.js
nvm install 18
nvm use 18
npm install -g @anthropic-ai/claude-code报错：npm WARN notsup Unsupported engine
bash
# 检查 Node.js 版本
node --version
# 必须是 18+，升级方法见上方报错：ECONNREFUSED 或网络错误
bash
# 检查是否需要代理
export HTTPS_PROXY="http://your-proxy:port"
npm install -g @anthropic-ai/claude-code
# 或配置 npm 代理
npm config set proxy http://your-proxy:port
npm config set https-proxy http://your-proxy:port报错：claude: command not found（安装后找不到）
bash
# 检查全局 npm bin 路径
npm bin -g
# 把该路径加入 PATH
echo 'export PATH="$(npm bin -g):$PATH"' >> ~/.bashrc
source ~/.bashrc验证安装成功
bash
# 版本检查
claude --version
# 简单测试
echo "print('hello world')" | claude -p "解释这段代码"
# 完整功能测试（在项目目录）
cd ~/my-project
claude来源：Claude Code Setup - Anthropic 官方文档