Tool ยท in the coding agent
Plan mode
A mode in which the coding agent may only read and plan, until a person approves the plan.
- Builds
- Human answer
No illustration yet
catalog/tools/plan-mode.svg Plan mode keeps the coding agent to reading and planning: it may explore the code but change nothing until a person approves the plan. It is a mode of the agent itself.
Finding it
- Claude Code: Shift+Tab switches into it,
claude --permission-mode planstarts in it, anddefaultModein the settings'permissionsmakes it the default. - Other coding agents: a plan mode of their own, or a read-only approval setting.
Using it
- For work whose direction a person should settle first: a change across many files, a migration, anything hard to undo.
- The plan names the files to change, the steps, and how each step will be checked.
- Keep the approved plan, in the repository or the session's record, so later work can be checked against it.
- A rejected plan comes back with the reason, and the agent plans again.
Examples: plan mode in Claude Code and in Codex.
Built from catalog/tools/plan-mode.md.