跳到正文

故障排查

按现象查原因。大部分问题是环境变量没生效、密钥复制不完整或 base URL 多写了路径。

先做三项检查

三项检查
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 官方价计费,属于正常现象。

跳过登录引导

~/.claude.json(只需添加这一项)
{
  "hasCompletedOnboarding": true
}

仍然解决不了

到 控制台 查看该请求的日志,带上请求时间和错误信息发邮件到 zxzxy1988@gmail.com。