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.290(1件)

Fixed
Settings
CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS=5m が 5 ミリ秒として読み取られ、リモートのダイアログが即座にキャンセルされる問題を修正した。単位付きの値は dialogExpiry にフォールバックする。
英語原文を表示
Fixed CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS=5m being read as 5 ms and cancelling remote dialogs at once; values with a unit suffix now fall back to dialogExpiry

変更前

CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS=5m のように単位付きの値を設定すると、Claude Code はその値を 5 ミリ秒として読み取っていたため、リモートクライアントへ転送されたダイアログが表示と同時にキャンセルされてしまい、ユーザーは回答する時間がほとんどなかった。

変更後

CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS に 5m のように単位付きの値を設定すると、Claude Code はその値を単位付きのまま読み取れず 5 ミリ秒として解釈していたため、リモート転送されたダイアログが表示直後に期限切れとしてキャンセルされていた。修正後は、単位付きの値は環境変数として無効な形式として扱われ、リモートダイアログの期限は dialogExpiry 設定にフォールバックするようになった。

ユーザーへの恩恵

単位付きの環境変数値を設定しても、リモートダイアログが即座にキャンセルされず dialogExpiry の期限が適用されるため、ダイアログに回答する時間を確保できる。

関連ドキュメント

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

変更後

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

ユーザーへの恩恵

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

関連ドキュメント