12 pages for --agents.

Claude Code changelog Claude Code CLI · in the page changelog …gateway mode * Added `autoCompactWindow` to subagent frontmatter and `--agents` definitions, so a subagent can auto-compact earlier than the main conversation's window * Added `CLAUDE_CODE_WORKFLOW_SU… CLI reference Claude Code CLI · in the page cli-reference …| | `--agents` | Define custom subagents dynamically via JSON. Accepts the [fields listed for CLI-… Error reference Claude Code CLI · in the page errors …the-json-schema-value-is-not-a-valid-json-schema) | | `Error: Invalid --agents configuration:` | [Command-line errors](#invalid-agents-configuration) | | `Error: --agents takes a JSON object, or a fil… Fullscreen rendering Claude Code CLI · in the page fullscreen …lowed-tools`](/docs/en/cli-reference#cli-flags), and your `--agent`, `--agents`, `--append-system-prompt`, and `--system-prompt-snapshot` flags * A `--chrome` or `--no-chrome` flag you launched with,… Run Claude Code programmatically Claude Code CLI · in the page headless …| | [Custom agents](/docs/en/sub-agents#choose-the-subagent-scope) | `--agents <file-or-json>` | | A plugin | `--plugin-dir <path>`, `--plugin-url <url>` | Bare mode also limits what happens while th… Deploy managed settings Claude Code CLI · in the page managed-settings …e#disablesideloadflags) | Reject the `--plugin-dir`, `--plugin-url`, `--agents`, and `--mcp-config` flags at startup. In cloud sessions, Claude Code instead starts the session and drops the server-del… Connect Claude Code to tools via MCP Claude Code CLI · in the page mcp …file from `~/.claude/agents/`, from managed settings, or passed with `--agents` Apart from Git's `GIT_CONFIG_KEY_<n>` variables, Claude Code removes every variable from your environment whose name lo… Manage mods for your organization Claude Code CLI · in the page plugins/mods/admin …laude writes during a session from loading. The setting also rejects `--agents` and `--mcp-config`. Read [`disableSideloadFlags`](/docs/en/settings-reference#disablesideloadflags) before you set it.… Manage Claude Code plugins for your organization Claude Code CLI · in the page plugins/org …| | `disableSideloadFlags` | Rejects `--plugin-dir`, `--plugin-url`, `--agents`, the Agent SDK `plugins` option, and non-SDK `--mcp-config` at startup, and rejects folders named in the [`CLAUDE_CODE_P… Troubleshoot plugins Claude Code CLI · in the page plugins/troubleshooting …adFlags)` You started `claude` with `--plugin-dir`, `--plugin-url`, `--agents`, or `--mcp-config`. Claude Code exited with this message and `Plugins, custom agents, and MCP servers can only be loaded… Claude Code settings Claude Code CLI · in the page settings …| (Managed settings only) Reject the `--plugin-dir`, `--plugin-url`, `--agents`, and `--mcp-config` CLI flags at startup, which users could otherwise pass to bypass [`strictKnownMarketplaces`](#strict… Create custom subagents Claude Code CLI · in the page sub-agents …1 (highest) | Deployed via [managed settings](/docs/en/settings) | | `--agents` CLI flag | Current session | 2 | Pass JSON when launching Claude Code | | `.claude/agents/` | Current project | 3 | Ask…