Plan mode

Plan mode คือโหมดที่สั่งให้ claude-code ค้นคว้าและเสนอแผนการเปลี่ยนแปลงก่อน โดยไม่ลงมือแก้จริง เอกสารอธิบายว่าในโหมดนี้ AI อ่านไฟล์ได้ รันคำสั่งเพื่อสำรวจได้ และเขียนแผนออกมาได้ แต่แก้ไฟล์ต้นฉบับไม่ได้ การแก้จะถูกบล็อกไว้จนกว่าเราจะอนุมัติแผน วิธีเข้าโหมดนี้ทำได้สองทาง คือกด Shift+Tab เพื่อวนโหมด หรือขึ้นต้นคำสั่งเดียวด้วย /plan สำหรับรอบนั้น และตั้งเป็นค่าเริ่มต้นของโปรเจกต์ได้ด้วยการใส่ defaultMode เป็น plan ในไฟล์ตั้งค่า

เมื่อแผนพร้อม AI จะเสนอแผนแล้วถามว่าจะเอาอย่างไรต่อ ทางเลือกหลักคืออนุมัติแล้วให้ทำงานต่อโดยรับการแก้ไฟล์อัตโนมัติ อนุมัติแล้วขอตรวจการแก้ทีละจุดเอง หรือยังไม่อนุมัติแล้วบอกว่าอยากให้แก้แผนตรงไหน การอนุมัติแผนจะพาออกจาก plan mode และสลับไปโหมดที่เราเลือกโดยอัตโนมัติ นอกจากนี้ยังกด Ctrl+G เพื่อเปิดแผนที่เสนอมาในโปรแกรมแก้ไขข้อความแล้วแก้แผนเองก่อนให้ทำต่อได้ด้วย

คุณค่าจริงของโหมดนี้อยู่ที่การย้ายจุดที่เราใช้ความคิด จากการมานั่งไล่ตรวจงานที่ทำเสร็จแล้วซึ่งแก้ยาก ไปเป็นการตรวจแผนตั้งแต่ยังไม่ลงมือซึ่งแก้ง่ายและถูกกว่ามาก งานที่ควรใช้ plan mode ทุกครั้งคืองานที่แตะหลายไฟล์ งานในโค้ดที่เราไม่คุ้น และงานที่ถ้าทำผิดทางแล้วต้องรื้อใหม่ทั้งหมด ส่วนงานสั้นๆ ที่ชัดเจนอยู่แล้วไม่จำเป็นต้องใช้ ประโยชน์เพิ่มอีกข้อคือแผนที่ได้เป็นเอกสารที่เอาไปคุยกับเพื่อนร่วมทีมได้ก่อนที่โค้ดจะเกิดขึ้นจริง ข้อควรระวังคือในกรณีที่ session นั้นเปิดโหมดข้ามการขออนุญาตไว้ ระบบจะไม่บังคับข้อห้ามของ plan mode คือ AI ยังถูกสั่งให้วางแผนโดยไม่แก้ แต่ถ้ามันลองแก้ไฟล์ขึ้นมาจริงก็จะทำได้โดยไม่มีการถาม

ตัวอย่างจากบทสนทนาจริง

นักพัฒนา: "ผมสั่งให้มันเปลี่ยนระบบ authentication ทั้งหมด มันลุยแก้ยี่สิบไฟล์รวดเลยครับ พอมาดูแล้วทิศทางไม่ใช่ที่ผมคิดไว้เลย ต้องรื้อใหม่หมด"

หัวหน้าทีม: "งานขนาดนี้ต้องเข้า plan mode ก่อนครับ กด Shift+Tab จนขึ้นว่า plan mode แล้วค่อยสั่ง มันจะไปอ่านโค้ดแล้วเสนอแผนมาให้ดูก่อนว่าจะแตะไฟล์ไหนบ้างและทำอะไร ตอนนั้นแหละที่เราจะเห็นว่าทิศทางไม่ตรงแล้วบอกให้แก้แผนได้ ใช้เวลาอ่านแผนห้านาที ประหยัดการรื้อทั้งวัน พออนุมัติแล้วมันถึงจะเริ่มแก้จริงครับ"

ระวังสับสนกับ

• permission-mode : permission mode คือชุดโหมดทั้งหมดที่คุมว่า AI ต้องขออนุญาตบ่อยแค่ไหน ส่วน plan mode เป็นหนึ่งในโหมดเหล่านั้น ที่พิเศษตรงเป้าหมายไม่ใช่แค่ลดการถาม แต่คือห้ามแก้จนกว่าจะเห็นแผนก่อน
• spec : spec คือเอกสารกำหนดสิ่งที่ต้องการให้ชัดก่อนเริ่มงาน ซึ่งคนเป็นคนเขียน ส่วนแผนใน plan mode เป็น AI เขียนให้หลังจากไปอ่านโค้ดจริงแล้ว ทั้งสองใช้คู่กันได้ คือเขียน spec ให้ชัดแล้วให้ AI เสนอแผนว่าจะทำตาม spec นั้นอย่างไร
• agent-mode : agent mode คือการปล่อยให้ AI ทำงานหลายขั้นจนเสร็จ ซึ่งเน้นการลงมือ ส่วน plan mode เป็นการกั้นไว้ก่อนลงมือ ในทางปฏิบัติงานใหญ่มักเริ่มที่ plan mode แล้วอนุมัติเข้าสู่การทำงานแบบ agent ต่อ