Create custom subagents changedsub-agents
Nearest release: v2.1.250, published under an hour before this site recorded the change. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.
Recorded here
Lines+3added
Lines−1removed
From line
20
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits91to this page, all time
The whole hunk
from line 20, old and new numbered
/
from line 20
2020
2121Claude uses each subagent's description to decide when to delegate tasks. When you create a subagent, write a clear description so Claude knows when to use it.
2222
23Those descriptions take up context, so keep them short. When the combined descriptions of your subagents, except the built-in ones, exceed 15,000 tokens, Claude Code shows a [warning at startup with the total token count](/docs/en/errors#agent-descriptions-are-over-the-15000-token-limit). Trim the `description` fields of your subagents, and move detail into each subagent's system prompt, which only loads when that subagent runs.
24
2325## Built-in subagents
2426
2527Claude Code includes built-in subagents that Claude automatically uses when appropriate. Each inherits the parent conversation's permissions; most run with a restricted tool set.
from line 1119
11171119 **Best practices:**
11181120
11191121 * **Design focused subagents:** each subagent should excel at one specific task
1120 * **Write detailed descriptions:** Claude uses the description to decide when to delegate
1122 * **Write specific descriptions:** Claude uses the description to decide when to delegate
11211123 * **Limit tool access:** grant only necessary permissions for security and focus
11221124 * **Check into version control:** share project subagents with your team
11231125</Tip>
No line in this hunk matches that.