Search the documentation
8 pages for --agents.
Titles and paths first, then pages whose text carries it. Each row opens that page as this site last read it.
Claude Code changelog
Claude Code CLI · in the page
changelog
…e an LSP plugin change that would re-read the conversation * Fixed `--agents` silently ignoring invalid JSON or invalid agent definitions; it now exits with a clear error, like `--mcp-config` * Fi…
CLI reference
Claude Code CLI · in the page
cli-reference
…| | `--agents` | Define custom subagents dynamically via JSON. Accepts the [fields listed for CLI-…
Fullscreen rendering
Claude Code CLI · in the page
fullscreen
…lowed-tools`](/docs/en/cli-reference#cli-flags), and your `--agent`, `--agents`, and `--append-system-prompt` flags Claude Code declines to relaunch if the session has a restriction it can't pass to…
Run Claude Code programmatically
Claude Code CLI · in the page
headless
…le-or-json>` | | Custom agents | `--agents <json>` | | A plugin | `--plugin-dir <path>`, `--plugin-url <url>`…
Deploy managed settings
Claude Code CLI · in the page
managed-settings
…| Reject the `--plugin-dir`, `--plugin-url`, `--agents`, and `--mcp-config` flags at startup. In cloud sessions, Claude Code drops the MCP servers the server delivered through…
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 ha…
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/a…