文档中心
控制台 →
🪟 Windows

Claude Code Windows 安装指南

在 Windows 上安装 Anthropic 官方终端编程助手 Claude Code，并接入 H&SのToken食堂 中转服务。

1

安装 Node.js 环境

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

  1. 打开浏览器访问 nodejs.org
  2. 点击 LTS 版本下载（版本号需大于 18，推荐长期支持版本）
  3. 下载完成后双击 .msi 文件
  4. 按照安装向导完成安装，保持默认设置即可

方法二：使用包管理器

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

PowerShell 
# 使用 Chocolatey
choco install nodejs

# 或使用 Scoop
scoop install nodejs
💡 提示
建议使用 PowerShell 而不是 CMD，功能更强大。如果遇到权限问题，请以管理员身份运行。

验证安装是否成功

打开 PowerShell，运行以下命令：

PowerShell 
node --version
npm --version

如果显示版本号，说明 Node.js 安装成功。

2

安装 Claude Code

打开 PowerShell，运行以下命令全局安装 Claude Code：

PowerShell 
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
💡 提示
使用淘宝镜像源可加速下载。如遇权限错误，请以管理员身份运行 PowerShell。

验证安装

PowerShell 
claude --version

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

更新 Claude Code

PowerShell 
claude update
3

配置 Claude Code

方法一：通过配置文件设置（推荐）

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

JSON 
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的API密钥",
    "ANTHROPIC_BASE_URL": "htttps://gpt.hslife.fun",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "permissions": {
    "allow": [],
    "deny": []
  }
}
⚠️ 注意
将 你的API密钥 替换为你在 gpt.hslife.fun 控制台创建的实际密钥。

方法二：通过环境变量设置

PowerShell 临时设置（当前会话有效）：

PowerShell 
$env:ANTHROPIC_BASE_URL = "htttps://gpt.hslife.fun"
$env:ANTHROPIC_AUTH_TOKEN = "你的API密钥"

PowerShell 永久设置（重启后仍生效）：

PowerShell 
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "htttps://gpt.hslife.fun", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你的API密钥", [System.EnvironmentVariableTarget]::User)
📌 说明
设置永久环境变量后，需要重新打开 PowerShell 窗口才能生效。

验证环境变量

PowerShell 
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN

输出应为你设置的地址和密钥，如果输出为空则设置失败，请重新操作。

4

开始使用

配置完成后，在任意目录运行以下命令启动 Claude Code：

PowerShell 
# 在当前目录启动
claude

# 或先进入项目目录
cd C:\path\to\your\project
claude
🎉 完成
Claude Code 已成功配置并连接到 H&SのToken食堂 中转服务，可以开始 AI 辅助编程了！
5

常见问题

安装时提示 "permission denied"

以管理员身份运行 PowerShell，或设置 npm 使用用户目录：

PowerShell 
npm config set prefix %APPDATA%\npm

PowerShell 执行策略错误

PowerShell 
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

环境变量设置后不生效

设置永久环境变量后需要完全关闭并重新打开 PowerShell，或注销后重新登录 Windows。