---
title: "03 - 互動模式基本操作"
type: note
specialty: Programming
tags: [codex-cli從0開始使用教學, 03-互動模式, slash-commands]
created: 2026-08-04
updated: "2026"
modified: 2026-08-04
---

# 03 - 互動模式基本操作

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

---

## 開一個 session

```bash
cd ~/Taiwan_IM_board
codex
```

或直接帶任務：

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

> ⚠️ **預設要在 git repo 裡跑。** 非 repo 目錄要用 `--skip-git-repo-check`（非互動模式）。

---

## 斜線指令

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

常見的：

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

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

---

## 快捷鍵

| 鍵 | 作用 |
|---|---|
| `Ctrl+C` | 離開（或 `/quit`）|
| **`Ctrl+J`** | **換行**（跨終端機最可靠的換行鍵）|
| `Esc` | 打斷目前工作 |

> 🔑 **`Ctrl+J` 要記住。** 多行輸入時 `Enter` 通常是送出，`Shift+Enter` 在很多終端機不可靠（跟 [[Programming/Claude-Code/Claude-Code-CLI從0開始使用教學/04-互動介面與快捷鍵|Claude Code 那邊]] 是同一個問題）。**`Ctrl+J` 是那個到處都能用的。**

---

## Session 管理

```bash
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。**所有規格都要自己帶。**

範本：

```markdown
# 任務：<一句話>

## 背景
<它需要知道的最小脈絡>

## 輸入
- <檔案路徑>

## 輸出（唯一）
- <明確的檔案路徑與格式>

## 硬規則
1. <不能違反的事>
2. **不要 git commit、不要 git push**
3. 不確定的地方標記出來，不要猜

## 完成條件
<可驗證的事實>

做完只回覆「DONE <路徑>」，不要貼出全文。
```

最後那句「不要貼出全文」很重要——尤其是被 [[Programming/Herdr/Herdr從0開始使用教學/06-CLI與自動化基礎|Herdr 讀輸出]] 時，長回應會撞上 alternate screen 的讀取限制。

---

## 🔗 相關筆記

- [[02-安裝與登入]] — 上一步
- [[04-Sandbox與Approval權限模型]] — 下一步：⚠️ 最該讀的一章
- [[08-實戰-被Claude指揮的雙手]] — 任務檔的完整範例
- [[Programming/Codex/Codex從0開始使用教學/05-實戰提示詞與上手流程|Codex 05 - 實戰提示詞]] — prompt 寫法

---

*最後更新：2026-08-04*