Claude Code - Windows 系统安装教程

前置准备

在开始之前，请确保：

1. 已安装 Node.js 18 或更高版本
   • 如果尚未安装，请查看 Node.js 安装教程
2. 已在 https://ai.gaoxiao888.com 注册账号并获取 API Key

第一步：安装 Claude Code

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

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

安装完成后，验证安装：

claude --version

第二步：配置环境变量

Windows 系统有三种配置方式，推荐使用方法 1。

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

1. 创建配置文件目录（如果不存在）：

mkdir C:\Users\你的用户名\.claude

2. 创建或编辑 C:\Users\你的用户名\.claude\settings.json 文件，输入以下内容：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "替换为您的API Key",
    "ANTHROPIC_BASE_URL": "https://ai.gaoxiao888.com/claude",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
  },
  "permissions": {
    "allow": [],
    "deny": []
  }
}

注意：

• 将 替换为您的API Key 改为你在官网生成的实际 API Key
• 其他渠道的 base URL 在生成 Key 的页面获取

方法 2：临时设置（仅当前终端有效）

在 PowerShell 中执行：

$env:ANTHROPIC_BASE_URL="https://ai.gaoxiao888.com/claude"
$env:ANTHROPIC_AUTH_TOKEN="替换为您的API Key"

在 CMD 中执行：

set ANTHROPIC_BASE_URL=https://ai.gaoxiao888.com/claude
set ANTHROPIC_AUTH_TOKEN=替换为您的API Key

方法 3：永久设置（全局生效）

图形界面方式：

1. 右键「此电脑」→「属性」
2. 点击「高级系统设置」
3. 点击「环境变量」
4. 在「用户变量」中新建：
   • 变量名：ANTHROPIC_BASE_URL
   • 变量值：https://ai.gaoxiao888.com/claude
5. 同样方法添加：
   • 变量名：ANTHROPIC_AUTH_TOKEN
   • 变量值：你的 API Key

PowerShell 命令方式：

[System.Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://ai.gaoxiao888.com/claude', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_AUTH_TOKEN', '替换为您的API Key', 'User')

重启终端后生效。

第三步：验证配置

在 PowerShell 中执行：

echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN

在 CMD 中执行：

echo %ANTHROPIC_BASE_URL%
echo %ANTHROPIC_AUTH_TOKEN%

如果显示正确的值，说明配置成功。

第四步：启动 Claude Code

在终端中执行：

claude

首次启动会进入交互模式，你可以开始与 Claude Code 对话了！

常见问题

1. 提示找不到 claude 命令

确保 Node.js 的全局包路径已添加到系统 PATH 中。

2. 401 认证错误

检查 API Key 是否正确配置，确保没有多余的空格或引号。

3. 网络连接问题

确认 base URL 配置正确，无需使用代理或 VPN。

下一步

• IDE 集成教程 - 在 VSCode 或 Cursor 中使用
• 功能详解 - 了解更多强大功能