你要重構一個模組,牵涉 20 個檔案。用 Claude Code 直接動手?中途會偏離原本的設計。先寫一份規劃文件?寫完還是得一步步執行。
Ultraplan 把「規劃」和「執行」拆開。Claude 在雲端用一個獨立的 session 產生規劃,你在網頁版編輯器裡 review 每一段、留註、要求修改——然後選擇在雲端執行或拉回本機 CLI。
這篇你會學到
- Ultraplan 解決什麼問題:為什麼複雜任務不應該直接動手
- 完整流程:從終端機下指令到在手機上 review
- 執行模式的差別:雲端執行 vs 本機執行
- 適合什麼任務、不適合什麼
你需要什麼
- Claude Code v2.1.92 以上
- Claude Pro 或 Team 訂閱(雲端執行需要)
- 一個想規劃再動手的大任務
為什麼複雜任務不應該直接動手
你讓 Claude 「重構 auth 模組」,它會馬上開始改檔案。改到第三個檔案發現方向不對——但前兩個已經改了,回不去。
規劃階段和執行階段需要不同的思考模式。 規劃時要看全局、考慮依賴關係、決定順序。執行時要專注當前步驟。結合在同一個對話裡,兩邊都做不好。
Ultraplan 讓 Claude 先用一個完整的 session 想清楚,你確認方向正確後再執行。
完整流程
第一步:在終端機下指令
你可以直接輸入:
/ultraplan migrate the auth service from sessions to JWTs
或是在任何 prompt 裡加入 "ultraplan" 關鍵字,Claude 就會走 Ultraplan 流程。
第二步:Claude 在雲端規劃
Claude 會在雲端啟動一個獨立的 Claude Code session,分析你的 codebase、寫出分步規劃。這期間你的本機終端機是自由的——你可以繼續做其他事。
第三步:在網頁版 review
Claude 規劃好之後,你會拿到一個網頁編輯器的連結。在裡面你可以:
- 看每一段規劃的細節
- 對特定段落留註(像 review PR 一樣)
- 要求修改某一段
- 整體確認或重做
手機也能開,所以你可以在通勤時 review。
第四步:執行
確認規劃後,你有兩個選擇: - 雲端執行:Claude 在雲端的 sandbox 裡按規劃執行,做完產生 PR
- 拉回本機:把規劃下載到本機 CLI,在本機執行(可以中途介入)
適合什麼任務
✅ 大規模重構(多檔案、有依賴關係)
✅ 架構變更(從 session 改 JWT、換資料庫、拆微服務)
✅ 新功能開發(先規劃模組分割和介面再寫程式)
❌ 簡單的 bug fix(直接修就好)
❌ 單檔修改(plan 的開銷大於執行)
❌ 探索性工作(還不知道要做什麼時,先與 Claude 對話釨清方向)
我後來才發現的事
💡 第一次跑會自動建雲端環境。 v2.1.101 之後不用先去網頁版設定,下指令就能用。
💡 規劃時間通常比你想的久。 一個 20 檔案的重構,Claude 可能花 5-10 分鐘規劃。但這正是重點——它在認真想,不是照最明顯的路徑衝。
💡 可以結合 /autofix-pr 用。 雲端執行完產生的 PR,開啟 auto-fix 讓 Claude 自動處理 CI 失敗和 review 意見。
做不到什麼
❌ 規劃過程你沒辦法介入。它是一個完整的 session,你只能等它規劃完再 review。
❌ 雲端執行沒辦法存取你本機的私有資源(像本機的 .env 或本地資料庫)。需要本機資源就選拉回本機執行。
工具設定
Ultraplan 是 Claude Code 內建功能,不用額外安裝。
- 確認 Claude Code 版本 ≥ v2.1.92
- 需要 Pro 或 Team 訂閱(雲端執行用)
- 在終端機輸入
/ultraplan+ 你的任務描述
官方文件在 Ultraplan guide。