Linux 安装指南

系统要求

• 发行版：Ubuntu 18.04+、Debian 10+、CentOS 8+、Fedora 32+、Arch Linux 等
• Node.js：18.0 或更高版本
• 磁盘空间：至少 200MB 可用空间

安装 Node.js

Ubuntu / Debian

# 使用 NodeSource 仓库安装
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

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

CentOS / RHEL / Fedora

# CentOS/RHEL
curl -fsSL https://rpm.nodesource.com/setup_20.x | sudo bash -
sudo yum install -y nodejs

# Fedora
sudo dnf install nodejs

Arch Linux

sudo pacman -S nodejs npm

使用 nvm（推荐，适用于所有发行版）

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

# 重新打开终端或运行
source ~/.bashrc  # 或 source ~/.zshrc

# 安装 Node.js
nvm install 20
nvm use 20
nvm alias default 20

安装 ClawdBot

使用 npm 全局安装：

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

如果遇到权限问题，不要使用 sudo。请使用以下方法修复 npm 权限：

# 创建 npm 全局目录
mkdir ~/.npm-global

# 配置 npm 使用新目录
npm config set prefix '~/.npm-global'

# 添加到 PATH（添加到 ~/.bashrc 或 ~/.zshrc）
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

# 重新安装
npm install -g @anthropic-ai/claude-code

验证安装

# 检查版本
claude --version

# 启动 ClawdBot
claude

常见问题

command not found: claude

确保 npm 全局目录在 PATH 中：

# 查看当前配置
npm config get prefix

# 将 bin 目录添加到 PATH
export PATH="$(npm config get prefix)/bin:$PATH"

EACCES 权限错误

不要使用 sudo 安装 npm 包。请使用上面的方法修复 npm 权限。

网络问题

如果下载速度慢，可以配置镜像：

npm config set registry https://registry.npmmirror.com

glibc 版本问题

如果你使用较旧的 Linux 发行版，可能需要更新 glibc。建议升级到较新版本的系统。

WSL 用户

在 WSL (Windows Subsystem for Linux) 中，按照本指南安装即可。建议使用 WSL 2 获得更好性能。