[DOCS] CLI deep-link docs missing `claude-cli://open?q=` length limit and long-prompt warning

Documentation Type

Missing documentation (feature not documented)

Documentation Location

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

Section/Topic

claude-cli:// deep links, especially the claude-cli://open?q= prompt-prefill format

Current Documentation

The setup page currently says:

This page covers system requirements, platform-specific installation details, updates, and uninstallation. For a guided walkthrough of your first session, see the quickstart. If you've never used a terminal before, see the terminal guide.

No documentation currently exists on that page for claude-cli:// deep links or the open?q= query format.

The closest analogous URI-handler documentation currently appears on the VS Code page:

The extension registers a URI handler at vscode://anthropic.claude-code/open. Use it to open a new Claude Code tab from your own tooling: a shell alias, a browser bookmarklet, or any script that can open a URL. The handler accepts two optional query parameters: | prompt | Text to pre-fill in the prompt box. Must be URL-encoded. The prompt is pre-filled but not submitted automatically. |

That shows the docs already explain pre-filled prompt behavior for the VS Code URI handler, but not for the CLI deep-link equivalent.

What's Wrong or Missing?

Changelog v2.1.85 introduced a user-facing deep-link query update, but the main docs do not explain it.

A. The claude-cli://open?q= deep-link format is undocumented

Users cannot learn from the docs that claude-cli://open?q=<url-encoded-prompt> is a supported way to open Claude Code with a pre-filled prompt.

B. The new 5,000-character limit is undocumented

The docs do not mention that deep-link queries now support up to 5,000 characters, so users have no authoritative reference for how much prompt text this format can carry.

C. The long-prompt review warning is undocumented

The docs do not explain that long pre-filled prompts now show a "scroll to review" warning before submission, which is important user-facing behavior for inspecting lengthy injected prompts.

That leaves the changelog as the only discoverable source for this deep-link capability.

Suggested Improvement

Add a claude-cli:// deep-links subsection to the setup page that documents:

• the claude-cli://open?q=<url-encoded-prompt> format
• that q supports up to 5,000 characters as of v2.1.85
• that long pre-filled prompts show a "scroll to review" warning so users can inspect the full prompt before sending

Include a short example such as claude-cli://open?q=review%20my%20changes.

If the docs team also adds the broader claude-cli:// terminal-selection guidance from earlier changelog entries, this query-parameter behavior should live in the same subsection.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/setup | Closest existing CLI installation/integration page; currently missing claude-cli://open?q= syntax, the 5,000-character limit, and the long-prompt "scroll to review" warning |

Total scope: 1 page affected

Related documentation pattern:

| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/vs-code | Existing URI-handler docs already explain how a pre-filled prompt parameter works for vscode://anthropic.claude-code/open |
| https://code.claude.com/docs/en/ide-integrations | Mirror page with the same VS Code URI-handler guidance |

Source: Changelog v2.1.85

Changelog entry: Deep link queries (claude-cli://open?q=…) now support up to 5,000 characters, with a "scroll to review" warning for long pre-filled prompts