Claude Code Windows使用指南

强烈推荐：优先使用 install_script.bat 一键完成全部环境部署。只要遇到安装、配置或连接问题，第一选择就是重新运行该脚本。

(一) 一键安装脚本（推荐）

想一次性完成 Node.js、npm 镜像、Claude Code / Codex / Gemini / Droid CLI / OpenClaw 以及环境变量配置，请优先使用随文档提供的 install_script.bat，而不是手动逐步安装。

1. 下载或找到官方一键安装脚本 install_script.bat。
2. 在资源管理器中右键该脚本，选择 ”以管理员身份运行”（脚本会先检查管理员权限）。
3. 按照脚本提示依次完成：
4. 检查 / 安装 Node.js（如未安装会自动下载安装 Node 20+）。
5. 将 npm 源切换为 https://registry.npmmirror.com。
6. 安装或更新 Claude Code / Codex CLI / Gemini CLI / Droid CLI / OpenClaw。
7. 如系统未安装 Git，会自动从国内镜像下载并安装 Git。
8. 提示输入 API Base（默认 https://api.share-ai.woolen.wang）和 API Token（如 sk-xxxx），脚本会自动：
   • 写入环境变量：ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN、CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 等；
   • 生成 Claude Code 配置目录 C:\Users\你的用户名\.claude 及 settings.json 文件。
9. 脚本执行结束后，关闭当前终端窗口，重新打开 PowerShell / CMD，执行：

claude --version

如果能看到版本号，说明 Claude Code 已安装完成。

只有在不方便使用脚本或脚本执行失败时，才需要参考下面的“手动安装”步骤。

---

(二) 手动安装Node.js环境

如果你已经通过 install_script.bat 完成安装并确认 node --version 能正常输出版本号，可以跳过本节。后续任何步骤出错，都可以直接回到这里，重新运行 install_script.bat 来修复环境。

Windows 安装方法

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

1. 打开浏览器访问 https://nodejs.org/
2. 点击 LTS 版本进行下载（推荐使用 18 或以上版本，脚本默认安装的是 Node 20 LTS）
3. 下载完成后双击 .msi 文件
4. 按照安装向导完成安装，保持默认设置即可

方法二：使用包管理器

如果你安装了 Chocolatey 或 Scoop，可以使用命令行安装：

# 使用 Chocolatey
choco install nodejs
# 或使用 Scoop
scoop install nodejs

Windows 注意事项

• 建议使用 PowerShell 而不是 CMD
• 如果遇到权限问题，尝试以管理员身份运行
• 某些杀毒软件可能会误报，需要添加白名单

验证安装是否成功

安装完成后，打开 PowerShell 或 CMD，输入以下命令：

node --version
npm --version

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

---

(三) 手动安装 Claude Code

打开 PowerShell 或 CMD，运行以下命令（与一键安装脚本内部使用的命令等价）：

全局安装 Claude Code

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

这个命令会通过 npmmirror 镜像源下载并安装最新版本的 Claude Code。更新也使用这个命令

提示

• 建议使用 PowerShell 而不是 CMD，功能更强大
• 如果遇到权限问题，以管理员身份运行 PowerShell

验证 Claude Code 安装

安装完成后，输入以下命令检查是否安装成功（与脚本检测方式一致）：

claude --version

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

提示：如果 claude --version 无法正常输出，优先考虑重新运行 install_script.bat，由脚本自动检查 Node/npm 及 Claude Code 安装状态。

---

(四) 配置 Claude Code

通过文件设置

如果你已经在 install_script.bat 中输入过 API Base 和 API Token，脚本已经自动生成 ~/.claude/settings.json，其内容与下方示例基本一致。本节主要用于手动检查和定制配置。

编辑文件 ~/.claude/settings.json 文件添加以下内容（如果没有 settings.json 文件，请自行创建，不需要时可随意删除，不影响 claude 使用）：

windows下路径为: C:/Users/你的用户名/.claude

Linux 或 macOS 系统中通常位于: ∼/.claude

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的API密钥",
    "ANTHROPIC_BASE_URL": "https://api.share-ai.woolen.wang",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "statusLine": {
    "type": "command",
    "command": "npx -y ccstatusline@latest",
    "padding": 0
  },
  "permissions": {
    "allow": [],
    "deny": []
  }
}

通过环境变量设置

为了让 Claude Code 连接到你的中转服务，需要设置以下环境变量（与脚本保持一致）：

PowerShell 临时设置（当前会话）

在 PowerShell 中运行以下命令：

$env:ANTHROPIC_BASE_URL = "https://api.share-ai.woolen.wang"
$env:ANTHROPIC_AUTH_TOKEN = "你的API密钥"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC = "1"

[!NOTE] 记得将 "你的API密钥" 替换为在上方 "API Keys" 标签页中创建的实际密钥。

PowerShell 永久设置（用户级）

在 PowerShell 中运行以下命令设置用户级环境变量：

# 设置用户级环境变量（永久生效）
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.share-ai.woolen.wang", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你的API密钥", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC", "1", [System.EnvironmentVariableTarget]::User)

查看已设置的环境变量：

# 查看用户级环境变量
[System.Environment]::GetEnvironmentVariable("ANThHROPIC_BASE_URL", [System.EnvironmentVariableTarget]::User)
[System.Environment]::GetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", [System.EnvironmentVariableTarget]::User)
[System.Environment]::GetEnvironmentVariable("CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC", [System.EnvironmentVariableTarget]::User)

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

验证环境变量设置

设置完环境变量后，可以通过以下命令验证是否设置成功：

在 PowerShell 中验证：

echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN
echo $env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC

在 CMD 中验证：

echo %ANTHROPIC_BASE_URL%
echo %ANTHROPIC_AUTH_TOKEN%

预期输出示例：

https://api.share-ai.woolen.wang
sk-xxxxxxxxxxxxxxxxxx

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

---

(五) 开始使用 Claude Code

现在你可以开始使用 Claude Code 了！

启动 Claude Code：

claude

在特定项目中使用：

# 进入你的项目目录
cd C:\path\to\your\project
# 启动 Claude Code
claude

---

Windows 安装常见问题解决

在排查任何问题（安装失败、命令无法识别、连接不上 API）时，都可以优先尝试重新运行一次 install_script.bat，脚本会自动帮你重装 Node/npm、相关 CLI、Git，并重写必要的环境变量和配置文件。

安装时提示 "permission denied" 错误

这通常是权限问题，尝试以下解决方法：

• 以管理员身份运行 PowerShell
• 或者配置 npm 使用用户目录：npm config set prefix %APPDATA%\npm

PowerShell 执行策略错误

如果遇到执行策略限制，运行：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

环境变量设置后不生效

设置永久环境变量后需要：

• 重新启动 PowerShell 或 CMD
• 或者注销并重新登录 Windows
• 验证设置：echo $env:ANTHROPIC_BASE_URL