支持中心
故障排查
当客户端连接失败、请求超时或模型调用异常时，可以先按这个页面排查。
连接失败
- - 先确认 Base URL 是否写对。
- - 再检查 Key、代理和 DNS 配置。
- - 必要时换一个客户端做对比测试。
Claude Code 400
- - 检查请求参数是否符合当前模型要求。
- - 确认客户端读取到的 Key 没有被截断。
Gemini CLI 异常
- - 确认 CLI 读取到的环境变量正确。
- - 检查 Base URL 和模型名称是否匹配。
API Connect / Timeout
- - 先排查本地网络和代理。
- - 再确认目标接口是否可达。
- - 必要时缩短链路并做本地对照测试。
模型不可见
- - 刷新模型列表。
- - 检查账号权限和提供方状态。
503 / 服务不可用
- - 先看状态页是否有告警。
- - 再确认是不是临时维护或上游异常。
说明
- - 排障时请尽量记录报错全文、时间点和复现步骤。
- - 同一个问题出现多次后，建议整理成 FAQ 条目。