[DOCS] Permission modes page shows auto mode instead of bypass permissions after `--dangerously-skip-permissions`

Documentation Type

Incorrect/outdated documentation

Documentation Location

https://code.claude.com/docs/en/permission-modes

Section/Topic

"Analyze before you edit with plan mode" — the plan acceptance options shown after exiting plan mode

Current Documentation

The permission modes page currently says:

When the plan is ready, Claude presents it and asks how to proceed. From that prompt you can: Approve and start in auto mode Approve and accept edits * Approve and review each edit manually

The same page also says:

The --dangerously-skip-permissions flag is equivalent.

That line appears in the bypassPermissions section, where the page explains that --dangerously-skip-permissions is equivalent to --permission-mode bypassPermissions.

What's Wrong or Missing?

Changelog v2.1.118 says Claude Code fixed the plan acceptance dialog to offer bypass permissions instead of auto mode when the session is running with --dangerously-skip-permissions.

The current permission modes page still presents "Approve and start in auto mode" as the approval option without explaining that the plan acceptance choice depends on the permission mode that was active before entering plan mode. For users who start in bypassPermissions via --dangerously-skip-permissions, this is outdated and describes the pre-fix behavior.

As written, the page can mislead users into expecting the wrong post-plan mode and makes the --dangerously-skip-permissions flow harder to understand.

Suggested Improvement

Update the plan mode section to explain that approving a plan resumes the relevant execution mode for the current session, rather than always offering auto mode.

For example, the docs could clarify that:

• sessions started with --dangerously-skip-permissions / bypassPermissions resume bypass permissions after plan approval
• auto appears only when auto mode is actually available for that session
• the label shown in the approval dialog depends on the mode Claude should return to after planning

If helpful, add a short note cross-referencing the bypassPermissions section so readers can understand why the dialog changes when they entered plan mode from a bypass-permissions session.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/permission-modes | Plan mode approval options currently say "Approve and start in auto mode" even though v2.1.118 fixed the --dangerously-skip-permissions case to offer bypass permissions instead |

Total scope: 1 page affected

Source: Changelog v2.1.118

Exact changelog entry:

Fixed plan acceptance dialog offering "auto mode" instead of "bypass permissions" when running with --dangerously-skip-permissions