ChatGPT / Codex 常见报错解决方案
🛠️ 看不懂报错，直接打开 AI 排错指南。 把报错截图、错误文字和卡住的步骤发给 AI，让它一步步帮你查；按教程选择当前可用、能力较强的模型。
想自己对照，往下找对应的错误即可，不用把整篇操作做一遍。
📑目录
一、先做这三件事
普通排错不需要发送密码、验证码、API Key 或 Session。官方服务故障、权益限制和官方侧能力变化，也不能保证靠本地设置修好。
二、按报错快速找到办法
⏳ 容量 / 额度：E01 capacity · E02 用量到上限 · E03 429
🔑 登录：E04 token exchange · E05 401 / refresh token · E06 localhost 回调
🌐 连接：E07 DOCTYPE / JSON · E08 一直重连 · E09 TLS / 证书
🚧 请求被拒：E10 403 · E11 500 / 502 / 503 / 504
🧩 模型 / 工具：E12 模型不支持 · E13 上下文太长 · E14 权限 / 沙箱 · E15 MCP 启动失败
只是觉得回答变差，看回答质量排查；邮箱收码看邮箱登录教程，明确要求短信才看手机号验证。
三、怎么确认修好
✅ 回到原来失败的地方，再做一次：登录后确认账号并发一句话；对话要收到完整回复；文件操作检查实际文件；工具报错就实际调用该工具。
新对话能用，不代表旧任务也恢复了。 断线后先检查已完成的修改，避免重复执行。
仍没解决，先按 AI 排错指南排查。需要人工协助时，从首页加群、添加群主好友，私发订单号、问题截图、卡住的步骤和已试过的方法。详见联系群主。
四、补充说明：15类报错
只读与你相符的一项。📷 配图来自此前核验的公开问题帖，用于认报错，不代表已确定你的故障原因；大截图保留原帖入口，避免占满页面。
E01｜模型容量不足
常见原文：Selected model is at capacity、overloaded。
这次模型无法承接请求，不等于个人额度用完。 先看服务状态与用量；有等待时间就等，或从当前账号的可用列表换一个合适模型，做一次小测试。
持续失败时保留时间、模型和反馈编号。状态页正常也不能排除个别问题，升级套餐不保证解决。
公开截图：GitHub #46172，2026-09-17，Windows 桌面端；版本未注明。倒计时只属于当次请求。
E02｜个人用量到上限
关键词：UsageLimitExceeded、You're out of Codex messages，或明确的恢复时间。
打开用量页，看清哪个限制触顶、何时恢复。按提示等待，或查看账号当前提供的用量选项。换客户端不会凭空多出一份额度；会员有效也可能暂时用完额度。
📷 原帖截图：2026-07-03，版本未注明，图中重置选项不代表每个账号都有。套餐说明
E03｜API返回429
先看完整错误，不能只凭429判断原因。 以下字段针对 OpenAI API：
rate_limit、slow_down：降低频率和并发，按Retry-After等待。credit_balance_exhausted：核对 API 余额。project_spend_limit_exceeded等限制：请项目或组织管理员核对相应上限。insufficient_quota：继续看具体的error.code。
反复重试不能补足余额。ChatGPT 订阅与 API 计费分开；订阅登录出现429时，只有明确写出用量上限，才按 E02 处理。第三方接口按该服务说明核对。
E04｜登录令牌交换失败
关键词：token_exchange_failed、Token exchange failed，常伴随 auth.openai.com/oauth/token。
先保存工作，从出错的客户端重新发起完整登录，不要一直刷新旧回调页。记下浏览器、桌面端、CLI 哪个能用，检查近期代理设置、证书提示和安全软件拦截记录。
网页能登录，客户端仍可能连接失败。不能据此认定封号，也不要统一关闭安全软件；TLS 错误转 E09，回调打不开转 E06。CLI 登录日志见文末。
📷 原帖截图：2026-03-24，Windows，未注明版本；图中没有 HTTP 状态码。另见相同提示报告。
E05｜登录过期或401
关键词：401 Unauthorized、refresh_token_reused、refresh_token_expired、refresh_token_invalidated。
先核对账号和登录方式。明确要求重新认证时，保存任务，再从出错客户端退出、重新登录。CLI 与扩展共享登录缓存，退出后另一端也可能要重登；受管理环境按管理员要求处理。
API Key 登录要查对应服务、项目与密钥。不能把所有401都解释成“多设备挤号”。
公开截图：GitHub #35673，2026-07-27，Windows App 26.721.4979.0；未说明撤销原因。
E06｜登录后回不到客户端
关键词：localhost:1455，或浏览器完成登录后，本地回调打不开。
确认客户端还在运行，并分清它在本机、WSL、容器还是远程服务器。浏览器回调要能返回对应环境。远程或无界面 CLI 可按官方说明尝试设备码登录，命令见文末。
设备码登录需要个人设置或工作区允许；只在自己发起的官方流程中使用设备码。它不能绕过访问权限，也不保证修复认证服务连接失败。
E07｜DOCTYPE或JSON解析失败
关键词：Unexpected token '<'、<!DOCTYPE、is not valid JSON。
程序想读数据，却可能收到了网页。先记下发生在登录、发消息还是调用工具时。用过第三方服务的，核对实际连接地址；官网登录页不能当 API 地址，也别盲目补 /v1。
官方登录流程出错，可从客户端重新发起。仍失败时，让 AI 查状态码、Content-Type 和去敏后的响应开头，分清登录页、网关页或拦截页。不要直接删光 JSON 文件。
📷 原帖截图：2025-05-22，ChatGPT 网页同文案截图；Codex 同文案记录见 #2280。
E08｜一直重连或回复中断
关键词：Reconnecting、stream disconnected before completion。
先看是否在等你批准操作。确实断线时，保留已完成进度，再发一个只需文字回复的小任务：是仅长任务失败，还是所有请求都失败？把差异交给 AI 或群主排查。
核对近期网络和配置变化。WebSocket 回退到 HTTPS 的提示本身不等于失败，继续看结果；涉及文件修改时，重试前检查是否已执行。
📷 原帖截图：2026-04-24，macOS App 26.422.30944；图中重连次数不能证明根因。
E09｜证书或TLS错误
关键词：证书校验失败、UnknownIssuer、TLS。
先核对系统时间；单位电脑或企业代理环境，请管理员检查证书链。CLI 可使用管理员提供的可信 PEM 证书，具体变量见文末官方认证说明。
不要用“忽略证书校验”当通用修复。 只有 error sending request、没有证书细节，还不能确定是 TLS 问题。
E10｜请求被拒绝或403
403要看谁返回、附带写了什么。
工作区或成员权限不足：确认账号，请管理员检查权限。
HTML 验证页或拦截页：按 E07 查响应来源。
API 明确提示地区不受支持：按官方支持范围与使用资格处理。
第三方服务拒绝：看该服务的接口和权限说明。
网页登录成功不代表所有功能都有权限；仅凭403不能认定封号。明确写出停用时，按页面支持流程处理。
📷 原帖截图：2026-06-12，WSL2 / CLI 0.139.0；403后带 HTML，图中地区提示不等于已确认根因。
E11｜服务或网关返回5xx
关键词：500、502、503、504。
先看请求连向官方、第三方还是单位网关。查对应服务状态，有 Retry-After 就按提示等；没有就拉开重试间隔。持续失败时保留时间和请求编号，交给服务提供方检查。
OpenAI API 的500可表示服务错误，503可表示模型暂时过载；其他入口不能只凭数字断言是 OpenAI 故障。重试有副作用的操作前，先确认它是否已经完成。
E12｜模型不支持或找不到
关键词：model_not_found、model ... not supported。
核对当前可选模型、登录方式、是否固定了旧模型配置。从当前账号的菜单选模型，再做小任务；不要照旧帖硬填名称，也不要把整份配置覆盖掉。
重新登录不会自动清除全部自定义配置。曾用中转的，可继续看切回官方账号。
📷 原帖截图：2026-09-09，版本未注明；提示模型不存在或无访问权限。旧配置个案
E13｜上下文太长
关键词：ContextWindowExceeded、context_length_exceeded。
这次带入的内容太多，与个人用量上限不同。 把需求、进度和关键文件位置整理成短交接；减少无关日志，拆小任务，必要时新建对话。
新对话只带必要材料，别把全部旧历史再粘进去。这样能减小输入，但不会恢复已经消耗的个人额度。
公开截图：GitHub #9046，2026-01-11，Windows / CLI 0.80.0；红字与底部“100%”并存，不能只看一个数字。
E14｜权限或沙箱出错
关键词：SandboxError、Permission denied、helper_failed。
先分清是“模型不回复”，还是“模型能回复、命令运行失败”。后者检查项目路径、具体文件、待批准操作和当前用户权限，不用为一个错误修改整盘权限或关闭全部保护。
Windows 明确报 1385 时，请管理员检查沙箱用户所需的登录权限；提供去敏后的 sandbox.log，不要提供 .sandbox-secrets。这条分支不适用于所有初始化错误。
📷 原帖截图：2026-09-12，Windows App 26.908.4834.0；图中是 helper_failed，没有1385，中央弹窗是页面示意。
E15｜MCP或插件启动失败
关键词：MCP startup failed、failed to start、handshaking ... failed。
先记下哪个工具失败，再查它的安装、启动命令、地址和授权。一个工具没连上，不代表普通聊天也不能用。
明确超时后，区分启动超时与调用超时；握手失败不一定靠延长等待解决。不依赖的自建工具可备份配置后暂停；管理方要求的工具先找管理员，required=true 的工具失败可能影响整体启动。
📷 原帖截图：2025-11-05，版本未注明。恢复后实际调用一次工具，列表里有名字还不够。
五、命令与参考资料
下面只供使用 Codex CLI 的读者按对应条目查阅，不是每个人都要运行：
查看版本：
codex --version；查看登录方式：codex login status。E05 确认需要重登后：先
codex logout，再codex login；退出会清除当前存储的登录凭据。E06 设备码登录：
codex login --device-auth，需账号或工作区允许。会话中查看状态：
/status；选择当前可用模型：/model。E04 登录诊断：直接运行
codex login会在配置的日志目录写入codex-login.log。E09 企业证书：
CODEX_CA_CERTIFICATE指向可信 PEM；未设置时回退到SSL_CERT_FILE，按官方认证说明配置。E15 MCP：
startup_timeout_sec管启动，tool_timeout_sec管调用；enabled=false可暂停服务，修改前备份并确认任务不依赖它。
📚 官方说明：认证与登录 · 错误分类 · API 错误码 · Windows 沙箱 · MCP 配置 · 故障反馈。
容量问题还有此前核验的 X 用户报告及 2026-06-16 历史事件。用户报告和历史修复不能作为当前账号的诊断或恢复承诺。
公开案例沿用此前核验记录；本次于2026-10-03复核官方认证、错误码、沙箱与MCP说明。未在客户账号上复现全部故障，具体按钮以当前版本为准。