[DOCS] Claude CLI deep link docs omit multiline `q` prompt encoding

Documentation Type

Missing documentation (feature not documented)

Documentation Location

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

Section/Topic

disableDeepLinkRegistration setting row / claude-cli://open?q=... deep links

Current Documentation

The docs currently say:

Set to "disable" to prevent Claude Code from registering the claude-cli:// protocol handler with the operating system on startup. Deep links let external tools open a Claude Code session with a pre-filled prompt via claude-cli://open?q=.... Useful in environments where protocol handler registration is restricted or managed separately

This is the only current code.claude.com page that documents claude-cli://open?q=....

What's Wrong or Missing?

The page confirms that claude-cli://open?q=... exists, but it does not document how the q value should be percent-encoded or that %0A can be used for multi-line prompts.

Changelog v2.1.91 added support for multi-line prompts in claude-cli://open?q= deep links, but there is still no user-facing documentation for:

• newline handling in the q parameter
• a concrete multi-line example
• the expected deep-link format for tool integrations that pre-fill prompts

Without that guidance, users building bookmarklets, shell helpers, launchers, or other integrations have to guess whether only single-line prompts are supported.

Suggested Improvement

Add a short deep-link usage section in the Claude Code docs and link to it from the disableDeepLinkRegistration row.

That section should document:

• the format claude-cli://open?q=<percent-encoded prompt>
• that %0A inserts a newline in the pre-filled prompt (supported as of v2.1.91)
• a concrete example such as claude-cli://open?q=Review%20this%20diff%0AFocus%20on%20security%20issues
• whether the prompt is pre-filled only or automatically submitted

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/settings | 181 | Only current mention of claude-cli://open?q=...; no query encoding or multiline example |

Total scope: 1 page affected

Cross-reference:

| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/vs-code | 249-259 | Comparable URI-handler docs explain that the prompt query parameter must be URL-encoded and show an example |

Source: Changelog v2.1.91

Changelog entry: Added support for multi-line prompts in claude-cli://open?q= deep links (encoded newlines %0A no longer rejected)