Resume Subagents - Claude Code
Continue a subagent's work across sessions.
You can resume a subagent's work later, in a new session, without losing its state. The subagent picks up where it stopped.
What it does
Claude Code saves subagent sessions to disk. A resume call restores the subagent's context, recent tool output, and in-flight task list. You can continue the investigation, adjust the prompt, or let the subagent finish a job it paused mid-run. This is the recipe for long-running specialist agents that span days.
When to use it
- Long-running research tasks that need human checkpoints.
- Migration or audit work that can't finish in one session.
- Parallel agent teams where some workers stall and need a human push.
- Anything where "start again from scratch" is wasteful.
Gotchas
- Resumed context is what the subagent had at pause. Anything that changed in the repo since isn't reflected until the next read.
- Very old resumes may reference files that have moved or been deleted.
- Resume is per-subagent. Resuming one worker doesn't resume the whole team.
Official docs: https://code.claude.com/docs/en/sub-agents.md#resume-subagents
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?




