Windows Claude Code 安装教程：2025 最新完整指南（Node.js 环境配置 + 故障排除）

2025/10/26 gacclaude codeclaude教程

关键词：Windows Claude Code 安装、Claude Code Windows 教程、Claude Code 插件安装、Node.js 配置 Claude Code、GAC 授权 Claude Code、API Key 配置 Claude Code

Claude Code 是一款强大的 AI 代码助手工具，支持 Windows 系统集成到 IDE（如 VS Code）中，提升开发效率。本教程详细介绍 Windows 系统下 Claude Code 的两种安装方法：GAC 站内授权安装（推荐用于 IDE 插件集成）和 API Key 配置安装。无论你是初次安装还是遇到故障，本指南都能一步步指导你完成部署。教程基于 Node.js 18+ 环境，确保兼容性。安装前，请准备好科学上网工具（部分步骤需访问外部资源）。

注意：Claude Code 安装需 Node.js、npm 和 Git 环境。整个过程无需复杂代理，但授权环节可能需关闭 VPN 以避免干扰。预计安装时间 10-15 分钟。

# 第一种安装方法：GAC 站内授权（推荐 IDE 插件用户，选择一种方式即可）

此方法通过 GAC 官网授权，简单快捷，适合首次用户。如果你在 IDE 中使用 Claude Code 插件，优先选择此法。

# 1. 确认 Windows 系统环境配置（Node.js、npm、Git）

首先，确保你的 Windows 系统已安装以下工具。打开命令提示符（CMD）或 PowerShell，运行以下命令检查版本：

node -v    // Node.js 版本需 18 或更高
npm -v     
git -v

如果命令输出正常版本号，即环境就绪。
下载链接：
- Node.js：https://nodejs.org/en/download/ (opens new window)
- Git：https://git-scm.com/downloads/win (opens new window)

若 npm 命令报错（权限问题），运行以下 PowerShell 命令设置执行策略：

Set-ExecutionPolicy RemoteSigned

输入 Y 确认。

Node.js npm Git 版本检查

# 2. 安装 Claude Code

环境配置完成后，运行以下 npm 全局安装命令（使用国内镜像加速）：

npm install -g https://gaccode.com/claudecode/install --registry=https://registry.npmmirror.com

安装过程可能需几分钟，完成后即可使用。

Claude Code 安装成功

# 3. 首次登录与 GAC 授权验证

安装成功后，输入以下命令登录：

claude login

首次使用时，GAC 会弹出浏览器窗口要求订阅验证。通过浏览器完成授权（无需代理）。
若未自动弹出，手动复制命令行中的链接到浏览器打开。授权后，将网页验证码复制回命令行，按 Enter 继续。
登录后，选择界面主题，并允许 Claude Code 访问当前目录文件。

授权成功即完成！🎉

Claude Code 登录授权

恭喜！Claude Code 已成功安装与部署。 现在，你可以直接在命令行中使用，或集成到 IDE 插件中加速编码。

# 4. 常见故障排除（第一种方法）

授权失败：关闭 VPN 或本地代理，重启终端，再次运行 claude login。
报错 "401 No valid credentials provided"（之前使用过其他站点）：
- 删除环境变量：Win + R > 输入 sysdm.cpl > 高级 > 环境变量 > 用户变量 > 删除所有以 ANTHROPIC 开头的变量 > 保存 > 新开命令行运行 claude login。
- 或编辑 JSON 配置：导航至 C:\Users\你的用户名\.claude 文件夹，修改或删除 settings.json，然后重试登录。

# 第二种安装方法：API Key 配置（适合自定义密钥用户）

此方法通过 GAC 官网获取 API Key 进行配置，灵活性更高。适用于需要精确控制访问的用户。

# 1. 确认 Windows 系统环境配置（Node.js、npm、Git）

同第一种方法，运行以下命令验证：

node -v    // Node.js 版本需 18 或更高
npm -v     
git -v

下载链接同上。若 npm 报错，运行 Set-ExecutionPolicy RemoteSigned 并确认 Y。

Node.js npm Git 版本检查（第二方法）

# 2. 安装 Claude Code

运行官方 npm 安装命令：

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

检查版本输出确认安装成功。

Claude Code 官方安装

# 3. 配置 API 密钥

在 GAC 官网（gaccode.com）的 API 密钥栏获取你的密钥。
导航至 C:\Users\你的用户名\.claude 文件夹，修改或新建 settings.json 文件，添加以下内容（替换为你的实际密钥）：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://gaccode.com/claudecode",
    "ANTHROPIC_API_KEY": "你的API密钥"
  }
}

# 4. 配置 jq（可选，Git Bash 内执行；需科学上网）

大部分用户可跳过此步。若第 3 步配置后 Claude Code 正常运行，即忽略。

在 Git Bash 中运行：

curl -L https://github.com/stedolan/jq/releases/latest/download/jq-win64.exe -o /tmp/jq.exe
mkdir -p ~/bin
mv /tmp/jq.exe ~/bin/jq.exe
export PATH=$PATH:~/bin
jq --version

然后设置环境变量：

export ANTHROPIC_BASE_URL=https://gaccode.com/claudecode
export ANTHROPIC_API_KEY=你的API密钥

更新配置文件：

(cat ~/.claude.json 2>/dev/null || echo 'null') | jq --arg key "${ANTHROPIC_API_KEY: -20}" '(. // {}) | .customApiKeyResponses.approved |= ([.[]?, $key] | unique)' > ~/.claude.json.tmp && mv ~/.claude.json.tmp ~/.claude.json

jq 配置过程

# 5. 登录 Claude Code 并集成 IDE

配置完成后，新开 PowerShell 或 CMD，运行：

claude login

选择主题，允许访问目录文件。
IDE 集成：在 VS Code 等 IDE 的扩展市场搜索 “Claude Code” 插件，一键安装。配置完成后，即可启动。

额外 IDE 配置：在 C:\Users\你的用户名\.claude 下新建或修改 config.json：

{
  "primaryApiKey": "你的API密钥"
}

Claude Code IDE 插件启动

恭喜！Claude Code 已成功安装与部署。 现在，享受 AI 辅助编码的乐趣！🎉🎉🎉

# 6. 常见故障排除（第二种方法）

登录报错“国家地区不支持”：启用 VPN 的 TUN 或虚拟网卡模式。
Missing API Key：检查 settings.json 配置是否正确，新开终端或 IDE 重试。
jq 配置失败：确保 Git Bash 已安装，并重启终端。