请求失败：按顺序排查，不要乱改配置

先保留一条有用的信息

记下请求时间、模型、错误提示和请求 ID。如果工具只显示一大段错误，先打开 User Client 的“使用记录”或“本地诊断”，找到同一时间的那条记录。不要把完整 Key 或原始私人提示词放进公开求助内容。

从最近的一层开始检查

1. Client 是否运行？ 本地入口是一个正在运行的服务。关掉或停止服务后，工具无法连接。
2. 地址是否对应工具？ OpenAI 兼容工具通常使用带 /v1 的地址；Claude Code 的 Base URL 使用根地址。优先复制客户端对应的完整入口。
3. 工具是不是用了本地 Key？ 平台 User Key 用来登录 Client，Partner Key 用来供号，都不能随意当成本地 Key。
4. 平台 Key 是否配置定价策略？ 创建 Key 后还要配置范围；看用户定价策略。
5. 有可用供给吗？ 模型、订阅等级、最高价和私有渠道都可能缩小候选范围。
6. TEE 验证是否通过？ 验证失败应检查版本和信任状态，不要为“先能用”关闭验证。

常见错误是什么意思

现象／状态	建议动作
连接被拒绝或超时	检查 Client、端口、防火墙及工具地址
401／密钥无效	确认本地 Key 仍存在，平台 Key 未被禁用
409／尚未配置渠道	到网站为这个 User API Key 配置路由
403／不允许该模型或路由	检查平台和本地 Key 的模型范围，以及私有渠道权限
503／没有可用账号	检查模型、价格上限和供给；稍后重试或联系运营方
输入太长	查询最终渠道的输入上限，压缩上下文或换有相应容量的模型
上游限额或繁忙	查看详情中的上游分类；不要连续重复发送大请求

错误也可能来自上游厂商。HTTP 数字用于分类，实际原因要结合错误文本和记录详情判断，不能看到 403 就认定某个账号已经封禁。

为什么使用记录里没有

请求可能在本机鉴权、格式检查或准备路由时就失败，没有成为 Relay 使用记录。这类问题先看本地诊断。Client 中的使用记录限定当前设备实例；网站可以有更宽的查询范围，见记录说明。

联系支持时带什么

提供请求 ID、准确时间、模型名、工具类型、操作系统和错误提示。说明是第一次请求失败，还是一段会话中途失败。先用短请求复现，再检查是不是只有一个工具出问题。