注册
ChatGPTCodex

Codex 常见报错总表：429、401、登录失败、连接中断、缺少环境变量、沙箱、Computer Use、远程控制，看到哪条读哪篇

把 Codex 最常见的报错和问题汇成一张对照表：429、401、Token exchange failed、stream disconnected、missing environment variable、Windows 沙箱失败、Computer Use 找不到、远程控制连不上，各给一句处理方向并链到详细文章。

NNathaniel bigo··原创首发·AI 辅助撰写
10 分钟读完
资料核对于 2026-10-27 · 依据官方文档与公开资料整理 Plus 账号
本文是索引页，把本站已有的 Codex 排查文章按报错原文汇总，资料核对于 2026-10-27。官方没有一份统一的 Codex 报错大全，具体依据见每篇详细文章的「核对说明」。配图为本站整理的示意图，不是软件截图。

适用于谁

  • 在 Codex 里遇到一条报错，不知道该读哪篇的人；
  • 想先看一眼有哪些常见问题的人。

结论先说

  1. 先看报错原文是哪一类：额度和限流、登录和凭据、网络连接、配置、系统和沙箱、功能可用性。
  2. 报错原文一般要原样搜索，别只记大意。
  3. 先看状态页，官方有进行中的事件就等恢复，读法见 /guides/chatgpt-down-check-status-page。
  4. 官方没有逐条解释的报错，详细文章里都写明了「官方未单独说明」，并只采用官方文档里写明的做法。

Codex 报错对照：看到什么，读哪一篇

图：本站根据 Codex 官方文档与本站相关文章整理的示意图

一、对照表

你看到的大致方向详细文章
exceeded retry limit, last status: 429 Too Many Requests先看用量页面和 /status，区分套餐额度、API 限额、工作区控制/guides/codex-exceeded-retry-limit-429-too-many-requests
Token exchange failed、token_exchange_failed浏览器登录成功却回不到 Codex，试设备码登录、回调端口、公司证书/guides/codex-token-exchange-failed-login-error
401 Unauthorized确认登录方式，重新登录，查 API 密钥、env_key、WSL 登录缓存/guides/codex-401-unauthorized-error
stream disconnected before completion连接中途断开，查状态页、WebSocket、代理和证书/guides/codex-stream-disconnected-before-completion
missing environment variable对照 env_key、MCP 的 env_vars、shell_environment_policy/guides/codex-missing-environment-variable
Windows 沙箱设置失败、错误 1385、Everyone 可写mxc、elevated、unelevated 三种实现的排查/guides/codex-windows-sandbox-setup-failed
Linux、WSL2 沙箱启动失败、权限模式怎么选bwrap、用户命名空间、审批模式/guides/codex-permissions-sandbox
找不到 Computer Use地区限制、插件安装、系统权限/guides/codex-computer-use-not-found
手机远程控制授权失败、SSH 主机账号和工作区一致、重新配对、主机保持唤醒/guides/codex-remote-control-ssh-host
登录不了、发不出消息ChatGPT 账号还是 API 密钥、MFA、网络/guides/codex-cannot-sign-in-send-message-connect
额度不够、什么时候重置各套餐额度、查看方法、省额度建议/guides/codex-usage-limits
Windows 版下载安装桌面 App 官方入口、winget、开发工具/guides/codex-windows-app-download-install
插件在哪装桌面 App 的 Plugins、CLI 的 /plugins/guides/codex-plugins-where-to-install
CLI 装不上、怎么更新官方安装命令和更新/guides/codex-cli-install-update

二、官方排查文档里的通用做法

官方 Codex Troubleshooting 页里和「卡住」有关的通用建议：

  1. 看 Codex 是不是在等你批准某个操作；
  2. 打开终端，运行 git status 这类基本命令；
  3. 开一个新对话，用更小、更聚焦的提示重新开始；
  4. 终端卡住：关闭终端面板，用快捷键 Ctrl 加反引号键（）重新打开，再运行 pwd 或 git status`；仍卡住就等进行中的对话结束后重启 App。

另有几个官方列的小问题：审查面板里出现了 Codex 没改的文件，是因为面板按项目的 Git 状态显示，可以切到 Last turn 视图只看上一轮的改动；找不到某个对话，先看侧边栏的筛选（选 Chronological）和设置里的 Archived chats；在工作树里代码跑不起来，用本地环境的安装脚本或 .worktreeinclude 复制被忽略的文件；CLI 有的功能桌面 App 里没有，是因为两者可能带着不同版本的 Codex，用 codex --version 对比。

向官方反馈 Codex 问题前先收集

图：本站根据 Codex 官方文档：Troubleshooting 整理的示意图

三、向官方反馈

官方给的两条路：在消息输入框里输入 / 提交反馈（在已有对话里提交时可以选择是否附上会话，提交后会得到一个会话 ID）；或到 GitHub 的 openai/codex 先搜已有问题，再提新问题。日志位置：会话记录 $CODEX_HOME/sessions（默认 ~/.codex/sessions），macOS 应用日志 ~/Library/Logs/com.openai.codex/年/月/日。分享日志前先检查有没有密钥和令牌。

常见问题

Q：为什么有些报错没有对应的文章？

本站只写能在官方文档里找到依据的内容。官方没有说明的报错，要么不写，要么在文章里写明官方未单独解释。

Q：我的套餐能不能用 Codex？

官方 Pricing 页写明 Work 和 Codex 包含在各 ChatGPT 套餐里，额度不同。想开通 Plus 可以看 /chongzhi/chatgpt-plus，更高额度看 /chongzhi/chatgpt-pro。

Q：Codex 刚入门，从哪开始？

见 /guides/codex-getting-started。

参考资料

  • Codex 官方文档：Troubleshooting — https://learn.chatgpt.com/docs/reference/troubleshooting
  • Codex 官方文档：Authentication — https://learn.chatgpt.com/docs/auth
  • Codex 官方文档：Windows sandbox — https://learn.chatgpt.com/docs/windows/windows-sandbox
  • Codex 官方文档：Remote connections — https://learn.chatgpt.com/docs/remote-connections
  • OpenAI 帮助中心：Network recommendations for ChatGPT errors on web and apps — https://help.openai.com/en/articles/9247338-network-recommendations-for-chatgpt-errors-on-web-and-apps
需要开通或续费？ChatGPT Plus 充值 →

Nathaniel 的更多内容

  1. 01

    Claude 登录报错对照（账号被停用以外）：There was an error logging you in、收不到登录邮件、验证码、Google 登录的处理

    Claude 登录不上，除了账号被停用，还有登录出错、收不到登录邮件、在另一台设备点链接、想设密码、Google 登录异常等情况。本文按官方登录帮助整理各提示的原文和处理，账号被停用另见专门文章。

    Claude0
  2. 02

    Claude 提示「Something went wrong」怎么办：限额、消息过长、容量紧张、登录出错的官方报错对照

    Claude 报 Something went wrong 或别的错误？官方《Troubleshoot Claude error messages》把常见错误分成限额、消息过长、登录出错、容量紧张四类，并给了各自的原文和处理。本文逐项整理，并说明官方没有单独解释笼统的出错提示。

    Claude0
  3. 03

    DeepSeek 除了「服务器繁忙」还有哪些报错：网页版提示对照和 API 错误码 400、401、402、422、429、500、503

    DeepSeek 报错不只有服务器繁忙。本文把官方常见问题里的网页版提示（上传失败、运行环境异常、账号停用、邮箱域名不支持）和 API 错误码汇成对照表，给出官方的原因和处理，并链到各篇详细文章。

    其他 AI 工具0
  4. 04

    Gemini 提示「此账号无法使用」（Can't access this service）怎么办：账号类型、年龄、Family Link 与工作学校账号的官方条件

    Gemini 提示 Can't access this service，意思是这个账号目前不符合使用条件。官方写明了可用的账号类型、年龄要求和 Family Link 账号不能用。本文按账号类型对照，并给出 Something went wrong 的处理。

    Gemini0
  5. 05

    Gemini Pro 免费试用、学生优惠到期后怎么办：自动转付费、重新验证 SheerID、取消后会失去什么

    Google AI Pro 学生优惠或试用到期后会怎样？官方说会自动转为正常付费的 Plus 或 Pro，会提前通知；没有按时重新验证 SheerID 会失去优惠。本文按官方帮助中心整理到期规则、取消后失去的内容和第三方订阅的处理。

    Gemini0
  6. 06

    Gemini 怎么切换模型：Flash-Lite、Flash、Pro、Argon 的选择步骤、思考等级和自动选择

    Gemini 网页版怎么手动切换模型？官方步骤是点聊天框底部当前模型再选，需要有 Google AI 方案，带锁图标的要升级。本文按官方说明整理各方案可选模型、思考等级默认值和自动模型选择。

    Gemini0

同产品的其他教程

  1. 01

    Codex 插件在哪装：桌面 App 的 Plugins 标签、CLI 的 /plugins、IDE 为什么没有，以及插件和技能、MCP 的区别

    Codex 的插件在 ChatGPT 桌面 App 的 Plugins 标签里装，命令行输入 /plugins，IDE 插件不支持。本文按官方文档讲各入口怎么装、装完怎么用、用 API 密钥登录时有什么限制，以及插件、技能、MCP 服务器的区别。

    ChatGPTCodex0
  2. 02

    Codex Windows 版怎么下载安装：ChatGPT 桌面 App 官方入口、winget 命令、开发工具与 WSL 设置

    Windows 上的 Codex 现在是 ChatGPT 桌面 App 里的一个入口。官方给了微软商店下载地址和 winget 安装命令，原生用 PowerShell 加 Windows 沙箱，也可切到 WSL2。本文按官方文档讲安装、登录、建议装的开发工具、管理员运行和常见小问题。

    ChatGPTCodex0
  3. 03

    Codex 远程控制授权失败怎么办、远程 SSH 怎么用：手机配对电脑、Remote Control、连接 SSH 主机的官方步骤

    用手机远程控制电脑上的 Codex，配对不成功或授权失败？官方 Remote connections 文档写了配对步骤和五类常见问题，也讲了怎么把桌面 App 连到 SSH 主机、怎么在主机之间交接对话。本文按官方文档整理，并给出一张排查对照图。

    ChatGPTCodex0
  4. 04

    Codex 沙箱初始化失败怎么办（Windows）：沙箱设置失败、错误 1385、Everyone 可写警告与 MXC、elevated、unelevated 怎么选

    Windows 上 Codex 沙箱设置失败、命令跑不起来、提示错误 1385 或 Everyone 可写？官方文档列了常见原因和处理，本文逐项整理，并说明 mxc、elevated、unelevated 三种实现的区别。

    ChatGPTCodex0
  5. 05

    Codex 找不到 Computer Use 怎么办：插件在哪装、地区限制、macOS 权限与 Windows 前台运行说明

    ChatGPT 桌面 App 的 Computer Use 能让 Codex 看屏幕、点鼠标、操作桌面应用，但官方写明它只在支持的地区可用，需要装 Computer Use 插件并开启开关。本文按官方文档讲插件在哪装、macOS 要给哪两个权限、Windows 为什么会占用前台，以及找不到时的排查。

    ChatGPTCodex0
  6. 06

    Codex 报「missing environment variable」怎么办：env_key、MCP 环境变量、命令读不到变量的官方配置说明

    Codex 提示缺少环境变量，多半出在自定义模型提供方的 env_key、MCP 服务器的 env_vars 或 shell_environment_policy 上。官方没有单独解释这条报错，本文按官方配置文档说明每个设置的作用和排查顺序。

    ChatGPTCodex0

0 条评论

登录 后参与评论

还没有评论，来抢沙发～