KKCode文档站

Appearance

Claude Code Linux 使用指南 ​

1. 安装 Node.js ​

方式一：NodeSource 仓库（推荐） ​

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

方式二：系统包管理器 ​

bash
# Ubuntu / Debian
sudo apt update
sudo apt install -y nodejs npm

# Fedora / CentOS / RHEL
sudo dnf install -y nodejs npm

验证安装 ​

bash
node --version
npm --version

2. 安装 Claude Code ​

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

如遇权限问题：

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

3. 配置环境变量 ​

临时生效（当前 shell）：

bash
export ANTHROPIC_BASE_URL="https://www.kkcode.ai/api"
export ANTHROPIC_AUTH_TOKEN="你的API密钥"

永久生效（bash）：

bash
echo 'export ANTHROPIC_BASE_URL="https://www.kkcode.ai/api"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.bashrc
source ~/.bashrc

永久生效（zsh）：

bash
echo 'export ANTHROPIC_BASE_URL="https://www.kkcode.ai/api"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.zshrc
source ~/.zshrc

验证变量：

bash
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN

4. 开始使用 ​

bash
claude

在项目目录中使用：

bash
cd /path/to/your/project
claude

5. 常见问题 ​

npm 全局权限问题 ​

bash
npm config set prefix ~/.npm-global
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

缺少编译工具 ​

bash
# Ubuntu / Debian
sudo apt install -y build-essential

# Fedora / RHEL
sudo dnf groupinstall "Development Tools"