Answer: Claude Code registers the claude-cli:// handler automatically on macOS, Linux, and Windows when you send anything to an interactive claude session or start Claude Code in agent view in a trusted folder; there is no separate install command. To prevent registration entirely, set disableDeepLinkRegistration to "disable" in settings.json (or in managed settings to enforce it across an organization). Status: Confirmed Entry: tool/claude-code/install-and-setup/register-deep-link-handler Revision: 1 Digest: sha256:af1c9d0ee6b4bb89 (changes whenever the content changes) Timeline: Created: 2026-11-13T03:03:57Z Last changed: 2026-11-13T03:03:57Z Last verified: 2026-11-20T12:20:06Z Next check: 2026-11-21T12:20:06Z Check interval: Daily Expected change: No fixed schedule Data: Field | Value | Source | As of Registration trigger 1 | Send anything to an interactive `claude` session | [1] | 2026-11-20 Registration trigger 2 | Start Claude Code in [agent view] | [1] | 2026-11-20 Disable setting | disableDeepLinkRegistration | [1] | 2026-11-20 macOS handler location | ~/Applications/Claude Code URL Handler.app | [1] | 2026-11-20 Linux handler location | claude-code-url-handler.desktop | [1] | 2026-11-20 Windows handler location | HKEY_CURRENT_USER\Software\Classes\claude-cli | [1] | 2026-11-20 Sources: [1] Anthropic. "Launch sessions from links". https://code.claude.com/docs/en/deep-links.md Role: primary. Accessed: 2026-11-20T12:20:06Z Quote: "Send anything to an interactive `claude` session, such as a message or `/help`." (Supports: Registration trigger 1) Quote: "Start Claude Code in [agent view](https://code.claude.com/docs/en/agent-view.md), such as with `claude agents`, in a folder you've [trusted]" (Supports: Registration trigger 2) Quote: "To prevent registration entirely, set [`disableDeepLinkRegistration`](https://code.claude.com/docs/en/settings-reference#disabledeeplinkregistration) to `"disable"` in `settings.json`." (Supports: Disable setting) Quote: "| macOS | `~/Applications/Claude Code URL Handler.app` |" (Supports: macOS handler location) Quote: "| Linux | `claude-code-url-handler.desktop` under `$XDG_DATA_HOME/applications`, defaulting to `~/.local/share/applications` |" (Supports: Linux handler location) Quote: "| Windows | `HKEY_CURRENT_USER\Software\Classes\claude-cli` |" (Supports: Windows handler location) Published: 2026-11-20T10:36:06Z Snapshot SHA-256: 9a2ba767a17696ddcfe7f1cc0b6d3f8da82882922555fd605045b6e18eeb3f8f (captured 2026-11-13T03:03:57Z) Verification: Method: Automated extraction from [1] with deepseek-flash (JSON output, thinking disabled). Every value was checked by code to appear verbatim in a quoted passage of [1]. On this check the text of [1] was unchanged since 2026-11-13T03:03:57Z, so the values verified then were kept. Cross-check: not-available at 2026-11-20T12:20:06Z. No independent second source is configured for this entry Last successful check: 2026-11-20T12:20:06Z Last attempt: 2026-11-20T12:20:06Z Notes and limitations: Extracted automatically from a single official source (section "Registration and supported platforms"). Related: https://latestn.com/tool/claude-code/install-and-setup/set-up-claude-code-google-cloud-anthropic-managed How do I set up Claude Code to use Claude Models on Google Cloud (Anthropic managed)? https://latestn.com/tool/claude-code/install-and-setup/slack-setup How do I set up Claude Code in Slack? https://latestn.com/tool/claude-code/install-and-setup/system-requirements What are the system requirements for installing Claude Code? https://latestn.com/tool/claude-code/install-and-setup/plugin-install-scope How do I choose an install scope when installing a Claude Code plugin? https://latestn.com/tool/claude-code/install-and-setup/prerequisites What do I need before installing Claude Code? https://latestn.com/tool/claude-code/install-and-setup/python-sdk-install How do I install the Claude Code Python Agent SDK in a virtual environment? https://latestn.com/tool/ All entries in AI tools Change log: Time | Event | Change | Source 2026-11-13T03:03:57Z | added | Entry created | — Changes for this entry as a feed: https://latestn.com/tool/claude-code/install-and-setup/register-deep-link-handler/latest Challenge this entry: Open challenges: None How: If a value here is wrong or out of date, send what is wrong and a link to evidence. Challenges are queued and checked against the evidence; they do not change the entry by themselves. If the entry changes as a result, the change log says so. Form: https://latestn.com/dispute/tool/claude-code/install-and-setup/register-deep-link-handler POST: https://latestn.com/dispute/tool/claude-code/install-and-setup/register-deep-link-handler with claim, evidence_url, and optionally field and contact (form-encoded or JSON) GET: https://latestn.com/dispute/tool/claude-code/install-and-setup/register-deep-link-handler?claim={what is wrong}&evidence_url={link} How to cite: LatestN. (2026). How do I register or disable the claude-cli:// handler on my platform so Claude Code deep links work? Revision 1, last verified 2026-11-20T12:20:06Z. https://latestn.com/tool/claude-code/install-and-setup/register-deep-link-handler (accessed 2026-11-21T09:54:33Z). @misc{LatestN_tool_claude_code_install_and_setup_register_deep_link_handler_r1, title = {How do I register or disable the claude-cli:// handler on my platform so Claude Code deep links work?}, author = {{LatestN}}, year = {2026}, howpublished = {\url{https://latestn.com/tool/claude-code/install-and-setup/register-deep-link-handler}}, note = {Revision 1; digest sha256:af1c9d0ee6b4bb89; last verified 2026-11-20T12:20:06Z; accessed 2026-11-21T09:54:33Z} } Reuse: License: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/) Attribution: Copying and adapting are allowed, including commercially, if you credit LatestN and link to the entry you used. Each entry ends with a ready-made citation. URL: https://latestn.com/tool/claude-code/install-and-setup/register-deep-link-handler