故障排查

先做最小测试

使用最少参数排除客户端配置问题：

curl https://www.hoofox.com/v1/chat/completions \
  -H "Authorization: Bearer $HOOFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "从模型广场复制的模型名称",
    "messages": [{"role": "user", "content": "你好"}]
  }'

401：认证失败

• 重新复制 API Key。
• 检查请求头中的 Bearer 前缀。
• 确认密钥状态为启用。
• 不要使用登录密码代替 API Key。

404：地址或模型错误

• Codex 和 OpenAI 兼容客户端使用 https://www.hoofox.com/v1。
• 检查完整接口路径。
• 从模型广场重新复制模型名称。

429：请求过于频繁

• 停止连续点击登录或重复发送请求。
• 降低并发数。
• 使用指数退避重试。
• 检查客户端是否在后台自动重试。

5xx：上游暂时不可用

• 等待片刻后重试。
• 使用相同输入切换到其他可用模型。
• 在使用日志中记录请求时间和错误信息。

客户端仍使用旧配置

1. 在 CC Switch 确认 Hoofox 供应商处于当前状态。
2. 完全关闭目标客户端。
3. 重新打开终端或客户端。
4. 再发送最小测试请求。

什么时候联系支持

同一最小请求在多次等待后仍稳定失败，或日志显示持续的渠道错误时，请整理必要信息后反馈。