[DOCS] Channels docs missing permission relay capability for forwarding tool approval prompts

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/channels-reference

Section/Topic

"Server capabilities" section in channels-reference, and the "Unattended use" note in channels docs

Current Documentation

The channels-reference capabilities table (lines 183-186) lists only two channel-relevant capability keys:

• capabilities.experimental['claude/channel'] — registers the notification listener
• capabilities.tools — enables tool discovery for two-way channels

The channels user guide states:

"If Claude hits a permission prompt while you're away from the terminal, the session pauses until you approve locally. For unattended use, --dangerously-skip-permissions bypasses prompts, but only use it in environments you trust."

No permission relay capability is documented.

What's Wrong or Missing?

Changelog v2.1.81 added --channels permission relay. Channel servers that declare the permission capability can forward tool approval prompts to the user's phone, providing a safe alternative to --dangerously-skip-permissions for unattended sessions.

The documentation is missing:

A. Permission capability key

No documentation of the capability key a channel server must declare to opt into permission relay (e.g., capabilities.experimental['claude/permission'] or equivalent).

B. How permission relay works

No explanation that approval prompts can be forwarded through the channel to the user's remote device instead of pausing for local approval.

C. Updated unattended use guidance

The current text presents --dangerously-skip-permissions as the only option for unattended sessions. Permission relay is a safer alternative that should be mentioned.

Suggested Improvement

A. Add permission capability to channels-reference

Add a new row to the capabilities table documenting the permission relay capability key and its behavior.

B. Update the unattended use note in channels.md

Replace or expand the current note (line 213) to mention permission relay:

"If Claude hits a permission prompt while you're away from the terminal, you have two options: (1) use a channel server that declares the permission capability to forward approval prompts to your phone, or (2) use --dangerously-skip-permissions to bypass prompts entirely (only in environments you trust)."

C. Add setup instructions

Add a subsection explaining how to configure a Telegram or Discord channel to handle permission forwarding.

Impact

High - Prevents users from using a feature

Additional Context

Affected Pages:

| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/channels-reference | Server capabilities table missing permission capability |
| https://code.claude.com/docs/en/channels | "Unattended use" note only mentions --dangerously-skip-permissions |
| https://code.claude.com/docs/en/cli-reference | --channels flag description doesn't mention permission relay |

Total scope: 3 pages affected

Source: Changelog v2.1.81 — "Added --channels permission relay — channel servers that declare the permission capability can forward tool approval prompts to your phone"