ChatGPT / Codex 常见报错解决方案

本文保留常见错误的综合索引。需要完整操作时，进入下面对应的独立教程；不要为了把文章变短而省掉验证步骤。

当前问题	独立排查
容量不足还是额度耗尽	区分容量与用量
401、登录过期	重新登录并确认身份
返回HTML、DOCTYPE或JSON解析错误	检查入口、代理与响应
权限、沙箱或确认卡住	理解权限与操作确认
任务上下文过长	整理长任务与检查点
MCP或插件连接失败	核对MCP连接
收不到登录邮件	检查登录邮件
2FA不可用	恢复已绑定验证方式

🛠️ 看不懂报错，直接打开 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说明。未在客户账号上复现全部故障，具体按钮以当前版本为准。

↑ 回到快速索引