Claude Code Windows 使用指南

Claude Code 是 Anthropic 官方推出的 AI 编程助手，支持通过 FreeAPI 代理服务使用。本指南将帮助您在 Windows 上完成安装和配置。

(一) 环境准备：安装 Node.js

Claude Code 需要 Node.js 环境才能运行（需 v18 或更高版本）。

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

1. 访问 https://nodejs.org/
2. 下载 LTS 版本（需 v18 或更高）
3. 双击 .msi 文件，按向导安装（保持默认设置）

方法二：使用包管理器

# 使用 Chocolatey
choco install nodejs

# 或使用 Scoop
scoop install nodejs

TIP

建议使用 PowerShell 而不是 CMD，以获得更好的体验。

验证安装

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

node --version
npm --version

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

---

(二) 安装 Claude Code

官方推荐使用 Native Install 安装方式，具有以下优势：

• 单个可执行文件，无需 Node.js 依赖
• 自动更新机制更稳定
• 启动速度更快

方法一：PowerShell

# 安装稳定版（默认）
irm https://claude.ai/install.ps1 | iex

方法二：CMD

REM 安装稳定版（默认）
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

方法三：NPM 安装

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

验证安装

安装完成后，运行以下命令验证：

claude --version

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

TIP

安装前请确保移除任何过期的别名或符号链接。使用 claude doctor 命令可以检查安装类型和版本。

---

(三) 连接 FreeAPI 服务

方法一：settings.json 配置（推荐）

配置文件路径：

C:\Users\你的用户名\.claude\settings.json

路径说明

• Windows：C:/Users/你的用户名/.claude
• Linux 或 macOS：~/.claude

如果 settings.json 文件不存在，请自行创建。

编辑 settings.json 文件，添加以下内容：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your-api-key",
    "ANTHROPIC_BASE_URL": "https://www.free-api.ai/api"
  }
}

重要提示

• 将 your-api-key 替换为您的实际 API 密钥
• 密钥获取方式：登录控制台 → API 密钥管理 → 创建密钥

方法二：环境变量配置

临时设置（当前会话）：

$env:ANTHROPIC_BASE_URL = "https://www.free-api.ai/api"
$env:ANTHROPIC_AUTH_TOKEN = "your-api-key"

永久设置（用户级）：

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://www.free-api.ai/api", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "your-api-key", [System.EnvironmentVariableTarget]::User)

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

验证配置

配置完成后，验证环境变量是否设置成功：

在 PowerShell 中执行：

echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN

在 CMD 中执行：

echo %ANTHROPIC_BASE_URL%
echo %ANTHROPIC_AUTH_TOKEN%

预期输出示例：

https://www.free-api.ai/api
your-api-key

WARNING

如果输出为空或显示变量名本身，说明环境变量设置失败，请重新按照上述步骤设置。

---

(四) VS Code 扩展配置

配置文件路径：C:\Users\你的用户名\.claude

1. 在 VS Code 扩展中搜索并安装 Claude Code for VS Code
2. 在 ~/.claude 目录下创建 config.json 文件（如果没有）
3. 添加以下内容：

// Path: C:\Users\你的用户名\.claude
{
  "primaryApiKey": "any-value"
}

NOTE

• 是 config.json，不是 settings.json
• primaryApiKey 字段值可以为任意内容，只要存在即可

---

(五) 启动 Claude Code

在项目目录下运行：

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

首次启动时，Claude Code 会进行初始化配置。

---

常见问题

1. 命令未找到

• 确保 npm 全局路径（通常是 C:\Users\你的用户名\AppData\Roaming\npm）已添加到系统 PATH
• 重新打开 PowerShell 窗口

2. API 连接失败

# 检查环境变量
echo $env:ANTHROPIC_AUTH_TOKEN

3. 更新 Claude Code

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