cross-session SendMessage

Claude は ListAgents で宛先のセッションを見つけ、SendMessage で送ります。届くのは Claude が書いたテキストだけで、送信側の会話履歴やファイルは含まれません。宛先は同じマシン上のセッションに限らず、別のマシン上やクラウド上のセッションも指定できます。

セッション間で届くメッセージは、ある Claude が別の Claude に向けて書いたテキストです。送信側の会話履歴やファイルは含まれません。

受信側の動きは次のとおりです。

• 受信側の Claude がターンの実行中であれば、ツール呼び出しの合間にメッセージを読みます。実行中のツールが中断されることはありません。
• 受信側のセッションがアイドルのときは、Claude Code がそのメッセージで新しいターンを始めます。
• 受信側の Claude は、一部の場合を除き、SendMessage で送信側に返信できます。
• 届いたメッセージは会話の中に薄い 1 行のプレビューとして表示され、そのプレビューは後も会話に残ります。

別のセッションから届いたメッセージは、ユーザーの同意として扱われません。保留中の許可確認に、ユーザーの代わりに応答することはできません。中継されたメッセージはユーザー権限を持たず、受信側は中継された許可要求を拒否し、auto mode はそれをブロックします。

メッセージの本文に /compact のようなコマンドが含まれていても、ただのテキストとして届き、Claude Code が実行することはありません。

auto mode では、SendMessage で他のエージェントセッションに送るメッセージが、送信前に許可分類器 (permission classifier) で評価されます。

セッション間メッセージは macOS と Linux で追加され、その後 Windows でも使えるようになりました。Bedrock、Vertex、Foundry 上、およびテレメトリを無効にしている場合は、同じマシン上のセッション間で SendMessage / ListAgents を使えます。アイドル時の通知 (notify_when_idle) は macOS と Linux が対象です。対象プランについては、公式のリリースノートには記載がありません。

受信と送信の扱いは、設定で制御できます。

• crossSessionInbound を accept・hold・refuse のいずれかに設定し、他のセッションから届いたメッセージの扱いを選びます。設定ファイルを編集する代わりに、/config の Messages from your other sessions (他のセッションからのメッセージ) の行で値を選ぶこともでき、選んだ値はユーザー設定に書き込まれます。
• 権限をバイパスして実行中のセッションに届いたセッション間メッセージは承認待ちになり、それ以外のセッションへのメッセージは自動で配信されます。/config には Dialog expiry の行もあります。
• 受信を拒否しているこのマシン上のセッションに送った場合、送信側には「refused」と報告されます。
• isolatePeerMachines を true にすると、このマシンの外にあるセッションへ SendMessage が届く前に、ユーザーの明示的な承認が必要になります。
• 受信を止めるには crossSessionInbound を refuse に設定します。届いたメッセージは配信されずに破棄されます。
• 送信とセッションの一覧表示を止めるには、SendMessage と ListAgents を指定した permission deny rules (許可の拒否ルール) を追加します。どちらも指定子を付けないツール名だけで書きます。

1. /list-agents コマンドを実行し、Claude がメッセージを届けられるセッションを確認します。
2. 相手のセッションに知らせたいこと、またはしてほしいことを Claude に伝えます。
3. 宛先を自分で指定する場合は、プロンプトで @ に続けてセッション名の先頭の文字を入力し、候補の一覧からセッションを選びます。
4. 受信側では、メッセージが会話の中に薄い 1 行のプレビューとして表示されます。全文は Ctrl+O でトランスクリプトビューアーを開き、送信元のセッション名の下で読めます。