Codex CLI Tips:文件搜索、排队输入和常用快捷键
整理 Codex CLI 中 @ 文件搜索、Enter 注入指令、Tab 排队输入、! shell 命令、Esc 编辑旧消息等高频技巧。
适用场景
Codex CLI 不只是输入文字再等结果。掌握几个快捷操作后,你可以更快地引用文件、补充指令、排队下一步、运行本地命令和修正旧消息。
这篇手册整理高频技巧。
@ 文件搜索
在 composer 中输入:
@
会打开 workspace 文件搜索。选中文件后按 Tab 或 Enter,把路径插入 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。