SSD Nodes Learn Hosting plans →
Руководства Matt ConnorАвтор: Matt Connor

Обмен сообщениями между сессиями Claude Code

Узнайте, как организовать взаимодействие сессий Claude Code через ListAgents и SendMessage. Разобраны требования к версиям v2.1.224 и выше, а также логика обработки сообщений.

Что означает обмен сообщениями между сессиями Claude Code

Две сессии Claude Code могут обмениваться сообщениями, если они запущены на одном компьютере от имени одного пользователя операционной системы. Сообщение — это один фрагмент обычного текста, который одна сессия Claude отправляет другой. Оно не содержит историю диалога или файлы. Claude находит другую сессию с помощью инструмента ListAgents и передаёт ей текст через SendMessage, поэтому вручную вызывать эти инструменты не нужно. Вы сообщаете, что должна знать другая сессия, а Claude сам формирует сообщение.

Эта функция называется обменом сообщениями между сессиями. По состоянию на November 2026 для неё требуется Claude Code версии v2.1.224 или новее на macOS и Linux, включая Linux внутри WSL 2, а на native Windows — версии v2.1.234 или новее. Обмен сообщениями между сессиями на одном компьютере работает у всех провайдеров, включая Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform и Microsoft Foundry, где требуется версия v2.1.248 или новее. Подключение к сессиям на других компьютерах или в облаке доступно с дополнительными ограничениями: оно выполняется через Remote Control, для которого требуется вход в claude.ai, поэтому не работает с API key и у этих четырёх провайдеров. Если сессия соответствует этим требованиям, обмен сообщениями уже включён, и отдельно включать его не нужно. Описанное ниже поведение основано на документации Anthropic по обмену сообщениями между сессиями.

На VPS эта функция особенно полезна, поскольку именно на VPS сессии работают достаточно долго, чтобы к ним имело смысл обращаться. На ноутбуке вы закрываете крышку. На сервере с tmux сессия, запущенная в понедельник, всё ещё работает в четверг и сохраняет контекст одного репозитория. Когда таких сессий становится две, способ их взаимодействия перестаёт быть теоретическим. Если вы ещё не настроили такую схему, начните с запуска Claude Code на VPS под управлением tmux. В этом материале рассматривается настройка сессий, которую предполагает данное руководство.

Когда вторая сессия оправдывает затраты токенов

Начните с оценки стоимости. Каждая сессия — это отдельный экземпляр Claude с собственным контекстным окном, поэтому две сессии обходятся примерно в два раза дороже, чем одна за тот же период. Отправленное сообщение учитывается в лимитах использования точно так же, как и введенный вами запрос. Координация не бесплатна, и работа, представляющая собой единую последовательность шагов, замедляется и становится дороже при разделении на несколько сессий.

Случаи, когда вторая сессия окупает себя, имеют общую черту. Две части работы выполняются одновременно, не ожидая друг друга, и одна из них получает данные, необходимые другой в процессе выполнения.

  • Одна сессия обнаруживает критическое изменение (breaking change), в то время как другая работает с кодом, который это изменение затронуло. Claude суммирует изменения и передает их, избавляя вас от необходимости перепечатывать их в другом терминале.
  • Две сессии работают с одним репозиторием в разных git worktrees, и одной из них нужно знать, какие изменения были приняты.
  • Длительная миграция или выполнение тестов отправляют результат обратно в сессию, за которой вы наблюдаете.
  • Сессия разработчика и сессия рецензента, где рецензент читает созданный разработчиком код и отправляет обратно свои замечания.

Если работа последовательна или обе сессии должны редактировать одни и те же файлы, используйте одну сессию. Если вам нужна скоординированная группа, которую Claude создает и контролирует в рамках одной задачи, используйте команды агентов (agent teams) — это отдельная и пока экспериментальная функция. Если вам просто нужно продолжить тот же диалог в другом терминале, возобновите сессию. Обмен сообщениями между сессиями предназначен для независимых сессий, которые вы запускаете и направляете самостоятельно.

Проверьте наличие функции перед планированием её использования

Сначала проверьте версию:

claude --version

Сравните полученное число с 2.1.224. Затем в рамках сессии введите /list-agents, которая также откликается на /peers. Команда выводит список всех агентов, доступных для данной сессии, с именами, под которыми они зарегистрированы. Если команда не распознаётся, значит, в этой сессии отсутствует обмен сообщениями между сессиями, и никакое значение crossSessionInbound это не исправит. Введите /status и найдите строку Peer address: в ней указан адрес входящих сообщений текущей сессии с префиксом uds:.

Пользователи VPS на старых сборках часто сталкиваются с одной проблемой. До версии 2.1.248 обмен сообщениями на одной машине зависел от получения флагов функций, а несколько переменных конфиденциальности отключают этот процесс, из-за чего функция остаётся в состоянии «выключено» по умолчанию. Это делают DO_NOT_TRACK, DISABLE_TELEMETRY, CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC и DISABLE_GROWTHBOOK. Пользователи защищают новый сервер, добавляя эти переменные в ~/.bashrc, а затем удивляются, почему /list-agents не существует. Начиная с версии 2.1.248, обмен сообщениями между сессиями на одной машине работает даже при отключённом получении флагов, поэтому обновление — наиболее правильное решение. Переменные по-прежнему важны для сессий за пределами текущей машины: при отключённом получении флагов Claude взаимодействует с ними только при доступности Remote Control, а CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC и DISABLE_GROWTHBOOK делают Remote Control недоступным. Те же значения могут поступать из карты env в файле настроек или из управляемых параметров, поэтому сначала проверьте окружение оболочки.

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

В старых сборках удалите значение той переменной, которая выводится при проверке. Для DISABLE_TELEMETRY и CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC любое непустое значение активирует поведение, включая строку 0, поэтому DISABLE_TELEMETRY=0 работает не так, как кажется. Чтобы отключить функцию, нужно удалить переменную или установить её значение как пустую строку.

Давайте сессиям имена, чтобы различать их

Claude обращается к сессии по имени, но задавать имя необязательно. Если имя не указано, Claude Code назначает его самостоятельно. Claude всё равно может найти эту сессию с помощью ListAgents и отправить ей сообщение через SendMessage. Для интерактивной сессии автоматическое имя состоит из имени рабочего каталога и суффикса из двух символов, например myapp-3f. Для одной сессии этого достаточно, но при наличии четырёх сессий возникают сложности. Кроме того, две сессии могут получить одинаковое имя. Чтобы выбрать имя самостоятельно, задайте его при запуске сессии:

claude --name builder-api

Имя также можно задать с помощью /rename внутри работающей сессии. Если сессия не подключена к Remote Control, вывод /list-agents показывает рабочий каталог каждой локальной сессии. По нему можно различить сессии с одинаковыми именами. В собственном списке Claude при совпадении имён к адресу добавляется короткий идентификатор. Пока сессия подключена к Remote Control, /list-agents не показывает рабочие каталоги и имена сессий, которые нельзя связать с конкретным пользователем. Поэтому такая строка выглядит как (unnamed session). При поиске целевой сессии Claude видит её без изменений. Задать имена самостоятельно проще, чем сопоставлять идентификаторы. Выбранное вами имя также делает автодополнение @ полезным: начиная с v2.1.232, введите @builder в запросе и выберите сессию. Claude точно поймёт, какую сессию вы имеете в виду.

Двухсессионная раскладка tmux для воспроизведения

Это сессия разработчика и сессия рецензента для одного репозитория. Рецензент работает в отдельном git worktree, поэтому они никогда не записывают изменения в один и тот же файл. git worktree add вместе с HEAD создают отсоединенный (detached) checkout, что необходимо для сессии, которая предназначена для чтения, а не для фиксации изменений. Поскольку эти две сессии выполняют разные задачи, рецензенту стоит задать собственный стиль вывода, который изменит системный промпт этой сессии и будет сохраняться на протяжении всей работы, в отличие от разовой инструкции.

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 выводит список окон по именам, чтобы вы могли выбрать нужное. В окне разработчика выполните /list-agents. Вы должны увидеть reviewer-api с рабочим каталогом ~/src/api-review. Если его нет, значит, сессия рецензента еще не завершила запуск или возникла одна из двух проблем, описанных в следующем разделе. После этого передайте задачу простыми словами:

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

Claude пишет резюме и отправляет его. Вы не пишете текст сообщения, и то, что отправляет Claude, может варьироваться. В окне рецензента сообщение отображается как тусклый однострочный превью с именем отправителя и первой строкой текста, например › Message from @builder-api: …. Если сессия простаивает, Claude сразу начинает новый цикл работы. Если сессия занята, сообщение ожидает завершения текущего вызова инструментов, поэтому выполнение команды не прерывается. Ctrl+O открывает просмотрщик транскриптов с полным текстом, и Claude считывает всё сообщение вне зависимости от того, развернули вы его или нет. Эта пара работает эффективнее, когда разработчик вносит небольшие изменения: узкий diff позволяет сделать передачу задачи более лаконичной, а рецензию — завершаемой за один цикл, что соответствует привычке, которую закрепляет навык ленивого старшего разработчика.

Кто кого видит на одном VPS

Доставка сообщений в пределах одной машины никогда не проходит через серверы Anthropic. Каждая сессия привязывает собственный сокет входящих сообщений — Unix domain socket с путем в файловой системе этой машины, и сессия появляется в списке других ваших сессий только после такой привязки. Из этого следуют два вывода, оба из которых важны при работе на сервере.

Доступ к сокету ограничен вашим пользователем операционной системы. Сессия, запущенная вами от имени root, и сессия, запущенная от имени deploy, не видят друг друга, даже если они находятся рядом в одном и том же сервере tmux, так как сессии одного пользователя не могут получить доступ к сокету другого. Запускайте обе сессии от имени одного и того же пользователя.

Контейнер имеет собственную файловую систему. Сессия внутри Docker и сессия на хосте не могут взаимодействовать друг с другом. Две сессии внутри одного и того же контейнера могут обмениваться сообщениями в обычном режиме. Если вы используете контейнеры для изоляции агентов, как описано в запуске агентов для программирования во временной ВМ, учитывайте, что обмен сообщениями работает внутри контейнера, но не через его границы.

Ваши сессии на других машинах, а также облачные сессии, отображаются в списке только тогда, когда текущая сессия подключена к Remote Control, при этом сессии на других машинах помечаются как Remote Control. Начиная с версии v2.1.225, Claude может начать диалог с сессией на другой вашей машине, а не только отвечать на сообщения. Эти сообщения проходят через серверы Anthropic, так же как и сообщения для облачной сессии. Облачная сессия не может ответить с помощью SendMessage, даже если сообщение содержит адрес для ответа: сообщение всё равно будет доставлено, и вы прочитаете ответ облачной сессии в её транскрипте на claude.ai/code. Если данная сессия не подключена к Remote Control в момент, когда Claude отправляет сообщение за пределы машины, сообщение всё равно будет отправлено, но без адреса для ответа, поэтому другая сторона не сможет на него ответить.

Почему ваше сообщение не было доставлено

Обычно причина не связана с сетью. Принимающая сессия сама решает, что делать с сообщением, и в данном случае решение было не доставлять его. Каждое входящее сообщение имеет один из трех исходов: доставлено, удержано (отложено без доставки до вашего подтверждения) или отклонено (удалено без доставки).

Если не применяется значение crossSessionInbound, Claude Code принимает решение по каждому сообщению, сравнивая режимы разрешений двух сессий. Он объединяет сессии, которые обходят запросы разрешений, в один класс, а все остальные сессии — в другой. auto, acceptEdits и dontAsk считаются режимами с запросами. Режим Plan считается обходом в интерактивной сессии терминала, если для нее доступны разрешения на обход. Если вы не уверены, к какому классу относится сессия, стоит сначала прочитать что именно делает каждый режим разрешений, так как большинство сессий сейчас запускаются в режиме auto, который относится к стороне с запросами. Правило симметрично:

  • Принимающая сессия, которая запрашивает разрешения, доставляет каждое сообщение. Она удерживает сообщение только в том случае, если отправляющая сессия идентифицирует себя как сессия с обходом запросов.
  • Принимающая сессия, которая обходит запросы, удерживает каждое сообщение до вашего одобрения. Она доставляет сообщение только в том случае, если отправитель также работает в режиме обхода.

Поэтому первый рабочий процесс, который создают многие пользователи, — именно тот, который не работает. Вы запускаете сборщик с --permission-mode bypassPermissions, потому что хотите, чтобы он работал без присмотра, оставляете настройки рецензента по умолчанию, и каждое сообщение, отправленное сборщиком, ожидает в диалоговом окне подтверждения, которое никто не видит. Это окно закрывается по истечении срока dialogExpiry, который по умолчанию равен 5m, и сообщение удаляется. Прежде чем винить сокет, проверьте экран принимающей сессии на наличие ожидающего диалога подтверждения.

Чтобы сессия принимала сообщения без участия пользователя, установите crossSessionInbound в значение accept. Место установки определяет, будет ли настройка применена. Claude Code сначала считывает управляемые настройки, затем флаг --settings, затем пользовательские настройки и применяет первое найденное значение. Значение в настройках проекта или локальных настройках применяется только в том случае, если оно более строгое, согласно иерархии accept < hold < refuse. Значение accept в .claude/settings.json является менее строгим, чем любое другое, поэтому оно игнорируется, если значение было задано доверенным источником. Укажите его в ~/.claude/settings.json или передайте для одной сессии. Начиная с версии v2.1.232, строка /config Messages from your other sessions записывает ту же пользовательскую настройку за вас.

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

Автономный рабочий процесс claude -p привязывает сокет входящих сообщений так же, как интерактивная сессия, и отображается в списке, но он не может показать диалоговое окно подтверждения. Claude Code удерживает там сообщение до истечения того же срока dialogExpiry (по умолчанию пять минут), доставляет его, если режим или настройки позволяют это сделать в течение данного интервала, в противном случае удаляет его и сообщает отправителю, с которым есть связь, что срок действия истек. Строка --settings выше показывает, как разрешить такому рабочему процессу принимать сообщения. Сессия, запущенная в режиме bare, вообще не привязывает сокет, поэтому она не может ни принимать сообщения, ни отображаться в списке.

Когда передача зависает

Циклы сообщений обрабатываются автоматически. Claude Code ограничивает частоту повторяющихся сообщений от одного отправителя, отбрасывает идентичные повторы, поступившие в течение короткого интервала, и ограничивает число принятых сообщений, ожидающих чтения, до 50 на сеанс. Поэтому цикл между двумя сеансами останавливается сам. Число удерживаемых сообщений ограничено 100; после этого новые сообщения вытесняют самые старые. Начиная с v2.1.238, если входящие сообщения сеанса отбрасываются из-за ограничения частоты или переполнения очереди, этот сеанс уведомляет ваш сеанс.

На практике возникает другая, менее заметная ошибка. Это не цикл, а передача задачи. Сеанс A задаёт сеансу B вопрос, ответ на который нужен для продолжения работы, а затем переходит в состояние ожидания. Сеанс B удерживает сообщение, занят длительной задачей или отвечает на вопрос, который сеанс A на самом деле не задавал. Сеанс A ждёт. Через час вы возвращаетесь и видите два бездействующих сеанса, а работа не выполнена.

Формулируйте передачи так, чтобы ответ не требовался. Хорошее сообщение содержит факт или решение: что изменилось и каким был результат. Плохое сообщение просит другой сеанс разрешить действие или дать ответ, без которого отправитель не может продолжить работу. Claude уже настроен не запрашивать у другого сеанса действие, которое было бы заблокировано его собственными настройками разрешений, и возвращать такую задачу вам. Применяйте это правило шире. Если сеанс не может продолжить работу без ответа, ответить должны вы. Если одному сеансу нужно только узнать о завершении длительной задачи другим сеансом, запросите уведомление, а не ответ: начиная с v2.1.236 в обоих сеансах Claude может попросить один из ваших сеансов на этом компьютере отправить однократное уведомление при следующем переходе в состояние ожидания или завершении работы. Claude Code отменяет такой запрос через 12 часов, если уведомление не поступило. Здесь также помогает контроль контекста: сеанс, который потерял ход работы, пишет расплывчатые сообщения; в разделе управление контекстом в Claude Code описана эта сторона проблемы.

Входящее сообщение нужно считать недоверенным вводом

Claude Code сообщает принимающему сеансу, что сообщение пришло из другого сеанса, а не от вас, и ограничивает действия, которые это сообщение может выполнять. Это ограничение реализовано в программе, которая оборачивает модель, а не зависит от готовности модели подчиниться. В этом состоит практическое отличие, которое даёт обвязка агента. Сообщение не может ответить вместо вас на ожидающий запрос разрешения, поскольку согласие другого сеанса не является вашим согласием. Оно не может изменить настройки разрешений, CLAUDE.md или другую конфигурацию по запросу другого сеанса. Косая команда внутри текста, например /compact, поступает как обычный текст и никогда не выполняется. Если для обработки сообщения требуется разрешение, которого нет у принимающего сеанса, вы увидите тот же запрос, что и при любой другой операции. Когда отправляющий сеанс работает в автоматическом режиме, его классификатор также проверяет каждое сообщение перед передачей в Claude Code. Заблокированное сообщение не достигает получателя. Эти ограничения действуют и в разрешительных режимах. Поэтому сеанс, выполняющий обход ограничений, по умолчанию удерживает входящие сообщения, а не доверяет им.

Это касается разрешений, но не содержимого. Отправляющий сеанс мог прочитать описание pull request, веб-страницу, README зависимости или комментарий к issue, написанный посторонним человеком. Всё прочитанное может повлиять на текст, который он отправит в другой сеанс. Сообщение является данными. К нему нужно относиться с таким же подозрением, как к любому другому тексту, поступившему в сеанс извне. Именно такую дисциплину описывает принцип не хранить секреты в AI-агентах: считайте недостоверным всё, что пересекло границу доверия, и никогда не позволяйте содержимому самостоятельно выдавать себе разрешение.

Если вы хотите уменьшить этот риск, доступны два средства управления. Установка crossSessionInbound в значение refuse отбрасывает входящие сообщения от равноправных сеансов, не доставляя их. В настройках проекта или локальных настройках это значение имеет приоритет над любым другим источником, поскольку является самым строгим в этой иерархии. Чтобы запретить этому сеансу отправлять сообщения или выводить списки, добавьте правила запрета разрешений для SendMessage и ListAgents. Оба значения указываются как имена инструментов без спецификатора. Установка isolatePeerMachines в значение true требует вашего явного подтверждения перед доставкой любого сообщения сеансу за пределами этого компьютера. Это подтверждение требуется даже в режиме bypassPermissions.

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

Запрет SendMessage также отключает отправку сообщений субагентам, поскольку для обоих действий используется один и тот же инструмент. В сеансе, который отказывается от операции, не отображается никаких изменений в его собственном /status или в списках других сеансов на том же компьютере. Поэтому проверяйте настройку в конфигурации сеанса, а не по содержимому экрана.

Мосты и MCP-серверы с общей памятью

В тот же период появилось несколько сторонних проектов, решающих смежные задачи: локальные мосты «агент-агент», передающие текст между запущенными агентами, и MCP-серверы (model context protocol), предоставляющие нескольким агентам единое хранилище для чтения и записи. Рассматривайте их как альтернативный подход, а не как конкурентов, и всегда проверяйте любую команду установки по файлу README конкретного проекта перед запуском. Обмен сообщениями здесь работает по принципу push, так как отправитель помещает текст в очередь получателя. Общее хранилище работает по принципу pull: никто не прерывает работу, а сессия видит заметку при следующем обращении. Модель pull лучше подходит для статусов, которые меняются медленно, и работает только тогда, когда сессия действительно запрашивает данные.

Если вы выбрали этот путь, стоит задавать вопросы о процессах, а не о списке функций. От имени какого пользователя работает сервер и к каким файлам на машине он имеет доступ? В статье Запуск MCP-серверов на VPS описана эта настройка. В статье Обмен навыками агентов между репозиториями рассматривается более простой случай, когда между сессиями нужно передавать инструкции, а не текущее состояние; это позволяет избавиться от множества лишних сообщений. Для общего понимания ситуации начните с запуск агента для программирования на VPS.

FAQ

Почему команда /list-agents не распознается в моей сессии?

В сессии отсутствует обмен сообщениями между сессиями. Сначала проверьте claude --version: для работы функции требуется версия 2.1.224 или новее на macOS и Linux, 2.1.234 или новее на нативной Windows, а также 2.1.248 или новее на Amazon Bedrock, Claude Platform в AWS, Google Cloud's Agent Platform и Microsoft Foundry. В сборках старше 2.1.248 также проверьте оболочку на наличие DO_NOT_TRACK, DISABLE_TELEMETRY, CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC или DISABLE_GROWTHBOOK, так как каждый из этих параметров отключает получение флагов функций, необходимых для обмена сообщениями в старых версиях. Обновление до версии 2.1.248 или новее устраняет эту зависимость для сессий на одном и том же компьютере.

Почему мое сообщение для другой сессии не дошло?

Если /list-agents работает, значит, обмен сообщениями включен, и доставку блокирует более узкая причина. Чаще всего это права доступа. Сессия, которая обходит запросы разрешений, удерживает каждое входящее сообщение до вашего подтверждения, если отправитель также не использует обход. Диалоговое окно подтверждения закрывается по истечении времени dialogExpiry (по умолчанию — пять минут). Проверьте принимающую сессию на наличие ожидающего диалога подтверждения. Чтобы исправить это, установите crossSessionInbound в значение accept в файле ~/.claude/settings.json или передайте его через --settings, так как значение accept в настройках проекта или локальных настройках игнорируется как менее строгое.

Может ли сессия Claude Code в Docker отправлять сообщения сессии на хосте?

Нет. Входящие сообщения каждой сессии привязаны к сокету в файловой системе компьютера, а у контейнера своя файловая система. Поэтому сессия внутри контейнера и сессия на хосте не могут взаимодействовать друг с другом. Две сессии внутри одного контейнера могут обмениваться сообщениями в обычном режиме. Аналогичное правило объясняет, почему сессия, запущенная от имени root, и сессия, запущенная от вашего обычного пользователя, не могут связаться: сокет ограничен пользователем операционной системы, который им владеет.

Безопасно ли выполнять действия по сообщению из другой сессии Claude Code?

Относитесь к тексту как к недоверенным входным данным, так как отправляющая сессия могла прочитать веб-страницу, README или комментарий к задаче, написанный кем-то другим. Claude Code уже ограничивает автоматическое выполнение сообщений: он не может подтвердить ожидающий запрос разрешения, изменить настройки разрешений или CLAUDE.md по запросу, а слэш-команды в тексте приходят как обычный текст и не выполняются. Эти меры защиты касаются прав доступа, а не оценки содержимого, поэтому читайте полученное сообщение, прежде чем давать принимающей сессии команду на выполнение действий.

Отправляет ли обмен сообщениями между сессиями мой код в Anthropic?

Между двумя сессиями на одном компьютере — нет. Сообщение передается через локальный сокет сессии и не проходит через серверы Anthropic. Передается только текст, написанный Claude, а не история переписки или файлы. Сообщения для сессии на другом вашем компьютере или для облачной сессии проходят через серверы Anthropic. Начиная с версии 2.1.225, Claude может начать диалог с сессией на другом вашем компьютере, а не только отвечать на него. Облачная сессия получает сообщение, но не может ответить на него с помощью SendMessage, поэтому вы читаете ответ в транскрипте на claude.ai/code. Установите isolatePeerMachines в значение true, чтобы требовать вашего подтверждения перед отправкой любых данных за пределы компьютера.

Была ли эта статья полезной?