Claude Code Windows 安装配置完全指南

本文介绍如何在 Windows、macOS 和 Linux/WSL2 系统上安装和配置 Claude Code，包括 Node.js 环境安装、Claude Code 安装、环境变量配置以及常见问题解决。

Windows 安装教程

1. 安装 Node.js 环境

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

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

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

方法二：使用包管理器

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

bash

# 使用 Chocolatey
choco install nodejs

# 或使用 Scoop
scoop install nodejs

Windows 注意事项

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

验证安装是否成功

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

bash

node --version
npm --version

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

2. 安装 Claude Code

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

bash

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

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

提示：

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

验证 Claude Code 安装

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

bash

claude --version

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

3. 设置环境变量

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

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

在 PowerShell 中运行以下命令：

powershell

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

记得将 "你的API密钥" 替换为在 BBQ 管理后台 "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

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

4. 配置其他 CLI 工具

配置 Gemini CLI 环境变量

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

PowerShell 设置方法：

powershell

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

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)

配置 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"

环境变量设置：

powershell

$env:CRS_OAI_KEY = "cr_xxxxxxxxxx"

配置 Droid CLI

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

配置文件示例：

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
    }
  ]
}

5. 开始使用 Claude Code

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

启动 Claude Code：

bash

claude

在特定项目中使用：

bash

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

# 启动 Claude Code
claude

macOS 安装教程

macOS 安装步骤与 Windows 类似，主要区别：

安装 Node.js：使用 Homebrew 或官网下载
bash
```
brew install node
```

安装 Claude Code：

bash

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

设置环境变量（添加到 ~/.zshrc 或 ~/.bash_profile）：

bash

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

使环境变量生效：
bash
```
source ~/.zshrc
```

Linux / WSL2 安装教程

安装 Node.js：

bash

# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

安装 Claude Code：

bash

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

设置环境变量（添加到 ~/.bashrc 或 ~/.zshrc）：

bash

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

使环境变量生效：
bash
```
source ~/.bashrc
```

Windows 常见问题解决

安装时提示 "permission denied" 错误

以管理员身份运行 PowerShell
或者使用 npm install -g @anthropic-ai/claude-code --unsafe-perm

PowerShell 执行策略错误

如果遇到执行策略错误，运行：

powershell

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

环境变量设置后不生效

重新打开 PowerShell 窗口
或者重启电脑

字节笔记本

Claude Code Windows 安装配置完全指南

Windows 安装教程

1. 安装 Node.js 环境

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

方法二：使用包管理器

Windows 注意事项

验证安装是否成功

2. 安装 Claude Code

验证 Claude Code 安装

3. 设置环境变量

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

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

VSCode Claude 插件配置

验证环境变量设置

4. 配置其他 CLI 工具

配置 Gemini CLI 环境变量

配置 Codex 环境变量

配置 Droid CLI

5. 开始使用 Claude Code

macOS 安装教程

Linux / WSL2 安装教程

Windows 常见问题解决

安装时提示 "permission denied" 错误

PowerShell 执行策略错误

环境变量设置后不生效

相关链接