这一章来聊聊 Codex 里最常用的操作。不用刻意背，用到的时候回来翻就行。

---

4.1 交互模式：打开 Codex 聊天

启动 Codex

最简单的方式，在终端里输入一个字就行：

# 打开 Codex 的全屏界面，就像打开了一个聊天窗口
codex

输入之后，终端会变成一个全屏的 TUI（终端用户界面）。你可以像聊天一样跟 Codex 对话，它会实时显示正在做的操作。

在交互模式里怎么用

打开之后，直接打字就能跟 Codex 聊。它会帮你：

你：帮我把这个项目里所有的 console.log 都清理掉

Codex：我来帮你清理 console.log，先看看有哪些文件……
  ▸ 正在搜索包含 console.log 的文件……
  ▸ 找到 12 个文件，共 38 处 console.log
  ▸ 正在逐个清理……
  ▸ 清理完成！已修改 12 个文件

你想想，这是不是很像跟一个特别听话的助手在说话？你说啥它就干啥，还把每一步都给你看。

审查 Codex 的操作

Codex 每次要改文件、跑命令的时候，会在界面上显示它的操作计划。你可以：

• 看清楚它打算干啥
• 觉得没问题就让它继续
• 觉得不对劲随时喊停

提示

交互模式最适合干复杂的活，因为你可以随时看 Codex 在干嘛、纠正它的方向。

---

4.2 非交互模式：一句话让 Codex 干完就走

有时候你不需要聊天，就想让 Codex 帮你干个活就完了。这时候用非交互模式。

基本用法

# 让 Codex 帮你干个活，干完自动退出
codex "帮我检查这个项目有没有安全问题"

# 另一种写法，效果一样
codex exec "帮我检查这个项目有没有安全问题"

说白了就是"指派任务"的模式——你告诉它干啥，它干完把结果给你，然后各走各的。

配合管道用，威力翻倍

非交互模式最厉害的地方是能接收其他命令的输出：

# 把错误日志传给 Codex 分析，管道符 | 就像把文件"递给" Codex
cat error.log | codex "分析这个错误日志，找出根本原因"

# 把 git 改动传给 Codex，让它帮你写提交信息
git diff | codex "根据这些改动，帮我写一个 commit message"

# 让 Codex 帮你审查某个 PR 的代码
git diff main..feature | codex "审查这些改动的代码质量"

啥时候用交互、啥时候用非交互？

场景	用哪种	为啥
干一个复杂的活，需要来回讨论	交互模式	能随时沟通和调整
干一个简单的活，一句话能说清	非交互模式	干完就走，省时间
需要审查 Codex 每一步操作	交互模式	能实时看到它在干嘛
写个脚本批量处理	非交互模式	方便自动化
帮分析一下错误日志	非交互模式	分析完给你结果就行

---

4.3 斜杠命令：Codex 内部的小工具

在交互模式里，有些以 / 开头的命令不是发给 Codex 的话，而是直接控制 Codex 本身的。就像你在微信里用 / 打开快捷菜单一样。

常用斜杠命令一览

命令	干嘛用的	啥时候用
/help	看看有哪些命令可用	忘了命令的时候，万能救命稻草
/clear	清空当前对话，从头开始	想重新聊的时候
/compact	把太长的对话压缩一下	聊了很久、Codex 变慢的时候
/model	查看或切换模型	想换个更强或更快的模型
/quit	退出 Codex	干完活了

使用场景举例

# 聊着聊着觉得太慢了？压缩一下对话
/compact

# 想换个更强的模型试试
/model

# 聊岔了想重新开始
/clear

# 忘了有哪些命令
/help

提示

/compact 特别好用！聊久了之后 Codex 会变慢，因为它要处理的内容太多了。用 /compact 压缩一下，就像给 Codex 减负，立马就利索了。

---

4.4 常用工作流程一图看懂

下面这张图展示了日常使用 Codex 最常见的流程：

几个典型流程

流程一：修 Bug

1. codex                          ← 打开 Codex
2. "src/auth.py 第42 行报错了，帮我看看"    ← 描述问题
3. 查看 Codex 的分析和修复方案        ← 审查方案
4. 没问题，让它改                    ← 确认执行
5. /quit                           ← 干完走人

流程二：快速分析

# 一句话搞定，不进入聊天
codex "这个项目的架构是什么样的？给我画个图"

流程三：批量处理

# 配合 find 和管道，批量让 Codex 处理
find . -name "*.py" -exec codex "给这个文件加上类型注解" {} \;

---

4.5 键盘快捷键

聊天的时候这些快捷键很实用：

快捷键	干嘛用的
Enter	发送消息
Ctrl + C	打断 Codex 当前正在做的事
Escape	取消当前输入
↑ / ↓	翻看之前发过的消息
Ctrl + C 两次	退出 Codex

提示

Ctrl + C 是个好习惯。如果 Codex 在干一件你发现不对的事，直接 Ctrl + C 打断它，然后告诉它换一种方式。不用等它干完再说。

---

4.6 几个实用小技巧

技巧1：让 Codex 先想好再动手

你：我想给这个项目加一个用户登录功能。先别动手，先告诉我你打算怎么做。

Codex：好的，我先分析一下当前项目……
  计划如下：
  1. 创建用户模型和数据库表
  2. 添加登录和注册的 API
  3. 前端添加登录页面
  4. 加上 JWT 认证中间件
  你看这个方案行不行？

你：第3步先不做，只做后端部分

Codex：收到！按调整后的方案执行……

先看方案再动手，比直接让它开干靠谱多了。你想想，万一方向错了，白干一通不是浪费时间嘛。

技巧2：用上下文让 Codex 更懂你

你：这个项目用了 React + TypeScript，数据库是 PostgreSQL。
    现在帮我给用户表加一个 email 字段。

把背景信息一次性说清楚，Codex 就不用猜了，出来的结果也更准确。

技巧3：出错了别慌，让它自己修

你：帮我跑一下测试

Codex：测试跑了，有 3 个失败了……

你：看看失败的原因，自己修一下

Codex：好的，我看看……
  原来是 xxx 导致的，我来修……
  修好了，再跑一遍测试……
  这次全部通过了！

Codex 自己搞出来的问题，让它自己修，往往修得最快。

技巧4：非交互模式写脚本

#!/bin/bash
# 每天上班前跑一次，自动检查项目状态
echo "=== 项目健康检查 ==="
codex "检查当前项目的依赖是否都安装了、有没有安全漏洞、测试是否全部通过"
echo "=== 检查完毕 ==="

把 Codex 的非交互模式写进脚本里，自动化的活就轻松了。

---

4.7 小结

要点	一句话总结
交互模式	codex 打开聊天界面，适合复杂的活
非交互模式	codex "任务" 干完就走，适合简单的活
/compact	对话太长时压缩一下，给 Codex 减负
/clear	清空对话重新开始
/help	忘了命令就看帮助
/quit	退出 Codex
Ctrl + C	打断 Codex 正在做的事

一句话： 交互模式适合"聊天式干活"，非交互模式适合"指派任务就完事"。选对模式，效率翻倍。

---

下一章来聊聊怎么让 Codex 懂你的项目，省得每次都从头解释：第5章 让 Codex 懂你的项目