03 - 互動模式基本操作

02-安裝與登入 | 00-Index | 下一篇 → 04-Sandbox與Approval權限模型


開一個 session

cd ~/Taiwan_IM_board
codex

或直接帶任務:

codex "把 tools/validate.py 的錯誤訊息改成繁體中文"

⚠️ 預設要在 git repo 裡跑。 非 repo 目錄要用 --skip-git-repo-check(非互動模式)。


斜線指令

在互動介面裡打 / 會開指令選單。用你安裝版本的選單為準——指令會隨版本增減。

常見的:

指令作用
/model選模型(打完 Enter 從彈出選單挑)
/permissions調整權限(/approvals 仍是別名,但已不在選單列表裡)
/status看目前 session 狀態
/mcp檢視可用的 MCP 工具與資源
/resume接續之前的 session
/title幫這次對話命名
/plugins管理 plugin
/agentagent thread 相關
/review進 review 模式
/copy複製
/fast速度模式
/personality調整回應風格
/raw原始輸出
/help說明(最可靠的指令清單來源
/quit離開

💡 不要背這張表。/help/ 看你這個版本實際有什麼。斜線指令是 Codex 迭代最快的部分。


快捷鍵

作用
Ctrl+C離開(或 /quit
Ctrl+J換行(跨終端機最可靠的換行鍵)
Esc打斷目前工作

🔑 Ctrl+J 要記住。 多行輸入時 Enter 通常是送出,Shift+Enter 在很多終端機不可靠(跟 Claude Code 那邊 是同一個問題)。Ctrl+J 是那個到處都能用的。


Session 管理

codex resume            # 接續目前 repo 最近的 session
codex resume --all      # 找其他目錄的 session

Session 預設以工作目錄為範圍。 這跟 Claude Code 的 --resume 一樣——在同一個目錄跑才找得到。

在 session 裡用 /resume 也可以。

💡 什麼時候該 resume 而不是重開:先前的對話已經含有計畫、決策和實作脈絡時。重開等於重新解釋一次,浪費額度。


圖片與檔案

Codex CLI 支援把圖片當輸入(截圖、設計稿、錯誤畫面)。實際的傳入方式(拖放 / 路徑 / 貼上)依版本而異,/help 會說明。

💡 這對你的 PDF 截圖 SOP 有用:可以把截好的圖給它看,確認 title/caption 有沒有被切掉——雖然這個判斷用 Claude 做也可以。


一個實用的工作節奏

1. cd 到 repo,開一個乾淨的 branch
2. codex --profile <適合的安全等級>
3. 給一個範圍很窄的任務 + 明確的完成條件
4. 看它的計畫和提議(on-request 模式會問你)
5. 做完自己 git diff 檢查
6. 自己 commit(不要讓它 commit)

第 6 步對你是硬規則:兩個 repo 都規定 commit 由 orchestrator 統一做。在全域 ~/.codex/AGENTS.md 裡寫死「不要 commit」是最省事的做法。


Prompt 寫法

Codex 讀不到你的 CLAUDE.md、也沒有你的 12 個 skill。所有規格都要自己帶。

範本:

# 任務:<一句話>
 
## 背景
<它需要知道的最小脈絡>
 
## 輸入
- <檔案路徑>
 
## 輸出(唯一)
- <明確的檔案路徑與格式>
 
## 硬規則
1. <不能違反的事>
2. **不要 git commit、不要 git push**
3. 不確定的地方標記出來,不要猜
 
## 完成條件
<可驗證的事實>
 
做完只回覆「DONE <路徑>」,不要貼出全文。

最後那句「不要貼出全文」很重要——尤其是被 Herdr 讀輸出 時,長回應會撞上 alternate screen 的讀取限制。


🔗 相關筆記


最後更新:2026-08-04