Plan Approval - Claude Code
Require lead approval before teammates execute their tasks.
Plan approval is a gate in Agent Teams where teammates must present a plan to the lead (or the user) before doing any real work.
What it does
When plan approval is on, teammates enter plan mode on claim. They produce a plan explaining their intended steps. The lead reviews, either approves the plan or sends it back for revision. Only then does the teammate execute. It's the safety net for teams working on large or sensitive changes.
When to use it
- Large refactors where wrong execution is expensive to undo.
- Multi-agent jobs on critical infrastructure.
- Any run where you want the lead to catch bad decompositions before they cost turns.
- Teaching a multi-agent workflow while keeping guardrails on.
Gotchas
- Approval adds latency. Don't use it for fast exploratory tasks.
- A careless lead rubber-stamps bad plans. Quality depends on the lead's attention.
- Too many revisions can stall a team. Set a revision cap.
Official docs: https://code.claude.com/docs/en/agent-teams.md#require-plan-approval-for-teammates
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.
Get the weekly deep dive
Tutorials on Claude Code, AI agents, and dev tools - delivered free every week.
Was this helpful?






