Lập kế hoạch dự án với Claude Code: hướng dẫn plan mode & ak plan (2026)

Vì sao phải lập kế hoạch trước khi để Claude Code code?

Sai lầm phổ biến nhất khi dùng Claude Code là gõ một câu prompt rồi để nó code thẳng. Nghe nhanh, nhưng rủi ro lớn: AI dễ "giải sai bài toán" - làm đúng thứ nó tưởng bạn muốn, không phải thứ bạn cần. Đến lúc xem diff thì đã sửa mười mấy file, và bạn phải chọn giữa sửa lại thủ công hay bỏ hết làm từ đầu.

Lập kế hoạch trước giải quyết đúng điểm đó. Khi bạn buộc Claude trình bày kế hoạch trước khi động vào code, bạn được soi trước phạm vi thay đổi, phát hiện hiểu nhầm khi nó còn rẻ, và giữ đúng scope. Bonus: tiết kiệm token, vì sửa một dòng trong bản kế hoạch rẻ hơn nhiều so với để AI viết sai rồi viết lại.

Có một lợi ích ít được nhắc: kế hoạch là nơi bạn và AI thống nhất "định nghĩa của xong". Khi kế hoạch ghi rõ những file sẽ đổi và cách kiểm tra, bạn có một mốc để đối chiếu diff cuối cùng - thay vì đọc code và tự hỏi "nó có làm đúng ý mình không". Nói cách khác, lập kế hoạch biến việc review từ "đoán mò" thành "so với checklist".

Khi nào NÊN lập kế hoạch: thay đổi đụng nhiều file; bạn chưa chắc cách làm; hoặc đang làm việc trong codebase lạ chưa nắm rõ luồng. Khi nào bỏ qua cho nhanh: sửa typo, đổi một hằng số, chỉnh một dòng - nếu bạn mô tả được diff bằng đúng một câu thì lập kế hoạch chỉ là overhead thừa. Nếu bạn hoàn toàn mới với công cụ này, đọc trước Claude Code là gì và hoạt động ra sao rồi quay lại phần dưới.

Plan mode của Claude Code là gì & cách bật

Plan mode là một chế độ quyền (permission mode) của Claude Code: khi bật, Claude chỉ đọc file và đề xuất kế hoạch, không ghi bất kỳ thay đổi nào lên disk cho đến khi bạn duyệt. Nó là "phanh an toàn" để bạn xem AI định làm gì trước khi cho phép.

Có ba cách bật:

1. Nhấn Shift+Tab để xoay vòng qua các chế độ: default → acceptEdits → plan. Nhấn cho đến khi vào plan.
2. Khởi động thẳng ở plan mode từ terminal:

   claude --permission-mode plan

3. Xác nhận bằng status bar - khi đang ở plan mode, thanh trạng thái hiển thị ⏸ plan mode on.

Một mẹo ít người biết: khi Claude đã đưa ra kế hoạch, nhấn Ctrl+G để mở kế hoạch đó trong text editor và sửa tay trước khi chạy - thêm ràng buộc, bỏ bước thừa, hoặc chỉ định file cụ thể. Sửa kế hoạch luôn rẻ hơn sửa code đã viết.

Cơ chế phím tắt và hành vi trên lấy theo tài liệu chính thức của Anthropic (best practices và common workflows, xem ngày 09/08/2026). Vì plan mode đang tiến hoá nhanh, nên kiểm tra lại phím tắt trong bản Claude Code bạn đang chạy.

Quy trình lập kế hoạch 4 bước: Explore → Plan → Implement → Commit

Đây là quy trình Anthropic khuyến nghị và cũng là khung dễ nhớ nhất. Mỗi bước có một mục tiêu riêng - đừng gộp.

Explore (trong plan mode)

Trước khi bàn giải pháp, cho Claude đọc và hiểu code hiện có. Ở plan mode nó chỉ đọc, không sửa, nên bạn yên tâm để nó "lục" thoải mái:

Đọc src/payments/ và src/orders/ để hiểu cách hệ thống xử lý thanh toán hiện tại. Chưa cần đề xuất gì, chỉ tóm tắt luồng.

Với dự án lớn, hãy giao phần research cho subagent để giữ context của phiên chính sạch - subagent đọc và trả về bản tóm tắt, còn cửa sổ context chính không bị nhồi hàng nghìn dòng. Mục tiêu của bước này không phải là giải pháp, mà là để Claude nói lại bằng lời của nó cách hệ thống đang hoạt động; nếu bản tóm tắt sai, bạn biết ngay là nó chưa hiểu bài toán.

Plan

Khi Claude đã hiểu code, yêu cầu nó lập kế hoạch cụ thể:

Tôi muốn thêm mã giảm giá cho đơn hàng. File nào cần đổi? Luồng xử lý ra sao? Lập kế hoạch chi tiết trước khi code.

Đọc kỹ kế hoạch. Nếu có chỗ chưa ổn, nhấn Ctrl+G sửa tay, hoặc phản hồi để Claude chỉnh lại. Đừng vội duyệt.

Implement

Duyệt kế hoạch (hoặc nhấn Shift+Tab thoát plan mode) để Claude bắt đầu code. Điểm quan trọng: neo kế hoạch bằng tiêu chí verify - nói rõ AI phải làm gì để tự chứng minh là đã xong:

Thực hiện kế hoạch. Sau khi xong, chạy npm test và đảm bảo tất cả test xanh. Nếu test đỏ, sửa cho đến khi qua.

Commit

Cuối cùng, gói lại thành commit sạch và mở PR:

Commit các thay đổi với message mô tả rõ, rồi mở pull request kèm phần tóm tắt những gì đã đổi.

Xem thêm quy trình Git & tạo PR với Claude Code để chuẩn hoá bước này.

Chia dự án lớn thành phase & roadmap

Quy trình 4 bước ở trên hợp với một tính năng gọn. Nhưng dự án kéo dài nhiều ngày hoặc nhiều tuần thì một kế hoạch phẳng sẽ vỡ: context loãng dần, Claude quên các quyết định cũ, và bạn mất kiểm soát.

Cách làm bền hơn: yêu cầu Claude lập roadmap gồm nhiều phase, mỗi phase ghi rõ mục tiêu, file sẽ đụng tới, và tiêu chí "xong". Lưu roadmap ra file (ví dụ PLAN.md hoặc thư mục plans/) để nó không biến mất khi bạn /clear. Sau đó thực thi từng phase trong một session riêng, context sạch - chạy /clear giữa các phase để mỗi phase bắt đầu tinh gọn, chỉ nạp đúng phần roadmap cần thiết.

Nguyên tắc chia phase: mỗi phase nên tự đứng được và kết thúc ở một trạng thái xanh (test pass, app chạy) để bạn có thể dừng bất cứ lúc nào mà không để lại code dở dang. Thứ tự phase nên đi từ nền tảng ra ngoài - dựng phần backend/logic trước, giao diện sau - để phase sau luôn có nền chắc để dựa vào.

Ví dụ roadmap cho tính năng "đăng nhập bằng Google (OAuth)":

Với tính năng phức tạp, dùng pattern interview → SPEC.md → session mới: bảo Claude "phỏng vấn tôi từng câu về yêu cầu rồi viết ra SPEC.md", sau đó mở một session mới đọc SPEC để thực thi với context sạch. Đây chính là tinh thần của spec-driven development (viết SPEC.md trước), và nó khớp với quy trình brainstorm → plan → cook → ship mà nhiều dev thực chiến đang dùng.

Mẹo để kế hoạch chất lượng hơn

• Neo bằng tiêu chí verify. Kế hoạch tốt luôn kèm cách kiểm tra: test nào phải xanh, build phải chạy, screenshot phải khớp. Bạn cũng có thể đặt điều kiện qua /goal để AI tự đánh giá sau mỗi bước thay vì báo "xong" khi chưa xong.
• Viết CLAUDE.md. Ghi convention dự án (cấu trúc thư mục, quy ước đặt tên, lệnh test) vào file CLAUDE.md để mọi kế hoạch luôn đúng ngữ cảnh, không phải nhắc lại mỗi lần.
• Prompt cụ thể. Trỏ đúng file, nêu pattern mẫu để bám theo, và nói rõ phần out-of-scope. Càng cụ thể, kế hoạch càng sát.
• Dùng subagent review kế hoạch. Nhờ một subagent với context tươi soi lại kế hoạch hoặc diff - góc nhìn "sạch" thường bắt được lỗ hổng mà phiên chính đã quen mắt.
• Dùng /rewind. Nếu một hướng kế hoạch chưa ổn, tua lại và thử hướng khác thay vì cố sửa chồng lên.

So sánh nhanh để thấy khác biệt:

Prompt kém: "Thêm đăng nhập Google cho app."

Prompt tốt: "Đọc src/auth/ và src/routes/. Tôi muốn thêm đăng nhập Google (OAuth) theo đúng pattern session đang có trong src/auth/session.ts. Ngoài phạm vi: chưa cần refresh token. Lập kế hoạch: file nào đổi, luồng callback ra sao, và tiêu chí verify (test auth.spec.ts xanh)."

ak plan - skill lập kế hoạch dựng sẵn (AgentKit)

Nói ngắn để khỏi nhầm: AgentKit ở đây là bộ kit cho Claude Code (agentkit.best, dùng CLI ak), KHÁC hoàn toàn với "OpenAI AgentKit".

Nếu bạn thấy mình lặp lại việc "prompt xin kế hoạch" mỗi lần bắt đầu tính năng, có một skill đóng gói sẵn quy trình đó: ak-plan. Thay vì tự soạn prompt, bạn gọi skill và nó sinh ra kế hoạch nhiều phase kèm roadmap theo khung nhất quán, hỗ trợ --html (xuất artifact tự chứa để xem/chia sẻ) và --wiki (xuất bản lên AgentWiki). Skill này nằm trong Engineer Kit - gói $99 (trang không nêu phí định kỳ), gồm 60+ skills và 30+ workflow. Nếu muốn thử ngay, có thể kích hoạt ak CLI (giảm 20% qua link) và cài kit qua đó.

Trung thực mà nói: với đa số việc, plan mode native đã đủ và miễn phí - bạn không cần kit để lập kế hoạch tốt. ak plan đáng cân nhắc khi bạn cần kế hoạch chuẩn hoá, lặp lại được và có tài liệu (artifact/wiki) cho cả team, chứ không phải điều kiện bắt buộc để bắt đầu.

Sai lầm thường gặp khi lập kế hoạch với AI

• Lập plan cho việc quá nhỏ. Sửa một dòng mà cũng bật plan mode thì chỉ tốn thời gian. Nếu mô tả được diff bằng một câu - cứ để nó làm.
• Kế hoạch dài mà không neo verify. Plan mười mấy bước nghe hoành tráng nhưng thiếu tiêu chí kiểm tra, AI dễ "trông có vẻ xong" trong khi thực tế chưa chạy. Luôn gắn test/build/điều kiện rõ ràng.
• Nhồi nhiều task vào một session. Làm ba tính năng không liên quan trong cùng một cửa sổ context khiến AI lẫn lộn. Chạy /clear giữa các task để giữ context tinh gọn.
• Tin kế hoạch mà bỏ qua diff. Kế hoạch đúng không đảm bảo code đúng. Vẫn phải đọc diff thật trước khi commit.

Câu hỏi thường gặp (FAQ)

Plan mode có tính phí thêm không?

Không. Plan mode là chế độ có sẵn trong Claude Code, không phải gói trả thêm. Bạn vẫn dùng theo gói hiện tại của mình (ví dụ Pro $20/tháng, hoặc Max 5x $100/tháng).

Bật plan mode bằng phím nào?

Nhấn Shift+Tab để xoay vòng default → acceptEdits → plan, dừng ở plan. Hoặc khởi động bằng claude --permission-mode plan. Status bar sẽ hiện ⏸ plan mode on.

Plan mode có tự sửa file không?

Không. Ở plan mode, Claude chỉ đọc file và đề xuất kế hoạch, không ghi thay đổi lên disk cho đến khi bạn duyệt. Đó là điểm an toàn cốt lõi của chế độ này.

Plan mode khác extended thinking (think/ultrathink) thế nào?

Khác nhau. Plan mode là chế độ quyền - kiểm soát việc AI có được sửa file hay không. Extended thinking (think/ultrathink) là tăng độ sâu suy luận của mô hình. Bạn có thể dùng chung: bật plan mode để an toàn, và yêu cầu suy nghĩ sâu hơn khi bài toán phức tạp.

ak plan có bắt buộc không, khác gì plan mode native?

Không bắt buộc. Plan mode native đủ dùng cho hầu hết trường hợp và miễn phí. ak plan là skill dựng sẵn (trong Engineer Kit của AgentKit) giúp sinh kế hoạch nhiều phase chuẩn hoá kèm artifact --html/--wiki - tiện khi cần lặp lại quy trình và có tài liệu cho team.

Chia dự án lớn thế nào cho hợp lý?

Yêu cầu Claude lập roadmap nhiều phase (mỗi phase có mục tiêu, file đụng tới, tiêu chí xong), lưu ra PLAN.md, rồi thực thi từng phase trong session riêng và chạy /clear giữa các phase để giữ context sạch.

Kết luận + bước tiếp theo

Chốt lại: đừng để Claude Code code ngay - hãy Explore → Plan → Implement → Commit, bật plan mode bằng Shift+Tab để soi trước khi duyệt, và chia dự án lớn thành phase với context sạch. Bước tiếp theo, đọc quy trình brainstorm → plan → cook → ship để có khung làm việc trọn vẹn, và spec-driven development khi bạn cần kế hoạch bài bản cho feature lớn.