| 现象 | 原因 | 解决 |
|---|---|---|
401 Unauthorized | 密钥复制不全 / 把控制台用户名当成了密钥 / 配置后没重启客户端 / 密钥在控制台被禁用 | 重新完整复制 sk- 开头的密钥，确认没漏字符，然后重启客户端再试 |
403 | 余额不足，或密钥分组与模型不匹配 | 控制台充值；或检查分组——Claude 模型不要用 codex pro[特惠] 的密钥（反之亦然），按分组重新建密钥 |
model not found | 模型 ID 写错了 | 用 claude-opus-4-8，注意不是 claude-opus-4.8 也不是 claude-4-opus |
404（双 /v1） | Base URL 带了 /v1，客户端又拼了一次，变成 /v1/v1/messages | Claude Code / Codex 用根域名 https://top-api.cc；只有 OpenAI SDK 直连才用 https://top-api.cc/v1 |
429 | 短时间请求太密集，触发限流 | 加退避重试、降低并发；长期不够用就升套餐提高 RPM |
请求慢 / timeout 超时 | 服务器在海外，部分线路或网络抖动 | 把客户端 timeout 调到 60s 以上；开亚洲节点（香港/新加坡/日本）或换运营商网络 |
| 收不到邮件验证码 | 邮件进了垃圾箱 / 推广文件夹，或发送有间隔限制 | 先翻垃圾箱，等 2-3 分钟再重发；实在不行换 Gmail / Outlook 邮箱重试 |
还没解决？把完整的错误信息截图发工单，并注明密钥前缀
sk-xxx...（只贴前缀，不要全贴）。也可加客服微信 gtsj-001。配置过程中遇到任何问题，都可以加客服微信 gtsj-001，我们可以帮你检查 Base URL、API Key、模型和客户端配置。
需要帮助？客服微信 gtsj-001 · 文档首页