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