Claude Code Subagents Run in the Background by Default
Anthropic · docs · agents, tools
What it is — Resolved via search — verify before relying on it. Claude Code docs on running subagents concurrently in the background while you keep working in the main session.
Key points
- Claude decides whether a subagent runs in the foreground or background based on the task, or you can ask it to run in the background (or press Ctrl+B).
- Background subagents surface permission prompts in your main session, naming which subagent is asking.
- Disable background tasks entirely with the
CLAUDE_CODE_DISABLE_BACKGROUND_TASKSenvironment variable.
Shared by Adam Tomat in #ai-dev.