Codex 教程 · 常见报错 · 第 4 篇

Codex 常见报错排查大全:登录失败、启动报错、Windows 沙箱、模型下线、额度用完

整理 Codex CLI 和 IDE 插件最常见的问题:codex doctor 自检、浏览器登录失败、approval_policy untrusted 报错、旧模型下线、Windows 沙箱 1385、WSL1、Docker、MCP 启动失败、额度用完,每个都给官方处理方法。

作者 Niko约 8 分钟
本页目录

本文命令和数字整理自 OpenAI 官方文档(developers.openai.com/codex、OpenAI 帮助中心和 GitHub 上的 openai/codex 仓库),核对日期 2026-10-25(北京时间)。Codex 更新很快,遇到出入以官方页面为准。

遇到问题先跑这一条

codex doctor

它会检查安装、配置、登录、运行环境、Git、终端等,生成诊断报告。大部分问题看报告就能定位。

1. 装完输入 codex 提示找不到命令

先关掉终端重新打开(让环境变量生效)再试。用 npm 安装的,确认 npm 全局目录在系统 PATH 里(通用排查方法,非官方原文)。还不行就换官方安装脚本重新装,见Codex 安装教程。

2. 浏览器登录后回不到终端 / 远程服务器上没法登录

Codex 登录时会在本机起一个回调(默认 localhost:1455)。远程、无浏览器的环境,或者本机网络设置挡住了这个回调时:

  • 首选设备码登录(beta):先在 ChatGPT 安全设置里打开设备码登录,然后运行 codex login --device-auth,在浏览器打开链接、输入一次性码。
  • SSH 端口转发:ssh -L 1455:localhost:1455 user@remote,再在远程运行 codex login。
  • 登录问题的专门日志是 codex-login.log(在日志目录下),找客服时可以提供。

3. 启动报错:approval_policy = “untrusted” is no longer supported

untrusted 这个审批策略已经废弃,CLI 0.149.0 起、桌面 App 和 VS Code 插件 26.818.31338 起会直接启动失败。

处理:打开 ~/.codex/config.toml(Windows 是 %USERPROFILE%\.codex\config.toml),删掉 approval_policy = "untrusted"。也检查一下 profile 文件、启动脚本里有没有 --ask-for-approval untrusted。想要更保守的设置,可以改成:

sandbox_mode = "read-only"
approval_policy = "on-request"

注意:项目级的 trust_level = "untrusted" 是另一个设置,仍然支持。

4. 提示模型不可用:旧模型已经下线

用 ChatGPT 账号登录时,下面这些模型已经下线(API Key 登录不受影响):

模型 下线时间
gpt-5.5 2026-10-14 中午 PDT(北京时间 10 月 15 日 03:00)
gpt-5.3-codex-spark 2026-09-14
gpt-5.4、gpt-5.4-mini 2026-08-31
gpt-5.2、gpt-5.3-codex 已弃用

处理:在 CLI 里用 /model 选一个当前可用的模型,并把 config.toml 里的 model = "..."、脚本里的 -m/--model 一起改掉。官方建议 Plus 及以上用 gpt-6.1-sol,Free/Go 在桌面 App 里用 gpt-6-luna。

关于 gpt-5.4 换成什么:开发者文档建议换成 gpt-6-sol(gpt-5.4-mini 换成 gpt-6-luna),帮助中心写的是 GPT-5.6 Terra(mini 换成 GPT-5.6 Luna)。这几个模型目前官方都还在提供,两种换法都能用。省事的做法是直接换成官方当前推荐的 gpt-6.1-sol(Plus 及以上),或在 /model 列表里选一个你账号能用的。

5. Windows:沙箱设置失败 / 错误 1385

  • 沙箱设置失败:常见原因是拒绝了管理员(UAC)弹窗,或公司电脑不允许创建本地用户、改防火墙。重试并同意弹窗;公司电脑请找 IT。
  • 错误 1385:Windows 策略不允许沙箱用户以所需方式登录。需要 IT 调整策略;临时可在策略允许时改用 unelevated 沙箱:
[windows]
sandbox = "unelevated"
  • 提示某些文件夹 Everyone 可写:说明那些文件夹权限太宽,沙箱保护不了,去掉 Everyone 的写权限后重启 Codex。
  • 需要给官方发诊断时,提供 CODEX_HOME/.sandbox/sandbox.log,不要发 .sandbox-secrets/ 里的内容。

6. Windows:VS Code 插件装了但没反应

可能缺少 C++ 开发工具。安装 Visual Studio Build Tools(C++ 工作负载)和 Microsoft Visual C++ Redistributable(x64),例如:

winget install --id Microsoft.VisualStudio.2022.BuildTools -e

装完完全重启 VS Code。

7. WSL1 里用不了

从 Codex 0.115 起 Linux 沙箱改用 bwrap,WSL1 不再支持,请升级到 WSL2,或者直接用 Windows 原生版。

8. Docker 容器里沙箱报错

容器配置可能不允许 Codex 需要的命名空间、bwrap 或 seccomp。官方做法:让容器本身作为隔离边界,在容器里用 --sandbox danger-full-access 运行。只对你信任的项目这么做,因为这时容器里的一切(包括 Codex 登录凭据)都可能被恶意项目读到。

9. 命令跑不了网络(比如 npm install 失败)

这通常不是故障:默认的 workspace-write 模式下,Codex 执行的命令默认不联网。确实需要时,在 config.toml 里打开:

[sandbox_workspace_write]
network_access = true

10. 一直显示 “Context automatically compacted”,没有进展

停掉这个任务,开一个新对话,用几句话总结目标和已经完成的部分。注意:开新对话不会重置额度。

11. AGENTS.md 好像没生效

确认在正确的目录启动、文件不是空的、上层或 ~/.codex 里没有 AGENTS.override.md 盖掉它;改完要重启 Codex。内容太长(默认超过 32 KiB)会被截断。

12. MCP 服务连不上 / 工具没出现

用 codex mcp list 看配置是否存在,TUI 里用 /mcp 看是否已连接。MCP 服务默认启动超时 10 秒(startup_timeout_sec)、单次工具调用超时 60 秒(tool_timeout_sec),启动慢的服务可以调大。需要 OAuth 的服务运行 codex mcp login 服务名。

13. 额度用完了

  • 用 /status 或官方用量面板看是哪个额度用完、什么时候重置。
  • 可以等重置、加购积分、升级套餐,或改用 API Key 按量继续。
  • OpenAI 客服不会帮你重置额度;如果你认为额度算错了,再联系官方客服。

参考资料

常见问题

遇到报错第一步做什么?

运行 codex doctor,看诊断报告里哪一项不正常,再对照本文对应的小节。

为什么升级后 Codex 打不开了?

最常见的原因是 config.toml 里还留着已经废弃的 approval_policy = "untrusted",或者 model 写的是已经下线的旧模型。删掉或改掉再启动。

可以直接关掉沙箱吗?

技术上可以(--yolo),但官方不推荐:没有沙箱时 Codex 不限于你的项目目录,可能误删数据。遇到沙箱问题优先按本文处理。

报错信息可以截图发给别人看吗?

可以,但先遮住账号、邮箱、路径里的个人信息。auth.json 和 .sandbox-secrets 里的内容任何时候都不要发。