[DOCS] Missing `disableDeepLinkRegistration` setting in settings documentation
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:
AddeddisableDeepLinkRegistrationsetting to preventclaude-cli://protocol handler registration
Affected pages:
| Page | URL | Issue |
| :--- | :-- | :---- |
| Settings | https://code.claude.com/docs/en/settings | disableDeepLinkRegistration setting missing from "Available settings" table |
This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗