settings.json

crossSessionInbound

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

自分の他の Claude Code セッションから届いたメッセージをこのセッションがどう扱うかを選択する。適用する値がない場合は、2つのセッションの権限モードクラスからメッセージごとに判断する。

既定値: 未設定の場合、Claude Code がメッセージごとに判断する

取りうる値

acceptClaude Code がメッセージを Claude に配信する
holdClaude Code がメッセージを配信せず通知を表示する
refuseClaude Code がメッセージを破棄する

記述例

{
  "crossSessionInbound": "hold"
}

使い方・用途

  • 他のセッションから SendMessage で届くメッセージの受信挙動を制御する設定
  • 未設定の場合、送信元・受信元セッションの権限モードに基づいてメッセージごとに判断される(バイパス権限のセッション同士が1クラス、それ以外がもう1クラス)
  • refuse に設定すると受信メッセージが破棄され、クロスセッションメッセージの受信を完全に止められる
  • hold に設定すると受信メッセージが保留され、長時間セッションでの意図しないコンテキスト消費(使用量増加)を防げる
  • バイパス権限モードで動作中のセッションへのメッセージは、ユーザー承認ダイアログ(approve/deny)で確認を求められる
  • 不正な値(例: "reject")は警告が出され、ユーザー設定ではメッセージが保持され、管理設定では拒否される
  • Claude Code v2.1.224 以降が必要
英語原文(公式ドキュメントより)

Choose what this session does with [messages arriving from your other Claude Code sessions](/docs/en/cross-session-messaging#control-inbound-messages). When no value applies, Claude Code decides per message from the two sessions' permission-mode classes. Requires Claude Code v2.1.224 or later.

関連ドキュメント

関連する変更履歴

v2.1.248(1件)

Fixed
IDE
無効な crossSessionInbound 値が黙って無視されていた問題を修正しました：ユーザー設定では警告を出してクロスセッションメッセージを保持し、管理設定では拒否するようになり、修正されるまで処理が保留されます。
英語原文を表示
Fixed an invalid crossSessionInbound value being silently ignored: it now warns and holds cross-session messages (user settings) or refuses them (managed settings) until fixed

変更前

無効な crossSessionInbound 値が黙って無視されていました。

変更後

無効な crossSessionInbound 値が検出されると警告が出され、ユーザー設定ではメッセージを保持し、管理設定では拒否するようになりました。

ユーザーへの恩恵

無効な設定値が検出され、適切な処理が行われるようになり、セキュリティと信頼性が向上します。

関連ドキュメント

v2.1.238(1件)

Changed
Permissions
受信拒否設定されているセッションへのクロスセッションメッセージ送信時に、成功と偽らず「refused」と正しく報告するようにしました。
英語原文を表示
Cross-session messaging: sending to a session on this machine that refuses inbound messages (e.g. crossSessionInbound: "refuse") now reports "refused" to the sender instead of a silent success

変更前

受信拒否されていても、送信側は「成功」と誤認してしまう場合がありました。

変更後

受信側の拒否状況を送信側に正確に通知します。

ユーザーへの恩恵

メッセージがなぜ届かなかったのかを確認する手間が省けます。

関連ドキュメント

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

変更後

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

ユーザーへの恩恵

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

関連ドキュメント