Step 1: 安装 Node.js 环境

方法一：使用 nvm 安装（推荐）

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install --lts

方法二：Debian/Ubuntu

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

NOTE

WSL 用户说明

• 确保已安装 WSL2（推荐 Ubuntu 发行版）
• 推荐使用 nvm 方式安装，避免权限问题

TIP

验证安装是否成功

node --version
npm --version

Step 2: 安装 Claude Code

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

TIP

验证 Claude Code 安装

claude --version

Step 3: 设置环境变量

方法一：临时设置（当前会话）

export ANTHROPIC_BASE_URL="https://api.bsf.ai"
export ANTHROPIC_AUTH_TOKEN="your_api_key"

方法二：bash 永久设置（推荐）

echo '' >> ~/.bashrc
echo '# API config' >> ~/.bashrc
echo 'export ANTHROPIC_BASE_URL="https://api.bsf.ai"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="your_api_key"' >> ~/.bashrc
source ~/.bashrc

方法三：zsh 永久设置

echo 'export ANTHROPIC_BASE_URL="https://api.bsf.ai"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="your_api_key"' >> ~/.zshrc
source ~/.zshrc

TIP

验证环境变量设置

echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN

Step 4: 开始使用

claude

常见问题

问题：npm 权限错误 (EACCES)

mkdir ~/.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

问题：WSL 中访问 Windows 文件

# Windows 文件系统挂载在 /mnt/ 下
cd /mnt/c/Users/YourName/

# 建议在 WSL 原生文件系统中工作
cd ~