Windows 安装指南

本指南面向 Windows 用户，使用放心API 作为 API 服务商，完成 Claude Code 的完整安装与配置。

系统要求

Windows 10（版本 1809 / build 17763）及以上，或 Windows 11

网络可正常访问（无需科学上网，放心API已做国内加速）

磁盘空间：至少 500MB 可用空间

安装步骤

步骤 1：安装 Git

Claude Code 依赖 Git 提供的 bash 环境，必须安装。

打开浏览器，访问 https://git-scm.com/downloads/win

点击页面上的「Click here to download」下载最新版安装包（.exe 文件）

双击安装包，安装过程中全部保持默认设置，一路点「Next」，不要修改安装路径

安装完成后，打开「Windows PowerShell」（蓝色图标），输入以下命令验证：

git --version

看到类似 git version 2.x.x.windows.x 的输出即为成功。

步骤 2：安装 Node.js

Claude Code 是一个 npm 包，需要 Node.js 运行环境。

打开浏览器，访问 https://nodejs.org/zh-cn/download

选择「LTS」（长期支持版）下载 Windows 安装包（.msi 文件）

双击安装包，全部保持默认设置，一路点「Next」，不要修改安装路径

安装过程中会询问是否安装「Tools for Native Modules」，可以跳过（不勾选），Claude Code 不需要此组件。

安装完成后，关闭并重新打开 Windows PowerShell，验证安装：

node -v
npm -v

两条命令都应输出版本号，例如 v22.x.x 和 10.x.x。

若提示「No suitable shell found」，说明 Git 未正确安装。请在系统变量中新建：

变量名：CLAUDE_CODE_GIT_BASH_PATH

变量值：C:\Program Files\Git\bin\bash.exe

重启终端后再试。若依旧无效，重装 Git 后重启终端。

步骤 3：卸载旧版 Claude Code（未安装请跳过）

如果之前安装过 Claude Code，先卸载干净：

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

步骤 4：安装 Claude Code

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

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

安装过程需要 1-3 分钟，看到命令提示符重新出现即为完成。

建议使用 PowerShell（蓝色图标）而不是 CMD，功能更强大。如果遇到权限问题，右键 PowerShell → 以管理员身份运行，再重新执行安装命令。

验证安装：

claude --version

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

步骤 5：注册放心API并获取 API Key

打开浏览器，访问 https://fangxinapi.com

注册账号并登录

进入「API 密钥」或「令牌管理」页面，点击「新建密钥」

复制生成的 API Key（格式通常为 sk- 开头的字符串），妥善保存，页面关闭后无法再次查看

同时记录放心API提供的 Base URL（在文档或控制台中可以找到，格式类似 https://fangxinapi.com）

步骤 6：配置环境变量

需要设置以下两个环境变量，将 你的API_KEY 替换为步骤 5 中复制的实际密钥：

变量名	变量值
`ANTHROPIC_BASE_URL`	`https://fangxinapi.com`（请以官网实际地址为准）
`ANTHROPIC_AUTH_TOKEN`	`你的API_KEY`

如何确认 Base URL：登录放心API控制台，在「接入文档」或「快速开始」页面可以找到正确的 Base URL。

以下提供三种设置方式，选择其中一种即可。

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

适合快速测试，关闭 PowerShell 窗口后失效，下次需重新设置。

在 PowerShell 中运行：

$env:ANTHROPIC_BASE_URL = "https://fangxinapi.com"
$env:ANTHROPIC_AUTH_TOKEN = "你的API_KEY"

方法二：PowerShell 永久设置（推荐）

通过 PowerShell 命令直接写入用户级环境变量，无需打开控制面板，重新打开 PowerShell 后永久生效。

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://fangxinapi.com", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你的API_KEY", [System.EnvironmentVariableTarget]::User)

设置完成后，关闭当前 PowerShell 窗口，重新打开，环境变量即可生效。

方法三：控制面板图形界面设置

适合不习惯命令行的用户，按以下步骤操作：

按 Win + S，搜索「编辑系统环境变量」，点击打开

在弹出的「系统属性」窗口中，点击右下角的「环境变量」按钮

在下方「系统变量」区域点击「新建」，依次添加以下两个变量：

变量名	变量值
`ANTHROPIC_BASE_URL`	`https://fangxinapi.com`
`ANTHROPIC_AUTH_TOKEN`	`你的API_KEY`

每次新建前，先检查列表中是否已有同名变量，若有请先删除再新建。

点击「确定」关闭所有窗口，关闭所有 PowerShell 窗口，重新打开后生效。

验证环境变量已生效

在 PowerShell 中验证：

echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN

在 CMD 中验证：

echo %ANTHROPIC_BASE_URL%
echo %ANTHROPIC_AUTH_TOKEN%

预期输出：

https://fangxinapi.com
你的API_KEY

输出为空或显示变量名本身：说明环境变量设置失败或未生效。请检查：

是否已关闭旧的 PowerShell 窗口并重新打开

使用方法三时，是否设置在「系统变量」而非「用户变量」

尝试重启电脑后再验证

步骤 7：验证完整配置

重新打开 Windows PowerShell，运行：

claude -v

然后进入任意一个文件夹，启动 Claude Code：

cd C:\Users\你的用户名\Desktop
claude

首次启动会出现交互引导页面，在「yes/no(recommended)」选项中选择 yes，完成初始化。

开始使用

安装完成后，在任何项目目录中启动 Claude Code：

# 进入你的项目目录
cd C:\path\to\your-project

# 启动 Claude Code
claude

常用命令：

claude          # 启动交互模式
claude -v       # 查看版本
claude --help   # 查看帮助

常见问题

❌ Unable to connect to Anthropic services

原因：ANTHROPIC_BASE_URL 未生效或地址填写有误。

排查步骤：

打开新的 PowerShell 窗口，运行 echo $env:ANTHROPIC_BASE_URL，确认输出了正确的地址

若输出为空，说明环境变量未生效，检查是否设置在「系统变量」而非「用户变量」

确认 Base URL 末尾没有多余的斜杠（/）

重启电脑后再试

❌ 401 Invalid token / Authentication failed

原因：API Key 填写有误或未生效。

系统要求#

安装步骤#

步骤 1：安装 Git#

步骤 2：安装 Node.js#

步骤 3：卸载旧版 Claude Code（未安装请跳过）#

步骤 4：安装 Claude Code#

步骤 5：注册放心API并获取 API Key#

步骤 6：配置环境变量#

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

方法二：PowerShell 永久设置（推荐）#

方法三：控制面板图形界面设置#

验证环境变量已生效#

步骤 7：验证完整配置#

开始使用#

常见问题#

❌ Unable to connect to Anthropic services#

❌ 401 Invalid token / Authentication failed#