Linux 安装指南

系统要求

• Linux 发行版（Ubuntu、Debian、CentOS、Fedora、Arch Linux等）
• Bash 或 Zsh shell
• curl 工具
• 稳定的网络连接

安装步骤

1. 安装 Node.js

使用 nvm（推荐）

nvm 提供简单的 Node.js 版本管理：

# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash

# 重新加载 shell 配置
source ~/.bashrc

# 如果使用 zsh
source ~/.zshrc

# 配置镜像加速下载（可选，建议中国用户使用）
nvm node_mirror https://npmmirror.com/mirrors/node/
nvm npm_mirror https://npmmirror.com/mirrors/npm/

# 安装并使用 Node.js 20
nvm install 20
nvm use 20

# 设为默认版本
nvm alias default 20

# 配置 npm 镜像加速
npm config set registry https://registry.npmmirror.com

# 验证安装
node --version
npm --version

或使用系统包管理器

直接通过包管理器安装：

# Ubuntu/Debian
sudo apt update
sudo apt install nodejs npm

# CentOS/RHEL/Fedora
sudo dnf install nodejs npm

# Arch Linux
sudo pacman -S nodejs npm

# 配置 npm 镜像加速
npm config set registry https://registry.npmmirror.com

2. 安装 Claude Code

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

如遇权限问题：

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

3. 获取 API 密钥

在配置环境变量之前，您需要先获取API密钥：

1. 访问 AI网关
2. 注册账户并登录
3. 访问 令牌页面 生成您的API密钥

4. 配置环境变量

使用您在AI网关获取的API密钥来配置环境：

临时设置（当前会话）

export ANTHROPIC_AUTH_TOKEN="你的API密钥"
export ANTHROPIC_BASE_URL="https://ai-router.plugins-world.cn"

永久设置（推荐）

# 添加到 Bash 配置文件
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.bashrc
echo 'export ANTHROPIC_BASE_URL="https://ai-router.plugins-world.cn"' >> ~/.bashrc

# 如果使用 Zsh
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.zshrc
echo 'export ANTHROPIC_BASE_URL="https://ai-router.plugins-world.cn"' >> ~/.zshrc

# 重新加载配置
source ~/.bashrc  # 或 ~/.zshrc

5. 验证安装

# 检查版本
claude --version

# 启动 Claude Code
claude

常见问题

权限问题

# 使用 sudo 安装
sudo npm install -g @anthropic-ai/claude-code

# 或配置 npm 用户目录
npm config set prefix ~/.npm-global
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

缺少依赖库

# Ubuntu/Debian
sudo apt install build-essential

# CentOS/RHEL/Fedora
sudo dnf groupinstall "Development Tools"

# Arch Linux
sudo pacman -S base-devel

nvm 命令不存在

# 重新加载配置文件
source ~/.bashrc  # 或 ~/.zshrc
# 或重新打开终端

npm 安装速度慢

# 确认使用了镜像加速
npm config get registry

# 如果未设置，手动配置
npm config set registry https://registry.npmmirror.com