Skip to content

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 中运行(不需要管理员权限):

powershell
irm https://claude.ai/install.ps1 | iex
bat
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
bash
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-你的密钥"
  }
}

也可以用环境变量:

powershell
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.niceai.dev", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-你的密钥", "User")
# 关掉并重新打开终端后生效
powershell
$env:ANTHROPIC_BASE_URL = "https://api.niceai.dev"
$env:ANTHROPIC_AUTH_TOKEN = "sk-你的密钥"
claude
bat
setx ANTHROPIC_BASE_URL "https://api.niceai.dev"
setx ANTHROPIC_AUTH_TOKEN "sk-你的密钥"
rem setx 只对之后新开的窗口生效
bash
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 接入 和 常见错误码对照。

下一步 ​

NiceAI · 稳定的 AI 大模型 API 中转站