Claude Code Windows 使用教程

前置说明

重要提示

  • 使用中转服务时，国内用户请勿使用代理工具
  • 建议使用 /model 命令切换至 Haiku 或 Sonnet 模型以优化成本和性能

概述

本教程将指导您在 Windows 系统上安装和配置 Claude Code 开发工具。

安装步骤

1. 安装 Node.js

访问 Node.js 官方下载页面：https://nodejs.org/en/download

安装要求：

  • 根据您的系统架构选择对应的安装包
  • 确保 Node.js 版本为 18.0 或更高版本

下载后点击安装，等待安装成功即可。

2. 安装 Git

访问 Git 官方下载页面：https://git-scm.com/install/windows

选择适合您系统的版本进行下载，运行 .exe 文件按默认选项安装即可。

3. 安装 Claude Code

在命令提示符中执行以下命令：

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

环境配置

配置认证绕过

首次使用前需要配置认证绕过，以跳过地区检查。

操作步骤：

  1. 在未使用代理的情况下首次运行 claude 命令，此时会报错（这是正常现象），系统会自动生成 .claude.json 配置文件。
  2. 按下 Win + R 键，输入 %USERPROFILE%，按回车键打开用户目录。
  3. 使用记事本打开 .claude.json 文件，在第一行添加以下配置：
json 
"hasCompletedOnboarding": true,

注意

请确保在该字段后添加逗号，将其放置在 JSON 对象的第一行。

配置 API 密钥

提供三种配置方式：

方式一：系统环境变量配置

通过系统设置配置全局环境变量。

操作步骤：

  1. 按下 Win + R 键，输入 sysdm.cpl，按回车键打开系统属性。
  2. 点击「高级」选项卡，然后点击「环境变量」按钮。
  3. 在「系统变量」区域点击「新建」，分别创建以下两个环境变量：
    • 变量名：ANTHROPIC_API_KEY，变量值：您的 API 密钥
    • 变量名：ANTHROPIC_BASE_URL，变量值：https://yyken.com

方式二：配置文件配置

通过编辑 Claude Code 配置文件设置密钥。

操作步骤：

  1. 按下 Win + R 键，输入 %USERPROFILE%，打开用户目录。
  2. 找到 .claude/settings.json 文件（如不存在，请先运行一次 Claude 程序或手动创建）。
  3. 使用记事本打开该文件，添加或修改以下内容：
json 
{
  "env": {
    "ANTHROPIC_API_KEY": "您的API密钥",
    "ANTHROPIC_BASE_URL": "https://yyken.com"
  }
}

方式三：命令行配置（临时，可用于快速验证）

按下 Win + R 键，输入 cmd 打开命令提示符，执行以下命令：

bash 
set ANTHROPIC_API_KEY=您的API密钥 && set ANTHROPIC_BASE_URL=https://yyken.com && claude

提示

此方式仅对当前终端有效，新开终端需要重新配置。

启动 Claude Code

配置完成后，按下 Win + R 键，输入 cmd 打开命令提示符，输入 claude 并按回车。等待 5–10 秒完成初始化，当出现 > 提示符时表示启动成功。

提示

首次启动时如果出现推荐配置页面，请选择 yes 应用密钥，否则会出现 Not logged in 提示。

常见问题

API 密钥无效错误

如果出现 InvalidAPIKey 错误，通常是密钥配置有误。

排查步骤：

  1. 按下 Win + R 键，输入 %USERPROFILE%，打开用户目录。
  2. 检查以下两个配置文件中的密钥设置：
    • %USERPROFILE%\.claude\settings.json
    • %USERPROFILE%\.claude.json
  3. 确认以下配置项的值正确无误：
    • "ANTHROPIC_API_KEY": "您的API密钥"
    • "ANTHROPIC_BASE_URL": "https://yyken.com"
  4. 如有错误，请参考「配置 API 密钥」章节重新配置。

启动报错：command not found

重新安装 Claude Code：

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

重新安装 Claude Code

卸载：

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

清理缓存数据（可选）：

powershell 
if (Test-Path "$HOME\.claude.json") { Remove-Item "$HOME\.claude.json" -Force }
if (Test-Path "$HOME\.claude")      { Remove-Item "$HOME\.claude" -Recurse -Force }

# 清除环境变量
$vars = @(
  "ANTHROPIC_API_KEY","ANTHROPIC_AUTH_TOKEN","ANTHROPIC_MODEL",
  "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC","DISABLE_AUTOUPDATER",
  "DISABLE_TELEMETRY","DISABLE_ERROR_REPORTING","HTTP_PROXY","HTTPS_PROXY",
  "SHELL","NPM_CONFIG_IGNORE_SCRIPTS","CLAUDE_CODE_GIT_BASH_PATH"
)
foreach ($v in $vars) { [Environment]::SetEnvironmentVariable($v, $null, "User") }

重新安装：

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

注意

重新安装后，请参考「配置认证绕过」章节完成认证配置。

配置完依旧显示 Not logged in · Please run /login

请确认首次启动时是否在推荐配置页面选择了 yes 应用密钥。如果选错了，请删除 .claude 目录和 .claude.json 重新配置：

powershell 
Remove-Item "$HOME\.claude.json" -Force -ErrorAction SilentlyContinue
Remove-Item "$HOME\.claude" -Recurse -Force -ErrorAction SilentlyContinue

然后重新按照「环境配置」章节从头配置即可。