instant_interrupt：让 Codex 随时能被打断，代价是留下一堆半成品

Sat, 17 Oct 2026 06:55:00 +0800

你让 Codex 重构认证模块，跨 40 个文件。四十秒之后你发现方向错了：它在按 session 方案往下写，而你要的是 JWT token。

这时候你敲一行新指令进去，会发生什么？

在默认配置下，什么都不会发生。Codex 会先把手上这次工具调用跑完，可能是一条几秒的 shell 命令，也可能是一串连续的文件写入，等它回到输入缓冲区，才看得到你刚才那句话。等你这行字生效，session 方案已经铺进十几个文件了。

Codex CLI 给这个行为留了一个开关：instant_interrupt。打开它，你的输入会立刻中断当前工具调用，控制权马上回到你手里。

一行配置的事，但它动的是交互模型的底层。

为什么默认要等

根源在同步执行。Codex 发起一次工具调用，然后阻塞，直到这次调用结束，再回头重新评估交互状态。

同步的好处是可预测。每一步都是完整的原子操作：工具调用跑完，结果进上下文，模型生成下一步。步骤和步骤之间，状态永远干净一致。

坏处是不听话。它在干活的时候你按键，它听不见。

打开 instant_interrupt 之后，新输入（一行改方向的指令、一次按键、一个 Ctrl+C）会立即打断当前工具调用。它不等 shell 进程退出，不等文件写完，不等网络请求返回。

~/.codex/config.json 里加一行：

{
 "instant_interrupt": true
}

或者写成 TOML：

instant_interrupt = true

几个需要知道的设定：

没开 instant_interrupt 的时候：

你： [发送改方向的指令]
Codex： [跑完当前工具调用，可能 2 到 30 秒]
Codex： [读到你的指令]
Codex： [按新方向开始执行]

打开之后：

你： [发送改方向的指令]
Codex： [立刻停掉当前工具调用]
Codex： [读到你的指令]
Codex： [按新方向开始执行]

差别就是中间那一行，也就是你等了多久才把控制权拿回来。