settings.json

disableDeepLinkRegistration

型string記述場所どの設定ファイルでも可

"disable" に設定すると、起動時に Claude Code が claude-cli:// ディープリンクのプロトコルハンドラーを登録しないようにする。

既定値: 未設定の場合、Claude Code はハンドラーを登録する

取りうる値

disable

記述例

{
  "disableDeepLinkRegistration": "disable"
}

使い方・用途

  • Claude Code が OS に claude-cli:// プロトコルハンドラーを登録する動作を無効化する設定
  • デフォルト(未設定)では、インタラクティブセッションで最初のプロンプト送信時にハンドラーが登録される
  • 値は文字列 "disable" のみ。プロトコルハンドラーの登録が制限・管理されている環境で利用する
  • マネージド設定に置けばユーザーは再有効化できず、組織全体で強制できる
  • ブラウザや他アプリからのディープリンク経由の自動連携を制限したい場合にも有用
英語原文(公式ドキュメントより)

Set to "disable" to prevent Claude Code from registering the claude-cli:// deep-link protocol handler on startup. Most useful in managed settings where users cannot override it. See https://code.claude.com/docs/en/settings#available-settings

関連ドキュメント

関連する変更履歴

v2.1.83(1件)

Added
Settings
claude-cli:// プロトコルハンドラの登録を無効化する disableDeepLinkRegistration 設定を追加しました
英語原文を表示
Added disableDeepLinkRegistration setting to prevent claude-cli:// protocol handler registration

変更前

Claude Code デスクトップアプリなどは、デフォルトで OS にディープリンクプロトコルを登録するため、意図しないリンククリックでターミナルが操作される可能性がありました。特定の環境でこの登録を明示的に拒否するオプションがありませんでした。

変更後

disableDeepLinkRegistration 設定を有効にすることで、プロトコルハンドラの登録を防止できるようになりました。ブラウザや他のアプリからの自動的な連携を制限できます。

ユーザーへの恩恵

セキュリティ上の理由や環境の制約により、アプリケーション間のディープリンク連携を制限したいユーザーや管理者が、システムの挙動をより細かく制御できるようになります。

関連ドキュメント