14 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
…w.md#how-background-sessions-are-hosted) | Turn off `claude agents`, `--bg`, `/background`, and the on-demand supervisor | `disableAgentView` | | [Configure the corporate launcher](/docs/en/corporate-…
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
…` being started as a background session * Fixed a prompt or reply of `--bg` or `--background` to a background session being taken for the flag, which could start new sessions over and over instead of…
claude-tag
Claude Code CLI · in the page
claude-tag
…ondary-200: 210 70.9% 51.6%; --accent-secondary-900: 211 72% 90%; --bg-000: 0 0% 100%; --bg-100: 48 33.3% 97.1%; --bg-200: 53 28.6% 94.5%; --bg-300: 48 25% 92.2%; --bg-400: 50 20.7% 88.6%;…
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
…and login](/docs/en/troubleshoot-install.md#auto-update-failed) | | `--bg and --print conflict` | [Command-line errors](#conflict-between-bg-and-print) | | `Couldn't tell whether --bg is a flag or te…
Run Claude Code programmatically
Claude Code CLI · in the page
headless
…](/docs/en/cli-reference.md) 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.md#how-background-sessions-are-host…
Choose a permission mode
Claude Code CLI · in the page
permission-modes
…in user or managed settings: * With no acceptance recorded, `claude --bg --permission-mode bypassPermissions` is refused. Accept the dialog in an interactive session first. * With `skipDangerousMode…
Configure permissions
Claude Code CLI · in the page
permissions
…space trust for the directory the session runs in. If you run `claude --bg` from a terminal in a directory you haven't trusted, the trust dialog appears first and the session starts once you accept it…
Manage sessions
Claude Code CLI · in the page
sessions
…is still running, Claude Code opens the running session itself. With `--bg` on the command line, the resume is a [background dispatch](/docs/en/agent-view.md#from-your-shell) instead. Before v2.1.285,…
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
…ound job you can attach to and detach from; also available as `claude --bg --exec 'pytest -x'`Plugins in `.claude/skills` directories are now loaded automatically, no marketplace required, and `claude…