Отправляйте сообщения другим сеансам Claude Code

​

Когда использовать обмен сообщениями между сеансами

• Передача находки: когда один сеанс обнаруживает критическое изменение или принимает решение, Claude суммирует его для сеанса, работающего над затронутой областью, вместо того чтобы вы переобъясняли это там.
• Координация параллельных worktrees: когда сеансы работают с одним репозиторием в отдельных worktrees, Claude может сообщить другим сеансам, что было внедрено.
• Получение статуса от долгоживущей работы: попросите миграцию или тестовый запуск отправить отчет обратно в сеанс, который вы наблюдаете, или попросите его оттуда. Если этот сеанс находится на этом компьютере, Claude также может попросить одно уведомление, когда сеанс следующий раз перейдет в режим ожидания или выйдет.
• Отправка сообщений между машинами: достичь один из ваших сеансов на другой машине или в веб-версии.

​

Отправка сообщения другой сессии

Ask the session running in my other terminal whether the migration finished

Explain what we just did to the session working on the payments API

Let @api-worker know the schema migration finished

• Сессия за пределами этого компьютера: облачная сессия или сессия Remote Control появляется в списке автодополнения только после того, как Claude получил список ваших сессий за пределами этого компьютера или отправил им сообщение, поэтому сначала попросите Claude вывести их список.
• Имя с пробелом или другими символами, кроме букв, цифр, дефисов и подчёркиваний: введите его в двойных кавычках, например @"release notes". Когда вы выбираете сессию из списка автодополнения, Claude Code вставляет кавычки за вас.

​

Доставка сообщений

• Сообщение превышает ограничение размера. Claude Code отклоняет его в отправляющей сессии до отправки.
• Быстрая серия сообщений сессии на этом компьютере достигла предела, который принимает входящий ящик этой сессии. Claude Code отклоняет дальнейшие сообщения этой сессии.
• Сессия за пределами этого компьютера указана в списке как не способная принимать межсессионные сообщения. Claude Code отклоняет сообщение в отправляющей сессии до того, как оно покинет этот компьютер.
• Адресат ответа на этом компьютере не проходит проверку безопасности, например если адресат является символической ссылкой. Эти проверки перечислены в разделе Refusing to send a cross-session message.

• Доставлено: Claude Code передаёт сообщение принимающему Claude.
• Задержано: Claude Code откладывает сообщение, не доставляя его. Задержанное сообщение попадает к Claude, только когда вы его одобрите или когда последующее изменение режима или настроек это разрешит.
• Отклонено: Claude Code отбрасывает сообщение, не доставляя его.

​

Получение уведомления, когда другая сессия переходит в режим простоя

​

Запрос уведомления

Tell me when the migration session finishes what it's working on

​

Что показывает каждая сессия

​

Ограничения

• refuse на любой из сторон: ничего не приходит. Отслеживаемая сессия отбрасывает запрос, не сохраняя его и не отвечая на него, поэтому подписка истекает без ответа через 12 часов, а запрашивающая сессия с refuse вообще не подписывается.
• hold на любой из сторон: уведомление приходит в сокращённом виде. Отслеживаемая сессия не включает однострочный статус, а запрашивающая сессия показывает уведомление в вашем транскрипте, не передавая его Claude.

​

Просмотр сессий, доступных Claude

• Субагенты: агенты, работающие внутри текущей сессии.
• Участники команды: участники собственной команды агентов этой сессии.
• Ваши другие локальные сессии: сессии Claude Code, работающие на том же компьютере, включая фоновые сессии. Сессия появляется, только когда она привязывает сокет входящего ящика.
• Ваши облачные сессии: отображаются, пока эта сессия подключена к Remote Control.
• Ваши сессии Remote Control на других компьютерах: отображаются, пока эта сессия подключена к Remote Control, и помечаются как Remote Control. Для сессии, у которой прервалось подключение Remote Control, Claude Code показывает статус offline.

• Рабочие каталоги: рабочий каталог каждой локальной сессии не отображается.
• Имена сессий: не отображается любое имя сессии, которое нельзя приписать человеку, поэтому строка без имени выглядит как (unnamed session).
• Первая строка: строка с собственным именем этой сессии не отображается, если только вы не ввели это имя в этом терминале — с помощью --name или с помощью /rename с именем — с момента запуска или последнего возобновления сессии.

• На имя откликается одна сессия: Claude Code доставляет сообщение только по имени.
• Несколько сессий имеют одно имя или Claude Code не смог проверить все места, где работают ваши сессии: Claude добавляет короткий идентификатор к каждой строке своего списка и использует этот идентификатор в адресе.

​

Отправка сообщений сессиям на других компьютерах

• offline: подключение Remote Control этой сессии прервалось. Сообщение отправляется, но приходит только после повторного подключения компьютера этой сессии.
• can't receive cross-session messages (off in that session): обмен сообщениями недоступен в этой сессии или её значение crossSessionInbound равно refuse. Claude Code отклоняет сообщение этой сессии до того, как оно покинет этот компьютер. Результат вызова SendMessage у Claude начинается с Not sent и указывает причину. После устранения причины в этой сессии последующий список больше не показывает это состояние, и Claude может отправлять этой сессии сообщения.

​

Ответы с других компьютеров и из облачных сессий

​

Как сеанс обрабатывает входящее сообщение

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

​

Как выглядит сообщение

• Нажмите Ctrl+O для открытия средства просмотра расшифровки и прочитайте полный текст под именем сеанса отправителя.
• В полноэкранном режиме отображения щёлкните строку предпросмотра, в которой опущена часть сообщения, чтобы развернуть её на месте.
• В сеансе, запущенном с --verbose, Claude Code показывает полный текст вместо предпросмотра.

Schema migration finished
The new column is tenant_id, and rebasing on main is safe now.

​

Управление входящими сообщениями

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

• Approve доставляет то одно сообщение Claude.
• Deny, или закрытие диалога, отбрасывает его.
• Когда диалог остается без ответа после крайнего срока dialogExpiry, Claude Code закрывает его и отбрасывает сообщение. Крайний срок по умолчанию составляет пять минут.
• Пока терминал не прикреплен к фоновому сеансу, Claude Code оставляет диалог открытым после крайнего срока. После того как вы прикрепите, если диалог остается без ответа в течение полного периода крайнего срока, Claude Code закрывает его и отбрасывает сообщение.
• Если класс режима разрешений этого сеанса изменяется пока сообщения удерживаются, Claude Code повторно применяет входящие правила, доставляет сообщения, которые они теперь принимают, и показывает уведомление.

​

Неинтерактивные сеансы

• До крайнего срока: если режим или изменение параметров позволяет сообщение, Claude Code доставляет его.
• После крайнего срока: Claude Code отбрасывает сообщение и сообщает об истечении отправителю, которого он может достичь.

​

Входящий сокет сеанса

• /status показывает его в строке Peer address. Путь имеет префикс uds:.
• Claude Code экспортирует его в hooks и команды Bash как переменную окружения CLAUDE_CODE_MESSAGING_SOCKET:
  • В сеансе, который запускается с включенным обменом сообщениями, Claude Code экспортирует переменную перед запуском любого hook, включая SessionStart.

• macOS и Linux, включая WSL 2: строка необязательна. Claude Code принимает соединение с ней или без нее.
• Нативная Windows: строка требуется. Claude Code закрывает любое соединение, чья первая строка не является действительной строкой аутентификации, и ничего не доставляет из этого соединения.

• Сообщения собственного дочернего элемента: когда значение crossSessionInbound не применяется, Claude Code доставляет сообщение, которое оно проверяет, пришло из собственных дочерних процессов сеанса, таких как hook или команда Bash, отправляющая обратно в собственный сокет сеанса.
  • На Linux, включая внутри WSL 2, Claude Code может проверить по доказательству процесса даже для дочернего элемента, который уже вышел. На macOS он может проверить это только пока отправляющий процесс все еще работает, и в контейнере, где Claude Code работает как ID процесса 1, он вообще не имеет доказательства процесса. На нативной Windows он также не имеет.
  • На macOS после выхода отправляющего процесса и в контейнерах, где Claude Code работает как ID процесса 1, это доказательство процесса отсутствует, и Claude Code вместо этого проверяет дочерний элемент, который отправил экспортированный сеансом CLAUDE_CODE_MESSAGING_TOKEN в строке аутентификации, которая открыла его соединение. На нативной Windows этот токен — единственный способ, которым Claude Code проверяет сообщение собственного дочернего элемента.
  • Когда Claude Code не может проверить ни одним способом, он обрабатывает сообщение как любое другое, которое не утверждает класс разрешений, поэтому сеанс, который обходит запросы разрешений, удерживает его для вашего одобрения.
• Изолированные сеансы: управляйте тем, может ли команда Bash достичь сокет изнутри sandbox с параметрами Unix-сокета sandbox, sandbox.network.allowAllUnixSockets и sandbox.network.allowUnixSockets.

​

Ограничение обмена сообщениями между сеансами

​

Требование одобрения для сообщений между машинами

{
  "isolatePeerMachines": true
}

​

Отключение обмена сообщениями между сеансами

• Остановить получение: установите crossSessionInbound на refuse, и Claude Code отбрасывает входящие одноранговые сообщения без доставки. Из параметров проекта или локальных, refuse применяется над каждым другим источником, и из ваших пользовательских параметров применяется, если только управляемые параметры или флаг --settings не устанавливают значение.
• Остановить отправку и перечисление: добавьте правила отказа разрешений, называющие SendMessage и ListAgents. Оба берут имя инструмента без спецификатора.

{
  "permissions": {
    "deny": ["SendMessage", "ListAgents"]
  },
  "crossSessionInbound": "refuse"
}

​

Доступность

• Операционная система: доступно на macOS, Windows и Linux, включая Linux внутри WSL 2.
• Сеансы на этом компьютере: доступно у каждого поставщика, включая Amazon Bedrock, Claude Platform на AWS, Google Cloud’s Agent Platform и Microsoft Foundry, а также в сеансах, которые работают с получением флагов функций отключённым. На этих поставщиках и с отключённым получением флагов обмен сообщениями на одном компьютере требует Claude Code v2.1.248 или более поздней версии. Claude Code доставляет эти сообщения через сокет для каждого сеанса на вашем компьютере, никогда не через серверы Anthropic. Чтобы запретить сеансу получать их, установите crossSessionInbound в значение refuse.
• Сеансы за пределами этого компьютера: Claude находит ваши облачные сеансы и ваши сеансы на других компьютерах из сеанса, который подключен к Remote Control, для чего требуется вход в claude.ai в качестве активной аутентификации этого сеанса и другие требования Remote Control. Claude не может найти эти сеансы с помощью ключа API или на Amazon Bedrock, Claude Platform на AWS, Google Cloud’s Agent Platform и Microsoft Foundry.

• /list-agents не распознан: сеанс не имеет обмена сообщениями между сеансами. Пройдите через требования выше, начиная с claude --version для проверки версии.
• /list-agents работает, но отправка не прошла: обмен сообщениями включён, и применяется что-то более узкое:
  • Правила запрета: правило запрета разрешений удаляет инструменты SendMessage и ListAgents.
  • Управление входящими: элементы управления входящими сообщениями принимающей сессии могут задержать или отбросить то, что вы ей отправляете.
  • Облачная сессия отсутствует: облачная сессия появляется только во время подключения этой сессии к Remote Control.
  • Сессия на другом компьютере отсутствует: сессия на другом из ваших компьютеров появляется только тогда, когда она работает с Remote Control и эта сессия также подключена.
  • Сессия на другом компьютере offline: сообщение сессии, указанной как offline, проходит, но прибывает только после переподключения компьютера этой сессии.
  • Облачная сессия или сессия на другом компьютере can't receive cross-session messages: сообщение сессии, указанной с этим условием, не покидает этот компьютер, а результат под SendMessage начинается с Not sent.
  • Старая облачная сессия или сессия на другом компьютере отсутствует: Claude Code читает эти списки сессий от новых к старым и останавливается после ограниченного количества страниц, поэтому Claude не может отправить сообщение по имени сессии, которая оказалась за их пределами.

​

Ограничения

• Только простой текст: Claude отправляет только простой текст между сеансами. Структурированные сообщения протокола команды агентов остаются внутри команды.
• Размер сообщения на одной машине ограничен: Claude Code отказывает сообщение сеансу на этом компьютере один раз его сериализованная форма проходит около миллиона символов. Отказ называет точные размеры. Ничего не достигает получающего сеанса.
• Быстрые всплески к одному сеансу отказываются на отправителе: один раз быстрый всплеск сообщений к сеансу на этом компьютере достигает того, что принимает входящий этого сеанса, Claude Code отказывает дальнейшие отправки в отправляющем сеансе. Отказ называет всплеск и сообщает Claude объединить остаток в одно сообщение или подождать.
• Циклы сообщений ограничены: в получающем сеансе Claude Code ограничивает повторяющиеся сообщения для каждого отправителя, отбрасывает идентичные повторы, прибывающие в короком окне, и ставит в очередь максимум 50 принятых сообщений для Claude для чтения. Цикл сообщений между двумя сеансами поэтому останавливается самостоятельно.

​

Связанные ресурсы

• Подагенты и команды агентов: обмен сообщениями в одном сеансе или команде
• Фоновые агенты: отправка и мониторинг параллельных сеансов, которые вы можете отправлять сообщениями
• Удаленное управление: подключите этот сеанс для достижения ваших сеансов на других машинах
• Каналы: отправляйте внешние события, такие как результаты CI или сообщения чата, в сеанс
• Параметры: crossSessionInbound, isolatePeerMachines и dialogExpiry
• Режимы разрешений: режимы позади входящего значения по умолчанию двух классов
• Справочник инструментов: строки ListAgents и SendMessage в таблице инструментов
• Запуск агентов параллельно: сравните способы, которыми Claude Code запускает несколько агентов