Follow Discord
Sweep 08 Oct 2026 · 18:53Z Build v2.1.295 516 read Stable v2.1.286 Latest v2.1.295 Next v2.1.295 Feeds RSS JSON llms.txt llms-full.txt Unofficial
HomeDocsClaude Code CLI 7 Oct 2026
One change · claude-code

Create custom subagents changedsub-agents

Nearest release: v2.1.293, published under an hour after upstream edited the page. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.

Upstream edited this page at 7 Oct 2026 17:14 UTC, give or take a minute or two: the time comes from Anthropic’s own sitemap rather than from a commit. This site recorded the change at 7 Oct 2026 17:37 UTC.

Upstream edited
Recorded here
Lines+2added
Lines−2removed
From line 16 where the diff opens
First seen 14 Aug 2026 this site's first read of the page
Recorded edits73to this page, all time

The whole hunk

from line 16, old and new numbered
/
lines
from line 16
1616* **Enforce constraints** by limiting which tools a subagent can use
1717* **Reuse configurations** across projects with user-level subagents
1818* **Specialize behavior** with focused system prompts for specific domains
19* **Control costs** by routing tasks to faster, cheaper models like Haiku
19* **Control costs** by routing tasks to faster, lower-cost models like Haiku
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 
from line 1189
11891189| Permissions | Prompts surface in your terminal | [Prompts surface in your main session](#run-subagents-in-foreground-or-background) when running in the background |
11901190| Prompt cache | Shared with main session | Separate cache |
11911191 
1192Because a fork's system prompt and tool definitions are identical to the parent, its first request reuses the parent's [prompt cache](/docs/en/prompt-caching#subagents-and-the-cache). This makes forking cheaper than spawning a fresh subagent for tasks that need the same context.
1192Because a fork's system prompt and tool definitions are identical to the parent, its first request reuses the parent's [prompt cache](/docs/en/prompt-caching#subagents-and-the-cache). Because of that reuse, a fork costs less than a fresh subagent for tasks that need the same context.
11931193 
11941194When Claude spawns a fork through the Agent tool, it can pass `isolation: "worktree"` so the fork's file edits are written to a separate git worktree instead of your checkout. A fork can't spawn further forks.
11951195 
Feedback