[DOCS] Missing documentation for "Delegate Mode" permission mode

Status Fixed / completed
Maintainer reply ✓ Yes — sarahdeaton
Activity 11 comments · opened Dec 17, 2025 · closed Jun 30, 2026
💡 Likely answer: A maintainer (sarahdeaton, collaborator) responded on this thread — see the highlighted reply below.

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/settings and https://code.claude.com/docs/en/iam

Section/Topic

Permission Modes / Default Permission Mode

Current Documentation

The settings and IAM docs describe these permission modes: default, acceptEdits, plan, and bypassPermissions.

The /status → Config menu in Claude Code v2.0.71 shows a fifth option called "Delegate Mode" that is not documented anywhere.

What's Wrong or Missing?

"Delegate Mode" appears as a valid permission mode option in the Claude Code UI
(/status → Config → Default permission mode) and in settings.json
("defaultMode": "delegate"), but no documentation exists explaining:

  • What this mode does
  • How it differs from default, acceptEdits, and plan modes
  • When/why a user would choose it

Suggested Improvement

Add documentation for Delegate Mode to the permission modes section, explaining
its behavior and use cases — similar to how plan mode and acceptEdits are
currently documented.

Impact

High - Prevents users from using a feature

Additional Context

<img width="551" height="351" alt="Image" src="https://github.com/user-attachments/assets/e47c90a2-c72e-4433-84b3-eab0d6cd3240" />

Screenshot attached showing the option in /status Config menu.

View original on GitHub ↗

11 Comments

MariusWilsch · 8 months ago

What the hell does it do? Anthropic keeps shipping stuff without documenting it.

justjxke · 8 months ago

Still have absolutely no clue what this does.

HavenDV · 8 months ago

I did a little research, and it simply limits the toolset to working with tasks (TaskCreate/TaskList/TaskUpdate/TaskGet) and a certain set of agents—so it acts as a team lead.

It makes sense, but I think it's still an experimental feature.

gwpl · 7 months ago

Naming is confusing, "permission=Delegate Mode" to me would suggest that it can ask e.g. via REST/unix socket/ etc some other agent/system/script to assess if command looks like allowed to be executed.

I did a little research, and it simply limits the toolset to working with tasks (TaskCreate/TaskList/TaskUpdate/TaskGet) and a certain set of agents—so it acts as a team lead.

This I would rather name "permission mode=Execute Via Other Agents As planner" or whatever other name.

github-actions[bot] · 6 months ago

This issue has been inactive for 30 days. If the issue is still occurring, please comment to let us know. Otherwise, this issue will be automatically closed in 30 days for housekeeping purposes.

jbray1982 · 6 months ago

I'd still like to know what it is

m2de · 6 months ago

Has delegate mode disappeared? I used to have and use it, but recently it's just not an option anymore. I am using bedrock .

andruhon · 6 months ago

It worked like a charm and it seems to be gone from 2.1.63 (Claude Code)

sarahdeaton collaborator · 2 months ago

Closing this out, but if the docs still don't answer what you were looking for, leave a comment and we'll reopen.