排查的第一步永远不是「试试重装」，是分清这是哪一类问题。
先分四类
| 症状 | 是哪一类 |
|---|---|
| 装不上、启动不了 | 环境 |
| 能启动，登录失败 | 账号 |
| 能用，但不听话 | 配置 |
| 能用，但突然不能用了 | 额度 |
四类的查法完全不同。 混在一起查，会在错的方向上花掉一下午。
八个常见症状
① 「怎么还在扣费」
先查登录方式。 用 API key 登录的话，走的是按量计费那条线，和你的订阅额度完全不通。
改用 ChatGPT 账号登录。见装上并登录。
② 说明书不生效
九成是这三种：放错了目录层级、文件名拼错、超过 32 KiB 被截断。
别猜，直接问它：
codex --ask-for-approval never "把你当前读到的全部说明来源列一遍"
三种情况在结果里都能一眼看出来。
③ 具名配置不生效
先看格式对不对。 从 0.134.0 起，具名配置是每套一个独立文件（~/.codex/名字.config.toml），不再是 config.toml 里的 [profiles.xxx] 段落。
老格式静默不生效，不报错。网上大量 2025 年的教程还是老写法。
④ 它总在问我要不要同意
这是默认行为，不是故障。要越出沙箱边界（写到目录外、联网）时它会问。
觉得太吵，先想清楚要放宽的是哪一组——沙箱（能碰什么）还是审批（问不问你）。见沙箱和审批。
⑤ 它说没有网络
默认就是不给联网，这是设计。
真需要的话，按域名白名单放行，别整个放开。
⑥ 它改不了某个文件
先看是不是那几个受保护的目录：.git、.agents、.codex 即使在可写模式下也保持只读。
这是好设计，别去关它——.git 是你出事之后唯一的退路。
⑦ 额度突然不够了
记住两件事：
- 额度按模型分开算，不是一个总池子。深度档撞顶了，日常档和快档可能还有很多
- 网页版聊天和 Codex 共用一个池子。上午在聊天里耗掉的，下午在 Codex 里就没有了
还有一层周限额叠在上面。五小时窗口没撞到，不代表这一周还能随便用。
⑧ 它给的结果和上次不一样
先想想中途换过模型没有。 不同模型的答题风格不一样，换了之后前后半段口径会对不上。
要换就在一件事开始之前换，别在中间换。
一个通用的姿势
出问题的时候，先让它自己报告状态，别自己猜。
它能列出当前用的模型、读到的说明书、当前的权限档位。这三样看一眼，八成的问题当场就定位了——而猜的话，你可能花一小时去修一个根本没坏的东西。
还是不行的话
Claude Code 那边的安装故障排查和环境相关问题里，有一多半条目讲的是你电脑本身的环境问题（编码、路径、权限），那些对 Codex 一字不差地适用。
如果你是从我们这里买的服务，账号和支付相关的问题直接找我们，别自己折腾。
本节事实查证日期：2026-09-10。 依据：OpenAI 官方 Codex 文档。⚠️ 版本相关的行为（尤其是配置格式）会变，以官网为准。