实战

让 Codex 少说废话:精简输出配置实战(附完整 config.toml)

2026/9/144 分钟阅读

你有没有被 Codex 的"话痨"属性折磨过?

每次让它改个 Bug,它先写一段 200 字的思考过程,再列一堆"你可能还想知道"的延伸建议,最后才给你看代码改动。你只想看 diff,它给你写一篇小作文。

其实,Codex 的输出风格是可以配置的。今天教你三招,让它从"话痨"变成"干练"。


为什么 Codex 会那么多废话?

默认情况下,Codex 有三个层面的输出噪音:

  1. 推理摘要:Codex 思考时会在界面上实时显示推理过程("word vomit")
  2. 最终回答过于冗长:默认 verbosity 偏高,喜欢铺垫、解释、总结
  3. 输出格式松散:没有明确的"先说结论再说过程"约束

解决思路是三层配置:隐藏推理过程 → 降低啰嗦程度 → 在 AGENTS.md 里写死输出格式。


第一招:修改 config.toml

Codex 的配置文件位于 ~/.codex/config.toml(macOS/Linux)或 %USERPROFILE%\.codex\config.toml(Windows)。

打开这个文件,加入以下配置:

# 隐藏推理过程摘要(减少界面噪音)
hide_agent_reasoning = true

# 降低最终回答的啰嗦程度
model_verbosity = "low"

# 可选:设置人格风格
personality = "pragmatic"

效果说明: - hide_agent_reasoning = true:关闭 Codex 思考时的实时流式摘要,界面干净很多 - model_verbosity = "low":降低模型输出的详细程度,默认是 medium - personality = "pragmatic":让人格风格更务实,少寒暄

如果想用命令行临时生效,可以这样传参:

codex -c hide_agent_reasoning=true -c model_verbosity=low

第二招:在 AGENTS.md 里写死输出规则

配置文件控制的是"风格",但要真正约束输出格式,需要在 AGENTS.md 里写规则。

Codex 每次启动时会读取 ~/.codex/AGENTS.md(全局)或项目根目录的 AGENTS.md(项目级)。

在项目根目录创建或编辑 AGENTS.md,加入:

# AGENTS.md

## Final answers
- 先说结论,再说过程
- 保持在 8 行以内,除非我要求详细说明
- 不要开头铺垫,不要"接下来我会..."
- 不要写"Next steps"部分
- 改动过的文件,一个一行列出来

验证 Codex 是否加载了这份规则:在 Codex 里输入:

请总结一下你当前的指令。

如果配置正确,Codex 会原样复述 AGENTS.md 里的内容。


第三招:用 codex exec 的 -o last.md 拿到干净输出

如果你是写脚本调用 Codex(比如自动化流水线),不希望输出里包含大量 transcript,可以用 codex exec 命令:

codex exec "为测试命令补充 README 说明" -o last.md

-o last.md(或 --output-last-message)会把 Codex 的最终回复写入 last.md 文件,脚本只需要读这一个干净的文本,不需要解析 transcript。


完整精简配置示例

如果你想一步到位,直接把 ~/.codex/config.toml 改成这样:

personality = "pragmatic"
hide_agent_reasoning = true
model_verbosity = "low"

同时在项目根目录的 AGENTS.md 里写:

## Final answers
- Lead with the result. No preamble.
- After editing files, list the paths, one per line.
- No "next steps" section unless asked.

适用场景

场景 建议配置
日常编码,不想看废话 hide_agent_reasoning = true + model_verbosity = "low"
追求极简输出风格 personality = "pragmatic"
团队规范统一 AGENTS.md 里写输出规则,强制所有会话遵守
脚本自动化调用 codex exec -o last.md 只取最终结果

一句话总结:Codex 话多不是 Bug,是配置问题。三行 config.toml + 一段 AGENTS.md,让它从话痨变干练。

来源:Flavio Copes《How to make AI harnesses talk less》,flaviocopes.com,2026-09-13

资料最后核对日期:2026-09-14 · 内容整理自 CodexGuide 社区公开教程