YOHOHOHO Claude Troubleshooting

Claude Code 常见错误排查

专门处理 Claude Code 接入本站时的密钥、配置、缓存、网络、分组和上游错误。

claude> Invalid API Key
# check Base URL / profile / cache
tip 先用短请求测试

当前显示 9

1Invalid API Key / Unauthorized

Claude Code 没有读取到有效的 YOHOHOHO API Key,或者仍在使用旧密钥。

场景:认证和密钥常见关键字:Invalid API Key / Unauthorized / 401 / API key

用户先这样处理

  1. 回到 YOHOHOHO 用户中心重新复制 API Key,确认以 sk- 开头。
  2. 确认 Claude Code 使用的是 YOHOHOHO 的配置,不是旧的官方登录缓存。
  3. 修改配置后完全退出 Claude Code,再重新打开测试。
  4. 不要把 Key 名称、备注、Base URL 或空格一起复制进去。

联系客服时请提供

  • 登录邮箱、API Key 名称或后 6 位。
  • Claude Code 报错截图。
  • 配置截图,必须遮挡完整 API Key。

2看起来仍在走自己的 Plus 或官方账号

本地客户端可能存在旧登录缓存、旧 profile 或项目目录里的局部配置覆盖。

场景:配置未生效常见关键字:官方额度 / Plus / cache / profile / auth

用户先这样处理

  1. 确认当前打开的是教程里配置过的 Claude Code 环境。
  2. 检查是否有多个配置文件或多个 profile,避免改了 A 配置却启动了 B 配置。
  3. 检查项目目录内是否存在局部配置覆盖全局配置。
  4. 修改后关闭所有 Claude Code 窗口,再重新打开。

判断是否走本站

  • 如果请求流水里没有记录,通常说明没有经过本站。
  • 如果禁用本站账号后立刻无法使用,说明请求至少经过了本站鉴权。

3Base URL 填错导致 connection failed

Base URL、端点路径或客户端协议不匹配时,Claude Code 可能直接连接失败。

场景:地址配置常见关键字:connection failed / fetch failed / ECONNRESET / ENOTFOUND

用户先这样处理

  1. 按教程复制站点提供的 API 端点,不要自己拼多余路径。
  2. 确认没有把网页后台地址、教程网址或 API Key 误填到 Base URL。
  3. 如果使用网络代理,确认代理没有拦截 HTTPS 请求。
  4. 换一个网络环境测试,例如手机热点或家宽。

4402 / quota exhausted / payment required

账号余额不足、订阅套餐过期,或当前订阅分组额度已经用完。

场景:余额和订阅常见关键字:402 / quota exhausted / insufficient balance / payment required

用户先这样处理

  1. 进入用户中心查看余额、订阅、剩余额度和过期时间。
  2. 确认 API Key 选择的是刚购买套餐对应的分组。
  3. 如果刚购买套餐,刷新用户中心并重新选择分组。
  4. 额度用完后需要等待刷新或购买新的可用套餐。

注意

  • 不要只看账号余额,套餐用户还要看订阅分组剩余额度。
  • 同一个 Key 切换分组后,后续请求按新分组规则计费。

5429 / rate limit / Too Many Requests

请求过快、并发过高,或上游账号临时限速。

场景:频率限制常见关键字:429 / rate limit / Too Many Requests / throttled

用户先这样处理

  1. 降低并发任务数量。
  2. 先停止自动重试脚本,等待几分钟后再测试。
  3. 长任务建议分段执行,避免一次塞入大量上下文。
  4. 如果频繁出现,联系管理员检查分组和上游状态。

6502 / 503 上游暂时不可用

请求已经到达本站,但上游账号、上游网络或模型服务临时失败。

场景:上游故障常见关键字:502 / 503 / upstream_error / service unavailable

用户先这样处理

  1. 不要连续高频重试,先等 1 到 3 分钟。
  2. 切换到同套餐支持的其他模型或分组测试。
  3. 确认不是自己的网络断开。
  4. 如果只在某个模型出现,优先把模型名和时间发给客服。

7stream disconnected / reconnected / 首字很慢

流式连接被网络、代理、客户端或上游延迟打断,长任务中更容易出现。

场景:流式连接常见关键字:stream disconnected / reconnected / timeout / slow first token

用户先这样处理

  1. 先发一条很短的问题测试是否能正常返回。
  2. 换网络或关闭不稳定代理再试。
  3. 把超长任务拆成多个小步骤。
  4. 如果只在晚上高峰期出现,可以稍后重试或换分组。

判断方向

  • 如果用户中心请求流水有记录,多半是请求已到本站。
  • 如果请求流水没有记录,更可能是客户端配置、本地网络或缓存没有走本站。

8model not found / model_not_supported

模型名拼写错误,或当前分组不支持这个模型。

场景:模型选择常见关键字:model not found / model_not_supported / 404

用户先这样处理

  1. 复制教程推荐模型名,不要自己改大小写。
  2. 确认 API Key 选择的分组支持这个模型。
  3. 先换成客服推荐的默认模型测试。
  4. 如果使用 CCSwitch,确认当前 profile 的模型名已经同步修改。

9400 invalid_request_error / 参数不兼容

Claude Code、CCSwitch 或某个插件发送了本站/上游不支持的参数。

场景:协议和参数常见关键字:400 / invalid_request_error / unsupported parameter / bad request

用户先这样处理

  1. 先按教程里的最小配置测试,不要混用多个教程里的参数。
  2. 更新 Claude Code 或 CCSwitch 到较新版本。
  3. 如果是某个插件触发,先关闭插件后重试。
  4. 把完整报错发给客服判断是模型、协议还是参数问题。