Plan Mode - Claude Code
Explore and propose changes without executing them.
Plan mode lets Claude think out loud, read code, and propose a full plan before it makes any changes. It's the deliberate, measure-twice-cut-once mode.
What it does
In plan mode Claude can run read-only tools (Read, Grep, Glob, WebFetch) but is blocked from Edit, Write, and most Bash. The output is a plan - what it would do, in what order, and why. You review the plan, tweak it, then exit plan mode to execute.
When to use it
- Large refactors where a wrong first step is expensive.
- Exploring a new codebase before touching anything.
- Planning a multi-file change you want a human to sign off.
- Any task where the cost of a bad edit is higher than the cost of a slower first turn.
Gotchas
- Plan mode can still read sensitive files. It's about preventing writes, not reads.
- A great plan still needs a careful execution turn. Don't skip the review.
- Exiting plan mode without executing is fine - you can use it as pure pre-reading.
Official docs: https://code.claude.com/docs/en/permission-modes.md#analyze-before-you-edit-with-plan-mode
Technical content at the intersection of AI and development. Building with AI agents, Claude Code, and modern dev tools - then showing you exactly how it works.
Newsletter
Get the weekly deep dive
Tutorials on Claude Code, AI agents, and dev tools, delivered free every week.
Was this helpful?
Related Guides
Related Tools
Claude Opus 4.7
Anthropic's flagship reasoning model. Best-in-class for coding, long-context analysis, and agentic workflows. 1M token c...
View ToolCursor
AI-native code editor forked from VS Code. Composer mode rewrites multiple files at once. Tab autocomplete predicts your...
View Tool
Zed
High-performance code editor built in Rust with native AI integration. Sub-millisecond input latency. Built-in assistant...
View ToolClaude
Anthropic's AI. Opus 4.6 for hard problems, Sonnet 4.6 for speed, Haiku 4.5 for cost. 200K context window. Best coding m...
View ToolRelated Videos
Claude Code 'Interview' Mode in 6 Minutes
Effortless Project Planning: Mastering Spec-Driven Development with Claude Code Kick off the new year with a fresh approach to project planning using Claude Code! In this video, learn how to achieve
Open Design: Turn Websites into Design Assets for Cursor & Claude Code
Open Design: Open-Source n8n App That Turns Any Website into a Brand Kit, Design System, HTML + Images The video introduces Open Design, an MIT-licensed full-stack template that combines AI and n8n a
Nimbalyst: The Open-Source Visual Workspace for Building with Codex and Claude Code
Nimbalyst Demo: A Visual Workspace for Codex + Claude Code with Kanban, Plans, and AI Commits Try it: https://nimbalyst.com/ Star Repo Here: https://github.com/Nimbalyst/nimbalyst This video demos N
Related Posts
Claude Outages Are a Workflow Design Problem
Claude outages and 529 overloads expose whether your AI coding workflow has checkpoints, receipts, model-switch paths, a...
Claude Opus 4.8 Is an Agent Honesty Release
Claude Opus 4.8 looks like a benchmark bump, but the developer story is better honesty, dynamic workflows, and effort co...
Anthropic Sonnet 4.5 in Claude Code
Anthropic's Claude Sonnet 4.5 isn't just another model increment. The company claims they've observed it maintaining foc...
Clean Code Makes AI Agents 34% More Efficient - New Research
A controlled study of 660 Claude Code trials shows clean codebases reduce token usage by 7-8% and file revisitations by...
Does Code Cleanliness Affect AI Coding Agents?
A new SonarSource study finds clean code doesn't boost agent pass rates - but it cuts token usage by 8% and file revisit...
Safari MCP Server Developer Guide 2026
Apple's Safari MCP server lets AI coding agents inspect pages, capture screenshots, evaluate JavaScript, and run accessi...
