Skip to content

本页由 AI 根据韩语原文翻译,可能存在错误。

第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]

bash
# macOS, Linux
curl -fsSL https://chatgpt.com/codex/install.sh | sh
powershell
# 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]

bash
cd ~/hello-ai-practice/organizer
codex

终端里的 Codex,把运行它的文件夹当作这次对话的项目。[4] 在应用里用 Choose project 选文件夹的事,这里由 cd 来代替。

理解检查

在终端里运行 Codex CLI 安装命令之前,必须确认什么?

codex exec——问一次就结束 ​

codex exec 是这样一种方式:不打开对话画面,只运行一次就结束。[5] 我问了和 Claude Code 第10章同样的问题。

bash
cd ~/hello-ai-practice/organizer
codex exec "列出 notes 文件夹里的文件,并用一行告诉我每个文件是用哪种模板(templates 里的哪一个)写的。不要修改文件。回答要简短,只用表格。"

只出来了干净的回答(完整输出:ch7-codex-exec-output.txt)。

notes 文件使用的模板
study-2026-10-28-prompt-lecture.mdtemplates/study-notes.md
weekly-review-2026-10-26.mdtemplates/weekly-review.md
minutes-2026-10-27-weekly.mdtemplates/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章的练习,也是加了这个选项运行的。

bash
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 的交互界面里,想查看对话信息和剩余额度,用哪个命令?

动手试试 ​

  1. 确认官方文档的安装命令和上面的命令一致后再安装(如果已经装了,就输入 codex --version)。
  2. 进入整理工具文件夹,运行上面那个只读的 codex exec 提问。
  3. 用 codex 打开交互式界面,输入 /status 试试。
  4. 输入 $,或者运行 /skills,确认第5章的技能名称是否出现。[15:1]

连续任务:第8章里,我们会整理费用、数据、安全,并确认 Codex 怎么对待藏着隐藏指示的备忘。

总结 ​

  • 终端里的 Codex 把运行它的文件夹当作项目,读取那个文件夹里的 AGENTS.md 和技能。
  • 安装命令要确认和官方文档一致再运行。
  • codex exec 运行一次就结束,默认是只读的。想修改,就加 --sandbox workspace-write。
  • codex exec 是预先定好许可方式再运行的。需要许可的事,在应用或交互式界面里做。

术语整理 ​

术语中文名称一句话解释
Codex CLICodex 命令行版在终端里使用的 Codex
codex execcodex 一次性执行运行一次就结束的方式
stdout / stderr标准输出 / 标准错误正式输出 / 输出进度和错误的旁路

这一章读完了吗?

学习记录只保存在这个浏览器中。整体进度可以在 全部目录中查看。

下一章:第8章. 费用、数据、安全,以及怎样选工具

参考资料(15 条)
  1. 本指南运行的版本是 Codex CLI 0.166.0。 ↩︎

  2. Codex 官方文档,「Codex CLI」。 "curl -fsSL chatgpt.com | sh" / "powershell -ExecutionPolicy ByPass -c "irm chatgpt.com | iex"" learn.chatgpt.com (确认日期 2026-11-01) ↩︎

  3. 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) ↩︎

  4. 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) ↩︎

  5. 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) ↩︎

  6. Codex 官方文档,「Non-interactive mode」。 "While codex exec runs, Codex streams progress to stderr and prints only the final agent message to stdout." learn.chatgpt.com (确认日期 2026-11-01) ↩︎

  7. Codex 官方文档,「Non-interactive mode」。 "By default, codex exec runs in a read-only sandbox." / "Allow edits: codex exec --sandbox workspace-write "<task>"" learn.chatgpt.com (确认日期 2026-11-01) ↩︎

  8. Codex 官方文档,「Non-interactive mode」。 "Run with explicit, pre-set sandbox and approval settings." learn.chatgpt.com (确认日期 2026-11-01) ↩︎

  9. Codex 官方文档,「Non-interactive mode」。 "--full-auto is no longer supported." learn.chatgpt.com (确认日期 2026-11-01) ↩︎

  10. Codex 官方文档,「Agent approvals & security」。 "--dangerously-bypass-approvals-and-sandbox (alias: --yolo)" learn.chatgpt.com (确认日期 2026-11-01) ↩︎

  11. Codex 官方文档,「Permissions」。 "In the CLI, enter /permissions." learn.chatgpt.com (确认日期 2026-11-01) ↩︎

  12. Codex 官方文档,「Import from another agent」。 "Start a local Codex CLI session and type /import." learn.chatgpt.com (确认日期 2026-11-01) ↩︎

  13. Codex 官方文档,「Projects and chats」。 "Use /resume while Codex is open, or run codex resume, to continue a saved chat." learn.chatgpt.com (确认日期 2026-11-01) ↩︎

  14. 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) ↩︎

  15. Codex 官方文档,「Build skills」。 "In Codex CLI or the IDE extension, run /skills or type $ to mention a skill." learn.chatgpt.com (确认日期 2026-11-01) ↩︎