Product feature · runtime
Subagent permissionsCommon product term
Control child-agent tools, inherited permissions, and approval behavior.
Terminology basis: Common product term. Anthropic — Create custom subagents
Subagent permissions: 4 supported, 2 partial, 0 unsupported, 25 unreviewed across 31 cataloged products.
Current evidence by product
Can my agent use Subagent permissions?
Read across for the answer. 6 of 31 current product columns have reviewed evidence; unreviewed does not mean unsupported.
Web
9 productsDesktop
13 productsCLI
9 productsDefinition and scope
What this capability means
This row asks which tools and permissions a child receives and how its actions obtain approval. A child may inherit parent permissions, receive a reduced tool set, prompt the operator, ask the parent to broker an action, or be unable to request more access.
Evidence should cover one-time and persistent approvals, resource and command scope, MCP and connector credentials, filesystem and network access, nested descendants, denial propagation, audit identity, and whether the operator can review a combined action plan before fan-out.
Traceable compatibility
Assertion ledger
Documentation evidence only. No runtime conformance test is implied.
- Target
- 2026-08-28 ChatGPT Work web documentation observation · hosted-observation
- Environment
- hosted-default
- Observed
- 2026-08-28
- policychildren use the tools available to the parent chat and website or connector permissions remain tool-specific; no local sandbox or approval-mode control is exposed
- OpenAI — Subagents in ChatGPT and Codexdocumented · reviewed 2026-08-28
- Target
- current ChatGPT desktop documentation · dated-documentation
- Environment
- local-default
- Observed
- 2026-08-28
- policysubagents inherit the permission mode chosen for the parent turn; choose it before delegation
- OpenAI — Subagents in ChatGPT and Codexdocumented · reviewed 2026-08-28
- Target
- current Codex CLI documentation · dated-documentation
- Environment
- local-default
- Observed
- 2026-08-28
- policyinteractive approval prompts identify the child thread; actions needing a new approval fail in non-interactive execution and return the error to the parent
- OpenAI — Subagents in ChatGPT and Codexdocumented · reviewed 2026-08-28
- Target
- current Gemini CLI documentation · dated-documentation
- Environment
- local-default
- Observed
- 2026-08-28
- policytool lists, inline or inherited MCP servers, and named policy rules can be scoped to a child; recursion protection always removes other agents
- Google — Gemini CLI subagentsdocumented · reviewed 2026-08-28
- Target
- current Claude Code subagent documentation · dated-documentation
- Environment
- local-default
- Observed
- 2026-08-28
- policyparent `bypassPermissions`, `acceptEdits`, or auto mode can take precedence over a child definition; background subagents auto-deny actions that would require a new prompt
- Anthropic — Create custom subagentsdocumented · reviewed 2026-08-28
- Target
- current VS Code subagent documentation · dated-documentation
- Environment
- local-default
- Observed
- 2026-08-28
- policychild identity and tool allowlists are configurable, but separate child approval ownership, grant consumption, and escalation semantics are not fully documented
- Visual Studio Code — Subagents in Visual Studio Codedocumented · reviewed 2026-08-28
- 1. Evidence checked 2026-08-28: Claude Code documents child-specific tool allowlists and denylists plus `default`, `acceptEdits`, `auto`, `dontAsk`, `bypassPermissions`, and `plan` permission modes, with explicit rules for parent-mode precedence.
- 2. Evidence checked 2026-08-28: ChatGPT Work children use the parent chat's available tools; local Codex children inherit the selected permission or sandbox policy, surface interactive approvals by source thread, and fail actions that need fresh approval in non-interactive flows.
- 3. Evidence checked 2026-08-28: Gemini CLI subagents can receive explicitly scoped tools, isolated MCP servers, and subagent-specific policy files; other agents remain unavailable to descendants.
- 4. Evidence checked 2026-08-28: VS Code coordinator agents can allowlist callable children, and each custom child can restrict built-in, extension, and MCP tools; the reviewed docs do not define a separate child approval ledger.
No sourced issues are attached to this row.
- Methodology note
- Anthropic — Create custom subagents documented · Anthropic · reviewed 2026-08-28
- OpenAI — Subagents in ChatGPT and Codex documented · OpenAI · reviewed 2026-08-28
- Google — Gemini CLI subagents documented · Google · reviewed 2026-08-28
- Visual Studio Code — Subagents in Visual Studio Code documented · Microsoft · reviewed 2026-08-28
Found a wrong or incomplete result?
Name the exact product, describe what happened, add the date, and link public evidence when available. A community report starts a review. It does not change the support state by itself.