你有沒有遇過 Claude Code 用一用感覺突然卡住？感覺越用越笨？
我有。最近我開始改變策略，與其一直跟 Claude Code 來回跑，我決定把同樣的任務丟給 Codex——結果原本卡住的問題十秒後它解決了。
那個瞬間我才意識到：Claude Code 跟 Codex 可以這樣互補使用。問題是，很多人一聽到「換工具」就以為要重建整個專案。不用。只要幾分鐘，你現有的 Claude Code 專案就可以讓 Codex 直接接手。
為什麼兩個工具不能直接共用？
Claude Code 跟 Codex 都是 AI 開發工具，但它們讀取專案的方式不一樣。
| 工具 | 主要設定檔 | 資料夾 |
|---|---|---|
| Claude Code | CLAUDE.md |
.claude/（settings、agents、skills） |
| Codex | AGENTS.md |
.codex/（settings、agents）+ .agents/（skills） |
| 兩者共用 | docs/、context/、references/ 等知識資料夾 |
|
問題很簡單：不是你的知識要重建，而是你要多給 Codex 它認識的入口檔案。你的 docs、references、context 資料夾——那些共享的知識，兩個工具都可以直接讀，不用動。
關鍵洞察：你的專案大腦不用動
很多人犯的錯是以為「工具換了，所有東西要重來」。不對。
你的 CLAUDE.md、你建的 skills、你的 context 資料夾——這些是你的專案知識層，跟工具無關。你只需要建立一個 Codex 能讀的介面層：AGENTS.md、.codex/config.toml、.agents/skills/。
你建的不是一個 Claude Code 專案，而是一個可以被任何 AI 工具讀取的智能系統。
Skills 跟 Agents 的遷移方式
Skills：直接複製
Claude Code 的 skills 放在 .claude/skills/，Codex 的放在 .agents/skills/。格式完全一樣——SKILL.md 兩個工具都認識，直接複製過去就好。
Agents：格式轉換
Claude Code 的 agents 是 .md 檔，放在 .claude/agents/。Codex 的 agents 是 .toml 檔，放在 .codex/agents/。格式不同，但裡面的指令邏輯是一樣的——你可以直接叫 Codex 幫你轉換格式，它知道怎麼做。
Migration Prompt：貼進去，Codex 自己搞定
打開 Codex，貼上這段 prompt，它會自己研究你的專案，把所有 Codex 設定建好：
我用 Claude Code 建了這個專案，現在想讓它也能在 Codex 裡正常運作。
請檢查這個專案，幫我建立 Codex 的設定。請做以下幾件事：
1. 在專案根目錄建立 AGENTS.md
- 以 CLAUDE.md 作為專案知識的來源
- 說明 AGENTS.md 是面向 Codex 的介面文件
- 包含清楚的專案地圖
2. 建立 .codex/config.toml
- 從最小可用的安全設定開始
- 不要加入任何密鑰
3. 建立 .agents/skills/
- 把重要的 Claude skills 從 .claude/skills/ 複製到 .agents/skills/
- 不要把 skills 放在 .codex/skills/ 裡
4. 為重要的 Claude agents 建立 .codex/agents/
- Claude agents 是 .claude/agents/ 裡的 .md 檔案
- Codex agents 是 .codex/agents/ 裡的 .toml 檔案
- 把指令轉換成 developer_instructions 格式
5. 如果需要，更新 .gitignore
在開始編輯之前，先告訴我你打算建立或修改哪些檔案。整個過程幾分鐘。Codex 會自己去研究你的文件，把需要的東西全部建好。
什麼時候用哪個工具？
這是我個人的答案，不是官方說法。
日常任務，用 Claude Code。內容創作、快速 debug、寫 skill、常規任務——Claude Code 快、熟悉你的風格、有你建好的記憶系統在背後支撐。
複雜的 app 開發，切換到 Codex + GPT 5.5。電商系統、複雜的後端邏輯、需要高推理能力的專案——把 Codex 調到 medium 或 high 推理強度，往往能更快突破瓶頸。
最重要的那個觀念：不要鎖死在一個工具裡。如果 Claude Code 今天停服，你還可以繼續工作嗎？有了 Codex 設定好在旁邊，你的答案是「可以」。
轉移之後的維護習慣
遷移完後，養成這個同步習慣：
.claude/skills/有新的 → 複製一份到.agents/skills/CLAUDE.md有重大更新 → 也更新AGENTS.md
不難。但不做的話，兩個工具慢慢會分裂——你的 Codex 就會用一份過時的大腦在工作。
免費下載：完整學習資源 PDF
13 頁速查表，包含完整 Migration Prompt、檔案結構對照、模型比較、維護習慣。