[DOCS] Documentation missing definition for "Delegate Mode" permission setting seen in CLI

[coygeek]

Documentation Type

Missing documentation (feature not documented)

Documentation Location

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

Section/Topic

The "Permission modes" table in docs/en/iam.md and the defaultMode setting description in docs/en/settings.md.

Current Documentation

The current documentation lists the following available permission modes:

Mode	Description
default	Standard behavior - prompts for permission on first use of each tool
acceptEdits	Automatically accepts file edit permissions for the session
plan	Plan Mode - Claude can analyze but not modify files or execute commands
bypassPermissions	Skips all permission prompts (requires safe environment - see warning below)

What's Wrong or Missing?

When running the /config command in the Claude Code CLI, the interface displays a permission mode called "Delegate Mode" (see attached context).

However, the term "Delegate Mode" does not appear anywhere in the official documentation. It is unclear if "Delegate Mode" is simply the UI display name for the acceptEdits setting, or if it is a distinct new mode with different behaviors regarding git operations or other tools. Users seeing this in their terminal have no reference to understand what permissions they are actually granting.

Suggested Improvement

Please update the Permission modes table to include "Delegate Mode."

If "Delegate Mode" is the new UI label for acceptEdits, the documentation should be updated to match the CLI terminology:

Mode	Description
acceptEdits (displayed as Delegate Mode in CLI)	Automatically accepts file edit permissions and safe git operations, but prompts for other tools.

If it is a new mode entirely, please add a row defining its specific capabilities and safety constraints.

Impact

High - Prevents users from using a feature

Additional Context

• In the CLI /config menu, the setting is rendered as: Default permission mode Delegate Mode
• Users migrating from acceptEdits need to know if this is a direct 1:1 mapping or if the scope of "delegated" actions has expanded (e.g., to include commit/push actions).

[gwpl]

Related

• #14297