Claude Code Plan Mode 規劃模式教學:怎麼開、計畫存在哪,實測先規劃再動手

部分實測2026.10.14

Claude Code 的 plan mode(規劃模式)讓它先讀程式、想好要怎麼改,把計畫交給你看,在你點頭之前不動任何檔案。這篇講怎麼打開(Shift+Tab、/plan、啟動參數)、計畫寫好之後的三個選項、怎麼設成預設;我拿一個加總收據的小程式實測:規劃階段它讀了檔、把計畫存成一個檔案,原始碼一個字都沒改;接著照計畫改完,跑出來的結果跟計畫裡預期的一字不差。2026 年 10 月 14 日實測。

更新 2026/10/14・約 7 分鐘讀完・查證環境:在我自己的 Mac 上用 Claude Code 2.1.280(訂閱方案,主對話的模型是 Opus 5.5)跑了兩次非互動模式(claude -p):第一次用 --permission-mode plan 規劃,用檔案的雜湊值確認前後沒有被改;第二次接著同一段對話、切到 acceptEdits 照計畫改,我自己再執行一次程式核對結果。互動模式裡的 Shift+Tab、計畫審核的選單、Ctrl+G 編輯計畫沒有實測,依官方文件

先講結論

  • Plan mode 是 Claude Code 的一種權限模式:它可以讀檔、跑查看用的指令、寫計畫,但不會改你的程式。在終端機按 Shift+Tab 切換,或在訊息前加 /plan,或用 claude --permission-mode plan 啟動。
  • 我實測請它幫一個加總收據的小程式加功能。規劃階段 37 秒,它讀了程式和三張收據、手算出一張印錯的,把計畫存成 ~/.claude/plans/ 裡的一個檔案;程式和收據前後的雜湊值完全一樣。
  • 接著同一段對話切到改檔模式,11 秒改完並自己跑一次,輸出跟計畫裡寫的預期結果一字不差。
目錄
  1. Plan mode 是什麼
  2. 怎麼打開
  3. 計畫寫好之後
  4. 實測:先規劃
  5. 實測:照計畫改
  6. 用之前要知道的
  7. 這篇沒有測的

請 Claude Code 改一個不熟的專案,最怕的是它一口氣改了一堆檔案,改完你才發現方向不對,還得一個一個退回去。

Plan mode(規劃模式)就是讓它先別動手:先讀程式、想清楚要怎麼改,把計畫交給你看。你點頭了它才開始改;不滿意,就叫它繼續想。

這篇講 plan mode 怎麼開、計畫寫好之後有哪些選項、怎麼設成預設,然後拿一個小程式實際跑一次「先規劃、再動手」。Claude Code 還不熟的話,先看 Claude Code 教學。

Plan mode 是什麼

Plan mode 是 Claude Code 的權限模式之一。官方文件列了幾種模式,差在它不問你就能做哪些事:

  • manual(設定值是 default):只有讀檔不用問,其他都會問你。
  • acceptEdits:讀檔、改檔,還有建資料夾、搬檔案這類常見的指令都不用問。
  • plan:可以讀檔、跑查看用的指令,寫出計畫,但不改你的原始碼。
  • auto:都不用問,背後有另一個模型在檢查有沒有超出你要求的動作。

官方文件對 plan mode 的描述是:研究、提出修改,但不動手。它會讀檔、跑指令探索,然後寫一份計畫。

適合的時候是:專案不熟、要改的地方牽涉好幾個檔案、或你想先確認它理解對了再讓它動。只是改一個字、修一個明顯的錯,就不必繞這一圈。

怎麼打開

三種方式:

  • 在終端機裡按 Shift+Tab。每按一次切一個模式,順序是 manual、accept edits、plan,狀態列會顯示目前在哪個模式。
  • 只想讓某一則訊息先規劃,在訊息前面加 /plan。
  • 啟動時就進 plan mode:
claude --permission-mode plan

想不核准計畫、直接離開,再按一次 Shift+Tab。

想讓某個專案每次都從 plan mode 開始,官方文件寫可以在專案的 .claude/settings.json 把 defaultMode 設成 plan。

計畫寫好之後

在互動模式裡,計畫寫好後 Claude Code 會問你怎麼繼續,官方文件列了三個選項:

  • Yes, and use auto mode:核准,切到 auto mode 開始改。auto mode 不能用的時候,這一項會變成 Yes, auto-accept edits,也就是改檔不再問你。
  • Yes, manually approve edits:核准,但每一個修改都要你同意。
  • No, keep planning:不核准,留在 plan mode,告訴它哪裡要改。

核准之後就離開 plan mode,照你選的那一項切換權限模式、開始改。官方文件還提到一個方便的地方:按 Ctrl+G 可以用你的文字編輯器打開計畫,直接改內容,再讓它照著做。

實測:先規劃

我準備了一個很小的 Python 程式 receipts.py,它把資料夾裡三張收據上印的「合計」加起來,印出總共 892 元。其中一張收據的合計是我故意印錯的:品項加起來 135,合計卻印 145。

我用非互動模式,加上 --permission-mode plan 請它:

幫 receipts.py 加一個功能:每張收據把品項金額自己加一遍,跟印的合計比對,不一樣就標出來;總額改用自己加的數字。

它做的事依序是:列出資料夾裡的檔案、讀 receipts.py、把三張收據的內容印出來看。這三個都是查看用的動作,它直接做了。

接著它寫了一份計畫,存成一個 Markdown 檔,放在我家目錄的 ~/.claude/plans/ 底下,檔名是自動取的 receipts-py-snug-scroll.md。計畫裡有:它手算三張收據的對照表、要改的地方(只抓每一行 = 後面的小計,不去驗算單價乘數量,因為三張的寫法不一樣)、找不到合計的時候怎麼辦、還有改完之後預期的輸出長什麼樣子。

最後它回答我:計畫寫好了,「還沒改任何程式碼」,請我確認。因為是非互動模式,沒有那個核准的選單,所以它是用文字問的。

我用檔案的雜湊值比對,規劃前後 receipts.py 和三張收據都沒有變。它唯一寫的檔案,就是放在 ~/.claude/plans/ 的那份計畫。這個階段花了 37 秒。

實測:照計畫改

接著我讓它接續同一段對話,但換成 acceptEdits 模式(改檔不用問),只說一句:「可以,照計畫改,改完跑一次給我看。」

它改了 receipts.py(從 14 行變成 25 行),然後自己執行一次,印出來的是:

全聯福利中心 民生店:299
便利商店 民生門市:135  ⚠ 印的合計是 145,差 10
量販店 內湖店:448
總共:882
⚠ 有 1 張收據的合計跟品項加總對不上

這跟計畫裡寫的「預期的輸出」一字不差。我自己再跑一次,結果一樣。這一段只花了 11 秒。

它還多補了一句:計畫裡有一個地方沒寫清楚,收據上找不到合計的時候,最後那行提醒也會把它算進去。這次三張都有合計,所以沒有影響。

整個流程的好處很具體:規劃那 37 秒我可以先看它理解得對不對,例如它有沒有發現收據的寫法不一致;確認之後,改的那一步就很快,而且結果可以拿計畫裡寫的預期去對。

用之前要知道的

Plan mode 不是什麼都不做。它會跑查看用的指令,例如列檔案、看內容;官方文件寫,auto mode 可以用的時候,規劃時的指令會交給另一個模型審查,不能用的時候,內建唯讀清單以外的指令會先問你。

它會寫一個檔案:計畫本身。我實測時是寫在 ~/.claude/plans/,不在專案資料夾裡。

非互動模式(claude -p)沒有核准計畫的選單。我實測時它用文字請我確認,我是接續同一段對話、換一個權限模式讓它開始改。寫腳本自動化的話,可以照這個兩段式的做法。

官方文件寫,從 2.1.283 版開始,終端機和 VS Code 的互動模式預設是從 auto mode 開始。我這台是 2.1.280,所以沒有遇到。想先規劃,記得切到 plan mode。

這篇沒有測的

互動模式裡的操作:Shift+Tab 切換、/plan、計畫寫好後的三個選項、Ctrl+G 編輯計畫。我兩次都是用 claude -p。

defaultMode 設成 plan、auto mode 下規劃時的指令審查。

VS Code 擴充套件和桌面版裡的 plan mode。VS Code 版怎麼用在 Claude Code VS Code 教學。

想讓某些事每次都一定被擋下,不靠模式切換,可以看 Claude Code Hooks 教學;要把一部分工作交給另一個 Claude,看 Claude Code 子代理教學。

常見問題

Claude Code 的 plan mode 怎麼開?

三種方式。在終端機裡按 Shift+Tab,依序會切到 manual、accept edits、plan,狀態列會顯示目前的模式;只想讓某一則訊息先規劃,在訊息前面加 /plan;或啟動時用 claude --permission-mode plan。再按一次 Shift+Tab 可以不核准計畫、直接離開。

Plan mode 的計畫存在哪裡?

我實測時,它把計畫寫成一個 Markdown 檔,放在家目錄的 ~/.claude/plans/ 底下,檔名是自動取的。在互動模式裡,官方文件寫可以按 Ctrl+G 用你的文字編輯器打開計畫直接修改,再讓它照著做。

Plan mode 會不會還是偷偷改檔案?

官方文件寫它不會改你的原始碼。我實測時用檔案的雜湊值比對,規劃前後程式和資料都沒有變;它唯一寫的檔案是放在 ~/.claude/plans/ 的計畫。查看用的指令(列檔案、看內容)它會直接跑。

可以讓每次都先進 plan mode 嗎?

可以。官方文件寫,在專案的 .claude/settings.json 把 defaultMode 設成 plan,這個專案在終端機開的對話就會從 plan mode 開始。

這篇怎麼查證的

這篇只有一部分實際跑過,其餘依官方文件整理,查證日期 2026/10/14(在我自己的 Mac 上用 Claude Code 2.1.280(訂閱方案,主對話的模型是 Opus 5.5)跑了兩次非互動模式(claude -p):第一次用 --permission-mode plan 規劃,用檔案的雜湊值確認前後沒有被改;第二次接著同一段對話、切到 acceptEdits 照計畫改,我自己再執行一次程式核對結果。互動模式裡的 Shift+Tab、計畫審核的選單、Ctrl+G 編輯計畫沒有實測,依官方文件)。哪些有跑、哪些沒跑,文中各段有寫。價格與方案以官方頁面為準,工具改版後內容可能過期。