Task, sous-agents (Claude Code)
Tool : A precise action the AI can call · requires claude-code
Launches an autonomous sub-agent with its own tools.
Powerful for parallelizing work; it inherits permissions from the parent, which introduces risk.
Security reflects where data goes, requested permissions and incidents on record at the verification date. It is not a guarantee of zero risk: check the deployment mode and the connections you enable.
What it does, concretely
When a side task risks flooding the main conversation with logs, search results, or file contents you will not reference again, Claude Code subagents handle that work in their own context window and return only a summary.
Each subagent runs with its own system prompt, restricted tool access, and independent permissions. Claude automatically decides to delegate a task to a subagent by reading its description, then returns only the result to the main conversation.
This tool is aimed at developers working on complex codebases who want to parallelize exploration, planning, and execution without saturating their main context. It also helps control costs by routing certain tasks to cheaper models such as Haiku.
However, subagents are not suited for fully independent sessions that need to communicate with each other or be monitored from a dashboard: other Claude Code features (background agents, agent teams) address those needs.
What it offers
- ·Built-in subagents (Explore, Plan, General-purpose) activated automatically based on task type.
- ·Custom subagent creation via a Markdown file with YAML frontmatter, stored in .claude/agents/ or ~/.claude/agents/.
- ·Tool access restriction per subagent (for example, read-only for Explore and Plan).
- ·Per-subagent model selection to control costs (Haiku, Sonnet, Opus).
- ·Configurable scope: subagent available for a single project, all your projects, or an entire organization via managed settings.
- ·Temporary subagent definition via the --agents CLI flag, without writing to disk.
- ·Startup warning when combined descriptions of custom subagents exceed 15,000 tokens.
In practice
- Price
- Free
- Commercial use
- Commercial use: yes
- Available on
- claude-code
- Host
- claude-code
- FR interface
- No
Security and data
- Rating
- Security: one caveat, see the card
- Capabilities
- readswritesexecutesnetwork
- Your data
- Data stays local
- Maintenance
- Active
Links and repository checked on 25 October 2026 · added on 1 July 2025
How to install Task, sous-agents (Claude Code)
.claude/agents/*.md