Codex CLI

Codex CLI Tips:文件搜索、排队输入和常用快捷键

整理 Codex CLI 中 @ 文件搜索、Enter 注入指令、Tab 排队输入、! shell 命令、Esc 编辑旧消息等高频技巧。

CodexCLI快捷键Tips

适用场景

Codex CLI 不只是输入文字再等结果。掌握几个快捷操作后,你可以更快地引用文件、补充指令、排队下一步、运行本地命令和修正旧消息。

这篇手册整理高频技巧。

@ 文件搜索

在 composer 中输入:

@

会打开 workspace 文件搜索。选中文件后按 TabEnter,把路径插入 prompt。

示例:

请参考 @src/components/site-header.tsx,修复移动端导航溢出问题。

这比手动复制长路径更快,也能减少路径写错。

Codex 运行时补充指令

如果 Codex 正在运行,你突然想补充限制,可以按 Enter 注入当前 turn。

示例:

不要修改 public 目录,只改组件和样式。

适合实时纠偏。

排队下一轮输入

如果 Codex 正在运行,但你已经知道下一步要做,可以按 Tab 排队输入。

排队内容可以是:

  • 普通 prompt。
  • slash command,例如 /review
  • ! 开头的 shell command。

Codex 当前 turn 完成后,会处理排队内容。

运行本地 shell 命令

在 composer 中输入:

!git status

Codex 会把这个命令输出作为用户提供的命令结果加入上下文,并继续遵守当前 approval 和 sandbox 设置。

适合快速补充:

!npm test
!git diff
!ls

不要用它绕过审批或运行高风险命令。

编辑上一条消息

当 composer 为空时,按两次 Esc 可以编辑上一条用户消息。继续按 Esc 可以往更早的 transcript 走,然后按 Enter 从那里 fork。

适合你发现刚才 prompt 写错了,想从正确版本继续,而不是在错误上下文上补丁式解释。

常见错误

不要在 Codex 已经跑偏很远后才补充关键限制。越早注入越好。

不要把 ! shell command 当成无权限通道。它仍然受当前 approval 和 sandbox 影响。

不要引用太多文件。@ 很方便,但上下文过多会让任务发散。

小结

Codex CLI 的高效使用靠几个小动作:@ 引用文件,Enter 运行中补充指令,Tab 排队下一步,! 提供命令输出,Esc Esc 修正旧消息。熟悉这些之后,终端协作会顺很多。

相关教程

常见问题

@ 文件搜索有什么用?
在 composer 中输入 `@` 可以打开 workspace 文件搜索,把选中文件路径插入 prompt,帮助 Codex 获取更明确上下文。

Codex 正在运行时还能输入吗?
官方文档说明可以按 Enter 向当前 turn 注入新指令,或按 Tab 排队下一轮输入、slash command 或 `!` shell command。