# SubagentHandback Tool

> How a helper hands back its report in auto mode.

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** SubagentHandback, Subagent report

## Think of it like

It is like a teacher who checks your work first. Then it goes up on the wall.

## Definition

The SubagentHandback tool is how a subagent hands its final report back in auto mode. Before the report reaches the main session, the auto mode safety check reads it. Claude Code only gives this tool to local subagents in auto mode, not to forked ones. It needs version 2.1.271 or later. You never call it yourself.

## Example

Emma runs a big change in auto mode. Each helper hands in its report with this tool, and the safety check reads every report on the way back.

## Why it matters

In auto mode, no one clicks yes. So a helper's report gets checked before the main session uses it.

## Common mistake

Looking for it outside auto mode. It is only given to subagents when auto mode is on.

## Three principles

- **The report back.** From a helper.
- **Checked first.** By the auto mode check.
- **Auto mode only.** Not in other modes.

## Related terms

- [Agent Tool](https://learn.benibix.com/term/ai/agent-tool)
- [Auto Mode](https://learn.benibix.com/term/ai/auto-mode)
- [Subagent](https://learn.benibix.com/term/ai/subagent)

## Taught in

- [Claude Code Subagents](https://learn.benibix.com/learn/ai-claude-code/claude-code-subagents): Claude Code, 15/16

![The main session starts subagents with the Agent tool, messages other sessions, and stops background work.](https://learn.benibix.com/diagrams/ct-agent-tools.svg)

---

Source: https://learn.benibix.com/term/ai/subagent-handback-tool
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-17
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
