先区分鉴权和限流
401 通常指向 Token、权限或环境变量；429 更可能与频率、额度或共享 Token 有关。统一接入 UUcode 后，团队可以用同一套口径排查。
把文档作为标准答案
doc.uucode.top 的 troubleshooting、平台概览和工具教程能帮助雅加达团队建立固定检查顺序，减少群聊里重复解释。
按工具拆分故障范围
为 Codex、Claude Code、OpenClaw、Hermes、图片生成和后端服务分别创建 Token，可以更快判断问题发生在哪个工作流。
01
检查基础配置
确认 Base URL、API Key、模型名和环境变量是否与 doc.uucode.top 文档一致。
02
查看错误类型
将 401、429、超时、模型不存在等错误分开记录，避免混在一起处理。
03
拆分并重试
使用独立 Token 或最小化请求重试，确认是工具配置、额度还是网络问题。
常见问题
401 和 429 应该先查哪个？
401 先查 Token 和权限；429 先查频率、额度、共享 Token 和重试策略。
为什么要按工具拆分 Token？
这样可以更快判断故障来自 Codex、Claude Code、agent、图片生成还是后端服务。