1
安装 Node.js 环境
Claude Code 需要 Node.js 环境才能运行。
Windows 安装方法
方法一：官网下载（推荐）
-
打开浏览器访问
https://nodejs.org/
- 点击 "LTS" 版本进行下载（推荐长期支持版本）
-
下载完成后双击
.msi
文件
- 按照安装向导完成安装，保持默认设置即可
方法二：使用包管理器
如果你安装了 Chocolatey 或 Scoop，可以使用命令行安装：
# 使用 Chocolatey
choco install nodejs
# 或使用 Scoop
scoop install nodejs
Windows 注意事项
- • 建议使用 PowerShell 而不是 CMD
- • 如果遇到权限问题，尝试以管理员身份运行
- • 某些杀毒软件可能会误报，需要添加白名单
验证安装是否成功
安装完成后，打开 PowerShell 或 CMD，输入以下命令：
node --version
npm --version
如果显示版本号，说明安装成功了！
2
安装 Claude Code
安装 Claude Code
打开 PowerShell 或 CMD，运行以下命令：
# 全局安装 Claude Code
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
这个命令会从 npm 官方仓库下载并安装最新版本的 Claude Code。
提示
- • 建议使用 PowerShell 而不是 CMD，功能更强大
- • 如果遇到权限问题，以管理员身份运行 PowerShell
验证 Claude Code 安装
安装完成后，输入以下命令检查是否安装成功：
如果显示版本号，恭喜你！Claude Code 已经成功安装了。
3
设置环境变量
配置 Claude Code 环境变量
为了让 Claude Code 连接到你的中转服务，需要设置两个环境变量：
方法一：PowerShell 临时设置（当前会话）
在 PowerShell 中运行以下命令：
$env:ANTHROPIC_BASE_URL = ""
$env:ANTHROPIC_AUTH_TOKEN = "你的API密钥"
💡 记得将 "你的API密钥" 替换为在上方 "API Keys" 标签页中创建的实际密钥。
方法二：PowerShell 永久设置（用户级）
在 PowerShell 中运行以下命令设置用户级环境变量：
# 设置用户级环境变量（永久生效）
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN",
"你的API密钥", [System.EnvironmentVariableTarget]::User)
查看已设置的环境变量：
# 查看用户级环境变量
[System.Environment]::GetEnvironmentVariable("ANTHROPIC_BASE_URL",
[System.EnvironmentVariableTarget]::User)
[System.Environment]::GetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN",
[System.EnvironmentVariableTarget]::User)
💡 设置后需要重新打开 PowerShell 窗口才能生效。
🚀 如果你在后台添加了 Droid 类型账号，请将上述命令中的
VSCode Claude 插件配置
如果使用 VSCode 的 Claude 插件，需要在配置文件中进行设置：
配置文件位置：
C:\Users\你的用户名\.claude\config.json
💡 如果该文件不存在，请手动创建。
{
"primaryApiKey": "你的API密钥"
}
验证环境变量设置
设置完环境变量后，可以通过以下命令验证是否设置成功：
在 PowerShell 中验证：
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN
在 CMD 中验证：
echo %ANTHROPIC_BASE_URL%
echo %ANTHROPIC_AUTH_TOKEN%
预期输出示例：
💡 如果输出为空或显示变量名本身，说明环境变量设置失败，请重新设置。
配置 Gemini CLI 环境变量
如果你使用 Gemini CLI，需要设置以下环境变量：
PowerShell 设置方法
在 PowerShell 中运行以下命令：
$env:CODE_ASSIST_ENDPOINT = ""
$env:GOOGLE_CLOUD_ACCESS_TOKEN = "你的API密钥"
$env:GOOGLE_GENAI_USE_GCA = "true"
💡 使用与 Claude Code 相同的 API 密钥即可。
PowerShell 永久设置（用户级）
在 PowerShell 中运行以下命令：
# 设置用户级环境变量（永久生效）
[System.Environment]::SetEnvironmentVariable("CODE_ASSIST_ENDPOINT", "", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("GOOGLE_CLOUD_ACCESS_TOKEN",
"你的API密钥", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("GOOGLE_GENAI_USE_GCA", "true",
[System.EnvironmentVariableTarget]::User)
💡 设置后需要重新打开 PowerShell 窗口才能生效。
验证 Gemini CLI 环境变量
在 PowerShell 中验证：
echo $env:CODE_ASSIST_ENDPOINT
echo $env:GOOGLE_CLOUD_ACCESS_TOKEN
echo $env:GOOGLE_GENAI_USE_GCA
配置 Codex 环境变量
如果你使用支持 OpenAI API 的工具（如 Codex），需要设置以下环境变量：
Codex 配置文件
在
~/.codex/config.toml
文件开头添加以下配置：
[openai]
base_url = ""
[model]
name = "claude-3-5-sonnet-20241022"
🚀 如果你要使用 Droid 类型账号池，请把配置中的
在
~/.codex/auth.json
文件中配置API密钥：
{
"openai_api_key": null
}
💡 将 OPENAI_API_KEY 设置为 null，然后设置环境变量 CRS_OAI_KEY 为您的 API
密钥（格式如 cr_xxxxxxxxxx）。
环境变量设置方法
Windows:
set CRS_OAI_KEY=cr_xxxxxxxxxx
配置 Droid CLI
Droid CLI 使用
~/.factory/config.json
保存自定义模型；在 Windows 中可直接编辑
C:\Users\你的用户名\.factory\config.json。
配置文件示例
将以下内容追加到配置文件中，并替换示例中的域名和 API 密钥：
{
"customModels": {
"relay-claude-sonnet-3-5": {
"endpoint": "",
"key": "cr_your_api_key_here",
"model": "claude-3-5-sonnet-20241022"
}
}
}
💡 在 Droid CLI 中选择自定义模型即可使用新的 Droid
账号池；确保服务地址可被本地访问。
4
开始使用 Claude Code
现在你可以开始使用 Claude Code 了！
在特定项目中使用
# 进入你的项目目录
cd C:\path\to\your\project
# 启动 Claude Code
claude
Windows 常见问题解决
安装时提示 "permission denied" 错误
这通常是权限问题，尝试以下解决方法：
- 以管理员身份运行 PowerShell
-
或者配置 npm 使用用户目录：
npm config set prefix %APPDATA%\npm
PowerShell 执行策略错误
如果遇到执行策略限制，运行：
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
环境变量设置后不生效
设置永久环境变量后需要：
- 重新启动 PowerShell 或 CMD
- 或者注销并重新登录 Windows
-
验证设置：
echo $env:ANTHROPIC_BASE_URL
1
安装 Node.js 环境
Claude Code 需要 Node.js 环境才能运行。
macOS 安装方法
方法一:使用 Homebrew(推荐)
如果你已经安装了 Homebrew,使用它安装 Node.js 会更方便:
# 更新 Homebrew
brew update
# 安装 Node.js
brew install node
方法二:官网下载
-
访问
https://nodejs.org/
- 下载适合 macOS 的 LTS 版本
-
打开下载的
.pkg
文件
- 按照安装程序指引完成安装
macOS 注意事项
- • 如果遇到权限问题,可能需要使用 sudo
- • 首次运行可能需要在系统偏好设置中允许
- • 建议使用 Terminal 或 iTerm2
验证安装是否成功
安装完成后,打开 Terminal,输入以下命令:
node --version
npm --version
如果显示版本号,说明安装成功了!
2
安装 Claude Code
安装 Claude Code
打开 Terminal,运行以下命令:
# 全局安装 Claude Code
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
如果遇到权限问题,可以使用 sudo:
sudo npm install -g @anthropic-ai/claude-code
验证 Claude Code 安装
安装完成后,输入以下命令检查是否安装成功:
如果显示版本号,恭喜你!Claude Code 已经成功安装了。
3
设置环境变量
配置 Claude Code 环境变量
为了让 Claude Code 连接到你的中转服务,需要设置两个环境变量:
方法一:临时设置(当前会话)
在 Terminal 中运行以下命令:
export ANTHROPIC_BASE_URL=""
export ANTHROPIC_AUTH_TOKEN="你的API密钥"
💡 记得将 "你的API密钥" 替换为在上方 "API Keys" 标签页中创建的实际密钥。
方法二:永久设置
编辑你的 shell 配置文件(根据你使用的 shell):
# 对于 zsh (默认)
echo 'export ANTHROPIC_BASE_URL=""' >>
~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.zshrc
source ~/.zshrc
# 对于 bash
echo 'export ANTHROPIC_BASE_URL=""' >>
~/.bash_profile
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.bash_profile
source ~/.bash_profile
🚀 如果你在后台添加了 Droid 类型账号,请将上述命令中的
验证环境变量设置
设置完环境变量后，可以通过以下命令验证是否设置成功：
在 Terminal 中验证：
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN
预期输出示例：
💡 如果输出为空或显示变量名本身，说明环境变量设置失败，请重新设置。
配置 Codex 环境变量
如果你使用支持 OpenAI API 的工具(如 Codex),需要设置以下环境变量:
Codex 配置文件
在
~/.codex/config.toml
文件开头添加以下配置:
[openai]
base_url = ""
[model]
name = "claude-3-5-sonnet-20241022"
🚀 如果你要使用 Droid 类型账号池,请把配置中的
在
~/.codex/auth.json
文件中配置API密钥:
{
"openai_api_key": null
}
💡 将 OPENAI_API_KEY 设置为 null,然后设置环境变量 CRS_OAI_KEY 为您的 API
密钥(格式如 cr_xxxxxxxxxx)。
环境变量设置方法
macOS:
export CRS_OAI_KEY=cr_xxxxxxxxxx
Shell 配置文件(持久保存):
添加到您的 shell 配置文件中:
# 对于 zsh (默认)
echo "export CRS_OAI_KEY=cr_xxxxxxxxxx" >> ~/.zshrc
source ~/.zshrc
# 对于 bash
echo "export CRS_OAI_KEY=cr_xxxxxxxxxx" >> ~/.bash_profile
source ~/.bash_profile
配置 Droid CLI
Droid CLI 使用
~/.factory/config.json
保存自定义模型;你可以在 Finder 中按
⌘ + Shift + G
并输入路径,或运行
open ~/.factory
快速打开配置目录。
配置文件示例
将以下内容追加到配置文件中,并替换示例中的域名和 API 密钥:
{
"customModels": {
"relay-claude-sonnet-3-5": {
"endpoint": "",
"key": "cr_your_api_key_here",
"model": "claude-3-5-sonnet-20241022"
}
}
}
💡 在 Droid CLI 中选择自定义模型即可使用新的 Droid
账号池;确保服务地址可被本地访问。
VSCode Claude 插件配置
如果使用 VSCode 的 Claude 插件,需要在配置文件中进行设置:
配置文件位置:
~/.claude/config.json
💡 如果该文件不存在,请手动创建。
{
"primaryApiKey": "你的API密钥"
}
配置 Gemini CLI 环境变量
如果你使用 Gemini CLI,需要设置以下环境变量:
Terminal 设置方法
在 Terminal 中运行以下命令:
export CODE_ASSIST_ENDPOINT=""
export GOOGLE_CLOUD_ACCESS_TOKEN="你的API密钥"
export GOOGLE_GENAI_USE_GCA="true"
💡 使用与 Claude Code 相同的 API 密钥即可。
永久设置
添加到你的 shell 配置文件:
# 对于 zsh (默认)
echo 'export CODE_ASSIST_ENDPOINT=""' >> ~/.zshrc
echo 'export GOOGLE_CLOUD_ACCESS_TOKEN="你的API密钥"' >> ~/.zshrc
echo 'export GOOGLE_GENAI_USE_GCA="true"' >> ~/.zshrc
source ~/.zshrc
# 对于 bash
echo 'export CODE_ASSIST_ENDPOINT=""' >> ~/.bash_profile
echo 'export GOOGLE_CLOUD_ACCESS_TOKEN="你的API密钥"' >> ~/.bash_profile
echo 'export GOOGLE_GENAI_USE_GCA="true"' >> ~/.bash_profile
source ~/.bash_profile
验证 Gemini CLI 环境变量
在 Terminal 中验证:
echo $CODE_ASSIST_ENDPOINT
echo $GOOGLE_CLOUD_ACCESS_TOKEN
echo $GOOGLE_GENAI_USE_GCA
配置 Codex 环境变量
如果你使用支持 OpenAI API 的工具(如 Codex),需要设置以下环境变量:
Codex 配置文件
在
~/.codex/config.toml
文件开头添加以下配置:
[openai]
base_url = ""
[model]
name = "claude-3-5-sonnet-20241022"
🚀 如果你要使用 Droid 类型账号池,请把配置中的
在
~/.codex/auth.json
文件中配置API密钥:
{
"openai_api_key": null
}
💡 将 OPENAI_API_KEY 设置为 null,然后设置环境变量 CRS_OAI_KEY 为您的 API
密钥(格式如 cr_xxxxxxxxxx)。
环境变量设置方法
macOS:
export CRS_OAI_KEY=cr_xxxxxxxxxx
Shell 配置文件(持久保存):
添加到您的 shell 配置文件中:
# 对于 zsh (默认)
echo "export CRS_OAI_KEY=cr_xxxxxxxxxx" >> ~/.zshrc
source ~/.zshrc
# 对于 bash
echo "export CRS_OAI_KEY=cr_xxxxxxxxxx" >> ~/.bash_profile
source ~/.bash_profile
配置 Droid CLI
Droid CLI 使用
~/.factory/config.json
保存自定义模型;你可以在 Finder 中按
⌘ + Shift + G
并输入路径,或运行
open ~/.factory
快速打开配置目录。
配置文件示例
将以下内容追加到配置文件中,并替换示例中的域名和 API 密钥:
{
"customModels": {
"relay-claude-sonnet-3-5": {
"endpoint": "",
"key": "cr_your_api_key_here",
"model": "claude-3-5-sonnet-20241022"
}
}
}
💡 在 Droid CLI 中选择自定义模型即可使用新的 Droid 账号池;确保服务地址可被本地访问。
4
开始使用 Claude Code
现在你可以开始使用 Claude Code 了!
在特定项目中使用
# 进入你的项目目录
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
macOS 安全设置阻止运行
如果系统阻止运行 Claude Code:
- 打开"系统偏好设置" → "安全性与隐私"
- 点击"仍要打开"或"允许"
- 或者在 Terminal 中运行:sudo spctl --master-disable
环境变量不生效
检查以下几点:
- 确认修改了正确的配置文件(.zshrc 或 .bash_profile)
- 重新启动 Terminal
- 验证设置:echo $ANTHROPIC_BASE_URL
1
安装 Node.js 环境
Claude Code 需要 Node.js 环境才能运行。
Linux / WSL2 安装方法
方法一:使用 NodeSource(推荐)
适用于 Ubuntu/Debian 系统:
# 添加 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
# Fedora/RHEL/CentOS
sudo dnf install nodejs npm
Linux / WSL2 注意事项
- • WSL2 用户建议使用 Ubuntu 20.04 或更高版本
- • 某些操作可能需要 sudo 权限
- • 建议使用 bash 或 zsh shell
验证安装是否成功
安装完成后,打开终端,输入以下命令:
node --version
npm --version
如果显示版本号,说明安装成功了!
2
安装 Claude Code
安装 Claude Code
打开终端,运行以下命令:
# 全局安装 Claude Code
npm install -g @anthropic-ai/claude-code
如果遇到权限问题,可以使用 sudo:
sudo npm install -g @anthropic-ai/claude-code
验证 Claude Code 安装
安装完成后,输入以下命令检查是否安装成功:
如果显示版本号,恭喜你!Claude Code 已经成功安装了。
3
设置环境变量
配置 Claude Code 环境变量
为了让 Claude Code 连接到你的中转服务,需要设置两个环境变量:
方法一:临时设置(当前会话)
在终端中运行以下命令:
export ANTHROPIC_BASE_URL=""
export ANTHROPIC_AUTH_TOKEN="你的API密钥"
💡 记得将 "你的API密钥" 替换为在上方 "API Keys" 标签页中创建的实际密钥。
方法二:永久设置
编辑你的 shell 配置文件(根据你使用的 shell):
# 对于 bash
echo 'export ANTHROPIC_BASE_URL=""' >>
~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.bashrc
source ~/.bashrc
# 对于 zsh
echo 'export ANTHROPIC_BASE_URL=""' >>
~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.zshrc
source ~/.zshrc
🚀 如果你在后台添加了 Droid 类型账号,请将上述命令中的
验证环境变量设置
设置完环境变量后，可以通过以下命令验证是否设置成功：
在终端中验证：
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN
预期输出示例：
💡 如果输出为空或显示变量名本身，说明环境变量设置失败，请重新设置。
VSCode Claude 插件配置
如果使用 VSCode 的 Claude 插件,需要在配置文件中进行设置:
配置文件位置:
~/.claude/config.json
💡 如果该文件不存在,请手动创建。
{
"primaryApiKey": "你的API密钥"
}
配置 Gemini CLI 环境变量
如果你使用 Gemini CLI,需要设置以下环境变量:
终端设置方法
在终端中运行以下命令:
export CODE_ASSIST_ENDPOINT=""
export GOOGLE_CLOUD_ACCESS_TOKEN="你的API密钥"
export GOOGLE_GENAI_USE_GCA="true"
💡 使用与 Claude Code 相同的 API 密钥即可。
永久设置
添加到你的 shell 配置文件:
# 对于 bash
echo 'export CODE_ASSIST_ENDPOINT=""' >> ~/.bashrc
echo 'export GOOGLE_CLOUD_ACCESS_TOKEN="你的API密钥"' >> ~/.bashrc
echo 'export GOOGLE_GENAI_USE_GCA="true"' >> ~/.bashrc
source ~/.bashrc
# 对于 zsh
echo 'export CODE_ASSIST_ENDPOINT=""' >> ~/.zshrc
echo 'export GOOGLE_CLOUD_ACCESS_TOKEN="你的API密钥"' >> ~/.zshrc
echo 'export GOOGLE_GENAI_USE_GCA="true"' >> ~/.zshrc
source ~/.zshrc
验证 Gemini CLI 环境变量
在终端中验证:
echo $CODE_ASSIST_ENDPOINT
echo $GOOGLE_CLOUD_ACCESS_TOKEN
echo $GOOGLE_GENAI_USE_GCA
配置 Codex 环境变量
如果你使用支持 OpenAI API 的工具(如 Codex),需要设置以下环境变量:
Codex 配置文件
在
~/.codex/config.toml
文件开头添加以下配置:
[openai]
base_url = ""
[model]
name = "claude-3-5-sonnet-20241022"
🚀 如果你要使用 Droid 类型账号池,请把配置中的
在
~/.codex/auth.json
文件中配置API密钥:
{
"openai_api_key": null
}
💡 将 OPENAI_API_KEY 设置为 null,然后设置环境变量 CRS_OAI_KEY 为您的 API
密钥(格式如 cr_xxxxxxxxxx)。
环境变量设置方法
Linux / WSL2:
export CRS_OAI_KEY=cr_xxxxxxxxxx
Shell 配置文件(持久保存):
添加到您的 shell 配置文件中:
# 对于 bash
echo "export CRS_OAI_KEY=cr_xxxxxxxxxx" >> ~/.bashrc
source ~/.bashrc
# 对于 zsh
echo "export CRS_OAI_KEY=cr_xxxxxxxxxx" >> ~/.zshrc
source ~/.zshrc
配置 Droid CLI
Droid CLI 使用
~/.factory/config.json
保存自定义模型;Linux / WSL2 用户可以使用文本编辑器(如 vim 或 nano)编辑该配置文件。
配置文件示例
将以下内容追加到配置文件中,并替换示例中的域名和 API 密钥:
{
"customModels": {
"relay-claude-sonnet-3-5": {
"endpoint": "",
"key": "cr_your_api_key_here",
"model": "claude-3-5-sonnet-20241022"
}
}
}
💡 在 Droid CLI 中选择自定义模型即可使用新的 Droid
账号池;确保服务地址可被本地访问。
4
开始使用 Claude Code
现在你可以开始使用 Claude Code 了!
在特定项目中使用
# 进入你的项目目录
cd /path/to/your/project
# 启动 Claude Code
claude
Linux / WSL2 常见问题解决
安装时提示权限错误
尝试以下解决方法:
- 使用 sudo 安装:sudo npm install -g @anthropic-ai/claude-code
- 或者配置 npm 使用用户目录:npm config set prefix ~/.npm-global
- 将 ~/.npm-global/bin 添加到 PATH 环境变量
WSL2 网络连接问题
如果在 WSL2 中无法连接到服务:
- 使用 Windows 主机 IP 地址而不是 localhost
- 检查 Windows 防火墙设置
- 确保服务绑定到 0.0.0.0 而不是 127.0.0.1
环境变量不生效
检查以下几点:
- 确认修改了正确的配置文件(.bashrc 或 .zshrc)
- 重新加载配置:source ~/.bashrc 或 source ~/.zshrc
- 验证设置:echo $ANTHROPIC_BASE_URL
