外观
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 | iexbat
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdbash
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-你的密钥"
claudebat
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 接入 和 常见错误码对照。