Bài 7.116 phút · 5 thẻ · 8 bài tập · 1 nhiệm vụ

Plan mode cho việc lớn

Dời quyết định lên trước khi có code: khi nào lập kế hoạch, đọc kế hoạch tìm giả định và phạm vi, duyệt, sửa bằng Ctrl+G, và giữ kế hoạch trong dự án.

Bài 1.3 giới thiệu plan mode như một trong bốn mode. Ở cấp 7, việc lớn dần: một tính năng chạm vào ba file, một lần refactor cả module. Với việc cỡ đó, sửa sai sau khi Claude đã viết xong tốn hơn nhiều so với sửa một kế hoạch. Bài này dùng plan mode cho issue #3 của todo-api (bộ lọc ?done=): khi nào nên lập kế hoạch, đọc một kế hoạch thế nào cho kỹ, và duyệt nó ra sao.

Khi nào cần lập kế hoạch

Plan mode bắt Claude nghiên cứu và đề xuất, chưa được sửa. Claude đọc file, chạy lệnh để tìm hiểu, viết ra một kế hoạch, và không đụng vào code cho tới khi bạn duyệt.

Đáng dùng khi:

  • thay đổi chạm vào nhiều file, như issue #3 đụng tới db.js, route và test;
  • có nhiều cách làm và bạn muốn chọn trước;
  • bạn chưa quen phần code đó;
  • sai thì tốn: refactor, đổi cấu trúc dữ liệu.

Không cần cho việc nhỏ, rõ ràng: sửa một dòng lỗi, đổi một thông báo. Lập kế hoạch cũng tốn thời gian và ngữ cảnh.

Còn khi bạn chưa rõ mình muốn gì, docs gợi ý một bước trước nữa: nhờ Claude phỏng vấn bạn tới khi đủ để viết spec vào SPEC.md, rồi mở phiên mới để làm từ spec đó.

Vào và ra plan mode

Ba cách vào:

  • Nhấn Shift+Tab tới khi thanh trạng thái hiện ⏸ plan mode on.
  • Thêm /plan trước một prompt, chỉ cho riêng prompt đó.
  • Mở phiên bằng claude --permission-mode plan. Muốn dự án luôn bắt đầu bằng plan mode thì đặt "defaultMode": "plan" trong .claude/settings.json.

Trong plan mode, Claude vẫn được chạy lệnh để tìm hiểu. Nếu auto mode có sẵn, bộ phân loại xét các lệnh đó thay vì hỏi bạn; nếu không, lệnh ngoài nhóm chỉ đọc sẽ hỏi. Thứ Claude không được làm là sửa code.

Khi thử với issue #3, chúng tôi thấy đúng như vậy: Claude đọc các file bằng git ls-files và cat, rồi dùng Write một lần duy nhất để ghi file kế hoạch. git status sau đó chỉ có file kế hoạch mới, không một file mã nào đổi.

Ra khỏi plan mode: nhấn Shift+Tab khi không có hộp duyệt đang mở. Cẩn thận ở hộp duyệt: ở đó Shift+Tab là duyệt kế hoạch. Muốn thoát mà không duyệt thì nhấn Esc trước.

Đọc một kế hoạch cho kỹ

Kế hoạch Claude viết cho issue #3 có năm phần, và đây là bố cục đáng mong đợi ở mọi kế hoạch:

  1. Context: yêu cầu được hiểu thế nào.
  2. Changes: sửa gì, theo từng file: src/db.js thêm tham số cho list(), route GET / kiểm ?done=, một dòng trong README.md.
  3. Tests: test nào, với dữ liệu nào: bốn todo mẫu, đủ tổ hợp còn/đã xóa và xong/chưa xong.
  4. Out of scope: những gì cố ý không làm.
  5. Verification: kiểm tra kết quả thế nào.

Khi đọc, tìm bốn thứ:

  • Giả định. Kế hoạch của chúng tôi viết rõ: "tôi hiểu true|false là phân biệt hoa thường, nên TRUE trả 400; nếu bạn muốn nhận mọi kiểu chữ thì báo tôi". Đây chính là chỗ bạn quyết định, trước khi có code.
  • Phạm vi. Mỗi file trong danh sách có thật sự cần không? Một dòng kiểu "tiện thể viết lại error handler" là dấu hiệu phình phạm vi.
  • Ngoài phạm vi. Claude phát hiện bug xóa hai lần trả 500 (issue #1) nhưng ghi rõ là không sửa trong kế hoạch này. Tốt: một kế hoạch, một việc.
  • Cách kiểm tra. Không có phần test hoặc verification thì kế hoạch chưa xong.

Duyệt, sửa hay lập tiếp

Khi kế hoạch xong, Claude hỏi bạn làm gì tiếp:

  • Yes, and use auto mode: duyệt và làm tiếp ở auto mode. Nếu auto mode không có, nút này là Yes, auto-accept edits.
  • Yes, manually approve edits: duyệt, nhưng xem từng lần sửa. Hợp với lần đầu làm theo kế hoạch.
  • No, keep planning: ở lại plan mode và nói Claude cần đổi gì, ví dụ "nhận TRUE và True như true".

Muốn tự sửa kế hoạch thì nhấn Ctrl+G: kế hoạch mở trong trình soạn thảo mặc định, bạn sửa thẳng rồi lưu lại trước khi Claude làm.

Duyệt là thoát plan mode và chuyển sang mode tương ứng; Claude bắt đầu sửa code. Muốn lập kế hoạch tiếp cho việc sau, nhấn Shift+Tab quay lại hoặc dùng /plan. Duyệt kế hoạch còn tự đặt tên cho phiên theo kế hoạch, giúp tìm lại sau (bài 7.3).

Kế hoạch nằm ở đâu, và ngữ cảnh

Kế hoạch được ghi ra file, mặc định trong ~/.claude/plans. Đặt plansDirectory để giữ chúng trong dự án:

JSON
{ "plansDirectory": "./plans" }

Khi đó kế hoạch nằm cạnh code, đọc lại được, và commit được nếu team muốn giữ lịch sử quyết định.

Lập kế hoạch tốn ngữ cảnh: Claude đã đọc cả đống file. Đặt showClearContextOnPlanAccept: true để hộp duyệt có thêm lựa chọn "Yes, clear context and …": duyệt, xóa ngữ cảnh lập kế hoạch, và bắt đầu làm chỉ từ kế hoạch. Kế hoạch tốt là đủ để làm việc; những gì Claude đọc trong lúc lập kế hoạch thì không cần mang theo.

Còn một lựa chọn về model: opusplan dùng Opus khi ở plan mode và tự chuyển sang Sonnet khi bắt đầu làm. Suy luận mạnh cho kế hoạch, tiết kiệm cho phần thực hiện.

Quy trình cho issue #3

Ghép lại thành một quy trình dùng được hằng ngày:

  1. Lập kế hoạch: /plan Implement issue #3 in app-works-247/todo-api (dùng GitHub MCP từ cấp 5 để Claude tự đọc issue).
  2. Đọc kỹ: giả định, phạm vi, ngoài phạm vi, cách kiểm tra.
  3. Chỉnh: "No, keep planning" kèm góp ý, hoặc Ctrl+G để sửa thẳng.
  4. Duyệt bằng "Yes, manually approve edits" cho lần đầu.
  5. Để hook làm phần còn lại: hook của bài 6.2 kiểm cú pháp từng file và không cho Claude báo xong khi test còn đỏ.
  6. Đối chiếu kết quả với kế hoạch, rồi commit.

Plan mode không làm Claude giỏi hơn. Nó dời các quyết định quan trọng lên trước khi có code, khi đổi ý còn rẻ. Bài sau, 7.2, lo chiều ngược lại: khi code đã viết rồi mà hướng đi sai, làm sao quay lại.

Luyện tập bài 7.1

5 thẻ ghi nhớ, 8 bài tập chấm ngay trên trang, 1 nhiệm vụ làm trên máy.

Bắt đầu luyện tập

Tra cứu liên quan

Gõ để tìm trong tra cứu, mẫu cấu hình và bài học. Không dấu cũng được.