crossSessionInbound

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

他の Claude Code セッションから届くメッセージを、このセッションがどう扱うかを選ぶ。適用される値がない場合、Claude Code は 2 セッションのパーミッションモードのクラスに基づきメッセージごとに判断する。Claude Code v2.1.224 以降が必要。

既定値未設定であるため、Claude Code がメッセージごとに判断する。

取りうる値

acceptClaude Code はメッセージを Claude に届ける。
holdClaude Code はメッセージを届けずにお知らせを表示する。
refuseClaude Code はメッセージを破棄する。

記述例

{
  "crossSessionInbound": "hold"
}

使い方・用途

  • 他のセッションから届くメッセージを毎回確認してから受け入れるのではなく、accept・hold・refuse のいずれかであらかじめ振る舞いを固定したいときに使う
  • bypassPermissions で動いているセッションに勝手にメッセージが届いて即座に実行されるのを防ぎ、確認を挟みたいときに使う
  • 長時間アイドル状態のセッションが他セッションからのメッセージを受信してコンテキスト全体を送ることでプラン使用量が増えるのを避けたいときに、hold や refuse を設定して使う
英語原文

Choose what this session does with messages arriving from your other Claude Code sessions. 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件)

無効な 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

関連ドキュメント

v2.1.238(1件)

クロスセッションメッセージング：着信メッセージを拒否する設定（例：crossSessionInbound: 'refuse'）の同一マシン上のセッションへの送信が、黙って成功するのではなく送信者に「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件)

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

変更後

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

関連ドキュメント