settings.json

dialogExpiry

型string既定値5m記述場所ユーザー設定または管理者設定

Claude Code がリモートクライアントへ転送するダイアログ、保留中のクロスセッションメッセージの承認ダイアログ、および端末に誰もいない可能性があるセッションでのセッション中盤の Fable 使用クレジット同意プロンプトに対する期限を設定する。

取りうる値

60s
5m既定
10m
never

記述例

{
  "dialogExpiry": "10m"
}

使い方・用途

  • リモートクライアント(Remote Control や SDK ホスト)へ転送されるダイアログ、保留されたクロスセッションメッセージの承認ダイアログ、Fable 使用クレジットの同意プロンプトに回答がない場合の期限を設定する
  • デフォルトは "5m"。期限までに回答がないとダイアログはキャンセルされ、デフォルトの「何もしない」動作で続行する
  • 60s / 5m / 10m / never から選択可能
  • 端末から離れがちな Remote Control・バックグラウンドセッションで、セッションを止めずに操作するための設定
  • クロスセッションメッセージの承認ダイアログはデフォルト5分で期限切れとなり、メッセージは破棄される。バックグラウンドセッションで端末が未アタッチの場合、期限を過ぎてもダイアログは開いたままになる
  • Claude Code v2.1.224 以降が必要
英語原文(公式ドキュメントより)

Set the deadline for dialogs Claude Code [forwards to a remote client](/docs/en/remote-control#limitations), such as a Remote Control or SDK host, for the approval dialog for a [held cross-session message](/docs/en/cross-session-messaging#control-inbound-messages), and for the mid-session [Fable usage-credits consent prompt](/docs/en/model-config#fable-and-usage-credits) in a session that may have nobody at the terminal. When no answer arrives before the deadline, Claude Code cancels the dialog and continues with its no-action default. Requires Claude Code v2.1.224 or later.

関連ドキュメント

関連する変更履歴

v2.1.224(1件)

Added
PermissionsSettings
セッションをまたぐ連携設定にcrossSessionInboundとdialogExpiryを追加：パーミッションの自動承認をバイパスして実行中のセッションに対して、他のセッションから送られたメッセージを一時保留してユーザーの承認を求めるようになり、それ以外の通常セッションへのメッセージは自動配信されるようになります。
英語原文を表示
Added crossSessionInbound and dialogExpiry settings: cross-session messages sent to a session running with bypassed permissions are held for your approval, and messages to other sessions auto-deliver

変更前

他のセッションからSendMessageで送られてくるメッセージを受信する際、受信側セッションの安全状態やパーミッションの設定状態（バイパスモードなど）を考慮して受信を保留にするきめ細やかな制御が行えませんでした。

変更後

セキュリティをバイパスしている特別なセッションへのインバウンドメッセージは自動的には処理されず、ユーザーの明示的な承認が得られるまで保留される仕組みが導入されます。また、通常のパーミッションチェックが有効なセッションへのメッセージはそのまま自動配信されます。

ユーザーへの恩恵

セキュリティバイパス中の重要なセッションに対して、他のエージェントから意図しないメッセージが自動で流し込まれて実行されるのを防ぐことができます。

関連ドキュメント