Search the documentation
11 pages for --bg.
Titles and paths first, then pages whose text carries it. Each row opens that page as this site last read it.
Set up Claude Code for your organization
Claude Code CLI · in the page
admin-setup
…ound-sessions-are-hosted) | Turn off `claude agents`, `--bg`, `/background`, and the on-demand supervisor…
Manage multiple agents with agent view
Claude Code CLI · in the page
agent-view
…n't listed. * From the shell, `cd` into the directory and run `claude --bg "<prompt>"`. When agent view is grouped by directory, dispatching sends the prompt to the selected row's directory, so you c…
Claude Code changelog
Claude Code CLI · in the page
changelog
…rn, kills the tree, and exits 143 * Fixed `/background` and `claude --bg` failing with "EUNKNOWN: unknown error, uv\_spawn" on Windows when Group Policy blocks PowerShell 5.1; the daemon now prefers…
CLI reference
Claude Code CLI · in the page
cli-reference
…g` | | `--bg`, `--background` | Start the session as a [background agent](/docs/en/agent-view) and return immedia…
Environment variables
Claude Code CLI · in the page
env-vars
…ground agents and agent view](/docs/en/agent-view): `claude agents`, `--bg`, `/background`, and the on-demand supervisor. Equivalent to the [`disableAgentView`](/docs/en/settings-reference#disableagen…
Error reference
Claude Code CLI · in the page
errors
…ng-the-update) | | `--bg and --print conflict`…
Run Claude Code programmatically
Claude Code CLI · in the page
headless
…ion](/docs/en/cli-reference) combines with `-p`. Claude Code rejects `--bg`, and rejects `--cloud` with a task description, with an error naming the conflict; `--cloud` with a session ID and `-p` inst…
Enterprise network configuration
Claude Code CLI · in the page
network-config
…rts on demand, outlives your shell, and hosts every `claude agents`, `--bg`, and `/background` session. See [How background sessions are hosted](/docs/en/agent-view#how-background-sessions-are-hosted)…
Choose a permission mode
Claude Code CLI · in the page
permission-modes
…shown, and a [background session](/docs/en/agent-view) started with `--bg` is refused until you've accepted the dialog in an interactive session. On Linux and macOS, Claude Code refuses to start in…
Claude Code settings
Claude Code CLI · in the page
settings
…ground agents and agent view](/docs/en/agent-view): `claude agents`, `--bg`, `/background`, and the on-demand supervisor. Typically set in [managed settings](/docs/en/permissions#managed-settings). Eq…
Week 22 · May 25–29, 2026
Claude Code CLI · in the page
whats-new/2026-w22
…job you can attach to and detach from; also available as <code>claude --bg --exec 'pytest -x'</code></div> <div>Plugins in <code>.claude/skills</code> directories are now loaded automatically, no…