[DOCS] Missing `disableDeepLinkRegistration` setting in settings documentation

Resolved 💬 2 comments Opened Mar 25, 2026 by coygeek Closed Mar 28, 2026

Documentation Type

other

Documentation Location

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

Section/Topic

Available settings — the main settings.json options table (lines 149–204 in the mirrored file)

Current Documentation

The "Available settings" table in the settings reference does not include disableDeepLinkRegistration. Searching the entire docs mirror for disableDeepLinkRegistration, deep link, claude-cli://, and protocol handler returns zero results.

What's Wrong or Missing?

The setting disableDeepLinkRegistration was added in Claude Code v2.1.83 to prevent the claude-cli:// protocol handler from being registered on the host system. This is a meaningful operator/enterprise control — administrators who want to restrict OS-level integrations (e.g., preventing Claude Code from registering a custom URL scheme) need to know this setting exists. Its absence from the settings reference leaves users with no documented way to discover or use it.

Suggested Improvement

Add a row for disableDeepLinkRegistration to the "Available settings" table. Suggested entry:

| Key | Description | Example |
| :-- | :---------- | :------ |
| disableDeepLinkRegistration | Prevent Claude Code from registering the claude-cli:// protocol handler on the host operating system. Set to true to disable deep link registration at startup. Useful in managed or locked-down environments where OS-level URL scheme registration is restricted. | true |

The row should be placed near other disable* settings such as disableAutoMode (line 161), disableAllHooks (line 163), and disableBypassPermissionsMode (line 236) for discoverability.

Impact

Medium - Makes feature difficult to understand

Additional Context

Source: Changelog v2.1.83

Exact changelog entry:

Added disableDeepLinkRegistration setting to prevent claude-cli:// protocol handler registration

Affected pages:

| Page | URL | Issue |
| :--- | :-- | :---- |
| Settings | https://code.claude.com/docs/en/settings | disableDeepLinkRegistration setting missing from "Available settings" table |

View original on GitHub ↗

This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗