常见问题排查

401 Unauthorized

常见原因：

• Token 填错。
• Token 被删除或禁用。
• 复制时多了空格、换行。
• 客户端没有按 Bearer 方式发送。

处理：重新创建令牌，并完整复制。

令牌无效

如果客户端提示令牌无效，先确认不是环境变量残留或配置位置错误。

Windows PowerShell 检查：

$Env:ANTHROPIC_AUTH_TOKEN
$Env:ANTHROPIC_BASE_URL
$Env:OPENAI_API_KEY
$Env:OPENAI_BASE_URL

macOS / Linux 检查：

echo "$ANTHROPIC_AUTH_TOKEN"
echo "$ANTHROPIC_BASE_URL"
echo "$OPENAI_API_KEY"
echo "$OPENAI_BASE_URL"

如果显示旧地址或旧 token，先清理后重新打开终端。

403 Forbidden

常见原因：

• 访问 IP 被 Cloudflare 或安全规则拦截。
• 代理 IP 风险较高。
• 当前路径或接口不允许访问。
• 新用户没有先完成注册 / 登录 / IP 加白。

处理：

1. 先进入 https://cf-ip-whitelist-worker.pages.dev/ 完成注册、登录、IP 加白。
2. 如果仍然 403，说明当前 IP 质量太差，换 IP 或换梯子。
3. 再访问 https://superapi.buzz 官网或 API。
4. 不要用大量脚本重试 403 请求，这只会提高拦截概率。

404 Not Found

通常是 Base URL 填错。

OpenAI 兼容客户端一般填：

https://superapi.buzz/v1

Claude Code 类 Anthropic 配置一般填：

https://superapi.buzz

不要把完整接口路径当 Base URL，例如不要填：

https://superapi.buzz/v1/responses

400 Bad Request

常见原因：

• 客户端会话状态异常。
• 请求参数不符合模型要求。
• 上下文里引用了已失效的历史 item。
• 输入文本超出接口限制。

处理：

1. 先 /clear 新开会话。
2. 如果仍然失败，减少输入长度。
3. 检查是否使用了模型不支持的参数。
4. 把服务端返回的 message 和 param 一起看，不要只看状态码。

如果需要恢复旧会话内容，可以让 Claude Code 读取本地 .claude 目录中的历史文件，但不要在异常会话里继续堆上下文。

429 Too Many Requests

表示当前账号池或上游账号触发限流。处理：

• 等待限流恢复。
• 换模型或分组。
• 降低并发。
• 不要用脚本密集重试。

503 Service temporarily unavailable

表示当前请求没有可用上游，可能是模型、分组、账号池临时不可用。

处理：

1. 确认模型是否在控制台可用。
2. 换一个同系列模型。
3. 如果大量出现，等待服务端账号池恢复。

selected model is at capacity

这是官方模型算力不足或上游拥挤导致的提示，通常不是 token 或 Base URL 配错。

处理：

1. 直接继续或稍后重试。
2. 换同系列模型。
3. 降低并发。
4. 如果只在某个分组复现，换分组测试。

decode response body error / stream disconnected

常见于流式请求中途被 CDN、客户端或网络断开。处理：

• 换网络或线路。
• 降低单次请求上下文大小。
• 尽量使用支持 SSE 的客户端。
• 如果是生图长请求，等待服务端保活逻辑完成后再重试。

request timed out / Request Timed Out

请求超时通常和网络、代理、长任务或上游响应慢有关。处理：

1. 先用小请求测试同一令牌和同一模型。
2. 降低上下文长度或减少图片数量。
3. 换网络或备用线路。
4. 如果只有生图长任务超时，等待服务端流式保活或稍后重试。

生图超时

可能超时的图片、过大分辨率图片、多图请求，不建议走普通非流式等待。

建议：

• 使用支持流式请求的客户端。
• 开启 partial images。
• 减少单次图片数量或降低分辨率。
• 不要在客户端超时后立即高频重试。

context too large

上下文超过模型限制。处理：

• 新开会话。
• 减少附加文件。
• 让 AI 只读取关键文件。
• 把大日志裁剪成关键片段。

Claude Code 里可以用：

/clear
/compact
/context

API connect Error

连接类错误一般不是模型能力问题，而是网络或地址问题。检查：

• Base URL 是否正确。
• 本地代理是否可用。
• DNS 是否能解析。
• 公司网络、防火墙、杀毒软件是否拦截。
• Cloudflare 是否返回 403、522、526 等错误。

Gemini CLI 卡住或 400

如果 Gemini CLI 使用一段时间后卡住、停止响应或报 400：

• 先重开会话。
• 检查网络代理。
• 降低上下文大小。
• 如果持续复现，换用 IDE 插件或其他客户端完成当前任务。

Kilo / Roo Token 消耗过快

RooCode、Kilo 等插件经常内置较长提示词，并会自动读取较多上下文。这通常属于客户端设计问题，不一定是 SuperAPI 配置错误。

处理：

1. 限制工作区范围。
2. 明确要求只读取相关文件。
3. 减少自动索引目录。
4. 复杂任务拆开做。

npm / git 安装失败

参考 网络与代理，先确认命令行能访问目标站点，再安装依赖。

跳转官方，没有走 SuperAPI

Claude Code 出现官方登录或官方扣费倾向时，通常是配置没生效。

处理顺序：

1. 优先用 CC Switch 重新切换配置。
2. 检查 .claude.json 是否完成 onboarding。
3. 检查 ANTHROPIC_BASE_URL 是否为 https://superapi.buzz。
4. 完全退出 Claude Code 后重启。

敏感词或安全拦截

如果请求被安全系统拦截，说明内容触发了平台或上游安全规则。处理方式是改写为合规需求，不要尝试绕过安全限制。

Claude Code 版本异常

如果新版本表现异常，可以先检查版本：

claude --version

必要时重新安装：

npm uninstall -g @anthropic-ai/claude-code
npm install -g @anthropic-ai/claude-code@latest

如果某个具体版本出现会话割裂、输出异常等问题，可以临时回退到上一个稳定版本：

npm install -g @anthropic-ai/claude-code@版本号

关闭 Claude Code 自动更新

如果需要固定版本，可在环境变量或 Claude Code 配置里加入：

DISABLE_AUTOUPDATER=1

固定版本适合排查问题，但长期使用仍建议关注官方更新和安全修复。