Claude Code 本地教程

Linux/WSL2 教程

本教程将指导你在 Linux 或 WSL2 系统上安装和配置 Claude Code。

1. 安装 Node.js 环境

Claude Code 需要 Node.js 环境才能运行。

版本要求

Claude Code 要求的 Node.js 版本 ≥ 18.0，最好使用 v20 或更高版本。

Linux 安装方法

方法一：使用官方仓库（推荐）

bash
# 添加 NodeSource 仓库
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -

# 安装 Node.js
sudo apt-get install -y nodejs

方法二：使用系统包管理器

虽然版本可能不是最新的，但对于基本使用已经足够：

Ubuntu/Debian：

bash
sudo apt update
sudo apt install nodejs npm

CentOS/RHEL/Fedora：

bash
sudo dnf install nodejs npm

Linux 注意事项

  • 某些发行版可能需要安装额外的依赖
  • 如果遇到权限问题，使用 sudo
  • 确保你的用户在 npm 的全局目录有写权限

验证安装是否成功

安装完成后，打开终端，输入以下命令：

bash
node --version
npm --version

如果显示版本号，说明安装成功了！

2. 安装 Claude Code

安装 Claude Code

打开终端，运行以下命令：

bash
# 全局安装 Claude Code
npm install -g @anthropic-ai/claude-code

如果遇到权限问题，可以使用 sudo：

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

验证 Claude Code 安装

安装完成后，输入以下命令检查是否安装成功：

bash
claude --version

如果显示版本号，恭喜你！Claude Code 已经成功安装了。

3. 设置环境变量

配置 Claude Code 环境变量

为了让 Claude Code 连接到你的中转服务，需要设置两个环境变量：

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

在终端中运行以下命令：

bash
export ANTHROPIC_BASE_URL="你的apiUrl". (你的apiUrl:导航栏->我的->账户信息概览->Claude Code 配置)
export ANTHROPIC_AUTH_TOKEN="你的API密钥" (你的API密钥:导航栏->我的->账户信息概览->Claude Code 配置)

注意

记得将 "你的API密钥" 替换为在 "API Keys" 标签页中创建的实际密钥。

方法二：永久设置

编辑你的 shell 配置文件：

对于 bash（默认）：

bash
echo 'export ANTHROPIC_BASE_URL="你的apiUrl"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.bashrc
source ~/.bashrc

对于 zsh：

bash
echo 'export ANTHROPIC_BASE_URL="你的apiUrl"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.zshrc
source ~/.zshrc

提示

设置后环境变量会在新打开的终端窗口中自动生效。

4. 开始使用 Claude Code

现在你可以开始使用 Claude Code 了！

启动 Claude Code

在终端中直接运行：

bash
claude

在特定项目中使用

bash
# 进入你的项目目录
cd /path/to/your/project

# 启动 Claude Code
claude

提示

  • 确保已经设置好环境变量后再启动 Claude Code
  • 如果使用永久设置，记得重新打开终端窗口或执行 source ~/.bashrc（或 source ~/.zshrc）
  • 首次启动可能需要一些时间来初始化

WSL2 特别说明

如果你在 Windows 上使用 WSL2：

  1. WSL2 中的 Linux 环境与 Windows 是隔离的
  2. 环境变量需要在 WSL2 的 Linux 环境中设置
  3. 可以通过 /mnt/c/ 访问 Windows 文件系统
  4. 建议在 WSL2 中使用 Linux 原生工具链

下一步

现在你已经完成了 Claude Code 的安装和配置，可以开始使用了！如果遇到问题，请查看常见问题。