---
title: "Claude Code plan mode: what it does, how to use it | Bombos"
description: "Plan mode lets Claude Code read files and explore, then propose a plan without editing code. Enter it with Shift+Tab, a /plan prefix or --permission-mode plan."
image: "https://bombos.ai/assets/og-en-v2.png"
---

# What does plan mode do in Claude Code and how do you turn it on?

Short answer

Plan mode is a Claude Code permission mode in which Claude reads files, runs commands to explore and writes a plan, but normally does not edit your source until you approve. You enter it with Shift+Tab, by starting a single prompt with /plan, or with claude --permission-mode plan. When the plan is ready you choose how to continue, or keep planning.

*Piet Baudoin · published November 17, 2026 · November 17, 2026*

## What Claude does in plan mode

Plan mode is one of Claude Code’s permission modes. The docs describe it as telling Claude to research and propose changes without making them: Claude reads files, runs shell commands to explore, and writes a plan, but does not edit your source. Edits stay blocked until you approve the plan, with one exception: in interactive terminal sessions with bypass permissions available, Claude is still told to plan, but an edit or command it attempts runs without a prompt.

Behind the scenes Claude can use the built-in Plan subagent, a read-only research agent meant for this mode. The plan itself is kept as a file, in `~/.claude/plans/` or the folder you set with `plansDirectory`.

## How to enter it

1.  **Shift+Tab** in the terminal cycles the modes: Manual (`default`), then `acceptEdits`, then `plan`. Auto mode, when available, comes last in the cycle, and from auto mode the first press goes back to Manual. The status bar shows `⏸ plan mode on`.
2.  **`/plan` at the start of a prompt** puts that one prompt in plan mode.
3.  **At startup**: `claude --permission-mode plan`.
4.  **As your default**: set `"defaultMode": "plan"` under `permissions` in a settings file.
5.  **In VS Code**: click the mode indicator at the bottom of the prompt box.

## What happens when the plan is ready

Claude shows the plan and asks how to go on:

| Option | What follows |
| --- | --- |
| Yes, and use auto mode | Claude implements, with auto mode’s background checks instead of prompts. Without auto mode this reads “Yes, auto-accept edits”. |
| Yes, manually approve edits | Claude implements and asks before each edit. |
| No, keep planning | You stay in plan mode and give feedback. |

Before you pick, press **Ctrl+G** to open the plan in your editor and change it. That is often faster than describing the change in a prompt.

One trap: at the approval prompt, Shift+Tab approves the plan. To get out without approving, press Esc first.

## The misunderstanding: “plan mode means Claude touches nothing”

Outside that bypass exception, plan mode blocks edits to your source, not all activity. Claude still runs shell commands to explore. Whether you are asked about each one depends on the session: when auto mode is available and the `useAutoModeDuringPlan` setting is on, which is the default, auto mode’s classifier reviews those commands instead of prompting you. If you want a session that cannot run anything outside a fixed list, plan mode is not that tool; permission rules and `dontAsk` mode are. More on the modes in [what auto mode is](https://bombos.ai/en/questions/claude-code/claude-code-auto-mode/).

## When it helps, and when to skip it

Plan mode earns its turn when a wrong direction is expensive:

1.  **Exploring a codebase before changing it**, the use the permission docs name for it.
2.  **Larger or risky changes**, where you want to agree on the approach first. The costs guide recommends plan mode for complex tasks because it prevents expensive rework when the initial direction is wrong.
3.  **Work you hand to others**: in an agent team, a teammate started while the lead is in plan mode plans first and only implements after its plan is approved.

For a one-line fix or a change you can describe exactly, planning adds a round trip without much gain. A specific prompt already does most of the work.

## What this means for a team

A plan is the cheapest moment to catch a wrong assumption, and it is readable by people who were not in the session. Pasting the plan into the pull request or the issue lets a reviewer see what was intended before reading the diff. But a plan is only as good as what Claude knew when writing it. It reads the repo and CLAUDE.md, not the decision someone made in a call last week. See also [how subagents keep exploration out of your session](https://bombos.ai/en/questions/claude-code/claude-code-subagents/) and [how to use Claude Code well](https://bombos.ai/en/questions/claude-code/how-to-use-claude-code-well/).

## Where Bombos fits

A plan is built from what Claude can see. Bombos is a plugin that gives Claude Code and the team’s other AI tools one shared memory with the context a plan usually misses: team decisions, rules learned from earlier corrections, and what is in mail, documents and other repos, each traceable to its source. One developer can try it on their own agents first.

## Related questions

Is it called planning mode or plan mode?

The official name is plan mode. The status bar shows ⏸ plan mode on, and the setting value is plan.

Can I edit the plan before Claude starts?

Yes. Press Ctrl+G to open the proposed plan in your text editor and change it directly before Claude proceeds.

How do I leave plan mode without approving?

With no approval prompt open, press Shift+Tab to move on in the cycle. At the approval prompt, press Esc first, because Shift+Tab there approves the plan.

Can I start every session in plan mode?

Yes. Set permissions.defaultMode to "plan" in your settings file, or start with claude --permission-mode plan. In VS Code, click the mode indicator under the prompt box.

Does plan mode cost extra?

Planning itself uses tokens like any turn. The costs guide recommends it for complex tasks because it prevents expensive rework when the first direction is wrong.

## Sources

1.  [Claude Code docs: Choose a permission mode](https://code.claude.com/docs/en/permission-modes)
2.  [Claude Code docs: Manage costs effectively](https://code.claude.com/docs/en/costs)
3.  [Claude Code docs: Create custom subagents](https://code.claude.com/docs/en/sub-agents)
4.  [Claude Code docs: Orchestrate teams of Claude Code sessions](https://code.claude.com/docs/en/agent-teams)

## What does your AI forget?

1.  01You tell us which AI you use and where it keeps starting over.
2.  02We show what a shared memory changes there, on your own examples.
3.  03You keep the plan, with or without Bombos.

![Piet Baudoin](https://bombos.ai/assets/team/piet-klein.jpg)

**Piet Baudoin**You talk to Piet, from the Bombos teamDutch team from Utrecht and Nijmegen · data in Europe

## More questions about Claude Code

-   [What are agent teams in Claude Code and how do you turn them on?](https://bombos.ai/en/questions/claude-code/claude-code-agent-teams/)
-   [What is auto mode in Claude Code, and is it safe to use?](https://bombos.ai/en/questions/claude-code/claude-code-auto-mode/)
-   [How much does Claude Code cost, and which plan do I need?](https://bombos.ai/en/questions/claude-code/claude-code-pricing/)
-   [What are Claude Code hooks and how do I set them up?](https://bombos.ai/en/questions/claude-code/claude-code-hooks/)
-   [How do I use Claude Code in VS Code and JetBrains?](https://bombos.ai/en/questions/claude-code/claude-code-in-vs-code-and-jetbrains/)
-   [How do Claude Code plugins work, and can a plugin add shared memory?](https://bombos.ai/en/questions/claude-code/claude-code-plugins-memory/)
-   [What is Claude Code Remote Control and how do I use it?](https://bombos.ai/en/questions/claude-code/claude-code-remote-control/)
-   [Can Claude Code review pull requests, and what does Code Review cost?](https://bombos.ai/en/questions/claude-code/claude-code-review/)

[All questions about Claude Code →](https://bombos.ai/en/questions/claude-code/)


---

```json
{"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://bombos.ai/#organization","name":"Bombos","url":"https://bombos.ai/","logo":"https://bombos.ai/assets/bombos-bee.png","description":"Bombos is the memory layer under every AI your team uses. One shared memory for Claude, ChatGPT, Copilot, Cursor and your own agents, that learns how you work.","sameAs":["https://www.linkedin.com/company/bombos-ai","https://www.youtube.com/@truebombos","https://www.instagram.com/truebombos/","https://bsky.app/profile/bombostrue.bsky.social","https://www.threads.com/@truebombos","https://mastodon.social/@Bombos","https://www.tiktok.com/@truebombos","https://t.me/truebombos","https://www.pinterest.com/truebombos/","https://github.com/bombos-ai","https://linktr.ee/bombos.ai","https://bombosai.substack.com","https://hashnode.com/@bombosai","https://hackernoon.com/u/bombos","https://dev.to/bombos"],"email":"info@bombos.ai","areaServed":["NL","Europe"],"knowsLanguage":["nl","en"],"contactPoint":{"@type":"ContactPoint","email":"info@bombos.ai","contactType":"sales","url":"https://bombos.ai/en/contact/","availableLanguage":["nl","en"]}},{"@type":"WebSite","@id":"https://bombos.ai/#website","name":"Bombos","url":"https://bombos.ai/","inLanguage":["nl-NL","en"],"publisher":{"@id":"https://bombos.ai/#organization"}}]}

{"@context":"https://schema.org","@type":"Article","headline":"What does plan mode do in Claude Code and how do you turn it on?","description":"Plan mode lets Claude Code read files and explore, then propose a plan without editing code. Enter it with Shift+Tab, a /plan prefix or --permission-mode plan.","abstract":"Plan mode is a Claude Code permission mode in which Claude reads files, runs commands to explore and writes a plan, but normally does not edit your source until you approve. You enter it with Shift+Tab, by starting a single prompt with /plan, or with claude --permission-mode plan. When the plan is ready you choose how to continue, or keep planning.","datePublished":"2026-11-17T00:00:00.000Z","dateModified":"2026-11-17T00:00:00.000Z","author":{"@type":"Person","name":"Piet Baudoin"},"publisher":{"@type":"Organization","@id":"https://bombos.ai/#organization","name":"Bombos","logo":{"@type":"ImageObject","url":"https://bombos.ai/assets/bombos-bee.png"}},"image":"https://bombos.ai/assets/og-en-v2.png","mainEntityOfPage":"https://bombos.ai/en/questions/claude-code/claude-code-plan-mode/","inLanguage":"en-US","isPartOf":{"@type":"CollectionPage","name":"Claude Code","url":"https://bombos.ai/en/questions/claude-code/"},"citation":[{"@type":"CreativeWork","name":"Claude Code docs: Choose a permission mode","url":"https://code.claude.com/docs/en/permission-modes"},{"@type":"CreativeWork","name":"Claude Code docs: Manage costs effectively","url":"https://code.claude.com/docs/en/costs"},{"@type":"CreativeWork","name":"Claude Code docs: Create custom subagents","url":"https://code.claude.com/docs/en/sub-agents"},{"@type":"CreativeWork","name":"Claude Code docs: Orchestrate teams of Claude Code sessions","url":"https://code.claude.com/docs/en/agent-teams"}]}

{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Bombos","item":"https://bombos.ai/en/"},{"@type":"ListItem","position":2,"name":"Questions","item":"https://bombos.ai/en/questions/"},{"@type":"ListItem","position":3,"name":"Claude Code","item":"https://bombos.ai/en/questions/claude-code/"},{"@type":"ListItem","position":4,"name":"What does plan mode do in Claude Code and how do you turn it on?","item":"https://bombos.ai/en/questions/claude-code/claude-code-plan-mode/"}]}

{"@context":"https://schema.org","@type":"FAQPage","mainEntity":[{"@type":"Question","name":"Is it called planning mode or plan mode?","acceptedAnswer":{"@type":"Answer","text":"The official name is plan mode. The status bar shows ⏸ plan mode on, and the setting value is plan."}},{"@type":"Question","name":"Can I edit the plan before Claude starts?","acceptedAnswer":{"@type":"Answer","text":"Yes. Press Ctrl+G to open the proposed plan in your text editor and change it directly before Claude proceeds."}},{"@type":"Question","name":"How do I leave plan mode without approving?","acceptedAnswer":{"@type":"Answer","text":"With no approval prompt open, press Shift+Tab to move on in the cycle. At the approval prompt, press Esc first, because Shift+Tab there approves the plan."}},{"@type":"Question","name":"Can I start every session in plan mode?","acceptedAnswer":{"@type":"Answer","text":"Yes. Set permissions.defaultMode to \"plan\" in your settings file, or start with claude --permission-mode plan. In VS Code, click the mode indicator under the prompt box."}},{"@type":"Question","name":"Does plan mode cost extra?","acceptedAnswer":{"@type":"Answer","text":"Planning itself uses tokens like any turn. The costs guide recommends it for complex tasks because it prevents expensive rework when the first direction is wrong."}}]}
```
