[DOCS] Permissions docs do not document remote `defaultMode` restrictions (`acceptEdits`/`plan` only)

Documentation Type

Incorrect/outdated documentation

Documentation Location

https://code.claude.com/docs/en/permissions

Section/Topic

Permission mode documentation for remote environments and permissions.defaultMode behavior.

Current Documentation

The permissions page currently lists multiple modes as generally available:

| 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 | | dontAsk | Auto-denies tools unless pre-approved ... | | bypassPermissions | Skips all permission prompts ... |

Settings docs currently describe:

| defaultMode | Default permission mode when opening Claude Code |

What's Wrong or Missing?

Changelog v2.1.70 states that in Claude Code Remote environments, permissions.defaultMode values other than acceptEdits or plan are now ignored.

Current docs do not communicate this remote-specific restriction. That creates configuration mismatch: users can set modes that appear valid in docs but are silently ignored in remote contexts.

Suggested Improvement

Add an explicit remote behavior note in permissions/settings docs:

1. In remote environments, only acceptEdits and plan are applied for defaultMode.
2. Other values are ignored in remote sessions.
3. Cross-link from remote/web session docs so users configuring --remote understand the constraint.

Impact

High - Prevents users from using a feature

Additional Context

Affected Pages:

| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/permissions | 33-41 | Permission mode table presents modes without remote-only defaultMode caveat |
| https://code.claude.com/docs/en/settings | 195-202 | defaultMode setting reference lacks remote restriction note |
| https://code.claude.com/docs/en/claude-code-on-the-web | 90-99 | Remote workflow guidance does not mention defaultMode mode limitations |
| https://platform.claude.com/docs/en/agent-sdk/permissions | 74-83 | Agent SDK cross-reference: permission mode definitions that readers may map to Claude Code remote behavior |

Total scope: 4 pages affected

Source: Release v2.1.70

• Fixed permissions.defaultMode settings values other than acceptEdits or plan being applied in Claude Code Remote environments — they are now ignored