先做三项检查
echo $ANTHROPIC_BASE_URL # 应为 https://api.opusvip.dev,不带 /v1
echo $ANTHROPIC_AUTH_TOKEN # 应为 sk- 开头的密钥
claude -p "hello" # 能收到回复即正常 Windows PowerShell 用 $env:ANTHROPIC_BASE_URL 查看。如果你把变量写在 ~/.claude/settings.json 的 env 里,终端里 echo 看不到,这是正常的,以 claude -p "hello" 的结果为准。
错误对照表
| 现象 | 原因与处理 |
|---|---|
| 请求被拒绝,提示客户端不受支持 | OpusVIP 只接受官方 Claude Code CLI。请使用官方 Claude Code 并保持较新版本;其他客户端、SDK 和 curl 会被拒绝。 |
| 仍然要求登录 Anthropic 账号 | 确认环境变量在当前终端已生效;首次安装可使用下方的 hasCompletedOnboarding 跳过引导。 |
| 401 / 认证失败 | 密钥不完整或已删除,到控制台重新复制。登录过 claude.ai 的先运行 /logout;如设置了 ANTHROPIC_API_KEY 请删除。 |
| 404 / 路径不存在 | ANTHROPIC_BASE_URL 末尾多写了 /v1 等路径,只填 https://api.opusvip.dev。 |
| 模型不存在 / 无可用渠道 | 请求的型号不在 OpusVIP 的 Opus 系列里(例如 Claude Code 默认的 sonnet 别名)。把 ANTHROPIC_DEFAULT_OPUS_MODEL 和 ANTHROPIC_DEFAULT_SONNET_MODEL 都指向 Opus 型号,见 选择与切换模型。 |
| 余额不足 | 充值比例 ¥2.5 = $1 额度,充值方式即将开放。失败的请求不会扣费。 |
| 连接超时或 TLS 错误 | 检查 HTTPS_PROXY、HTTP_PROXY、ALL_PROXY 和代理软件规则,确认没有拦截或错误转发 api.opusvip.dev。 |
| Windows 设置后不生效 | setx 只影响新窗口。关闭所有终端和 IDE 后重开,或改用 settings.json,见 IDE 文档。 |
| 日志里出现了 Haiku 请求 | Claude Code 的后台辅助请求(如生成会话标题)使用 Haiku,按 Haiku 官方价计费,属于正常现象。 |
跳过登录引导
{
"hasCompletedOnboarding": true
} 仍然解决不了
到 控制台 查看该请求的日志,带上请求时间和错误信息发邮件到 zxzxy1988@gmail.com。