常见报错

省流：
400 请求参数、JSON 格式、字段、模型参数错误
401 未提供 API Key，或 API Key 格式/内容无效
403 API Key 无权限、额度不足、分组限制、IP 限制或上游拒绝访问
404 请求路径错误、接口不存在，或模型/资源不存在
413 请求体过大；也可能需要减少上下文长度
429 请求过快、并发过高、限流或周卡额度用完了
502 网关或上游服务异常，建议稍后重试
503 当前无可用服务资源、账号/路由不可用、上游暂不可用或客户端节点配置异常
504 请求处理超时，建议缩短请求或稍后重试
524 Cloudflare 代理入口连接源站超时；仅适用于走 CF 代理的域名

1.codex提示无法生图或者生图质量不佳/需要openai秘钥

原因：新版本codex官方禁用了中转api的生图接口，需要单独修复一下配置才能进行生图

解决办法：
**【强烈推荐】**方法一:使用图片生成skills↓按照提示安装技能，需要自备能连接Github的网络

https://github.com/Acreg/codex_skills_image-2

也可直接使用侧边栏的图片生成站点，无需配置登录即用，生图低至0.08一张

方法二：复制这段提示词给codex，让他修复一下，然后重启codex，然后就可以在codex中使用image-2模型生成图片

请修复 Codex 生图功能：读取 ~/.codex/auth.json 中的 OPENAI_API_KEY，将其写入 Windows 用户级环境变量 OPENAI_API_KEY；同时设置 OPENAI_BASE_URL=https://api.onemini.top/v1。然后用 ~/.codex/skills/.system/imagegen/scripts/image_gen.py 执行一次 --dry-run 验证。不要输出或泄露完整密钥，不要实际生成图片产生费用。注意：配置的是 Image API/CLI 回退链路，不是原生 image_gen 授权。

2.codex无法回答，报错。

[跟着使用教程重新配置一遍，能解决80%的问题！！↓]
https://docs-api.onemini.top/9323851m0

较为通用的判断依据：打开侧边栏的渠道状态看监控，如果是绿色的，就是主站是没问题的，问题出在网络或者客户机上面
推荐开魔法上网访问，会顺畅很多

（1）流在完成前断开连接:上游请求失败

“stream disconnected before completion: Upstream request failed”

解决办法：看主站侧边栏的渠道状态，若看见监控里面是绿色可用的，就是网络问题，需要换个节点。如果是红色报错，马上联系客服看看号池

（2）已超出重试限制，最后状态:429请求过多，请求ID:***...

exceeded retry limit, last status: 429 Too Many Requests, request id: *******

翻译：已超出重试限制，最后状态:429请求过多，请求ID:***...

解决办法：周卡满额度或者没有余额了，充值或者在“API秘钥”侧边栏功能区中切换API秘钥分组为可用的分组

（3）所选模型已满载，请尝试其他模型。

Selected model is at capacity. Please try a different model.

翻译：所选模型已满载，请尝试其他模型。

解决办法：这个是GPT官方那边满载了，只能过一段时间再看看能不能用

（4）上下文压缩失败或者一直在压缩上下文，无法对话，或者出现以下报错↓

翻译：请求实体过大

解决办法：可能是上下文超限了或者，在对话中分叉一下对话，在新对话中尝试再次使用

（5）Invalid 'input[8].id'
这个是codex的bug，新建一个对话，或者在还能正常回答的地方分叉一下对话在新对话中继续

解决办法：

（6）codex历史对话打不开，或者历史对话消失
解决办法：使用Cockpit Tools或者codex++修复历史对话
【二选一，不知道选什么的话使用第一个即可】
Cockpit Tools：
https://github.com/jlcodes99/cockpit-tools/releases
Windows用户找到exe后缀的文件下载安装即可，苹果mac用户找到.dmg后缀的文件安装

安装Cockpit Tools之后，跟着图片点击

选择深度修复，点击开始修复
修复完毕之后彻底退出codex重新打开一次（记得任务栏托盘也要退出），然后codex丢失的会话或者加载不了的历史对话就能用了
codex++：
https://github.com/BigPizzaV3/CodexPlusPlus/releases

codex++跟着图片走进行会话修复，修复后彻底重启codex，若修复不了请使用Cockpit Tools深度修复

（5）codex无法给另一个对话发送消息

一键复制给 Codex让他自己修复即可，最后记得重启codex，退出托盘彻底关闭重启

请修复 Codex Desktop 的跨任务工具不可用问题。

现象：codex://threads/... 深度链接可以打开，但 read_thread、send_message_to_thread、wait_threads 等工具缺失或报 No handler registered。

请按以下顺序执行：
1. 先检查当前桌面版 Codex、CLI 版本和线程工具是否已注册。
2. 如果工具定义存在但 handler 不可用，不要清理配置、插件、缓存、线程数据库，也不要盲目重复发送消息。
3. 保存当前任务状态后，完整重启 Codex Desktop，让线程工具桥重新注册。
4. 重启后重新打开目标 codex://threads/... 任务。
5. 先验证 read_thread、send_message_to_thread、wait_threads，再发送新的协作消息。
6. 如果发送结果不确定，先等待目标任务确认，不要立即重试，防止重复消息或重复任务。
7. 最后报告版本、修复动作、工具恢复情况和验证结果。