Source Intelligence
Follow Discord

DisclaimerUnofficial, and not affiliated with Anthropic. Nearly all of this is read straight out of what ships: npm bundles, captured prompts, published docs. Anthropic's own notes go in verbatim, marked as theirs. The rest is my reading, and every entry carries the strings behind it. If one looks wrong, vote it down and say why.

← All of v2.1.198 Home All releases ←olderv2.1.197 v2.1.199newer→
Claude Code v2.1.198

--bg and --allow-tools Flags for claude agents

What

Two new flags for the claude agents command.

Usage
# Attach to a named background session
claude agents --bg <session-name>

# Grant specific tools when launching an agent
claude agents --allow-tools Bash,Read,Write
Details
  • --bg moves a session to the background and detaches (conflicts with --print — the interactive session that claude agents attaches to is never started with --print)
  • --allow-tools grants specific tool permissions inline; denied tools are listed with an advisory to pass --allow-tools to grant them
  • The background session keeps running after detach; re-attach with claude agents from another terminal
Evidence

Error message (search for "--bg and --print conflict") and denied-tool notice (search for ": denied tools (pass --allow-tools to grant):")

Strings lifted out of the shipped bundle, so the claim above can be checked against them.

See this entry in the whole of v2.1.198 →