前言：说实话，Codex 这个 agent 工具用下来，确实能大幅提升日常开发效率。今天整理一下我经常用到的快捷键和操作思路，希望能帮到上手的同学。

界面介绍

Codex CLI 的“界面”其实就是你的终端窗口。

启动时没有任何图形面板，一切交互都通过命令行完成。

这听起来可能有点朴素，但正是这种设计让它轻量到极致，能无缝融入 grep、awk、xargs 这些经典 Unix 工具的工作流。

• 命令提示符：输入 codex 后回车，终端会进入交互式环境，显示 > 作为输入提示符。此时你输入的每一行都会被当作自然语言指令。
• 输入区域：就是终端里 > 后面的部分。支持单行直接输入，也可以用反斜杠 结尾实现多行输入。
• 输出区域：Codex 的回复，如代码、解释、建议等，会直接打印在终端中，与普通命令输出无异。
• 辅助信息：部分操作，如配置错误、网络异常，会以彩色文字或状态行提示，帮助你快速定位问题。

这个设计思路很关键：没有侧边栏，没有按钮，所有操作都通过键盘完成。

正是这种“极简”，让 Codex CLI 比任何图形化工具都更契合 Unix 哲学。

常用指令

Codex CLI 的指令可以分为两类：子命令和自然语言指令。

一、核心子命令

通过 codex <子命令> 调用，适用于确定性任务：

• codex exec "你的需求"：执行一条自然语言指令，生成代码并输出到终端。这是最常用的模式，也可以简写为 codex "你的需求"。
• codex explain -f 文件名：对指定文件或代码片段给出逐行解释，适合学习陌生代码或排查逻辑问题。
• codex config set KEY VALUE：管理配置，例如 OPENAI_API_KEY、MODEL、MAX_TOKENS 等，便于在不同环境间切换。
• codex chat "问题"：进入纯对话模式，更适合问答、概念解释等非代码生成场景。

二、自然语言指令示例

无需记忆命令格式，直接用日常语言描述即可，Codex 会自动理解意图。

• “写一个 Node.js 脚本，读取所有日志文件并统计错误数量”
• “把这段 Python 代码改成异步版本并加上错误处理”
• “给以下 SQL 查询添加索引建议”
• “解释一下这个正则表达式的含义”
• “生成一个 Dockerfile，用于部署 Flask 应用”

指令越具体，输出越精准。

建议在描述时包含目标语言、关键约束和期望的输出格式。

常用快捷键

Codex CLI 没有传统 GUI 的快捷键菜单，但 REPL 环境提供了一套键盘操作。

熟练掌握后，同样可以摆脱鼠标。

操作	按键	说明
提交指令	Enter	输入完成后回车执行
多行输入	行末输入 再回车	在需要写多行代码时换行，最后一行不加反斜杠直接回车提交
退出 REPL	/exit 或 Ctrl+D	优雅退出交互模式
中断生成	Ctrl+C	终止正在输出的长回复
清屏	Ctrl+L	清除当前终端内容，保持视野干净
浏览历史	↑ / ↓	回看之前在 REPL 中输入过的指令
光标移动	Ctrl+A / Ctrl+E	跳转到行首 / 行尾
删除至行尾	Ctrl+K	快速清空当前行内容

小技巧：当你需要重复执行类似的指令时，先用 ↑ 调出历史，再用 Ctrl+E 跳到末尾修改几个词，最后回车即可。

这比重新输入快得多。

" / "命令介绍

在 Codex CLI 的交互式 REPL 环境中，输入以斜杠 / 开头的命令，可以触发特定的快捷操作，进一步简化高频任务。

输入 / 后，系统会展示可用命令列表。

常用 / 命令一览：

• /explain：解释当前对话上下文中的代码或上一条回复，适合快速理解逻辑。
• /fix：自动修复最近生成的代码片段中的语法或常见逻辑错误。
• /test：为最近讨论的函数或类生成一组测试用例。
• /doc：为函数、类或接口生成文档注释，如 JSDoc、Docstring。
• /simplify：将复杂代码重写为更易读的等价形式。
• /translate：把代码转换为另一种编程语言，例如 Python → TypeScript。
• /exit：退出交互式环境，与 Ctrl+C 效果相同。

使用示例：假设你刚刚让 Codex 生成了一段 Python 函数，现在想让它自我审查并添加测试，可以依次输入：

> /fix
> /test

这种斜杠命令流让工作节奏更加流畅。

它减少了手动输入“给这段代码生成测试”等自然语言的次数，非常适合高频开发场景。

使用技巧和方法

要让 Codex CLI 真正融入日常工作，需要一些实战方法和思路。

下面按从基础到进阶的顺序梳理。

1. 基础用法：用好文件上下文

使用 -f 参数把项目文件喂给 Codex，可以大幅提高回复质量：

codex -f src/auth.js "分析这个模块的安全性"

同时输入多个文件也没问题：

codex -f src/router.ts -f src/middleware.ts "找出这两个文件之间的不一致"

2. 中级用法：结合 Shell 管道

Codex 的标准输出可以直接传给其他 Unix 工具：

codex exec "写一个 awk 统计请求日志各状态码数量" | bash

或者把代码审查结果保存为 Markdown：

codex exec -f service.go "review 这段代码并给出改进建议" > review.md

3. 高级用法：构建自动化流水线

利用反引号或 $() 将 Codex 嵌入脚本，实现无人工介入的流程。

例如，自动生成 commit message：

git add -A
git commit -m "$(codex '根据 git diff --staged 的内容，用中文写一句简明的提交信息')"

4. 形成自己的指令库

随着使用深入，你会积累一套高频指令，建议把它们整理成别名或脚本：

alias cr='codex exec -f'
alias cex='codex exec -f . "review 当前目录所有代码的安全性"'

长此以往，Codex CLI 会成为你命令行工具箱中不可或缺的一部分。

• 无论是调试线上问题
• 还是学习新技术栈
• 或是批量处理文本

它都能让你的操作更精确、更高效。