claude-code - 💡(How to fix) Fix [DOCS] `agent-view` docs omit `claude agents --dangerously-skip-permissions` as a dispatch default

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/agent-view

Section/Topic

"Permission mode, model, and effort" in the agent view guide

Current Documentation

The docs currently say:

To set defaults for every session you dispatch from agent view, pass any of --permission-mode, --model, or --effort when opening it:

claude agents --permission-mode plan --model opus --effort high

And later:

Using bypassPermissions or auto is refused until you have accepted that mode by running claude with it once interactively, since those modes let a session you aren't watching act without approval. The same applies whether you pass the mode to claude agents or to claude --bg --permission-mode.

What's Wrong or Missing?

The page documents the new claude agents defaults for --permission-mode, --model, and --effort, but it does not document the parallel --dangerously-skip-permissions flag from v2.1.143 even though the changelog says agent view accepts it to set defaults for dispatched sessions.

That leaves a specific gap in the same section that explains dispatch defaults:

A. The direct bypass flag is omitted from the documented agent-view defaults

Readers are told they can preconfigure dispatched sessions with --permission-mode, --model, and --effort, but not that claude agents --dangerously-skip-permissions also sets the default permission behavior for sessions launched from the view.

B. The current wording only implies bypass mode indirectly

The note about bypassPermissions being refused until previously accepted suggests some claude agents mode support exists, but it does not explicitly document the direct flag users would search for from the changelog or from the main CLI flag reference.

Suggested Improvement

Update the "Permission mode, model, and effort" section to explicitly include --dangerously-skip-permissions as an agent-view dispatch default.

For example:

Before:

To set defaults for every session you dispatch from agent view, pass any of --permission-mode, --model, or --effort when opening it:

After:

To set defaults for every session you dispatch from agent view, pass --permission-mode, --model, --effort, or --dangerously-skip-permissions when opening it.

If the intended behavior is that --dangerously-skip-permissions is equivalent to --permission-mode bypassPermissions for sessions dispatched from agent view, say that explicitly and add a concrete claude agents --dangerously-skip-permissions example.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

Total scope: 2 pages affected

Version context: The v2.1.143 changelog says claude agents accepts --permission-mode, --model, --effort, and --dangerously-skip-permissions to set defaults for sessions dispatched from the view.