bsf.ai 文档

简体中文

English

简体中文

English

Appearance

Step 1: 安装 Node.js 环境 ​

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

方法一：官网下载（推荐）

  1. 打开浏览器访问 https://nodejs.org
  2. 点击「LTS」版本进行下载（推荐长期支持版本）
  3. 下载完成后双击 .msi 文件
  4. 按照安装向导完成安装，保持默认设置即可

方法二：使用包管理器

powershell
# Chocolatey
choco install nodejs

# Scoop
scoop install nodejs

NOTE

Windows 注意事项

  • 建议使用 PowerShell 而不是 CMD
  • 如果遇到权限问题，尝试以管理员身份运行

TIP

验证安装是否成功 安装完成后，打开终端，输入以下命令：

bash
node --version
npm --version

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

Step 2: 安装 Claude Code ​

打开 PowerShell 或 CMD，运行以下命令：

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

TIP

验证 Claude Code 安装

bash
claude --version

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

Step 3: 设置环境变量 ​

配置 Claude Code 环境变量

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

powershell
$env:ANTHROPIC_BASE_URL = "https://api.bsf.ai"
$env:ANTHROPIC_AUTH_TOKEN = "your_api_key"

方法二：PowerShell 永久设置（用户级）

powershell
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.bsf.ai", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "your_api_key", [System.EnvironmentVariableTarget]::User)

设置后需要重新打开 PowerShell 窗口才能生效。

TIP

验证环境变量设置

powershell
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN

Step 4: 开始使用 ​

启动 Claude Code

bash
claude

在特定项目中使用

powershell
cd C:\path\to\your\project
claude

常见问题 ​

问题：PowerShell 执行策略错误

如果遇到「无法加载脚本」或「执行策略」相关错误，请以管理员身份运行：

powershell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
问题：找不到 claude 命令

如果提示 'claude' 不是内部或外部命令：

  1. 确认已正确安装 Claude Code
  2. 确认已重新打开终端窗口
  3. 检查 npm 全局安装路径是否在 PATH 中：npm config get prefix
问题：npm 安装速度慢

可以使用国内镜像加速安装：

bash
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com