Follow Discord
Sweep 22 Sep 2026 · 17:19Z Build v2.1.280 501 read Stable v2.1.267 Latest v2.1.280 Next v2.1.280 Feeds RSS JSON llms.txt Unofficial
One name

--background

A Claude Code CLI flag, read out of the shipped bundle. No mined inventory carries it: everything below comes from what this site has written about it.

Also written --bg. Every list on this page counts all of these spellings together.

FamilyCLI flagCLI flags
Builds0of the 123 on this box
First seennever in a mined build
Last seennever in a mined build
Statusnever minedas of v2.1.280

What it is

Start the session as a [background agent](/docs/en/agent-view) and return immediately. Prints the session ID and management commands. Combine with --exec to run a shell command as a background job instead of a Claude session, or with --agent to run a specific subagent. Can't be combined with -p/--print; see the [error reference](/docs/en/errors#command-line-errors)

Anthropic's own wording. Read off CLI reference, captured 2026-09-22.

Presence across releases

0

The miner has never read a build containing this name. It is here because a changelog entry of ours names it, which is evidence that it existed and not evidence of which releases carried it. The inventory starts at v2.1.138 and everything older than that was never mined.

First cited

1

The earliest release whose published evidence quoted --background was v2.1.187, 23 Jun 2026. That is the oldest release this project wrote about it, so it is a floor on the name's age and not the release that introduced it. It is not a presence reading: which builds carried the name is the table above.

ReleaseDateThe span that was quoted
v2.1.18723 Jun 2026--bg, --background

Read out of the published npm bundle release by release, and out of Anthropic's own documentation as this site captured it. Nothing on this page is a description anybody here wrote about what the CLI flag does. All CLI flags.

Feedback