ByteNoteByteNote
字

字节笔记本

2026年2月22日

Claude Code Windows 安装配置完全指南

#Claude Code
API中转
¥120
每日科技简报 · 每天一篇,快速了解科技圈大事

本文介绍如何在 Windows 系统上安装和配置 Claude Code，包括 Node.js 环境安装、Claude Code 安装、中转服务环境变量配置，以及 Gemini CLI、Codex、Droid CLI 等相关工具的配置方法。

安装 Node.js 环境

Claude Code 需要 Node.js 环境才能运行。

Windows 安装方法

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

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

方法二：使用包管理器

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

powershell
# 使用 Chocolatey
choco install nodejs

# 或使用 Scoop
scoop install nodejs

Windows 注意事项

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

验证安装是否成功

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

powershell
node --version
npm --version

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

安装 Claude Code

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

powershell
# 全局安装 Claude Code
npm install -g @anthropic-ai/claude-code

这个命令会从 npm 官方仓库下载并安装最新版本的 Claude Code。

提示

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

验证 Claude Code 安装

安装完成后，输入以下命令检查是否安装成功：

powershell
claude --version

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

设置环境变量

配置 Claude Code 环境变量

为了让 Claude Code 连接到你的中转服务，需要设置两个环境变量：

方法一：PowerShell 临时设置（当前会话）

在 PowerShell 中运行以下命令：

powershell
$env:ANTHROPIC_BASE_URL = "https://glm.bytenote.net/api"
$env:ANTHROPIC_AUTH_TOKEN = "你的API密钥"

记得将 "你的API密钥" 替换为在 "API Keys" 标签页中创建的实际密钥。

方法二：PowerShell 永久设置（用户级）

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

powershell
# 设置用户级环境变量（永久生效）
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://glm.bytenote.net/api", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你的API密钥", [System.EnvironmentVariableTarget]::User)

查看已设置的环境变量：

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

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

VSCode Claude 插件配置

如果使用 VSCode 的 Claude 插件，需要在配置文件中进行设置：

配置文件位置：C:\Users\你的用户名\.claude\config.json

如果该文件不存在，请手动创建。

json
{
  "primaryApiKey": "crs"
}

验证环境变量设置

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

在 PowerShell 中验证：

powershell
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN

在 CMD 中验证：

cmd
echo %ANTHROPIC_BASE_URL%
echo %ANTHROPIC_AUTH_TOKEN%

预期输出示例：

text
https://glm.bytenote.net/api
cr_xxxxxxxxxxxxxxxxxx

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

配置 Gemini CLI 环境变量

如果你使用 Gemini CLI，需要设置以下环境变量：

PowerShell 设置方法

在 PowerShell 中运行以下命令：

powershell
$env:GOOGLE_GEMINI_BASE_URL = "https://glm.bytenote.net/gemini"
$env:GEMINI_API_KEY = "你的API密钥"
$env:GEMINI_MODEL = "gemini-2.5-pro"

使用与 Claude Code 相同的 API 密钥即可。

PowerShell 永久设置（用户级）

在 PowerShell 中运行以下命令：

powershell
# 设置用户级环境变量（永久生效）
[System.Environment]::SetEnvironmentVariable("GOOGLE_GEMINI_BASE_URL", "https://glm.bytenote.net/gemini", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "你的API密钥", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("GEMINI_MODEL", "gemini-2.5-pro", [System.EnvironmentVariableTarget]::User)

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

验证 Gemini CLI 环境变量

在 PowerShell 中验证：

powershell
echo $env:GOOGLE_GEMINI_BASE_URL
echo $env:GEMINI_API_KEY
echo $env:GEMINI_MODEL

配置 Codex 环境变量

如果你使用支持 OpenAI API 的工具（如 Codex），需要设置以下环境变量：

Codex 配置文件

在 ~/.codex/config.toml 文件开头添加以下配置：

toml
model_provider = "crs"
model = "gpt-5-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.crs]
name = "crs"
base_url = "https://glm.bytenote.net/openai"
wire_api = "responses"
requires_openai_auth = true
env_key = "CRS_OAI_KEY"

在 ~/.codex/auth.json 文件中配置 API 密钥：

json
{
  "OPENAI_API_KEY": null
}

将 OPENAI_API_KEY 设置为 null，然后设置环境变量 CRS_OAI_KEY 为您的 API 密钥（格式如 cr_xxxxxxxxxx）。

环境变量设置方法

Windows:

cmd
set CRS_OAI_KEY=cr_xxxxxxxxxx

配置 Droid CLI

Droid CLI 使用 ~/.factory/config.json 保存自定义模型；在 Windows 中可直接编辑 C:\Users\你的用户名\.factory\config.json。

配置文件示例

将以下内容追加到配置文件中，并替换示例中的域名和 API 密钥：

json
{
  "custom_models": [
    {
      "model_display_name": "Sonnet 4.5 [crs]",
      "model": "claude-sonnet-4-5-20250929",
      "base_url": "https://glm.bytenote.net/droid/claude",
      "api_key": "你的API密钥",
      "provider": "anthropic",
      "max_tokens": 8192
    },
    {
      "model_display_name": "GPT5-Codex [crs]",
      "model": "gpt-5-codex",
      "base_url": "https://glm.bytenote.net/droid/openai",
      "api_key": "你的API密钥",
      "provider": "openai",
      "max_tokens": 16384
    }
  ]
}

在 Droid CLI 中选择自定义模型即可使用新的 Droid 账号池；确保服务地址可被本地访问。

开始使用 Claude Code

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

启动 Claude Code

powershell
claude

在特定项目中使用

powershell
# 进入你的项目目录
cd C:\path\to\your\project

# 启动 Claude Code
claude

Windows 常见问题解决

安装时提示 "permission denied" 错误

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

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

PowerShell 执行策略错误

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

powershell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

环境变量设置后不生效

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

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

Go Playground - Go 语言官方在线编程环境

下一篇

Claude Code Windows 安装配置完全指南

分享: