第7章 在终端里使用——用一行 codex exec 检查整理工具
选读 需要的时候再读。跳过也能跟上后面的章节。一句话总结:Codex CLI 是在终端里使用的 Codex。它会读取运行所在文件夹里的
AGENTS.md和技能。codex exec "要做的事"只运行一次就结束,而且默认是只读的。它和 Claude Code 的claude -p很像,但这一点不同。
这一章依据 2026年11月1日确认的 Codex 官方文档,以及在 macOS 终端里运行 Codex CLI 的结果[1]写成。如果你是第一次用终端,可以跳过这一章。 终端是什么,在 Claude Code 第10章里讲过了。
安装并开始使用
官方文档里的安装命令是这样的。[2]
# macOS, Linux
curl -fsSL https://chatgpt.com/codex/install.sh | sh# Windows PowerShell
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"把命令拆开来看是这样的。
curl -fsSL 地址:下载地址上的安装脚本(写着安装步骤的文件)。-fsSL是把四个选项连在一起写的:“出错就停下、隐藏进度显示、显示错误、地址搬家了就跟过去”。|(管道):把前一个命令的结果交给后一个命令。sh:运行接过来的脚本。- Windows 那边也一样。
irm负责下载,iex负责运行。-ExecutionPolicy ByPass只在这一次解除脚本运行限制。
请确认安装命令和官方文档(learn.chatgpt.com)上写的一模一样,再去运行。 因为这是把从网上下载的脚本直接执行的命令。
安装完成后,进入整理工具文件夹,输入 codex。第一次请选择 Sign in with ChatGPT。[3]
cd ~/hello-ai-practice/organizer
codex终端里的 Codex,把运行它的文件夹当作这次对话的项目。[4] 在应用里用 Choose project 选文件夹的事,这里由 cd 来代替。
理解检查
在终端里运行 Codex CLI 安装命令之前,必须确认什么?
codex exec——问一次就结束
codex exec 是这样一种方式:不打开对话画面,只运行一次就结束。[5] 我问了和 Claude Code 第10章同样的问题。
cd ~/hello-ai-practice/organizer
codex exec "列出 notes 文件夹里的文件,并用一行告诉我每个文件是用哪种模板(templates 里的哪一个)写的。不要修改文件。回答要简短,只用表格。"只出来了干净的回答(完整输出:ch7-codex-exec-output.txt)。
| notes 文件 | 使用的模板 |
|---|---|
study-2026-10-28-prompt-lecture.md | templates/study-notes.md |
weekly-review-2026-10-26.md | templates/weekly-review.md |
minutes-2026-10-27-weekly.md | templates/minutes.md |
来源:本指南的实践结果(2026-11-01)。运行过程的记录另外丢弃,只留下了最终回答。
codex exec 把进度和最终回答走不同的路输出。[6]
- 进度:走屏幕旁路(stderr,标准错误)。
- 最终回答:只走正式输出(stdout,标准输出)。
想把结果存成文件时,这个区别就有用了。比如,试着输入 codex exec "…" > result.md。> 是“把正式输出装进这个文件,而不是显示在屏幕上”的符号。这样,屏幕上只会滚过进度,result.md 里只会装进最终回答。如果已经有同名文件,> 会清掉它的内容重新写。所以请选一个第一次用的新名字。
codex exec 默认是只读的。 想让它修改文件,就加上 --sandbox workspace-write。[7] 本指南第2、3、5章的练习,也是加了这个选项运行的。
codex exec --sandbox workspace-write '$weekly-review'codex exec 是预先定好许可方式再运行的方式。[8] 本指南第5章的练习里,写入 .agents 文件夹被拦住时,Codex 没法询问,就那样停住了。需要许可的事,在应用或交互式 codex 里做会更方便。
也有把沙箱和许可全部关掉的危险选项,但整理备忘时请不要用。
老文章里出现的选项和危险的选项(点击展开)
老文章里出现的 --full-auto 选项已经不再支持。[9] 也有把沙箱和许可全部关掉的 --dangerously-bypass-approvals-and-sandbox 之类的选项[10],但整理备忘用不着。
理解检查
想用 codex exec 让它修改文件,却什么都没改。最合适的原因是什么?
交互式 codex 里的命令
用 codex 打开交互式界面后,可以使用以 / 开头的命令。
| 命令 | 做什么 |
|---|---|
/permissions | 更改权限(应用里的权限菜单) |
/import | 导入 Claude Code、Cursor 的设置 |
/resume | 继续已保存的对话 |
/status | 查看对话信息和剩余额度 |
/skills | 查看技能列表 |
来源:Codex 官方文档[11][12][13][14][15]
结束交互式界面后,想在外面继续,就输入 codex resume。[13:1]
/permissions 和 /import 是终端这边的命令。在应用里,用的是输入框下面的权限菜单(第4章)和设置里的 Import 菜单(第3章)。
理解检查
在 Codex CLI 的交互界面里,想查看对话信息和剩余额度,用哪个命令?
动手试试
- 确认官方文档的安装命令和上面的命令一致后再安装(如果已经装了,就输入
codex --version)。 - 进入整理工具文件夹,运行上面那个只读的
codex exec提问。 - 用
codex打开交互式界面,输入/status试试。 - 输入
$,或者运行/skills,确认第5章的技能名称是否出现。[15:1]
连续任务:第8章里,我们会整理费用、数据、安全,并确认 Codex 怎么对待藏着隐藏指示的备忘。
总结
- 终端里的 Codex 把运行它的文件夹当作项目,读取那个文件夹里的
AGENTS.md和技能。 - 安装命令要确认和官方文档一致再运行。
codex exec运行一次就结束,默认是只读的。想修改,就加--sandbox workspace-write。codex exec是预先定好许可方式再运行的。需要许可的事,在应用或交互式界面里做。
术语整理
| 术语 | 中文名称 | 一句话解释 |
|---|---|---|
| Codex CLI | Codex 命令行版 | 在终端里使用的 Codex |
codex exec | codex 一次性执行 | 运行一次就结束的方式 |
| stdout / stderr | 标准输出 / 标准错误 | 正式输出 / 输出进度和错误的旁路 |
这一章读完了吗?
学习记录只保存在这个浏览器中。整体进度可以在 全部目录中查看。
参考资料(15 条)
本指南运行的版本是 Codex CLI 0.166.0。 ↩︎
Codex 官方文档,「Codex CLI」。 "curl -fsSL chatgpt.com | sh" / "powershell -ExecutionPolicy ByPass -c "irm chatgpt.com | iex"" learn.chatgpt.com (确认日期 2026-11-01) ↩︎
Codex 官方文档,「Codex CLI」。 "Open a project directory and run
codex. The first time you run Codex, choose Sign in with ChatGPT or another available sign-in method." learn.chatgpt.com (确认日期 2026-11-01) ↩︎Codex 官方文档,「Projects and chats」。 "Codex CLI treats the directory where you start it as the project for the chat." learn.chatgpt.com (确认日期 2026-11-01) ↩︎
Codex 官方文档,「Non-interactive mode」。 "Non-interactive mode lets you run Codex from scripts (for example, continuous integration (CI) jobs) without opening the interactive TUI." learn.chatgpt.com (确认日期 2026-11-01) ↩︎
Codex 官方文档,「Non-interactive mode」。 "While
codex execruns, Codex streams progress tostderrand prints only the final agent message tostdout." learn.chatgpt.com (确认日期 2026-11-01) ↩︎Codex 官方文档,「Non-interactive mode」。 "By default,
codex execruns in a read-only sandbox." / "Allow edits:codex exec --sandbox workspace-write "<task>"" learn.chatgpt.com (确认日期 2026-11-01) ↩︎Codex 官方文档,「Non-interactive mode」。 "Run with explicit, pre-set sandbox and approval settings." learn.chatgpt.com (确认日期 2026-11-01) ↩︎
Codex 官方文档,「Non-interactive mode」。 "
--full-autois no longer supported." learn.chatgpt.com (确认日期 2026-11-01) ↩︎Codex 官方文档,「Agent approvals & security」。 "
--dangerously-bypass-approvals-and-sandbox(alias:--yolo)" learn.chatgpt.com (确认日期 2026-11-01) ↩︎Codex 官方文档,「Permissions」。 "In the CLI, enter
/permissions." learn.chatgpt.com (确认日期 2026-11-01) ↩︎Codex 官方文档,「Import from another agent」。 "Start a local Codex CLI session and type
/import." learn.chatgpt.com (确认日期 2026-11-01) ↩︎Codex 官方文档,「Projects and chats」。 "Use
/resumewhile Codex is open, or runcodex resume, to continue a saved chat." learn.chatgpt.com (确认日期 2026-11-01) ↩︎Codex 官方文档,「Pricing」。 "If you want to see your remaining limits during an active Codex CLI session, you can use
/status." learn.chatgpt.com (确认日期 2026-11-01) ↩︎Codex 官方文档,「Build skills」。 "In Codex CLI or the IDE extension, run
/skillsor type$to mention a skill." learn.chatgpt.com (确认日期 2026-11-01) ↩︎