常见问题排查
排查顺序
当 Codex 类客户端无法正常访问 Codebyby 中继时，建议不要同时改很多配置。优先按固定顺序逐项排查。
- 基础地址是否正确
- Key 是否有效
- 模型名是否可用
- 请求头是否完整
- 客户端是否走了错误代理或旧缓存
常见问题一：无法连接
优先检查：
- 当前域名是否仍有效
- 本机网络是否可访问中继地址
- 是否把文档域名误当成 API 地址
- 是否遗漏了路径前缀
常见问题二：鉴权失败
优先检查：
- Key 是否复制完整
Authorization头格式是否正确- Key 是否已过期、禁用或属于其他实例
- 客户端是否读取了错误的 Key
常见问题三：模型调用失败
优先检查：
- 模型名是否与当前实例支持列表一致
- 客户端是否仍在使用旧默认模型
- 请求是否被额度、策略或速率限制拦截
常见问题四：只有某个工具失败
如果终端请求正常，但某个 IDE 或插件失败，优先排查：
- 该工具自己的代理设置
- 本地缓存的旧配置
- 插件面板中的独立地址或 Key 配置
- 是否存在额外请求头或兼容层设置
联系支持前建议准备
- 大致发生时间
- 使用的客户端名称
- 脱敏后的 Key 标识
- 目标模型
- 错误响应、日志片段或截图