安装教程
在 Windows、macOS、Linux 系统上安装和配置 Claude Code
安装教程¶
跟着这个教程，你可以轻松在自己的电脑上安装并使用 Claude Code。整个过程只需要 5 分钟。
前置要求¶
Claude Code 需要 Node.js 环境才能运行。请确保你的电脑已安装 Node.js 18.0 或更高版本。
Windows 系统¶
步骤 1：安装 Node.js¶
方法一：官网下载（推荐）¶
- 打开浏览器，访问 https://nodejs.org/
- 点击 "LTS" 版本下载（推荐的长期支持版本）
- 下载完成后双击
.msi文件 - 按照安装向导，使用默认设置完成安装
方法二：使用包管理器¶
如果你已经安装了 Chocolatey 或 Scoop：
# 使用 Chocolatey
choco install nodejs
# 或使用 Scoop
scoop install nodejs
验证安装¶
安装完成后，打开 PowerShell 或 CMD，输入以下命令：
node --version
npm --version
如果显示版本号，说明安装成功了！
步骤 2：安装 Claude Code¶
打开 PowerShell 或 CMD，运行：
npm install -g @anthropic-ai/claude-code
验证安装：
claude --version
步骤 3：设置环境变量¶
临时设置（当前会话）¶
在 PowerShell 中运行：
$env:ANTHROPIC_BASE_URL = "https://asia.qcode.cc/api"
$env:ANTHROPIC_AUTH_TOKEN = "your-api-key"
永久设置（推荐）¶
设置用户级环境变量：
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://asia.qcode.cc/api", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "your-api-key", [System.EnvironmentVariableTarget]::User)
记得将
your-api-key替换为在 QCode.cc 控制台 中创建的实际密钥。
验证设置¶
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN
步骤 4：开始使用¶
# 进入你的项目目录
cd C:\path\to\your\project
# 启动 Claude Code
claude
Windows 常见问题¶
权限错误？
- 以管理员身份运行 PowerShell
- 或配置 npm 使用用户目录：npm config set prefix %APPDATA%\npm
PowerShell 执行策略错误？
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
环境变量不生效？ - 设置永久环境变量后重启 PowerShell 或 CMD - 或注销并重新登录 Windows
macOS 系统¶
步骤 1：安装 Node.js¶
方法一：使用 Homebrew（推荐）¶
如果你已经安装了 Homebrew：
# 更新 Homebrew
brew update
# 安装 Node.js
brew install node
方法二：官网下载¶
- 访问 https://nodejs.org/
- 下载 macOS 的 LTS 版本
- 打开下载的
.pkg文件 - 按照安装说明完成安装
验证安装¶
node --version
npm --version
步骤 2：安装 Claude Code¶
npm install -g @anthropic-ai/claude-code
如果遇到权限问题，使用 sudo：
sudo npm install -g @anthropic-ai/claude-code
验证安装：
claude --version
步骤 3：设置环境变量¶
临时设置（当前会话）¶
export ANTHROPIC_BASE_URL="https://asia.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="your-api-key"
永久设置（推荐）¶
编辑你的 shell 配置文件：
# 对于 zsh（macOS 默认）
echo 'export ANTHROPIC_BASE_URL="https://asia.qcode.cc/api"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="your-api-key"' >> ~/.zshrc
source ~/.zshrc
# 对于 bash
echo 'export ANTHROPIC_BASE_URL="https://asia.qcode.cc/api"' >> ~/.bash_profile
echo 'export ANTHROPIC_AUTH_TOKEN="your-api-key"' >> ~/.bash_profile
source ~/.bash_profile
记得将
your-api-key替换为在 QCode.cc 控制台 中创建的实际密钥。
步骤 4：开始使用¶
# 进入你的项目目录
cd /path/to/your/project
# 启动 Claude Code
claude
macOS 常见问题¶
权限错误？
- 使用 sudo 安装：sudo npm install -g @anthropic-ai/claude-code
- 或配置 npm 使用用户目录：npm config set prefix ~/.npm-global
系统阻止执行？ - 打开 "系统偏好设置" → "安全性与隐私" - 点击 "仍要打开" 或 "允许"
Linux / WSL2 系统¶
步骤 1：安装 Node.js¶
方法一：使用 NodeSource 官方仓库（推荐）¶
# 添加 NodeSource 仓库
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
# 安装 Node.js
sudo apt-get install -y nodejs
方法二：使用系统包管理器¶
# Ubuntu/Debian
sudo apt update
sudo apt install nodejs npm
# CentOS/RHEL/Fedora
sudo dnf install nodejs npm
验证安装¶
node --version
npm --version
步骤 2：安装 Claude Code¶
npm install -g @anthropic-ai/claude-code
如果遇到权限问题：
sudo npm install -g @anthropic-ai/claude-code
验证安装：
claude --version
步骤 3：设置环境变量¶
临时设置¶
export ANTHROPIC_BASE_URL="https://asia.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="your-api-key"
永久设置¶
# 对于 bash（默认）
echo 'export ANTHROPIC_BASE_URL="https://asia.qcode.cc/api"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="your-api-key"' >> ~/.bashrc
source ~/.bashrc
# 对于 zsh
echo 'export ANTHROPIC_BASE_URL="https://asia.qcode.cc/api"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="your-api-key"' >> ~/.zshrc
source ~/.zshrc
步骤 4：开始使用¶
cd /path/to/your/project
claude
Linux 常见问题¶
缺少依赖库？
# Ubuntu/Debian
sudo apt install build-essential
# CentOS/RHEL
sudo dnf groupinstall "Development Tools"
下一步¶
恭喜！你已经成功安装了 Claude Code。接下来：