---
title: "使用命令列版 Codex"
description: "Codex CLI 是 OpenAI 的本地 coding agent，可以在終端裡讀取程式碼、修改程式碼、執行命令，並把結果交給你審查。"
verifiedAt: "2026-05-07"
---

> [!NOTE]
> **這一篇用 10 分鐘換什麼**：把 Codex CLI 從"一個命令"重新理解成**一套終端 agent 的入口**——互動式 TUI、`exec` 指令碼化、`cloud` 委派、`mcp` 接入、`sandbox` 與 approval 雙層邊界。讀完後你會知道哪種場景該用哪種啟動姿勢。

Codex CLI 是 OpenAI 的 coding agent（程式設計 Agent），可以從你的終端本地執行。它能在你選定的目錄裡讀取程式碼、修改程式碼，並執行程式碼。

```mermaid
flowchart LR
    CLI["⚡ codex"]
    Local["💻 本地 TUI<br/>codex / codex resume / codex fork"]
    Exec["📜 指令碼化<br/>codex exec"]
    Cloud["☁️ 雲端<br/>codex cloud / apply"]
    Ext["🔌 擴充套件<br/>codex mcp / features / sandbox"]
    Sec{"🔐 安全雙層"}
    SB["sandbox<br/>read-only / workspace-write / danger"]
    AP["approval<br/>on-request / never"]
    CLI --> Local
    CLI --> Exec
    CLI --> Cloud
    CLI --> Ext
    CLI --> Sec
    Sec --> SB
    Sec --> AP
```

Codex CLI 是開源專案：

https://github.com/openai/codex

它使用 Rust 構建，重點是速度和效率。

ChatGPT Plus、Pro、Business、Edu 和 Enterprise 套餐都包含 Codex。你可以在官方 pricing（價格）頁面瞭解具體包含內容：

https://developers.openai.com/codex/pricing

官方頁面還提供了一個 Codex CLI overview（Codex CLI 概覽）影片：

```text
title     Codex CLI overview
videoId   iqNzfK4_meQ
```

## CLI 設定

Codex CLI 支援 macOS、Windows 和 Linux。

在 Windows 上，你可以在 PowerShell 中原生執行 Codex，並使用 Windows sandbox（Windows 沙箱）。如果你需要 Linux-native environment（原生 Linux 環境），可以使用 WSL2。

Windows 設定細節見官方 Windows setup guide：

https://developers.openai.com/codex/windows

如果你是 Codex 新手，建議閱讀官方 best practices guide：

https://developers.openai.com/codex/learn/best-practices

## 什麼時候選 CLI

優先選擇 CLI 的場景：

- 你已經在 terminal 中工作，並希望 Codex 直接使用當前 repo。
- 任務需要跑本地測試、lint、build 或指令碼。
- 你想用 `~/.codex/config.toml` 控制模型、sandbox、approval 和 MCP。
- 你要把 Codex 接入指令碼、CI 或批處理。
- 你需要 `codex exec`、`codex mcp`、`codex resume`、`codex sandbox` 等命令。

不適合優先選 CLI 的場景：

- 你主要想要桌面多執行緒、worktree、review pane 和 GUI diff。
- 你希望在 GitHub 裡直接委託 cloud task。
- 你不熟悉 terminal，也沒有本地開發環境。

## 使用 Codex CLI 工作

### 互動式執行 Codex

執行 `codex`，啟動一個 interactive terminal UI（互動式終端介面，也就是 TUI）會話。

官方對應頁面：

https://developers.openai.com/codex/cli/features#running-in-interactive-mode

### 控制模型和推理

使用 `/model` 可以在 GPT-5.4、GPT-5.3-Codex 以及其他可用模型之間切換，也可以調整 reasoning levels（推理強度）。

官方對應頁面：

https://developers.openai.com/codex/cli/features#models-reasoning

### 圖片輸入

你可以附加截圖或設計稿，讓 Codex 在閱讀提示詞的同時參考這些圖片。

官方對應頁面：

https://developers.openai.com/codex/cli/features#image-inputs

### 圖片生成

你可以直接在 CLI 裡生成或編輯圖片。如果希望 Codex 基於已有素材迭代，也可以附加參考圖。

官方對應頁面：

https://developers.openai.com/codex/cli/features#image-generation

### 執行原生代碼審查

在 commit 或 push 之前，可以讓另一個 Codex agent（Codex Agent）審查你的程式碼。

官方對應頁面：

https://developers.openai.com/codex/cli/features#running-local-code-review

### 使用 subagents

使用 subagents（子 Agent）可以並行處理複雜任務。

官方對應頁面：

https://developers.openai.com/codex/subagents

### 網頁搜尋

你可以讓 Codex 搜尋網頁，為當前任務獲取最新資訊。

官方對應頁面：

https://developers.openai.com/codex/cli/features#web-search

### Codex Cloud 任務

你可以從終端發起 Codex Cloud 任務，選擇 environments（環境），並在不離開終端的情況下應用任務產生的 diffs（差異改動）。

官方對應頁面：

https://developers.openai.com/codex/cli/features#working-with-codex-cloud

### 把 Codex 指令碼化

你可以用 `exec` command（`exec` 命令）把 Codex 指令碼化，自動執行可重複的工作流。

官方對應頁面：

https://developers.openai.com/codex/noninteractive

### Model Context Protocol（MCP）

透過 Model Context Protocol（MCP，模型上下文協議），你可以給 Codex 接入更多第三方工具和上下文。

官方對應頁面：

https://developers.openai.com/codex/mcp

### 審批模式

在 Codex 編輯檔案或執行命令之前，你可以選擇適合自己風險承受程度的 approval mode（審批模式）。

官方對應頁面：

https://developers.openai.com/codex/cli/features#approval-modes

## 常用命令地圖

| 命令 | 用途 | 適合場景 |
| --- | --- | --- |
| `codex` | 啟動 interactive TUI | 日常本地開發和探索 |
| `codex exec` / `codex e` | 非互動執行 Codex | CI、指令碼、批處理、結構化輸出 |
| `codex resume` | 繼續舊會話 | 回到之前的上下文 |
| `codex fork` | fork 舊會話到新 thread | 保留歷史，同時嘗試另一條路線 |
| `codex apply` | 應用 Codex Cloud task 的 diff | 從雲端任務回到本地工作樹 |
| `codex cloud` | 在終端管理 cloud tasks | 不開啟 Web UI 的 cloud workflow |
| `codex login` / `logout` | 登入或移除憑據 | 初始化和賬號切換 |
| `codex mcp` | 管理 MCP servers | 接入外部工具和上下文 |
| `codex features` | 管理 feature flags | 開關穩定或實驗能力 |
| `codex sandbox` | 用 Codex sandbox 執行命令 | 除錯 sandbox 行為 |
| `codex app` | 從終端啟動 Codex Desktop | CLI 和桌面 app 聯動 |
| `codex app-server` | 啟動 app server | 遠端 TUI 或富客戶端除錯 |

官方 command reference 會標註 Stable、Experimental 等 maturity。新手優先使用 Stable 命令；Experimental 命令要按除錯或內部整合看待，不要當成長期 API 承諾。

## 推薦啟動引數

低風險本地開發：

```bash
codex --sandbox workspace-write --ask-for-approval on-request
```

只讀分析：

```bash
codex --sandbox read-only --ask-for-approval on-request
```

非互動任務：

```bash
codex exec --sandbox workspace-write --ask-for-approval never "Run lint and summarize failures"
```

需要 live web search：

```bash
codex --search
```

不要在普通工作目錄裡使用：

```bash
codex --dangerously-bypass-approvals-and-sandbox
```

這個模式會繞過 approvals 和 sandbox，只適合外部已經隔離好的 runner、VM 或 disposable container。

## CLI 工作流正規化

### 解釋專案

```text
Tell me about this project. Focus on architecture, entry points, build commands, and the safest first change.
```

適合新接手程式碼庫。先讓 Codex 讀結構和指令碼，不要直接改程式碼。

### 小範圍修 bug

```text
Reproduce the failing test, identify the smallest responsible code path, fix only that bug, and run the narrowest relevant test.
```

關鍵是要求 reproduce、localize、minimal fix、prove。

### 本地 code review

```text
Review my unstaged changes for bugs, missing tests, and risky behavior. Do not edit files. Return findings with file paths and evidence.
```

先只讀 review，再決定是否讓 Codex 修改。

### 指令碼化執行

```bash
codex exec --json --output-last-message /tmp/codex-summary.md "Audit this package and report only actionable failures"
```

`--json` 適合下游程式消費事件，`--output-last-message` 適合保留最終摘要。

## 安全邊界

CLI 的核心安全配置來自兩層：

- `sandbox`：Codex 技術上能訪問和修改什麼。
- `approval`：Codex 什麼時候必須暫停請求許可。

常見組合：

| 組合 | 用途 |
| --- | --- |
| `read-only` + `on-request` | 只讀調研、review、方案 |
| `workspace-write` + `on-request` | 日常本地開發 |
| `workspace-write` + `never` | 受控自動化 |
| `danger-full-access` + `never` | 外部隔離環境內的高許可權自動化 |

需要額外目錄寫許可權時，優先用 `--add-dir`，不要直接切到 full access。

## 新手完成標準

第一次使用 CLI，建議完成這套閉環：

1. `codex login status` 確認登入。
2. 在 Git repo root 執行 `codex`。
3. 用只讀 prompt 讓 Codex 解釋專案。
4. 用小任務讓 Codex 修改一處低風險檔案。
5. 讓 Codex 跑最小驗證命令。
6. 用 `git diff` 審查改動。
7. 只在確認後提交。

## 官方資料

- [Codex CLI](https://developers.openai.com/codex/cli)
- [Command line options](https://developers.openai.com/codex/cli/reference)
- [Config basics](https://developers.openai.com/codex/config-basic)
- [Agent approvals & security](https://developers.openai.com/codex/agent-approvals-security)
- [Codex best practices](https://developers.openai.com/codex/learn/best-practices)

## 接下來去哪

<Cards>
  <Card title="CLI 命令引數" href="/zh-Hant/docs/codex/official/01-products/27-cli-args" description="逐項理解 codex 全部 flag" />
  <Card title="CLI 功能詳解" href="/zh-Hant/docs/codex/official/01-products/26-cli-features" description="按功能維度深入" />
  <Card title="CLI Slash 命令" href="/zh-Hant/docs/codex/official/01-products/25-cli-slash" description="TUI 內可用的 / 命令" />
  <Card title="非互動模式" href="/zh-Hant/docs/codex/official/01-products/28-non-interactive" description="codex exec 指令碼化與 CI 用法" />
  <Card title="Cloud 執行時" href="/zh-Hant/docs/codex/official/05-cloud-remote/18-cloud-runtime" description="把任務委派給雲端環境" />
  <Card title="基礎配置" href="/zh-Hant/docs/codex/official/02-config-security/06-basic-config" description="config.toml 是 CLI 行為的家" />
  <Card title="批准與安全模式" href="/zh-Hant/docs/codex/official/02-config-security/07-approval-security" description="日常應該選哪個組合" />
</Cards>
