Introduction to Subagents

💎 Key Takeaways

Course NameIntroduction to Subagents
PlatformClaude Academy
PriceFree
Duration45 minutes, self-paced
LevelBeginner
PrerequisitesBasic familiarity with Claude Code
SkillsSubagent architecture, custom subagent creation, YAML/markdown configuration, tool access scoping, output format design, delegation decision-making, Claude Code workflow optimization

About

This course teaches you how Claude Code’s subagent system works and how to build, configure, and use subagents for real development tasks. You learn the mechanics of context isolation, how to create custom subagents using the /agents command, how to write system prompts that produce reliable and structured output, and how to decide when delegating to a subagent actually helps versus when it adds unnecessary overhead.

The course is produced by Anthropic and published on Claude Academy, the official learning platform for Claude tools and workflows.

Who’s Teaching

N/A

What’s Covered

  • How subagents spin up isolated context windows and return summaries to the main thread
  • Built-in subagents in Claude Code: General Purpose, Explore, and Plan
  • Creating custom subagents with the /agents command using Claude-generated or manual configuration
  • Configuring subagent scope (project-level vs. user-level), model selection, and tool access
  • Writing YAML frontmatter and markdown system prompts for subagent config files
  • Structuring output formats so subagents know when to stop and what to return
  • Surfacing obstacles and environment quirks through dedicated output sections
  • Identifying anti-patterns: expert persona subagents, sequential pipelines, and test runner subagents

Skills You’ll Develop

  • Building and configuring custom subagents in Claude Code
  • Writing targeted system prompts with structured output templates
  • Scoping tool access appropriately per subagent role
  • Controlling when subagents are triggered automatically via description fields
  • Applying the intermediate-work decision rule to choose between delegation and main-thread execution
  • Designing subagent workflows for code review and codebase research tasks

Level

Beginner. Best suited for developers already using Claude Code who want to handle longer, more complex sessions without degrading context quality. No prior experience with agentic workflows is required.