dialogExpiry

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

Claude Code がリモートクライアント(Remote Control や SDK ホストなど)へ転送するダイアログ、および保留されたクロスセッションメッセージの承認ダイアログに対する期限を設定する。Claude Code v2.1.236 以降では、同じ期限が、端末に誰もいない可能性のあるセッションにおけるセッション中の Fable 使用クレジット同意プロンプトにも適用される。期限までに回答がない場合、Claude Code はダイアログを取り消し、何もしない既定の動作で続行する。Claude Code v2.1.224 以降が必要。

取りうる値

60s
5m既定
10m
never

記述例

{
  "dialogExpiry": "10m"
}

使い方・用途

  • Remote Control や SDK ホストに転送されるダイアログについて、端末に誰もいない場合に無期限に待ち続けないよう期限を設定したい場合に使う。
  • 権限をバイパスして動作しているセッション宛ての cross-session メッセージの承認ダイアログが、既定の 5 分より長くまたは短く開いておく時間を制御したい場合に使う。
  • v2.1.236 以降では、端末に誰もいない可能性があるセッションで表示される Fable 使用クレジットの同意プロンプトが、期限を過ぎたら自動的にキャンセルされるまでの時間を調整したい場合に使う。
英語原文

Set the deadline for dialogs Claude Code forwards to a remote client, such as a Remote Control or SDK host, and for the approval dialog for a held cross-session message. On Claude Code v2.1.236 or later, the same deadline bounds the mid-session Fable usage-credits consent prompt 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件)

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

関連ドキュメント

v2.1.224(1件)

セッションをまたぐ連携設定に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

変更後

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