What
Argument scanning now knows which flags take one value and which take a list, so options like --tools, --mcp-config, --betas, --channels, --plugin-dir and --file no longer swallow or lose their arguments. It also handles -- when locating the first positional argument.
Details
- Flags that are boolean but accept an optional value, such as
-r,--worktree,--cloudand--rc, are tracked separately. cc://andcc+unix://targets are recognised as session addresses.- Detecting
-p/--printnow goes through the same shared helper as everything else.
Evidence
--dangerously-load-development-channels
Strings lifted out of the shipped bundle, so the claim above can be checked against them.
The entry above is what we published on the day. These lines were added later, as Anthropic's own pages caught up, and they sit beside the original rather than replacing it.
Added since
A small documentation edit on All settings touched a line naming --mcp-config after this was published.
In cloud sessions, Claude Code also ignores server-delivered mid-session MCP updates, the path behind cloud session configuration and SDK `setMcpServers()` calls that reach those sessions. In-process `type: "sdk"` entries stay exempt there…settings-reference see the edit
Confirmed since
Anthropic's documentation has since written up --tools, on Tools reference.
* You name `Glob` or `Grep` in [`--tools` or `--allowedTools`](/docs/en/cli-reference#cli-flags) when you start the session, or in the equivalent [Agent SDK](/docs/en/agent-sdk/overview) options. With `--tools` you get the ones you list, a…tools-reference see the edit
Added since
A small documentation edit on CLI reference touched a line naming --tools after this was published.
| `--tools` | Restrict which built-in tools Claude can use. Use `""` to disable all, `"default"` for the default set, or tool names like `"Bash,Edit,Read"`. On macOS, Linux, and WSL, the default set leaves out `Glob` and `Grep`, as describ…cli-reference see the edit
Added since
A small documentation edit on Create plugins touched a line naming --plugin-dir after this was published.
Trying the plugin with `--plugin-dir` tells you it can work. To find out how often Claude actually reaches for it and gets the right result, run it against a set of test prompts with [`claude plugin eval`](/docs/en/plugin-evals). Each prom…plugins see the edit
Confirmed since
Anthropic's documentation has since written up --mcp-config, on CLI reference.
| `claude agents` | Open [agent view](/docs/en/agent-view) to monitor and dispatch parallel background sessions. Use `--cwd <path>` to show only sessions started under that directory, or `--json` to print active sessions as a JSON array fo…cli-reference see the edit
Confirmed since
Anthropic's documentation has since written up --plugin-dir, on Discover and install prebuilt plugins through marketplaces.
* Edits to a plugin you loaded with [`--plugin-dir`](/docs/en/plugins#test-your-plugins-locally) while you develop itdiscover-plugins see the edit
One source agreesOne thing we can check says the same as this entry.
Anthropic's documentation agrees
Anthropic's documentation has since written up --plugin-dir, on Discover and install prebuilt plugins through marketplaces.