Claude Code 擬好了計畫。先讀、加註解,再核准。

計畫模式會讓 Claude Code 在動你的程式碼之前先寫計畫。這裡說明計畫存放的位置、如何閱讀、標出要修改的地方,並在 DotMD 檢查結果。

需要 macOS 14 或以上版本。閱讀免費;編輯與審閱為一次付費。

快速解答

在計畫模式中(按 Shift+Tab,或在提示開頭輸入 /plan),Claude Code 會把計畫寫成 Markdown 檔案,存放在 ~/.claude/plans。在 .claude/settings.json 設定 "plansDirectory": "./plans",就能改把計畫留在專案內。用 DotMD 開啟該資料夾,即可閱讀每份渲染後的計畫、對想修改的行加註解,並在你核准之前讓 Claude Code 修正。

Claude Code 計畫模式在做什麼

在計畫模式中,Claude Code 會讀取並探索你的專案,然後寫出計畫。在你核准計畫之前,它不會編輯原始碼檔案。這讓計畫成為攔截錯誤想法成本最低的地方:第 3 步的錯誤只需一則註解,而不必重寫整個功能。

進入計畫模式有三種方式:

  • 在提示輸入框按 Shift+Tab 切換模式。
  • 在提示開頭輸入 /plan。
  • 用 claude --permission-mode plan 開始工作階段。

若想讓每個工作階段都從計畫模式開始,請在設定中把 defaultMode 設為 "plan"。

Claude Code 把計畫檔案存在哪裡

預設情況下,計畫是存放在專案之外 ~/.claude/plans 的 Markdown 檔案。這很容易找不到,而且放在那裡的計畫不在 git 中。plansDirectory 設定可以改變存放位置。把它寫進 .claude/settings.json:

{
  "plansDirectory": "./plans"
}

路徑是相對於專案根目錄。像 ../plans 這種專案以外的路徑會被忽略,計畫會回到 ~/.claude/plans。放在專案內的話,你可以提交它們、在 pull request 中審閱,並讓下一個工作階段重新讀取。

在 DotMD 閱讀計畫

計畫是 Markdown,有標題、清單、表格,還常有圖表。DotMD 會以應有的閱讀樣貌呈現,而不是終端機裡的純文字。

  1. 加入資料夾

    按 ⌘O,選擇專案資料夾,或其中的計畫資料夾。若是預設位置,請直接選擇 ~/.claude/plans:在開啟對話框中,按 ⇧⌘. 可顯示隱藏的資料夾。

  2. 看著它出現

    Claude 寫計畫時,新計畫會即時出現在側邊欄,開啟中的檔案一有變動就會重新載入。表格、程式碼與 Mermaid 圖表都會繪製出來。

  3. 從頭讀到尾

    加註解之前,先把整份計畫讀完。步驟順序不對、漏掉的 migration、Claude 不該碰的檔案:讀第二遍時,你會看到更多。

用註解,不要重打

在聊天中輸入「不對,把第 3 步改成用現有的 helper」,Claude 就得猜你指的是哪一步。在 DotMD 中,你選取那一步並按 ⌥⌘M,再寫下要改什麼。註解會綁定在對應的行上,完全不會動到檔案。

讀完計畫後,告訴 Claude Code:「處理我在 DotMD 裡的註解。」它會透過 MCP 讀取註解、修正計畫,並把每則註解連同備註送回。每項修正都會顯示在檔案中,舊文字為紅色、新文字為綠色,你可逐項接受或重新開啟。然後核准,Claude 就開始建置。連接只要一行:請見 Claude Code 指南。

@DotMD:Markdown 檔案中代理的修正,舊文字為紅色、新文字為綠色,就在它所回應的註解旁
修正就在它所回應的註解旁邊:舊文字為紅色,新文字為綠色。

讓 Claude 每份計畫都送給你

你可以每次都開口要求,也可以一次說定。在 CLAUDE.md 加上類似這樣的一行:

After writing a plan, send it to me with request_review in DotMD
and wait for my approval before changing any code.

之後 Claude 會把計畫交給 DotMD,並在一次呼叫中等待,期間不消耗 token,直到你按下附上註解的 Send 或 Approve。DotMD 也能一鍵把審閱規則加進你的指示檔:請見 Mac 上的 CLAUDE.md 與 AGENTS.md。

Ctrl+G 還是 DotMD?

Claude Code 可以用 Ctrl+G 在你的文字編輯器中開啟計畫,由你自己修改。這是改一個字的快速辦法。DotMD 則用於另一件事:在一份很長的計畫中標出要 Claude 修改的地方,並在事後檢查它改了什麼,包括沒人要求的更動。兩者可以搭配使用,哪個適合就用哪個。

關於 Claude Code 計畫的問題

Claude Code 把計畫存在哪裡?

存在 ~/.claude/plans,除非設定中的 plansDirectory 指向專案內。

我可以把計畫放進 git 嗎?

可以。把 plansDirectory 設為專案內的資料夾,例如 ./plans 或 docs/plans,然後提交。

Claude 擬計畫時,DotMD 需要開著嗎?

只有透過 MCP 加註解與審閱時才需要。閱讀計畫只需要這個 App。

閱讀計畫免費嗎?

免費。與代理的註解和審閱需要 DotMD Reviewer;請見價格。

更多問題