canonical_url: https://yycode.net/docs/zh-TW/claude-code-codex-collaboration-guide
lang: zh-TW
updated_at: 2026-07-04T13:33:48.616Z
source_html: https://yycode.net/docs/zh-TW/claude-code-codex-collaboration-guide

# Claude Code 與 Codex 協同開發指南

## 為什麼要這樣搭配？

一句話：**讓貴的模型動腦，讓便宜的模型動手，帳單不爆炸。**

Claude 擅長理解需求、架構規劃、複雜推理，但價格也擺在那——用它來寫大量程式碼，Token 燒得飛快。Codex 的程式碼能力強、速度快，關鍵是價格便宜很多。

所以最合理的搭配是：

- **Claude 負責規劃**：理解你的需求，拆解任務，做架構決策，想清楚怎麼做
- **Codex 負責執行**：通過 `/codex:rescue` 接手具體的編碼任務，寫程式碼、修 bug、跑測試
- **Codex 負責審查**：通過 `/codex:review` 給 Claude 的程式碼做 code review，充當第二雙眼睛

這個搭配的核心邏輯是：Claude 的 Token 只花在「想清楚」上，具體的編碼和審查交給更便宜的 Codex。對於每天高強度使用 Claude Code 的人來說，能顯著降低整體開銷。

> 本指南假設你已完成 Claude Code 和 Codex 的安裝設定。如未完成，請先參考：
> - Claude Code 設定：[yycode 快速開始指南](DragonCode快速开始指南.md)
> - Codex 設定：[yycode × Codex 快速開始指南](DragonCode-Codex快速开始指南.md)

---

## 1. 安裝 Codex 插件

兩邊都配好之後，在 Claude Code 裡裝一個插件就能串起來：

```bash
/plugin marketplace add openai/codex-plugin-cc
/plugin install codex@openai-codex
/reload-plugins
/codex:setup
```

`/codex:setup` 會自動檢測 Codex 是否安裝、是否已認證。如果提示未登入，執行 `!codex login` 完成認證。

安裝完成後，輸入 `/codex` 即可看到新增的斜杠指令。

---

## 2. 核心指令

這個插件一共就三類能力：**審查**、**委派任務**、**任務管理**。

### 審查類（只讀，不改程式碼）

| 指令 | 作用 |
|---|---|
| `/codex:review` | 讓 Codex 審查目前未提交的改動，或對比分支 |
| `/codex:adversarial-review` | 對抗性審查——不只是檢查程式碼，而是主動質疑你的設計決策 |

```bash
# 審查未提交的改動
/codex:review

# 審查目前分支和 main 的差異
/codex:review --base main

# 後台執行，不阻塞目前對話
/codex:review --background

# 對抗性審查，指定關註方向
/codex:adversarial-review --background 檢查是否有竞態條件，質疑缓存策略的選擇
```

### 委派類（把任務交給 Codex 執行）

| 指令 | 作用 |
|---|---|
| `/codex:rescue` | 把一個具體任務交給 Codex 去做，Codex 會實際修改程式碼 |

這是實現「Claude 規劃，Codex 執行」的核心指令。你可以把 Claude 規劃好的任務，逐個交給 Codex 去實現：

```bash
# 讓 Codex 去查 bug
/codex:rescue investigate why the tests started failing

# 讓 Codex 去修 bug
/codex:rescue fix the failing test with the smallest safe patch

# 讓 Codex 去實現一個功能
/codex:rescue 實現使用者註冊的表單驗證邏輯

# 後台執行，適合耗時任務
/codex:rescue --background 重構資料庫連接池

# 指定更便宜的模型，進一步省錢
/codex:rescue --model gpt-5.4-mini 寫一組單元測試覆盖 utils.ts
/codex:rescue --model spark 快速修復這個 lint 錯誤

# 繼續上次的任務
/codex:rescue --resume 把上次的修復方案應用上去
```

> ?? **省錢技巧**：`--model gpt-5.4-mini` 或 `--model spark` 可以用更便宜更快的模型執行簡單任務。

### 任務管理類

| 指令 | 作用 |
|---|---|
| `/codex:status` | 檢視正在執行和最近完成的 Codex 任務 |
| `/codex:result` | 取得已完成任務的結果（含 session ID，可在 Codex 中繼續） |
| `/codex:cancel` | 取消正在執行的後台任務 |

---

## 3. 推薦工作流：Claude 規劃，Codex 執行

### 日常開發流程

```
你提需求 → Claude 分析拆解 → /codex:rescue 逐個執行 → /codex:review 審查 → 提交
```

1. **用自然語言描述需求**，讓 Claude 理解你要什麼
2. **Claude 做規劃**：拆解任務、確定實現方案、理清先後順序——這是 Claude 最擅長的
3. **用 `/codex:rescue` 把具體編碼任務交給 Codex**：Claude 規劃好了"要做 A、B、C 三件事"，你就用 rescue 一個個交給 Codex 去寫
4. **程式碼寫完跑審查**：`/codex:review --background`，讓 Codex 做獨立 code review
5. 根據審查意見修復後提交

這個流程的好處是：Claude 的 Token 只花在規劃和理解上，大量的編碼工作走 Codex 的便宜額度。

### 高風險改動流程

涉及資料庫遷移、認證授權、基礎設施變更時，多加一層對抗性審查：

```
Claude 規劃 → /codex:rescue 執行 → /codex:review → 修復 → /codex:adversarial-review → 再修復 → 提交
```

對抗性審查會主動質疑你的設計——比如"為什麼選這個緩存策略""回滾方案考慮了嗎""這裡有沒有競態條件"。高風險改動需要這種壓力測試。

### Claude 卡住時

如果 Claude 在某個任務上反覆嘗試都不理想，直接換 Codex 來試：

```bash
/codex:rescue 用最小改動修復這個問題
```

換一個模型的思路，經常能突破僵局。

---

## 4. 後台執行（推薦）

審查和 rescue 任務都建議加 `--background`，不阻塞目前對話：

```bash
/codex:rescue --background 實現分頁功能
# 繼續和 Claude 聊别的事...
/codex:status          # 隨時看進度
/codex:result          # 完成後取結果
```

> `/codex:result` 會回傳一個 session ID，你可以用 `codex resume <session-id>` 在 Codex 裡繼續這個任務。

---

## 5. 審查門禁（可選）

開啟後，Claude Code 在完成任務前會自動觸發一次 Codex 審查，發現問題則打斷流程先修復：

```bash
/codex:setup --enable-review-gate    # 開啟
/codex:setup --disable-review-gate   # 關閉
```

> ?? **注意**：審查門禁會顯著增加 Token 消耗，可能造成 Claude 和 Codex 之間的長循環。建議僅在關鍵專案中使用，日常開發手動跑 `/codex:review` 即可。

---

## 6. Codex 模型設定

想改變 Codex 預設使用的模型或推理強度，可以在設定檔中設置。

使用者級設定：`~/.codex/config.toml`
專案級設定：專案根目錄下 `.codex/config.toml`

```toml
model = "gpt-5.4-mini"
model_reasoning_effort = "high"
```

也可以在每次調用時通過 `--model` 和 `--effort` 臨時指定：

```bash
/codex:rescue --model spark --effort medium 快速修復 lint 錯誤
```

---

## 7. 什麼時候不該用 Codex

以下情況建議全程用 Claude：

| 場景 | 原因 |
|---|---|
| 深度業務邏輯重構 | Codex 拿不到 Claude 對話中積累的完整上下文，生成的程式碼可能和專案風格不一致 |
| 需要跨檔案深度理解的任務 | Codex rescue 是獨立執行的，不共享 Claude 的對話歷史 |
| 程式碼量很少的任務 | 只有幾行程式碼，沒必要委派，直接讓 Claude 寫更快 |

---

## 8. 實用技巧

- **簡單任務用便宜模型**：`--model spark` 適合修 lint、寫樣板程式碼這種不需要深度推理的活
- **先 review 再 adversarial-review**：不要上來就用對抗性審查，先用普通審查過一遍基礎問題
- **善用 --resume**：`/codex:rescue --resume` 可以繼續上一次的 Codex 任務，不用從頭開始
- **關註兩邊用量**：雖然整體更省，但記得同時關註 Claude 和 OpenAI 兩邊的用量，避免某一邊意外超支
- **Skill 沖突處理**：如果你的自定義 Skill 和 Codex 插件有觸發詞沖突，在沖突 Skill 裡加 `priority: low`

---

## 常見問題

**Q：安裝插件後沒看到 `/codex` 指令？**
A：執行 `/reload-plugins` 重新載入插件。

**Q：`/codex:review` 報認證錯誤？**
A：說明 Codex 的認證沒配好。請參考 [yycode × Codex 快速開始指南](DragonCode-Codex快速开始指南.md) 重新設定，或執行 `!codex login` 重新登入。

**Q：`/codex:rescue` 和直接讓 Claude 寫程式碼有什麼區別？**
A：rescue 是把任務交給 Codex 獨立執行，消耗的是 OpenAI 額度而不是 Claude Token。適合標準化編碼任務。但 Codex 拿不到你和 Claude 的對話上下文，所以任務描述要寫清楚。

**Q：審查結果和 Claude 的判斷矛盾怎麼辦？**
A：這恰恰是雙模型協作的價值。兩邊意見不一致時，你作為開發人員來做最終決策。

**Q：到底能省多少？**
A：取決於你把多少編碼工作交給 Codex。如果你的工作流中程式碼生成占比高（比如大量寫測試、寫 CRUD），把這些都 rescue 出去，Claude 的消耗可以大幅降低。