Codex vs Claude Code:兩大終端機 AI 助手怎麼選,加新手避坑總整理

前五課你一路把 Codex 從安裝、核准模式、改檔流程、AGENTS.md,一直練到動手做完一個真實需求。到這裡你應該有個感覺:所謂「終端機 AI 工程助手」,骨子裡就是一個會讀你專案、會改檔、會跑指令、聽得懂人話的助手。

那問題來了:市面上不只 Codex 一家。你一定聽過 Claude Code——Anthropic 出的同類工具,用法幾乎一模一樣。很多人卡在這裡:到底該用哪個?要不要兩個都訂?學了 Codex 換到 Claude Code 是不是要重學一次?

這堂課就是系列的收尾。我們先把兩者攤開來比,給你一張「照著選就對」的決策圖;接著把前五課的心法濃縮成一套通用工作流(這套流程在兩個工具上都能用);最後把新手最常踩的坑連同真實錯誤訊息一次整理清楚,讓你帶著一整套能長期用的習慣離開。

這堂課適合誰適合:已經會用 Codex 跟終端機一起改專案、想知道 Claude Code 值不值得也裝一個、並想把整套習慣定型的人(本課程屬工程師應用專區)。需要基礎:跑過前五課,會開終端機、看得懂 `git status` 與 `git diff`。前置課:第 1 到第 5 課(尤其第 2 課核准模式、第 4 課 `AGENTS.md`)。

這堂學什麼

Codex 與 Claude Code 的七項橫向比較:出品、模型、記憶檔、訂閱、開源、非互動指令、核心體驗
一張決策圖:照你手上的訂閱直接選,不用兩邊都花錢
Codex CLI 2026 年 7 月的指令地圖:codex / codex exec / codex resume / codex review
Codex 的兩道安全閥:--sandbox 沙盒模式 × --ask-for-approval 核准模式怎麼搭
一套跨工具通用的**「不炸專案」標準工作流**(前五課心法濃縮版)
新手最常踩的坑與確切錯誤訊息的解法

觀念一:別糾結,先看你在付誰的錢

先給結論,免得你看完比較表還在猶豫。選工具這件事,對絕大多數人來說只有一個判準:你已經在付誰的訂閱,就先用誰。

決策圖:你已經在付誰的訂閱?有 ChatGPT 就用 Codex、有 Claude 就用 Claude Code、都有就同一任務兩邊各跑一次

原因很實際:Codex 可以直接用你的 ChatGPT Plus/Pro 訂閱登入使用,Claude Code 可以直接用你的 Claude Pro/Max 訂閱使用。如果你已經在付 ChatGPT,再另外訂一份 Claude 只為了試 Claude Code,多半是浪費錢——核心體驗高度相似,學會一個,另一個幾乎立刻上手。

真的想比較?最好的方法不是看評測文,是拿同一個任務在兩邊各跑一次,看誰的產出比較合你意、誰的節奏你比較順手。工具的差距,遠小於「你有沒有把需求講清楚」造成的差距——這點我們後面會再強調。

觀念二:七項橫向比較

把兩者攤開來看,你會發現它們像兩個不同廠牌但功能對齊的工具:

Codex 與 Claude Code 七項比較表:出品、模型、記憶檔、非互動模式、訂閱、開源、核心體驗

逐項說明幾個重點(以 2026 年 7 月現況為準):

出品:Codex 是 OpenAI,Claude Code 是 Anthropic。
背後模型:Codex 現在預設用 gpt-5.5,另有 gpt-5.4(旗艦)、gpt-5.4-mini(快而省,適合子代理與輕量任務),ChatGPT Pro 還有研究預覽的 gpt-5.3-codex-spark。Claude Code 這邊是 Claude Opus 4.8、Sonnet 5 這一代。注意舊版的 gpt-5-codex、gpt-5.2 這類名字對 ChatGPT 登入已經淘汰了,舊教學裡看到請自動換算成新名字。
專案記憶檔:Codex 是 AGENTS.md(第 4 課教過),Claude Code 是 CLAUDE.md。作用一模一樣——把專案規矩寫一次,省得每次重講。
非互動模式:Codex 用 codex exec "任務",Claude Code 用 claude -p "任務"。兩者都能塞進腳本或 CI 自動化。
訂閱共用:Codex 吃 ChatGPT Plus、Pro、Business、Edu、Enterprise;Claude Code 吃 Claude Pro、Max。
開源:Codex CLI 是開源的(用 Rust 寫,主打速度);Claude Code 沒有開源。
核心體驗:終端機加自然語言,兩邊幾乎一樣。

觀念是互通的核准模式、先計畫再動手、寫專案記憶檔、叫它自己跑測試——這些心法在兩個工具上完全通用。你前五課學的不是「Codex 的操作」,是「怎麼跟終端機 AI 協作」。這才是能帶著走的資產。

觀念三:Codex CLI 指令地圖(2026-07)

既然這是 Codex 系列的收尾,把 CLI 目前的核心指令再收攏一次。Codex CLI 這半年更新很快,現在版本已經到 0.142 這一帶,幾個你一定會用到的入口:

Codex CLI 指令地圖:codex 互動、codex exec 一次跑完、codex resume 接續、codex review 審 diff

codex:開互動工作台,用自然語言邊聊邊改,這是日常主力。
codex exec "任務"(別名 codex e):非互動一次跑完,把結果吐到 stdout 或 JSONL,適合腳本與 CI。它預設跑在 read-only 沙盒,要它改檔記得加 --sandbox workspace-write。
codex resume --last:接續上一段對話繼續做,不用重講背景;也可以 codex resume <SESSION_ID> 指定某一段。非互動情境用 codex exec resume --last "接著把剛剛發現的問題修掉"。
codex review:讓 Codex 幫你審 diff 或 PR,專門抓 bug、風險與偏題。

所有指令都吃 --sandbox(沙盒)和 -m(選模型,例如 codex -m gpt-5.5)這兩個參數,這是下一個觀念的重點。

觀念四:兩道安全閥,沙盒 × 核准

第 2 課講過核准模式,這裡把它跟沙盒放在一起看,你才會知道「放權」到底放的是什麼。Codex 用兩個獨立的旋鈕在控制 AI 的自由度:

沙盒模式與核准模式對照:沙盒決定能碰多少檔案,核准決定動手前要不要問你

第一道:--sandbox 沙盒——決定 AI 能碰多少東西。

read-only:只能讀,最安全,codex exec 的預設。
workspace-write:可以改工作區內的檔案,日常最推薦。
danger-full-access:全開、無限制,只在乾淨的隔離環境(例如 CI 容器)才用。

第二道:--ask-for-approval 核准——決定它動手前要不要問你。

untrusted:每個指令都問,互動最綿密。
on-request:需要時才問,效率與控制的平衡點。
on-failure:先照做,失敗才升級問你。
never:完全不問,非互動自動化才用。

兩個旋鈕組合起來,就能精準對應情境。日常在自己專案裡改東西,--sandbox workspace-write 配一個會在關鍵時問你的核准模式,是最舒服的甜蜜點:AI 能動手,但碰到破壞性操作會停下來等你點頭。

手把手實戰:一套「不炸專案」的標準工作流

把前五課心法濃縮成一條流程。這條流程在 Codex 和 Claude Code 上通用,照著走,你放手讓 AI 改專案時就不會心驚膽跳。

不炸專案標準工作流五步:git status、先要計畫、workspace-write 動手、git diff review、commit

動手前先 git status,確認乾淨

沒有版本控制,就等於沒有還原鍵。放手讓 AI 改之前,先確認工作區是乾淨的:

git status

如果還有沒 commit 的改動,先處理掉(commit 或 stash),讓起點乾淨。這樣萬一 AI 改壞了,一句 git restore . 就能全部回到原點。這是整條流程裡最便宜、最救命的一步。

先要「計畫」,對齊方向再動手

新手最常犯的錯,是一上來就叫它動手。正確做法是先讓它把做法講出來,你確認方向對了再放行:

我想把登入頁的表單驗證改成即時驗證(打字時就檢查,不用等送出)。
先不要改任何檔案,列出你打算改哪幾個檔、每個檔要動什麼、有沒有副作用。我確認後再動手。

Codex 對複雜任務本來就會先規劃,但你主動要一份計畫,能省下大量來回。方向錯的時候,在這一步攔下來,比改完再重來便宜太多。

用 workspace-write 讓它動手

方向確認後,讓它在可控的沙盒裡改檔。互動模式下直接說「照計畫動手」即可;若是非互動一次跑完:

codex exec --sandbox workspace-write "照剛剛的計畫,把登入頁表單改成即時驗證"

記得 codex exec 預設是 read-only,要改檔一定要補上 --sandbox workspace-write,否則它會告訴你沒有寫入權限。破壞性操作(刪檔、改資料庫、推線上)則務必留在會問你的核准模式,親自把關。

git diff 逐行 review,別跳過

AI 會出錯,也會「過度發揮」——你只叫它改 A,它順手把 B 也動了。commit 前一定要看過:

git diff

覺得肉眼看不過來,可以請它先自審:

codex review

但 codex review 是輔助,不是免死金牌。最終要為這段程式碼負責的是你,不是 AI。看不懂的改動,當場問它「這行為什麼要改」。

確認無誤才 commit 收工

review 通過、測試綠燈,才存檔:

git add -A && git commit -m "登入頁改為即時驗證"

養成小步 commit 的習慣:一個小功能一個 commit,訊息寫清楚。這樣哪天要回頭,歷史一目瞭然,回滾也精準。把重複出現的規矩(commit 訊息格式、測試怎麼跑、哪些檔不要動)沉澱進 AGENTS.md,下次 AI 就自動遵守,越用越懂你的專案。

常見坑

先看這張,再看細節新手翻車八成是這三種,而且都有很明確的徵兆。

新手最常踩的三個坑:沒 git 就放手、對話塞爆脈絡失焦、沙盒開太大

坑 1:沒 git 就放手讓 AI 改,改壞了回不去

徵兆:AI 一口氣改了七八個檔,你發現方向錯了,想還原——結果沒有版本控制,只能一個一個手動改回去,或整個專案報廢重來。解法:動手前一律 git status 確認乾淨、必要時先 git commit 存一個乾淨的起點。有了 commit,git restore .(丟棄未 commit 的改動)或 git reset --hard HEAD(回到上一個 commit)就是你的還原鍵。這一步花你十秒,省你半天。

坑 2:codex exec 說沒權限改檔

你想用非互動模式一次改完,卻看到類似這樣的訊息:

sandbox: workspace is read-only; cannot write files

原因:codex exec 預設跑在 read-only 沙盒,它只能讀不能寫。解法:明確加上寫入權限——

codex exec --sandbox workspace-write "你的任務"

這其實是安全設計,不是 bug:它逼你在自動化時「明講」要給多少權限,避免你在腳本裡不小心開了 danger-full-access 讓 AI 亂搞。

坑 3:對話塞到爆,AI 開始失焦、答非所問

徵兆:聊了很久之後,AI 開始忘記前面講過的規矩、重複問你已經回答的事,或狀態列出現類似:

context left: 3%

脈絡(context)是有上限的,塞太滿舊資訊會被擠掉,AI 就失焦了。解法:換一個不相關的任務時,就開新 session(互動模式用 /new),把重要背景重講一次;要延續同一件事,則用 codex resume --last 接回去,而不是在同一條爆掉的對話裡硬撐。另外,把長期規矩寫進 AGENTS.md——它每次都會被載入,不吃你的對話額度。

坑 4:沙盒或核准開太大,AI 誤刪檔、誤推線上

徵兆:為了省事,你直接 --sandbox danger-full-access 配 --ask-for-approval never,結果 AI 在「整理專案」時刪掉了你沒備份的檔案,或把半成品推上了正式站。解法:日常一律 workspace-write 配一個會在關鍵時問你的核准模式;danger-full-access 只留給乾淨的隔離環境(CI 容器、拋棄式 VM)。權限這種東西,寧可小氣,不要大方——放權是給值得信任的操作,不是給所有操作。

作業

裝上另一個試試(選做但推薦):如果你只有 ChatGPT 訂閱,就照決策圖用 Codex;若剛好兩邊訂閱都有,挑一個小任務(例如「幫這個專案的 README 補一段安裝說明」),用 Codex 跟 Claude Code 各跑一次,親身感受差異,而不是聽別人說。
把工作流走一遍:找一個真實的小需求,嚴格照「git status → 要計畫 → workspace-write 動手 → git diff review → commit」五步做完。刻意在第二步攔一次它的計畫、在第四步抓一個你不同意的改動,體會這兩步的價值。
收尾你的 AGENTS.md:回顧這幾天用 Codex 的過程,把你重複交代過的規矩(commit 訊息格式、測試指令、不要碰的檔案)補進 AGENTS.md,讓它成為你專案的長期資產。
自我檢查:不看筆記,說得出 read-only、workspace-write、danger-full-access 三種沙盒分別什麼時候用嗎?說得出 codex exec 和 codex resume 的差別嗎?說不出就回觀念三、四再看一次。

記住一句話這些終端機 AI 工具不是取代工程師,是放大工程師。同樣一小時,會善用它的人產出翻好幾倍——差別不在你選 Codex 還是 Claude Code,在你有沒有把需求講清楚、有沒有守住 git 與 review 這兩條命脈。

系列收尾與下一步

恭喜你走完整套《Codex 指南》。回顧這條路:第 1 課認識它、第 2 課學會用核准模式安全放權、第 3 課掌握改檔流程、第 4 課用 AGENTS.md 教會它你的專案規矩、第 5 課實戰做完一個需求,到這一課把工具選擇與長期習慣一次收齊。你現在具備的,不只是「會用 Codex」,而是一整套跟終端機 AI 協作的心法——這套心法搬到 Claude Code、搬到未來任何一個同類工具,都能立刻套用。

接下來想更上一層,方向有兩個:一是把「怎麼跟 AI 下好指令」練到爐火純青——回去看〈Claude 新手指南〉的 Prompt 原理那一課,那套講清楚需求的心法,在終端機 AI 上威力更大;二是把 Codex 接進你的實際工作流,試著寫幾個 codex exec 的自動化腳本,讓它幫你跑重複的雜事。工具已經在你手上了,剩下的,是拿它去做出真正屬於你的東西。