这是一份持续增长的 Codex 速记页。每个条目只保留选择设置和排查概念混淆时需要的信息。
xhigh（极高）、Max（最高） 与 Ultra
这三个档位不只是同一条“思考更久”刻度。xhigh 和 Max 调整所选模型处理单个任务时的推理投入；Ultra 还会改变任务编排方式，自动把适合拆分的工作委派给子代理。
| 设置 | 执行方式 | 更适合 |
|---|---|---|
xhigh（极高） |
单个代理投入极高推理深度 | 多步骤、多来源或有复杂权衡的困难任务 |
Max（最高） |
单个代理获得最大推理深度和更多推理时间 | xhigh 仍不够可靠、需要充分探索和核验的最难问题 |
Ultra |
最大推理，并自动委派和汇总多个子任务 | 能清晰拆成检索、实现、测试、审查等独立工作流的大型任务 |
- 选择顺序：先使用能满足要求的最低档位；困难任务可试
xhigh，质量比速度和用量更重要时再比较Max，能够有效并行拆分时才考虑Ultra。 - 成本边界：提高推理强度通常会增加延迟和 token 用量，但官方没有给出
Max相对xhigh的固定倍数，也不保证每个任务都更正确。Ultra中的子代理还会各自执行模型与工具工作，并产生额外协调成本。 - 可用性：
Max和Ultra只会出现在支持并启用它们的产品配置中。官方说明多数任务并不需要这两个档位。 - 来源：OpenAI Codex models、OpenAI Codex subagents。
在脏工作区运行 lint 前先检查脚本
pnpm lint、npm run lint 只是脚本名，不保证是只读检查；项目可能把它定义成 eslint ... --fix，一执行就会改写整个匹配范围。
- 安全检查：先读取
package.json中对应脚本；需要只读验证时，直接运行不带--fix的底层命令，并把路径收窄到本次改动。 - 变更确认：运行前后比较
git status --short与git diff --name-only，可以及时发现格式化器越界修改。 - 恢复边界：如果工作区原本已有用户改动，不要直接用覆盖式 Git 命令回退；先精确区分本次工具产生的差异，再取得用户授权或逐项恢复。
- 验证依据：npm/pnpm 脚本会原样执行
package.json中配置的命令；eslint --fix的语义就是把可自动修复的问题写回文件。实际运行也应以脚本内容和前后 Git 差异为准。