Codex 会话界面与执行反馈解读

进入 codex 交互式会话后，界面会持续输出代理的思考、工具调用与审批请求。新手常被滚动输出淹没，本节教你分区阅读会话反馈、抓住关键决策点、判断该不该批准下一步动作，不依赖某个具体按钮位置——界面布局随版本调整，阅读方法稳定可迁移。

一、会话输出的五类信息

信息区	典型内容	你要关注什么
任务输入区	你发出的指令与补充说明	范围、约束、验收标准是否表达清楚
规划与说明	代理对目标的理解、拟定步骤、拟修改文件清单	方向是否正确、是否超范围、方案是否可行
工具调用反馈	读取的文件路径、执行的命令及其输出、报错信息	读的是不是关键文件、命令是否合理、错误根因是否被识别
审批请求提示	待批准的写入、命令或安装等动作及其说明	动作类型、目标路径、是否必要、风险高低（见第三节）
结论与建议	改动汇总、待验证项、下一步建议	是否覆盖原始目标、剩余风险与验证方式

二、如何读工具调用与命令反馈

1. 先看对象，再看动作：每条工具调用先确认"操作了哪个文件/目录、执行了什么命令"，再判断结果，避免只看结论不看过程。
2. 报错要追根因：出现红色错误或退出失败时，重点读报错第一行与相关文件路径；把完整报错贴回会话让代理定位，而不是让它换个无关方向继续试。
3. 区分只读与写操作：浏览、检索、运行测试属低风险；修改文件、安装依赖、访问网络、删除或提交属需要重点判断的动作。
4. 对照既定计划：每一步都应服务于已确认方案；输出中出现计划外文件或命令，先暂停澄清。

三、看懂审批请求再决定放行

判断维度	自问清单
动作对象	改的是不是约定清单内的文件？路径是否指向项目工作区而非系统目录？
动作性质	是读取/格式化/测试，还是写文件、装依赖、执行脚本、联网、删除？
必要性	该动作是否当前步骤所必需，能否先让代理只输出方案？
可回滚性	项目是否在 Git 管理下、改动能否用版本控制回退？

四、FAQ

常见疑问	处理建议
输出太长看不过来	聚焦规划段、命令行与审批请求；要求代理先给简明计划和文件清单，避免在长篇输出里找结论。
代理反复读取同一批文件	可能是上下文过长或目标不清；让它先总结已掌握的事实、明确下一步，必要时重开一个聚焦的会话。
不确定某命令是否危险	先拒绝或选择保守策略，复制命令查其用途；不熟悉的安装、删除、联网动作不在陌生项目直接放行。
界面找不到某个按钮/命令名	界面随版本演进，优先以 codex --help 与当前官方文档为准；本教程聚焦稳定的判断方法。

五、动手练习

• 在练习项目启动一次会话，只做只读探索；逐条记录代理访问了哪些文件、属于哪类信息，练习在审批点前判断动作性质。