SSD Nodes Learn Hosting plans →
ガイド Matt Connor著者 Matt Connor

Claude Codeでセッション間通信を使う方法

同じVPS上のClaude Codeセッション間で文章を送受信する方法を解説します。ListAgentsとSendMessageの使い方、2つ目のセッションが役立つ場面、メッセージが保留される理由、v2.1.224以降の要件を確認できます。

Claude Code セッション同士がメッセージを送る仕組み

同じマシン上で同じオペレーティングシステムユーザーとして実行されている場合、2 つの Claude Code セッションは相互にメッセージを送れます。メッセージは、一方の Claude がもう一方の Claude に送るプレーンテキストです。会話履歴やファイルは含まれません。Claude は ListAgents ツールで相手のセッションを見つけ、SendMessage でテキストを送信するため、これらのツールを手動で呼び出すことはありません。相手のセッションに知らせる内容を伝えると、Claude がメッセージ自体を作成します。

この機能は cross-session messaging と呼ばれます。2026 年 11 月時点では、macOS と Linux(WSL 2 内の Linux を含む)で Claude Code v2.1.224 以降、ネイティブ Windows で v2.1.234 以降が必要です。同じマシン上のセッション間のメッセージングは、Amazon Bedrock、AWS 上の Claude Platform、Google Cloud の Agent Platform、Microsoft Foundry を含むすべてのプロバイダーで動作します。これら 4 つのプロバイダーでは v2.1.248 以降が必要です。他のマシンやクラウド上のセッションに接続する機能には、より厳しい制限があります。Remote Control 経由で接続するため、claude.ai へのサインインが必要です。そのため、API key や上記 4 つのプロバイダーでは動作しません。セッションが要件を満たしていれば、メッセージングはすでに有効で、追加の設定は必要ありません。以下の動作は、cross-session messaging に関する Anthropic のドキュメントに基づいています。

VPS でこの機能が重要になるのは、VPS ではセッションを十分な時間維持でき、連絡する価値があるためです。ノートパソコンでは蓋を閉じます。tmux 配下のサーバーでは、月曜日に開始したセッションが木曜日になっても実行され続け、1 つのリポジトリのコンテキストを保持しています。そのようなセッションが 2 つになると、セッション間の通信方法は理論上の話ではなくなります。まだ構成していない場合は、まず tmux 配下の VPS で Claude Code を実行する から始めてください。このガイドが前提とするセッションの構成を説明しています。

2 つ目のセッションにトークンを使う価値がある場合

まずコストを考えます。各セッションは、それぞれ独自のコンテキストウィンドウを持つ別個の Claude インスタンスです。そのため、同じ期間では 2 つのセッションにかかるコストは、1 つの場合のおよそ 2 倍になります。送信されたメッセージは、自分で入力したプロンプトと同じように使用量へ加算されます。調整にもコストがかかります。実際には 1 つの手順として進める作業をセッション間に分けると、処理は遅くなり、費用も増えます。

2 つ目のセッションを使う価値があるケースには、共通する形があります。2 つの作業が互いを待たずに同時実行され、一方が作業の途中で、もう一方が必要とする情報を得る場合です。

  • 一方のセッションが breaking change を見つけ、もう一方がその変更で壊れたコードを基に作業している場合。Claude は変更内容を要約して送信できるため、別の端末で自分が入力し直す必要がありません。
  • 2 つのセッションが、別々の git worktree で同じリポジトリを操作し、一方がどの変更を取り込んだかを知る必要がある場合。
  • 長時間の migration やテスト実行が、結果を監視中のセッションへ返す場合。
  • builder セッションと reviewer セッションを使う場合。reviewer は builder が生成した内容を読み、確認結果を返します。

作業が順番に進む場合や、両方のセッションが同じファイルを編集する場合は、1 つのセッションを使います。Claude が単一のタスク内で起動して監督する、連携したグループが必要な場合は agent teams を使います。これは別の、まだ experimental な機能です。同じ会話を別の端末で続けたいだけなら、セッションを resume します。Cross-session messaging は、自分で開始して指示する独立したセッション間で使用します。

機能を前提にする前に、利用できることを確認する

まずバージョンを確認します。

claude --version

この番号を 2.1.224 と比較します。次に、セッション内で /list-agents と入力します。これは /peers と入力しても実行できます。このコマンドは、このセッションから到達できるすべてのエージェントと、それぞれが応答する名前を表示します。コマンド自体が認識されない場合、このセッションではセッション間メッセージングを利用できません。crossSessionInbound の値を変更しても利用可能にはなりません。/status と入力し、Peer address 行を探します。この行には、このセッション自身の受信トレイアドレスが uds: を先頭に付けて表示されます。

古いビルドの VPS ユーザーには注意点があります。v2.1.248 より前は、同一マシン内のメッセージングが機能フラグの取得に依存していました。また、複数のプライバシー変数によってこの取得が無効になり、機能がデフォルトの無効状態のままになっていました。DO_NOT_TRACK、DISABLE_TELEMETRY、CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC、DISABLE_GROWTHBOOK はすべてこの動作を引き起こします。新しいサーバーを強化するために、これらを ~/.bashrc に貼り付けた結果、/list-agents が存在しない理由が分からなくなることがあります。v2.1.248 以降は、機能フラグの取得が無効でも、同一マシン上のセッション間メッセージングが動作します。そのため、更新するのがより確実な解決策です。これらの変数は、このマシンの外部にあるセッションには引き続き影響します。取得が無効な場合、Claude がそのようなセッションに到達できるのは Remote Control が利用可能な場合だけです。CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC と DISABLE_GROWTHBOOK は Remote Control を利用できなくします。同じ値は、設定ファイル内の env マップや管理対象設定から指定されることもあります。そのため、まず shell を確認してください。

env | grep -E 'DO_NOT_TRACK|DISABLE_TELEMETRY|DISABLE_GROWTHBOOK|NONESSENTIAL'

古いビルドでは、出力された変数のうち該当するものを unset します。DISABLE_TELEMETRY と CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC では、空でない値を指定すると動作が有効になります。0 という文字列も同様です。そのため、DISABLE_TELEMETRY=0 は見た目どおりの動作をしません。無効にするには、変数を unset するか、空の文字列を設定します。

セッションに名前を付けて区別できるようにする

Claude は名前でセッションにメッセージを送りますが、名前の設定は必須ではありません。名前を設定しない場合、Claude Code がセッション名を自動的に付けます。その場合も、Claude は ListAgents でそのセッションを検索し、SendMessage でメッセージを送信できます。対話型セッションでは、作業ディレクトリ名と myapp-3f のような 2 文字の接尾辞を組み合わせて自動的に名前が付けられます。セッションが 1 つなら問題ありませんが、4 つあると区別しにくくなります。また、2 つのセッションに同じ名前が付くこともあります。名前を自分で指定するには、セッションの開始時に設定します。

claude --name builder-api

実行中のセッション内では、/rename でも設定できます。セッションが Remote Control に接続されていない場合、/list-agents の出力には各ローカルセッションの作業ディレクトリが表示されます。これにより、同じ名前のセッションを区別できます。また、名前が重複すると、Claude 自身の一覧ではアドレスに短い識別子が追加されます。セッションが Remote Control に接続されている間は、/list-agents から作業ディレクトリと、ユーザーに対応付けられないセッション名が省略されます。そのため、その行は (unnamed session) と表示されます。Claude が対象を検索するときに認識する内容は変わりません。識別子を確認するより、セッションに自分で名前を付けるほうが簡単です。自分で付けた名前を使うと、@ の先行入力も便利になります。v2.1.232 以降では、プロンプトに @builder と入力してセッションを選択すると、Claude に対象のセッションを正確に指定できます。

再現可能な2セッション tmux レイアウト

これは、1 つのリポジトリで builder セッションと reviewer セッションを動かす構成です。reviewer は別の git worktree で作業するため、2 つのセッションが同じファイルを書き換えることはありません。git worktree add と HEAD を使うと detached checkout になるため、コミットせずに読み取りを行うセッションに適しています。2 つのセッションは役割が異なるため、reviewer には 専用の出力スタイルを設定する価値があります。これにより、そのセッションの system prompt が変更されます。1 回だけ入力した指示のように時間とともに効力が薄れるのではなく、すべてのターンに適用されます。

cd ~/src/api
git worktree add ../api-review HEAD
tmux new-session -d -s agents -n builder -c ~/src/api
tmux new-window -t agents -n reviewer -c ~/src/api-review
tmux send-keys -t agents:builder 'claude --name builder-api' C-m
tmux send-keys -t agents:reviewer 'claude --name reviewer-api' C-m
tmux attach -t agents

Ctrl+b に続けて w を実行すると、ウィンドウが名前付きで一覧表示されるため、目的のウィンドウを選択できます。builder ウィンドウで /list-agents を実行します。作業ディレクトリが ~/src/api-review の reviewer-api が表示されるはずです。表示されない場合は、reviewer セッションの起動が完了していないか、次のセクションで説明する 2 つの問題のいずれかに該当します。その後、平易な言葉で内容を引き継ぎます。

Tell reviewer-api which files I changed for the rate limiter and what to look at first.

Claude が概要を作成して送信します。メッセージ本文を自分で書く必要はなく、Claude が送信する内容は状況によって変わります。reviewer ウィンドウでは、送信者名と本文の先頭行を含む、薄い色の 1 行プレビューとしてメッセージが表示されます。たとえば › Message from @builder-api: … のようになります。そのセッションがアイドル状態なら、Claude はすぐに新しいターンを開始します。ターンの途中であれば、メッセージは tool call の間まで保留されるため、実行中のコマンドが中断されることはありません。Ctrl+O で transcript viewer が開き、全文を確認できます。Claude は展開したかどうかに関係なく、メッセージ全体を読み取ります。builder が変更を小さく保つと、この 2 つのセッションはより効率的に連携できます。差分が小さければ引き継ぎ内容も短くなり、もう一方のセッションが 1 ターンでレビューを完了しやすくなるためです。これは lazy senior dev skill が徹底させる習慣です。

1台のVPSにおけるセッション間の可視性

同一マシン内での配信は、Anthropicのサーバーを経由しません。各セッションは独自のインボックスソケット(そのマシンのファイルシステム上のパスを持つUnixドメインソケット)をバインドします。セッションがソケットをバインドしたときのみ、他のセッションのリストに表示されます。サーバー運用において、以下の2点に注意が必要です。

ソケットは、OSのユーザーごとに制限されます。rootとして開始したセッションと、deployとして開始したセッションは、たとえ同じ tmux サーバー内で並んでいても互いを認識できません。これは、あるユーザーのセッションが別のユーザーのソケットにアクセスできないためです。両方のセッションを同じユーザーで実行してください。

コンテナは独自のファイルシステムを持ちます。Docker内のセッションとホスト上のセッションは、互いにアクセスできません。同じコンテナ内の2つのセッションであれば、通常通りメッセージをやり取りできます。使い捨てVMでのコーディングエージェント実行のように、分離のためにエージェントをコンテナ内で管理する場合、メッセージングはコンテナ内でのみ機能し、コンテナの境界を越えることはできません。

他のマシン上のセッションやクラウドセッションは、現在のセッションが Remote Control に接続されている間のみリストに表示されます。他のマシン上のセッションには Remote Control というラベルが付きます。v2.1.225 以降、Claude は他のマシン上のセッションに対して返信するだけでなく、会話を開始できるようになりました。これらのメッセージは Anthropic のサーバーを経由します。クラウドセッションへのメッセージも同様です。クラウドセッションは SendMessage で応答することはできません。メッセージに返信先アドレスが含まれている場合でも、メッセージは届きますが、クラウドセッションからの応答は claude.ai/code のトランスクリプトで確認することになります。Claude がマシン外へメッセージを送信する際、現在のセッションが Remote Control に接続されていない場合でもメッセージは送信されますが、返信先アドレスがないため、相手側は応答できません。

メッセージが届かない理由

通常、原因はネットワークではありません。受信側のセッションがメッセージの処理方法を決定し、配信しないと判断しています。到着したメッセージの結果は、配信、保留(承認するまで未配信のまま保持)、拒否(配信せず破棄)のいずれかです。

crossSessionInbound の値が適用されない場合、Claude Code は 2 つのセッションの権限モードを比較して、メッセージごとに判断します。権限プロンプトを省略するセッションを 1 つのクラスにまとめ、それ以外のセッションをもう 1 つのクラスにまとめます。auto、acceptEdits、dontAsk はプロンプトを表示するモードです。Plan mode は、バイパス権限を利用できる対話型ターミナルセッションでは、プロンプトを省略するモードとして扱われます。セッションがどちらのクラスに属するか分からない場合は、まず 各権限モードの実際の動作 を確認してください。現在、多くのセッションは auto で開始され、これはプロンプトを表示する側に分類されるためです。ルールは次のように対称です。

  • 受信側セッションが権限プロンプトを表示する場合、すべてのメッセージが配信されます。ただし、送信側セッションがプロンプトを省略するセッションであると示した場合は、メッセージを保留します。
  • 受信側セッションがプロンプトを省略する場合、すべてのメッセージが承認待ちになります。送信側もプロンプトを省略する場合に限り、メッセージを配信します。

そのため、多くの人が最初に構築するワークフローは、まさに動作しない構成です。非対話で実行したいため、--permission-mode bypassPermissions を指定して builder を起動し、reviewer はデフォルトのままにすると、builder が送信するすべてのメッセージが、誰も確認していない承認ダイアログで待機します。このダイアログは dialogExpiry の期限が経過すると閉じます。期限のデフォルト値は 5m で、その後メッセージは破棄されます。socket を疑う前に、受信側セッションの画面に保留中の承認ダイアログがないか確認してください。

セッションが非対話でメッセージを受け取れるようにするには、crossSessionInbound に accept を設定します。設定場所によって適用範囲が決まります。Claude Code は、管理対象設定、--settings フラグ、ユーザー設定の順に読み込み、最初に見つかった値を適用します。プロジェクト設定またはローカル設定の値が適用されるのは、accept < hold < refuse の順序で、より厳しい値の場合だけです。.claude/settings.json に設定した accept は最も緩い値であるため、信頼された設定元に値が設定されている場合は無視されます。~/.claude/settings.json に設定するか、1 回のセッションに対して指定してください。v2.1.232 以降では、Messages from your other sessions の /config 行を使って、同じユーザー設定を自動的に書き込めます。

claude --name runner --settings '{"crossSessionInbound":"accept"}'

ヘッドレスの claude -p worker は、対話型セッションと同様に inbox socket を bind し、一覧にも表示されます。ただし、承認ダイアログを表示できません。Claude Code は、同じ dialogExpiry の期限(デフォルトでは 5 分)が経過するまでメッセージを保留します。その間にモードまたは設定の変更によって配信可能になれば配信し、そうでなければ破棄して、到達可能な送信側に期限切れとして通知します。上記の --settings 行を使うと、このような worker がメッセージを受け取れるようになります。bare mode で起動したセッションは socket をまったく bind しないため、メッセージを受信できず、一覧にも表示されません。

引き継ぎがデッドロックする場合

メッセージループは自動的に処理されます。Claude Code は送信元ごとの反復メッセージをレート制限し、短い時間内に到着した同一メッセージの繰り返しを破棄します。また、読み取り待ちとして受け付けるメッセージをセッションごとに50件までに制限するため、2つのセッション間のループは自然に停止します。保留中のメッセージは100件までで、それを超えると古いものから破棄されます。v2.1.238以降、セッションの受信箱がレート制限またはキュー満杯のためにあなたのメッセージを破棄すると、そのことがあなたのセッションに通知されます。

実際に起きる障害は、より静かで、ループではなく引き継ぎです。セッションAが、続行する前に回答が必要な質問をセッションBに送り、その後アイドル状態になります。Bがメッセージを保留している場合もあれば、長時間かかる処理の途中の場合もあります。あるいは、BがAの意図とは異なる質問に回答することもあります。Aは待ち続けます。1時間後に戻ると、アイドル状態のセッションが2つあり、作業は何も進んでいません。

返信を必要としない引き継ぎを書いてください。よいメッセージには、事実または判断が含まれます。何が変わり、結果がどうなったかを伝えます。悪いメッセージは、別のセッションに許可を求めたり、送信元がその回答を待たないと進めない質問をしたりします。Claude には、Claude 自身の権限設定で禁止される操作を別のセッションに依頼せず、その作業をあなたに戻すよう、すでに指示されています。このルールを自分の運用にも適用してください。セッションが回答なしでは進めない場合、その回答を行うのはあなたです。あるセッションが、別のセッションの長時間の作業が終わった時点だけ知る必要がある場合は、返信ではなく通知を依頼してください。両方のセッションがv2.1.236以降であれば、Claude はこのマシン上のあなたのセッションの1つに対し、次にアイドル状態になるか終了したときに1回だけ通知を返すよう依頼できます。何も届かない場合、Claude Code は12時間後にその依頼を破棄します。ここでもコンテキストの規律が役立ちます。話の流れを失ったセッションは、曖昧なメッセージを書きがちです。この点については、Claude Code でコンテキストを管理するで説明しています。

受信メッセージを信頼できない入力として扱う

Claude Code は、メッセージがあなたではなく別のセッションから届いたことを受信側のClaudeに伝え、そのメッセージで実行できる操作を制限します。この強制は、モデルが従う意思ではなく、モデルをラップするプログラムによって行われます。これが、エージェントハーネスがもたらす実務上の違いです。別のセッションからの同意はあなたの同意ではないため、メッセージで保留中の権限プロンプトにあなたの代わりに回答することはできません。別のセッションに依頼されたという理由で、権限設定、CLAUDE.md、その他の設定を変更することもできません。/compactのようなスラッシュコマンドが本文に含まれていても、プレーンテキストとして届き、実行されることはありません。メッセージへの対応に、受信側セッションにない権限が必要な場合は、他の作業と同じプロンプトが表示されます。送信側セッションが自動モードで動作している場合、Claude Code は各メッセージを配信する前に分類器でも確認します。分類器がブロックしたメッセージは、受信側に届きません。これらの制限は許可範囲の広いモードでも維持されます。そのため、バイパスモードで動作しているセッションは、受信メッセージをデフォルトで保留し、信頼して処理することはありません。

これは権限に関する制限です。内容までは対象になりません。送信側セッションが、プルリクエストの説明、Webページ、依存関係のREADME、または見知らぬ人が書いたissueコメントを読んでいる可能性があります。そして、読んだ内容があなたの別のセッションに送る文章へ影響することがあります。メッセージはデータです。セッションの外部から入った他のテキストと同じように、疑って扱う必要があります。これはAIエージェントにSecretを渡さないで説明している規律です。信頼境界を越えたものは誤っている可能性があると考え、それ自体に権限を与えないでください。

このようなメッセージを減らすには、2つの制御方法があります。crossSessionInboundをrefuseに設定すると、受信したピアメッセージを配信せずに破棄します。プロジェクト設定またはローカル設定でこの値を指定すると、他のすべてのソースより優先されます。優先順位の段階で最も厳しい設定だからです。このセッションからの送信または一覧表示を停止するには、SendMessageとListAgentsを指定する権限拒否ルールを追加します。どちらも指定子なしのツール名だけで記述します。isolatePeerMachinesをtrueに設定すると、このマシンの外部にあるセッションへメッセージが届く前に、明示的な承認が必要になります。この承認はbypassPermissionsモードでも必要です。

{
  "crossSessionInbound": "refuse",
  "isolatePeerMachines": true
}

SendMessageを拒否すると、同じツールが両方に使われているため、サブエージェントへのメッセージ送信も無効になります。拒否しているセッションでは、自身の/statusにも、同じマシン上にある他のセッションの一覧にも、見た目上の変化は表示されません。そのため、画面ではなく、セッションの設定からこの設定を確認してください。

ブリッジと共有メモリ MCP サーバー

同じ時期に、関連する別の形態を持つサードパーティープロジェクトもいくつか登場しました。実行中のエージェント間でテキストを中継するローカルのエージェント間ブリッジや、複数のエージェントが読み書きできる共有ストアを提供する MCP(model context protocol)サーバーです。これらは競合製品ではなく、異なる構成として評価してください。実行前に、インストールコマンドがプロジェクト独自の README に記載された内容と一致することを確認してください。メッセージングは push です。送信側が受信側のターンにテキストを書き込むためです。共有ストアは pull です。どのセッションも中断されず、次に確認した時点でノートを読み取るためです。変化が遅い状態の共有には pull のほうが適しており、セッションが実際に確認した場合にだけ機能します。

この方式を選ぶ場合、確認すべき点は機能一覧ではなくプロセスです。サーバーはどのユーザーとして実行され、サーバー上のどのデータを読み取れるのでしょうか。VPS 上で MCP サーバーを実行する では、その構成を説明しています。リポジトリ間でエージェントのスキルを共有する では、セッション間で共有したいものがライブ状態ではなく手順である、より単純なケースを説明しています。この方法を使うと、通常なら送信する多くのメッセージを減らせます。全体像を確認するには、VPS 上でコーディングエージェントを実行する から始めてください。

FAQ

なぜセッションで /list-agents が認識されないのですか?

セッション間メッセージング機能が有効になっていない可能性があります。まず claude --version を確認してください。この機能には、macOS および Linux では 2.1.224 以降、Windows ネイティブ環境では 2.1.234 以降、Amazon Bedrock、Claude Platform on AWS、Google Cloud's Agent Platform、Microsoft Foundry では 2.1.248 以降のバージョンが必要です。2.1.248 より前のビルドを使用している場合、シェルで DO_NOT_TRACK、DISABLE_TELEMETRY、CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC、または DISABLE_GROWTHBOOK が設定されていないか確認してください。これらは古いビルドで必要だった機能フラグの取得を無効化します。2.1.248 以降にアップデートすると、同一マシン上のセッション間でのこの依存関係は解消されます。

なぜ他のセッションへのメッセージが届かないのですか?

/list-agents が正常に動作している場合、メッセージング機能は有効であり、より限定的な要因がメッセージを阻害しています。一般的な原因は権限モードです。権限プロンプトをバイパスするセッションは、送信側もバイパス設定をしていない限り、すべての着信メッセージを承認待ちとして保留します。この承認ダイアログは dialogExpiry の期限(デフォルトで 5 分)を過ぎると破棄されます。受信側のセッションで承認待ちのダイアログが出ていないか確認してください。これを解決するには、~/.claude/settings.json 内で crossSessionInbound を accept に設定するか、--settings を付与して実行してください。プロジェクト設定やローカル設定での accept は、より緩い値として無視されるためです。

Docker 内の Claude Code セッションからホスト側のセッションへメッセージを送れますか?

いいえ。各セッションのインボックスはマシン上のファイルシステムにあるソケットであり、コンテナは独自のファイルシステムを持つため、コンテナ内のセッションとホスト側のセッションは相互に通信できません。同一コンテナ内の 2 つのセッションであれば、通常通りメッセージをやり取りできます。同様の理由で、root として実行されているセッションと、通常のユーザー権限で実行されているセッションも通信できません。ソケットは、それを所有するオペレーティングシステムのユーザーに制限されているためです。

他の Claude Code セッションからのメッセージは実行しても安全ですか?

送信側のセッションが第三者の作成した Web ページ、README、Issue コメントなどを読み込んでいる可能性があるため、メッセージの内容は信頼できない入力として扱ってください。Claude Code は、メッセージが自動的に実行されることを既に制限しています。保留中の権限プロンプトを自動承認することや、要求に応じて権限設定や CLAUDE.md を変更することはできません。また、テキスト内のスラッシュコマンドはプレーンテキストとして扱われ、自動実行されることはありません。これらの保護機能は権限を対象としており、判断を代行するものではないため、受信側のセッションに実行を指示する前に、届いた内容を必ず確認してください。

セッション間メッセージングでコードが Anthropic に送信されますか?

同一マシン上の 2 つのセッション間では、送信されません。メッセージはそのマシンのセッションごとのソケットを経由し、Anthropic のサーバーを通過することはありません。送信されるのは Claude が作成したテキストのみであり、会話履歴やファイルが送信されることはありません。別のマシン上のセッションやクラウドセッションへのメッセージは、Anthropic のサーバーを経由します。v2.1.225 以降、Claude は別のマシン上のセッションに対して返信するだけでなく、会話を開始できるようになりました。クラウドセッションはメッセージを受信しますが、SendMessage で返信することはできないため、その応答は claude.ai/code のトランスクリプトで確認してください。マシン外への送信前に承認を求めるには、isolatePeerMachines を true に設定してください。

この記事は役に立ちましたか?