Source: https://wiki.niceai.dev/guide/claude-code-windows

# Windows 上使用 Claude Code

Claude Code 可以直接在 Windows 上运行，也可以装在 WSL 里。接入 NiceAI 的方法和其他系统一样：把 `ANTHROPIC_BASE_URL` 设为 `https://api.niceai.dev`（不加 `/v1`），`ANTHROPIC_AUTH_TOKEN` 设为 Claude 分组的密钥。Windows 上最常见的问题是环境变量设在了错误的地方。

## 原生 Windows 还是 WSL

根据 Claude Code 官方安装文档：

| 方式 | 需要 | 适合 |
| --- | --- | --- |
| 原生 Windows | 无；Git for Windows 可选 | 项目和工具都在 Windows 上 |
| WSL 2 | 已启用 WSL 2 | 用 Linux 工具链，或需要沙箱执行命令 |

原生 Windows 下，装了 Git for Windows 时 Claude Code 用 Git Bash 执行命令；没装时改用 PowerShell。两种都能用，按你的项目所在位置选择即可。

## 安装

在 PowerShell 中运行（不需要管理员权限）：

**-group**

```powershell [PowerShell]
irm https://claude.ai/install.ps1 | iex
```

```bat [CMD]
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
```

```bash [WSL]
curl -fsSL https://claude.ai/install.sh | bash
```



提示符以 `PS C:\` 开头的是 PowerShell，只有 `C:\` 的是 CMD。在 PowerShell 里运行 CMD 的命令会报 `&&` 不是有效的分隔符，反过来会报 `irm` 不是内部命令。

## 配置 NiceAI

推荐写进 `settings.json`，对所有终端都生效：

- 原生 Windows：`%USERPROFILE%\.claude\settings.json`
- WSL：WSL 里的 `~/.claude/settings.json`（和 Windows 那份是两个不同的文件）

```json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.niceai.dev",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的密钥"
  }
}
```

也可以用环境变量：

**-group**

```powershell [PowerShell（长期）]
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.niceai.dev", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-你的密钥", "User")
# 关掉并重新打开终端后生效
```

```powershell [PowerShell（仅当前窗口）]
$env:ANTHROPIC_BASE_URL = "https://api.niceai.dev"
$env:ANTHROPIC_AUTH_TOKEN = "sk-你的密钥"
claude
```

```bat [CMD（长期）]
setx ANTHROPIC_BASE_URL "https://api.niceai.dev"
setx ANTHROPIC_AUTH_TOKEN "sk-你的密钥"
rem setx 只对之后新开的窗口生效
```

```bash [WSL]
echo 'export ANTHROPIC_BASE_URL="https://api.niceai.dev"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="sk-你的密钥"' >> ~/.bashrc
source ~/.bashrc
```



## 验证

重新打开终端，运行 `claude`，输入 `/status` 确认 Base URL 是 `https://api.niceai.dev`，再随便问一句。

## 常见问题

### 设置了环境变量，Claude Code 还是用的官方地址？

- 用 `setx` 或 `SetEnvironmentVariable` 设置后，**已经打开的终端和编辑器不会更新**，要全部关掉重开。VS Code 内置终端需要重启整个 VS Code。
- 在 WSL 里运行时，Windows 的用户环境变量默认不会自动带进去，要在 WSL 里单独设置。
- `settings.json` 和环境变量同时存在且值不同时容易混淆，建议只保留一处。

### 提示 `claude` 不是内部或外部命令？

安装后需要重新打开终端，让 PATH 生效。仍不行时，按官方文档的排错页检查安装目录是否在 PATH 中。

### 找不到 Git Bash？

装了 Git for Windows 但 Claude Code 找不到时，在 `settings.json` 的 `env` 里指定路径（和 NiceAI 的两项写在一起即可）：

```json
{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}
```

也可以不装 Git，直接用 PowerShell 模式。

### 中文路径或中文用户名出问题？

尽量把项目放在不含空格和中文的路径下，例如 `D:\code\project`，可以避开不少工具链的兼容问题。

### 返回 404 或 401？

`ANTHROPIC_BASE_URL` 不要加 `/v1`；密钥要用 Claude 分组。详见 [Claude Code 接入](https://wiki.niceai.dev/guide/claude-code) 和 [常见错误码对照](https://wiki.niceai.dev/guide/error-codes)。

## 下一步

- [Claude Code 接入](https://wiki.niceai.dev/guide/claude-code)
- [CC Switch 一键导入](https://wiki.niceai.dev/guide/cc-switch)
- [Claude Code 为什么输入 token 多](https://wiki.niceai.dev/guide/tech/claude-code-input-tokens)
