安装配置

系统要求

项目	要求
操作系统	Windows 10+、macOS 10.15+、Ubuntu 20.04+ / Debian 10+
Node.js	18.0 或更高版本
磁盘空间	至少 2GB 可用空间
内存	建议 4GB 以上

提示

Windows 用户可直接使用 PowerShell 或 CMD，无需安装 WSL2。

---

第一步：安装 Node.js

Windows

方法一：官方安装包（推荐）

1. 访问 Node.js 官网 下载 LTS 版本的 Windows 安装包（.msi 文件）

2. 双击运行安装程序，按提示完成安装

   • 选择安装路径（建议保持默认）
   • 务必勾选 “Add to PATH”

3. 打开 PowerShell 或 CMD，验证安装：

   node --version
   npm --version

方法二：使用 Winget

winget install OpenJS.NodeJS

方法三：使用 Chocolatey

# 安装 Chocolatey（如果未安装，需管理员权限）
Set-ExecutionPolicy Bypass -Scope Process -Force
[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072
iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))

# 安装 Node.js
choco install nodejs

macOS

方法一：使用 Homebrew（推荐）

1. 安装 Xcode 命令行工具和 Homebrew：

   sudo xcode-select --install
   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. 安装 Node.js：

   brew install node

3. 验证安装：

   node --version
   npm --version

方法二：官方安装包

访问 Node.js 官网 下载 macOS 安装包（.pkg 文件），双击安装即可。

Linux

Ubuntu / Debian

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

CentOS / RHEL / Fedora

curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash -
sudo yum install -y nodejs
node --version

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

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

注意

确保 Node.js 版本 ≥ 18.0，运行 node --version 检查。

---

第二步：安装 Claude Code

Windows

打开 PowerShell 或 CMD：

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

macOS

打开 终端：

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

Linux

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

警告

如果提示权限错误，使用 sudo npm install -g @anthropic-ai/claude-code，或通过 nvm 管理 Node.js 以避免权限问题。

提示

如果之前安装过其他中转客户端 CLI，建议先卸载以避免端口冲突：

npm ls -g @anthropic-ai/claude-code   # 检查是否已安装
npm uninstall -g @anthropic-ai/claude-code  # 卸载

---

第三步：配置环境变量

你需要从中转站获取以下认证信息：

• API 地址（ANTHROPIC_BASE_URL）：中转站的 API 服务地址
• Auth Token（ANTHROPIC_AUTH_TOKEN）：在中转站 cc 分组中创建的 Key

1. 登录你的中转站后台
2. 进入 令牌 / API Key 管理页面
3. 点击 创建令牌，分组选择 cc（Claude Code 专用分组）
4. 复制生成的 Key，即为 ANTHROPIC_AUTH_TOKEN 的值

警告

请确保选择 cc 分组创建 Key，其他分组的 Key 可能无法正常使用 Claude Code。

临时配置（当前会话有效）

Windows CMD

set ANTHROPIC_BASE_URL=https://api-key.info
set ANTHROPIC_AUTH_TOKEN=apikey
cd your-project-folder
claude

Windows PowerShell

$env:ANTHROPIC_BASE_URL = "https://api-key.info"
$env:ANTHROPIC_AUTH_TOKEN = "apikey"
cd your-project-folder
claude

macOS / Linux

export ANTHROPIC_BASE_URL="https://api-key.info"
export ANTHROPIC_AUTH_TOKEN="apikey"
cd your-project-folder
claude

永久配置（推荐）

Windows

方法一：通过系统属性

1. 右键点击 此电脑 → 属性 → 高级系统设置
2. 点击 环境变量
3. 在”用户变量”中点击 新建，分别添加：
   • 变量名 ANTHROPIC_BASE_URL，值为你的 API 地址
   • 变量名 ANTHROPIC_AUTH_TOKEN，值为你的 Token
4. 点击 确定 保存，重启终端生效

方法二：通过 PowerShell

# 为当前用户永久设置
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api-key.info", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "apikey", "User")

# 验证
[Environment]::GetEnvironmentVariable("ANTHROPIC_BASE_URL", "User")

macOS

将环境变量写入 shell 配置文件（macOS 默认使用 Zsh）：

echo 'export ANTHROPIC_BASE_URL="https://api-key.info"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="apikey"' >> ~/.zshrc
source ~/.zshrc

Linux

# Bash 用户
echo 'export ANTHROPIC_BASE_URL="https://api-key.info"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="apikey"' >> ~/.bashrc
source ~/.bashrc

# Zsh 用户
echo 'export ANTHROPIC_BASE_URL="https://api-key.info"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="apikey"' >> ~/.zshrc
source ~/.zshrc

永久配置完成后，以后只需在项目目录中运行 claude 即可启动。

---

第四步：首次启动

cd your-project-folder
claude

按照提示依次完成：

1. 选择你喜欢的 主题
2. 确认 安全须知
3. 使用默认 Terminal 配置
4. 信任工作目录

完成后即可开始与 Claude 对话！

---

VS Code 插件配置

新版 Claude Code VS Code 插件要求强制登录，可通过创建配置文件解决：

macOS / Linux

mkdir -p ~/.claude && touch ~/.claude/config.json
nano ~/.claude/config.json

Windows CMD

mkdir %USERPROFILE%\.claude
echo. > %USERPROFILE%\.claude\config.json
notepad %USERPROFILE%\.claude\config.json

Windows PowerShell

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.claude"
New-Item -ItemType File -Force -Path "$env:USERPROFILE\.claude\config.json"
notepad "$env:USERPROFILE\.claude\config.json"

写入以下内容并保存：

{
  "primaryApiKey": "apikey"
}

保存后重启 VS Code，插件即可正常使用。

---

配置文件说明

CLAUDE.md

在项目根目录创建 CLAUDE.md 文件，为 Claude 提供项目级指令：

# 项目说明

- 这是一个 React + TypeScript 项目
- 使用 pnpm 作为包管理器
- 测试命令: pnpm test
- 构建命令: pnpm build

配置层级

层级	路径	用途
全局	~/.claude/CLAUDE.md	个人全局偏好
项目	项目根目录/CLAUDE.md	项目级指令（可提交到 Git）
本地	项目根目录/.claude/CLAUDE.md	本地私有指令（不提交）

---

常见问题

node 命令无法识别

Windows

# 检查 PATH
echo $env:PATH

# 手动添加（临时）
$env:PATH += ";C:\Program Files\nodejs"

建议重新安装 Node.js 并确保勾选 Add to PATH。

macOS / Linux

which node

# 如果使用 nvm
source ~/.bashrc
nvm use --lts

npm 安装速度慢

# 切换国内镜像源
npm config set registry https://registry.npmmirror.com

# 恢复官方源
npm config set registry https://registry.npmjs.org

PowerShell 执行策略限制（Windows）

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

防火墙阻止连接（Windows）

1. 打开 Windows 防火墙设置
2. 点击”允许应用或功能通过 Windows 防火墙”
3. 找到 Node.js 并勾选”专用”和”公用”网络

---

验证配置

Windows CMD

echo %ANTHROPIC_BASE_URL%
echo %ANTHROPIC_AUTH_TOKEN%
claude --version

Windows PowerShell

echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN
claude --version

macOS / Linux

echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN
claude --version

输出正确的环境变量值和版本号，说明一切就绪！

---

推荐终端工具

Windows

建议安装 Windows Terminal 获得更好的体验：

winget install Microsoft.WindowsTerminal

macOS

推荐使用 iTerm2 或系统自带终端。

Linux

系统自带终端即可，或安装 Alacritty、Kitty 等现代终端。

下一步

安装完成后，前往 基本用法 了解如何高效使用 Claude Code。