Features · Built in · since version 1.0.33

Plan mode

Have Claude explore the code and propose a plan before it changes anything.

What it is

In plan mode Claude can read files and look around the project, but it does not edit your source files. When it has worked out an approach, it shows you a plan. You approve it, ask for changes, or edit it yourself; only after approval does Claude start making changes.

Why it matters

  • Agree before code changesYou see the approach for a large or risky change and correct it while it is still cheap to change.
  • Safe explorationAsk questions about an unfamiliar codebase without any risk of files being edited.
  • You choose how it continuesOn approval you decide whether Claude then works with edits accepted automatically or checked one by one.

How it works

  1. Press Shift+Tab until the status bar shows plan mode, or start with claude --permission-mode plan.
  2. Or type /plan followed by what you want, to plan a single request.
  3. Claude reads files and explores, then presents its plan; press Ctrl+G to edit the plan in your editor.
  4. Approve the plan to leave plan mode and choose the mode for the work, or choose to keep planning.
  5. To leave without approving, press Shift+Tab when no approval prompt is open.

Hands-on example coming

This feature has no reviewed example yet. The official documentation below has the details.

Update history

  1. Version 2.0.28 · Oct 27, 2025

    Updated Plan mode gained a dedicated Plan subagent.

  2. Version 1.0.33 · Jun 23, 2025

    Introduced First changelog mention of plan mode; it shipped earlier without an entry.

Official documentation