全部命令在 PowerShell(管理员) 里跑。每条命令前面带
① ② ③编号,照着顺序复制粘贴即可。
打开 https://nodejs.org/ ,下 Node 22 LTS 或更新,全部默认安装。
装完新开 PowerShell,验证:
node -v
npm -v
输出像 v22.x.x 和 10.x.x 就行。
irm https://claude.com/install.ps1 | iex
claude --version
期望看到一行:
2.1.177 (Claude Code)
https://api.ai-pioneer.cn/v1sk-ZDUcMtXm 开头替换 ~/.claude/settings.json 的 env 段(其它键保留):
$cfg = "$env:USERPROFILE\.claude\settings.json"
# 直接用 PowerHashtable 重写整个文件最稳,避免手工编辑 JSON 出错
$settings = Get-Content $cfg -Raw | ConvertFrom-Json
$settings.env = [ordered]@{
ANTHROPIC_BASE_URL = "https://api.ai-pioneer.cn/v1"
ANTHROPIC_API_KEY = "替换sk-擎创云 API密钥"
ANTHROPIC_MODEL = "deepseek-v4-flash"
# 关掉 experimental beta,避免 Hub 不认 beta 头
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS = "1"
}
$settings | ConvertTo-Json -Depth 10 | Set-Content -Path $cfg -Encoding UTF8
Get-Content $cfg
期望看到:
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.ai-pioneer.cn/v1",
"ANTHROPIC_API_KEY": "替换sk-擎创云 API密钥",
"ANTHROPIC_MODEL": "deepseek-v4-flash",
"CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
},
...
}
提示:也可以走
claudeCode.environmentVariables数组写法(VSCode 风格),但要同时删掉env段,否则会被覆盖。两种写法挑一种。
不想改全局配置、只想在某一次调用时接 Hub 的:
$env:ANTHROPIC_BASE_URL = "https://api.ai-pioneer.cn/v1"
$env:ANTHROPIC_API_KEY = "替换sk-擎创云 API密钥"
$env:ANTHROPIC_MODEL = "deepseek-v4-flash"
& "C:\Users\Administrator\Desktop\Claude Code\claude.exe" -p "用一句话中文自我介绍"
跑一句最便宜的模型试链路:
& "C:\Users\Administrator\Desktop\Claude Code\claude.exe" -p "用一句话中文自我介绍,证明连接成功" --model deepseek-v4-flash
返回中文就算通。如果返回空 / 报错,跳到末尾「报错自查」。
不进交互、单轮出结果(推荐在 CI / 脚本里用):
& "C:\Users\Administrator\Desktop\Claude Code\claude.exe" -p "ping" --model glm-5.2 --output-format text
跑 --debug api 看真实 HTTP 状态码:
& "C:\Users\Administrator\Desktop\Claude Code\claude.exe" -p "ping" --debug api 2>&1 | Select-String -Pattern "status|POST|HTTP"
期望看到日志里有 POST https://api.ai-pioneer.cn/v1/messages,并且状态 200。
改 ~/.claude/settings.json 里的 ANTHROPIC_MODEL:
$cfg = "$env:USERPROFILE\.claude\settings.json"
$settings = Get-Content $cfg -Raw | ConvertFrom-Json
# 切到 deepseek-v4-pro
$settings.env.ANTHROPIC_MODEL = "deepseek-v4-pro"
# 切到 MiniMax
$settings.env.ANTHROPIC_MODEL = "MiniMax-M3"
# 切到智谱 GLM
$settings.env.ANTHROPIC_MODEL = "glm-5.2"
$settings | ConvertTo-Json -Depth 10 | Set-Content -Path $cfg -Encoding UTF8
& "C:\Users\Administrator\Desktop\Claude Code\claude.exe" -p "你好" --model glm-5.2
& "C:\Users\Administrator\Desktop\Claude Code\claude.exe" -p "你好" --model MiniMax-M3
& "C:\Users\Administrator\Desktop\Claude Code\claude.exe" -p "你好" --model deepseek-v4-pro
(Get-Content "$env:USERPROFILE\.claude\settings.json" -Raw | ConvertFrom-Json).env.ANTHROPIC_MODEL
或:
Select-String -Path "$env:USERPROFILE\.claude\settings.json" -Pattern "ANTHROPIC_MODEL"
在 settings.json 里直接改 ANTHROPIC_MODEL:
$settings.env.ANTHROPIC_MODEL = "新模型id"
$settings | ConvertTo-Json -Depth 10 | Set-Content -Path "$env:USERPROFILE\.claude\settings.json" -Encoding UTF8
加完跑一下:
& "C:\Users\Administrator\Desktop\Claude Code\claude.exe" -p "ping" --model "新模型id"
~/.claude/settings.json:影响所有项目<你的工程目录>\.claude\settings.local.json:只影响这个项目,优先级高于全局如果某个仓库想临时切回官方 Anthropic,不动全局,写一个项目级配置:
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.anthropic.com",
"ANTHROPIC_API_KEY": "sk-ant-official-key-..."
}
}
放在 D:\myrepo\.claude\settings.local.json 即可,下次 cd 进这个目录自动生效。
| 报错 | 处理 |
|---|---|
claude: command not found |
用全路径 C:\Users\Administrator\Desktop\Claude Code\claude.exe,或把该目录加到 PATH |
401 / 403 unauthorized |
Key 错或没权限;去 https://api.ai-pioneer.cn 检查 Key 是否给 claude 授权 |
404 model not found |
模型 id 拼错;先跑 curl https://api.ai-pioneer.cn/v1/models 看真名 |
Request not allowed (request id: ...) |
后台没给这个 Key 开该模型的权限;换 Key 或去后台授权 |
fetch failed / ECONNREFUSED |
清代理:$env:HTTP_PROXY=''; $env:HTTPS_PROXY=''; $env:ALL_PROXY=''; $env:NO_PROXY='*',再重试 |
status=200 但回复空 |
Hub 余额不足,去 https://api.ai-pioneer.cn 充值或换正式 Key |
unknown beta header |
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 没设,加上 |
ANTHROPIC_BASE_URL 不生效 |
路径必须以 /v1 结尾(不是 /v1/、不是 /),Claude Code 会自己拼 /messages |