Начнем с того, что цель текущего исследования - разобрать работу Agent Teams и межагентного общения в Claude Code изнутри, а также понять что объединяет агентов с отдельными контекстами и прямым обменом сообщениями. Разобрать координацию очередей, файловые почтовые ящики и служебные протоколы
Статья разбирает жизненный цикл агентов: от запуска и выбора модели до доставки сообщений, восстановления истории и завершения работы.
Реверс и изучение механизмов проводилось на версии Claude Code 2.1.311 от 6 ноября 2026 года. Помимо внутреннего устройства, рассмотрены границы гарантий и практический сценарий совместного анализа проекта.
Коротко о главном
Субагенты подходят для ограниченных задач, Agent Teams же - для совместной работы агентов и обменом промежуточных результатов как полноценная автономная команда (Наверное уже все слышали о методике работы Grok Bot).
В исследованной сборке у
SendMessageвосемь ветвей доставки. Работающему агенту сообщение добавляется в очередь; завершившегося система может возобновить. Остановка пользователем обрабатывается отдельно.Команда использует несколько независимых видов состояния. Список участников, входящие сообщения, задачи и история диалога не заменяют друг друга.
Сохранение файлов не гарантирует восстановления команды после
/resume. Продолжение отдельного агента внутри действующей сессии - другой механизм.Сообщение агента не заменяет разрешение пользователя. Подтверждение отправки также не означает, что поручение выполнено.
1. Метод исследования и границы выводов
Сведения о внутреннем устройстве относятся к конкретной сборке, а пользовательские инструкции - к официальной документации. Это различие важно: документация обновляется независимо от бинарника и уже содержит примечания к более поздним версиям.
Исследовательская часть основана на статическом разборе исполняемого файла Claude Code. Статический разбор позволяет восстановить ветвления и структуры данных, но сам по себе не доказывает поведение всех сочетаний настроек при запуске.
| Параметр исследования | Значение |
|---|---|
| Версия | Claude Code 2.1.311 |
| Объект | Mach-O, самостоятельный исполняемый файл Bun; заявленный размер - 276 МБ |
| Извлечённый граф | 2866 JavaScript-модулей, около 58 МБ текста |
| Первый проход | Распаковка встроенного графа bunfs, поиск строковых констант, чтение минифицированных модулей |
| Второй проход | Повторная сверка запуска, сообщений и командного протокола по единому текстовому корпусу и бинарнику |
| Дополнительное сопоставление | Реализация формата в Bun, включая StandaloneModuleGraph.rs; открытые материалы Claude Code о модификациях |
Минификация сокращает имена функций. Поэтому обозначения вроде tr, bx, g6t ниже - идентификаторы исследованной сборки, а не публичный API.
Для указания мест в коде используются три вида координат: corpus@N - байтовое смещение в извлечённом текстовом корпусе; binary@N - смещение в исполняемом файле; chunk-*.js:строка - положение в отдельно распакованном модуле. Они действительны только для соответствующих артефактов. Способ сопоставления приведён в конце статьи.
Сведения о реализации далее атрибутируются исследованию; независимый повторный анализ бинарника и запуск всей системы для этой публикации не выполнялись. Пользовательские настройки и ограничения сверены с официальной документацией Agent Teams, прочитанной 7 ноября 2026 года.
2. Что запускает инструмент Agent
Субагент и участник команды
Для поручения с одним итоговым отчётом обычно достаточно субагента. Команда полезна, когда исполнителям нужно обсуждать промежуточные результаты и согласовывать работу.
| Свойство | Обычные субагенты | Agent Teams |
|---|---|---|
| Основной сценарий | Выполнить ограниченное поручение и вернуть результат вызывающему | Работать над общей задачей, обсуждая промежуточные результаты |
| Контекст | Собственное окно контекста | Собственное окно контекста каждого участника; история ведущего не переносится |
| Координация | Работой управляет вызывающий агент | Сообщения между участниками; общий список задач, если доступны Task-инструменты |
| Общение | Помимо возврата результата, именованные субагенты могут обмениваться сообщениями | Участники адресуют сообщения друг другу по именам |
| Выполнение в исследованной реализации | Локальный субагент - вложенный цикл запросов | Внутри основного процесса или отдельными процессами в панелях терминала |
| Расход ресурсов | Запросы и контекст субагента | Запросы и контексты участников, сообщения и координация |
Пользовательское различие описано в сравнении команд и субагентов. Устройство процессов восстановлено по коду сборки 2.1.311.
Согласно исследованию, инструмент Agent - в этой сборке также с псевдонимом Task - передаёт запуск исполнителю: Agent → runEngine(tr) → bx. Функция bx обслуживает и главного агента, но дочерний вызов получает собственные agentId, agentContext и abortController.
В реестре задач обычный локальный агент представлен записью local_agent. Участник команды внутри процесса использует тип in_process_teammate; облачный запуск - remote_agent. Это разные виды выполнения, хотя внешне все они могут выглядеть как делегирование задачи.
Схема показывает варианты выполнения, а не обязательную смешанную конфигурацию. Разделение контекстов само по себе не гарантирует изоляцию файлов и прав доступа. Выполнение в том же процессе также не устраняет расходы на запросы к модели и обработку контекста.
Параметры и проверки запуска
В исследованной схеме входа основные параметры сгруппированы так:
| Поле | Назначение и условия |
|---|---|
prompt | Обязательное поручение агенту |
description | Краткое описание для интерфейса и списка задач |
subagent_type | Встроенное или пользовательское определение; general-purpose используется по умолчанию, только если доступен в данной сессии |
name | Имя для адресации; при включённых командах может переводить запуск в создание участника |
model, effort | Выбор модели и уровня рассуждения с учётом настроек и внутренних условий |
run_in_background | Фоновый запуск либо ожидание результата инструмента |
isolation | Выбор отдельного способа выполнения, в том числе рабочей копии git; облачный путь обрабатывается отдельно |
cwd | Рабочий каталог; исследованная ветка отклоняет недопустимый переход в другой каталог |
name нельзя считать безусловным признаком команды. Текущая документация уточняет: именованный запуск становится участником при включённой возможности Agent Teams, кроме оговорённых случаев fork и явно заданной isolation. В неинтерактивном режиме участники не создаются.
До начала работы исполнитель проверяет вход, каталог, глубину вложенности и состояние вызывающего агента. Затем применяются ограничения команд и fork, разрешения на тип агента и обработчик agent.spawn. Обработчик может отклонить запуск или переписать поручение и параметры; изменённый вход снова проверяется системой разрешений. После выбора определения проверяются денежный бюджет и доступность параллельного запуска, формируются инструкции и регистрируется задача.
Порядок важен: найденный в коде предел ещё не означает, что любой запрос до него дойдёт. Запуск может быть запрещён раньше из-за прав, состояния родителя или типа агента.
Контекст хранит родительский идентификатор, глубину, тип и признаки фонового выполнения. Запись задачи дополняет их моделью, состоянием running, completed, failed или killed, причиной остановки, результатом и путём к истории. Сообщения субагента отмечаются isSidechain: true; отдельная история сохраняется в subagents/agent-<agentId>.jsonl, метаданные - в соседнем agent-<agentId>.meta.json.
Ключевые координаты: запуск - corpus@18181700–18186500, цикл - corpus@18204300, контекст - corpus@18203800.
Типы агентов и выбор модели
Реестр встроенных типов зависит от режима сессии. Ниже - обнаруженные определения, а не обещание доступности каждого типа в любой установке.
| Тип | Назначение | Особенности исследованного определения |
|---|---|---|
general-purpose | Универсальные поручения | Широкий набор инструментов; разрешения проверяются отдельно |
Explore, Plan | Исследование и планирование | Инструменты записи исключены; Plan должен указать ключевые файлы реализации |
web-fetch | Загрузка страниц | Локальное выполнение, до 15 ходов |
fork | Продолжение с наследованием контекста родителя | До 200 ходов; не выбирается как обычный тип по умолчанию |
worker | Исполнитель режима координатора | До 500 ходов |
workflow-subagent | Выполнение внутри Workflow | Запрещены инструменты Write и Workflow |
comment-thread-analyst | Анализ ветки комментариев | Один инструмент, до 6 ходов |
statusline-setup, claude-code-guide | Настройка строки состояния и справка по Claude Code | Специализированные служебные определения |
teammate | Участник без собственного типа | Минимальное встроенное определение для командного запуска |
Пользовательские определения загружаются из .claude/agents/ проекта, пользовательского каталога и других поддерживаемых источников. Заголовок файла задаёт имя, описание, инструменты, модель, effort, права, maxTurns, память и способ изоляции; тело становится инструкцией агента. Исследованный парсер ограничивает размер файла одним МиБ.
Поддерживаемые поля нельзя механически переносить между источниками определения. В исследованной плагинной ветке, например, игнорируются permissionMode, hooks и mcpServers, тогда как для определений проекта предусмотрен иной уровень управления. Текущая документация также отдельно описывает, какие поля применяются к участникам команды и как это зависит от способа запуска.
Обычный порядок выбора модели: явный параметр запуска → модель определения → CLAUDE_CODE_SUBAGENT_MODEL → модель родителя. CLAUDE_CODE_SUBAGENT_MODEL_FORCE исключает первые два источника; обработчик agent.spawn также может изменить выбор. Уровень effort ограничивается допустимыми значениями, а относительные варианты lower и higher в исследованной ветке зависят от внутреннего флага. Это не основание использовать внутренние варианты как стабильный интерфейс.
3. Как SendMessage выбирает маршрут
Инструмент SendMessage передаёт сообщение диспетчеру, который определяет маршрут по адресу и состоянию получателя. Обычный текст ответа модели не является самостоятельной отправкой другому агенту; автоматический возврат результата - отдельный механизм.
| Ветка | Получатель | Действие системы |
|---|---|---|
main | Главный диалог | Постановка в очередь основной сессии |
agent-live | Работающий субагент | Добавление в pendingMessages; обработка на следующем раунде инструментов |
agent-stopped | Завершившийся субагент | Продолжение сохранённой истории; сообщение становится следующим запросом |
agent-stopped-by-user | Агент, остановленный пользователем | Отказ в автоматическом возобновлении; работу следует считать отменённой |
agent-evicted | Агент, чья запись выгружена из памяти | Поиск уже работающего экземпляра либо восстановление участника или субагента по сохранённым данным |
local-session | Другая локальная сессия | Доставка через сокет домена Unix в исследованной реализации |
cloud-session | Облачная сессия | HTTP-мост; в исследованной сборке облачная сессия ещё не может отправить ответ другой сессии |
mailbox | Участник команды | Запись в его файловый почтовый ящик |
Ветви диспетчера находятся в corpus@32559350–32572300. Это не восемь независимых сетевых протоколов: часть маршрутов обслуживает очереди в памяти.
Адресация и смена владельца имени
Получателя можно указать по имени, идентификатору или уточнённой форме name [ref]. После первой отправки имя закрепляется за конкретным идентификатором. Если позднее оно указывает на другого агента, система отклоняет отправку с сообщением «Nothing was sent» и предлагает уточнить адрес.
Имена main, team-lead, user, system и имена, похожие на идентификаторы агентов, зарезервированы. Повторное имя работающего агента получает суффикс. При восстановлении реестра из истории есть ограничение: для имени, выданного до последнего сокращения контекста, может понадобиться идентификатор.
Для работающего субагента доставка не прерывает текущее действие. Если он завершится раньше обработки сообщения, предусмотрено возобновление с этим сообщением. Повторная отправка до уведомления о результате может создать лишнюю работу.
TaskStop относится к управлению выполнением, а не к обычной доставке. Исследование описывает остановку с последующим уточняющим сообщением, но это нельзя распространять на ветку agent-stopped-by-user: для пользовательской отмены прямо предусмотрен запрет автоматического возобновления.
Очередь сессии и межсессионный транспорт
Внутренняя очередь объединяет сообщения, уведомления задач и другие события. Приоритеты - immediate, next, later. Событие может лишь попасть в историю, не запуская новый запрос к модели: для этого предусмотрены признаки passive и shouldQuery: false. Несколько событий могут обрабатываться одной порцией. Следовательно, добавление события, начало нового хода и получение ответа - разные этапы.
Для локальных сессий исследован транспорт JSONL - последовательность JSON-сообщений через сокет. Путь публикуется через CLAUDE_CODE_MESSAGING_SOCKET; сведения о сессии сохраняются в ~/.claude/sessions/<pid>.json. Протокол различает аутентификацию, пользовательское сообщение и управляющие команды, в том числе квитанции доставки.
Проверки канала включают владельца и приватность каталога, совпадение пользователя, сведения о процессе от ОС и стартовый токен. PID не считается достаточным секретом: идентификатор процесса может использоваться повторно. Механизм SO_PEERCRED относится к исследованному локальному сокетному пути, а не к каждому способу запуска на любой ОС.
Межсессионное сообщение представляется обёрткой cross-session-message, а локальное агентное - agent-message; содержимое экранируется. Квитанции различают удержание, отказ, истечение срока, доставку и отбрасывание. Для локальной сессии есть и одноразовая подписка notify_when_idle из главного диалога.
Для общения двух самостоятельно запущенных сессий создавать команду не требуется: документация рассматривает межсессионный обмен как отдельную возможность.
4. Как результат возвращается вызывающему агенту
Возврат результата не сводится к SendMessage. В исследованной сборке предусмотрены следующие способы:
| Способ | Когда применяется | Что получает вызывающий |
|---|---|---|
tool_result | Ожидание вызова Agent | Результат, идентификатор агента и сведения о расходе ресурсов |
<task-notification> | Фоновое выполнение | Статус, краткое описание, результат или указание на него |
SubagentHandback | Явная передача при установленном контракте запуска | Один отчёт, адресованный вызывающему агенту |
Фоновое уведомление содержит идентификаторы задачи и вызова инструмента, тип, статус и сводку. Оно различает успешное завершение, ожидание собственной фоновой работы, ошибку, остановку и достижение предела ходов. Само уведомление может поступать как служебный ввод в сообщении роли user; происхождение определяется обёрткой и обработкой системы, а не одним названием роли.
SubagentHandback не принимает произвольного получателя. Контракт хранится в записи задачи; повторная передача отчёта в рамках одного запуска отклоняется. Если вызывающий уже не работает, предусмотрен отказ; для изменившегося фонового состояния адресат выбирается по сохранённому контракту и связанным очередям.
При использовании SubagentHandback система предупреждает агента не дублировать финальный отчёт через SendMessage. В уведомлении о завершении вызывающему может прийти указатель на уже переданный отчёт вместо второй копии. Это локальное устранение дублей, а не гарантия доставки «ровно один раз» для всей системы.
Защита формата и проверка содержания
Перед передачей отчёта нормализуются переводы строк, включая необычные Unicode-разделители. Затем каждая строка получает отступ в два пробела. Обратный разбор проверяет отступы; служебная обёртка указывает, что ниже находится результат модели, а не сообщение пользователя. Имитации служебной разметки дополнительно экранируются.
Механизм отделяет содержимое отчёта от структуры служебного сообщения. Он не доказывает безопасность текста и не исключает любые попытки внедрения инструкций. Координаты форматирования и проверки - corpus@4857478–4857900.
В записи задачи есть отдельные статусы передачи:
| Статус | Значение в исследованном пути |
|---|---|
send | Отчёт передан; проверка могла не требоваться, завершиться успешно либо оказаться недоступной с соответствующим предупреждением |
flagged | Отчёт передан с предупреждением безопасности; признак сохраняется для последующих попыток отправителя в данном запуске |
withheld | Отчёт удержан; текст обнулён решением более высокого уровня до проверки отчёта |
Для проверки отчётов в автоматическом режиме обнаружен классификатор с порогами, зависящими от модели. Его инструкции не восстановлены. В этой ветке недоступность классификатора может сопровождаться предупреждением при продолжающейся доставке; поэтому фразу «любая ошибка проверки блокирует отчёт» использовать нельзя.
Это описание конкретного пути SubagentHandback в 2.1.311. В текущей документации отдельно описана проверка межагентных сообщений: заблокированное классификатором сообщение не передаётся. Разные виды сообщений и этапы проверки нельзя объединять в одну гарантию.
5. Команда на файловой системе
Конфигурация, задачи и почтовые ящики
Конфигурация команды, сообщения, задачи и история хранятся отдельно. Документированные пути и восстановленные журналы выполняют разные функции:
| Путь | Назначение | Что из этого не следует |
|---|---|---|
~/.claude/teams/{team-name}/config.json | Список участников и текущее служебное состояние | Это не пользовательское декларативное описание команды |
~/.claude/teams/{team-name}/inboxes/{agent-name}.json | Входящие сообщения конкретного агента | Ящик не является архивом всей переписки |
~/.claude/tasks/{team-name}/ | Общий список задач | Сохранение задач не сохраняет работающих участников |
subagents/agent-<agentId>.jsonl внутри каталога сессии | История агента в исследованной реализации | История не заменяет регистрацию и проверку прав при возобновлении |
Соседний agent-<agentId>.meta.json | Тип задачи и метаданные продолжения | Восстановление участника не строится только по списку команды |
По текущей документации, имя команды выводится из идентификатора сессии. При её завершении каталог конфигурации удаляется, а каталог задач остаётся на диске. Ручные изменения config.json перезаписываются при следующем обновлении состояния.
В исследованном config.json есть идентификаторы ведущего и сессии, сведения о ведущем процессе и массив members. Участник описан именем, идентификатором, типом, способом выполнения, рабочим каталогом и при необходимости идентификатором панели терминала.
Обновление списка выполняется как чтение, изменение и запись под блокировкой. Есть проверки, предотвращающие удаление участника, который успел присоединиться заново. Сведения о ведущем процессе обновляются сравнением прежних значений под блокировкой; обнаружена и обработка состояния, оставшегося после смерти процесса. Это внутреннее обслуживание состояния, а не документированный способ передать роль ведущего другому участнику.
В файловой ветке config.json записывается без атомарной замены, в отличие от почтового ящика. Блокировка ограничивает конкурирующую запись, но сама по себе не гарантирует целостности после произвольного сбоя. Для другой ветки хранения обнаружено обновление через сравнение и замену. Координаты конфигурации - corpus@9232456–9239085.
Запись, чтение и удаление сообщений
Почтовый ящик содержит JSON-массив. Запись включает from, text, timestamp, read, msg_id и дополнительные поля оформления и сводки. Схема проверяется и при записи, и при чтении: ошибочная запись не должна мешать обработке остальных допустимых сообщений.
Отправитель под блокировкой читает содержимое, проверяет его, добавляет запись и сохраняет обновление атомарно. Перед записью файла фиксируется запись в локальном журнале хешей; при ошибке сохранения она отменяется.
Получатель периодически читает новые сообщения, проверяет происхождение, разбирает управляющие типы и помечает обработанное. Пометка реализована удалением обработанных записей: в файле остаются недоставленные сообщения. Между чтениями повторы подавляются и в памяти; если обновление файла не удалось, сообщения остаются для следующей попытки.
Именно поэтому почтовый ящик - транспорт, а не источник полной истории. Его реализация находится в corpus@9202370–9212200.
Что подтверждает отправка
Для почтового маршрута успешная отправка означает, что сообщение записано в ящик получателя. Если диск заполнен или каталог недоступен для записи, отправитель получает ошибку. Эта семантика прямо описана в документации.
Схема показывает логические этапы; маршрут ответа может отличаться. Для важного поручения запрашивайте отдельный результат: изменённые файлы, найденные места в коде, вывод команды или обоснованный отказ.
6. Командный протокол и доверие к отправителю
Сообщения управления
Командный обмен включает не только произвольный текст, но и структурированные сообщения:
| Тип | Назначение |
|---|---|
plan_approval_request, plan_approval_response | Передача плана и ответа на него |
shutdown_request, shutdown_approved, shutdown_rejected | Штатное завершение участника либо отказ |
task_assignment, task_completed | Назначение задачи и сообщение о выполнении |
idle_notification | Переход участника в состояние простоя, результат или причина ошибки |
teammate_terminated | Уведомление о прекращении работы участника |
Управляющие поля не принимаются на веру только потому, что они записаны в JSON. Обработчик переписывает from из внешнего конверта сообщения, ограничивает длины и глубину вложенности. Идентификатор агента в запросе разрешения должен совпадать с отправителем конверта. Ответы на план и запросы разрешений в исследованном протоколе принимаются только от team-lead; связанные запросы и ответы сопоставляются по идентификаторам.
Наличие plan_approval_response не означает обязательного содержательного рецензирования плана ведущим. Документация описывает и автоматическое одобрение при определённых условиях запуска в режиме планирования. Утверждение плана также не заменяет согласие пользователя на действие.
Ledger: локальный журнал, а не подпись
Процесс хранит журнал хешей записанных сообщений - ledger. Хеш включает отправителя, время, текст и дополнительные поля. Проверка различает следующие состояния:
| Результат | Значение |
|---|---|
verified | Содержимое совпало с записью, известной этому же процессу |
forged | Сработала проверка подмены отправителя, представляющегося ведущим или участником внутри процесса |
unverifiable | Локального подтверждения нет; сюда входят и допустимые сообщения от других процессов |
Хеш содержимого - не криптографическая подпись. Ledger не переживает перезапуск процесса. Отсутствие записи само по себе не доказывает подделку: например, сообщение участника из другого процесса может оставаться непроверяемым и при этом допустимым.
Это существенное уточнение исследования: нельзя сводить проверку к правилу «любое письмо от ведущего без локального хеша поддельное». Для forged нужен конкретный признак подмены. Координаты проверки - corpus@9186600–9186724, журнала - corpus@8836100.
Модель доверия предполагает приватность пользовательских файлов ~/.claude. Эти механизмы не дают основания считать каталог команд защищённым каналом между недоверенными пользователями одной машины.
7. Лимиты, бюджеты и защита от повторов
Запуск и расход ресурсов
Значения ниже относятся к исследованной сборке. Внутренние настройки и специальные режимы могут менять применение проверок.
| Ограничение | Значение | Управление или координата | Поведение |
|---|---|---|---|
| Параллельные субагенты | 20 по умолчанию | CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS; corpus@13358784 | Отказ при срабатывании проверки; не универсальный предел размера Agent Teams |
| Глубина запуска субагентов | 3 по умолчанию; главный агент имеет глубину 0 | CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH; corpus@9494722 | Отказ с предложением выполнить работу напрямую |
| Денежный бюджет | Настроенный maxBudgetUsd | Проверка corpus@18183700 | При исчерпании новый агент не запускается |
| Мягкий бюджет токенов | 15 000 000 по умолчанию | CLAUDE_CODE_TOTAL_TOKENS_REMINDER_BUDGET; corpus@11896942 | Напоминание <total_tokens>; не эквивалент жёсткого денежного ограничения |
Размер результата tool_result | 100 000 символов | maxResultSizeChars, константа Cvt | Обрезка результата |
Для общего числа субагентов за сессию обнаружена переменная CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION, но значение по умолчанию не восстановлено. Назвать здесь надёжный предел нельзя.
При отказе по глубине, параллельности или бюджету система сообщает причину и дальнейшее действие. Например, для ограничения параллельности есть указание «Do not retry». Отказы учитываются через recordRefused; статистика разделяет запрошенные и выполненные запуски, завершения и причины остановки. Это позволяет модели изменить план вместо повторения заведомо недопустимого вызова.
Входящие межсессионные сообщения
Для исследованного пути приёма peer-сообщений проверки идут в порядке: цепочка пересылок → повтор содержимого → частота → допуск в очередь. Его нельзя без дополнительной проверки приписывать каждому внутреннему каналу команды.
| Проверка | Значение | Уточнение |
|---|---|---|
| Счётчик отправителя | Ёмкость 30, пополнение 0,5 единицы/с | Это разрешения на отправку, не токены языковой модели |
| Повтор содержимого | Окно 30 с | Хранится последнее тело от конкретного отправителя, а не вся переписка |
hop-runaway | Длина цепочки больше 28 | Ограничение общей длины пересылок |
hop-loop | Не менее 10 вхождений собственных идентификаторов получателя | Проверяется возвращение сообщения к той же сессии |
| Очередь peer-сообщений | 50 | При переполнении - queue-full |
| Учёт отправителей | До 256 записей | Ограниченный реестр с вытеснением давно не использованных записей |
| Сериализованный фрейм | Предел длины 1 048 576 символов | В исследовательском описании также назван «1 МБ»; длину строки нельзя считать универсальным байтовым пределом |
Константы проверок находятся в corpus@8843901, очереди - corpus@8848158, размера фрейма - corpus@8850200. Внутренний флаг tengu_harbor_kite_limits может менять ряд значений в допустимых пределах.
На стороне отправителя есть собственное ограничение темпа: разрешение резервируется до записи и возвращается при неудаче. Получатель и отправитель также получают сведения об отказах, чтобы не запускать немедленные повторные пересылки. Большие результаты предлагается хранить в доступном получателю файле, передавая сообщение с указанием на него.
Бюджеты командных сообщений
Разные типы содержимого имеют разные пределы. Их нельзя складывать в единый «размер контекста команды».
| Поле или порция | Предел | Координата или область |
|---|---|---|
planContent | 40 000 символов | corpus@9215372 |
feedback, описание задачи, отдельный результат или текст служебного сообщения | 4 000 символов для соответствующих полей | corpus@9215512 |
subject задачи | 256 символов | Схема task_assignment |
| Причина завершения | 416 символов | Константа GU; corpus@9215600 |
Краткая сводка idle_notification | 200 символов | Схема уведомления |
Сумма результатов idle_notification за обработку очереди | 16 000 символов | corpus@9215520 |
Превышение ряда этих бюджетов приводит к обрезке, а не к отказу всего сообщения. Поэтому длинный отчёт разумнее сохранять отдельно, оставляя в уведомлении выводы и местоположение полного текста.
Таймеры не равнозначны остановке
В исследовании также восстановлены временные условия. Они зависят от соответствующих ветвей выполнения; наличие константы не означает безусловного срабатывания таймера.
| Механизм | Восстановленное условие |
|---|---|
| Опрос почтового ящика | Интервал 1 с у активного InboxPoller |
| Выгрузка простаивающего участника in-process | Кандидат после 30 с простоя; просмотр истории, ожидающие сообщения и работающие связанные задачи могут удерживать его |
| Контроль зависания фонового агента | Примерно интервал потока плюс 300 000 мс; откладывается, пока инструменты выполняются |
| Подсказка о переводе в фон | 2 000 мс |
| Автоматический перевод в фон | 120 000 мс в соответствующей ветке |
| Ожидание обязательных MCP-серверов | До 30 000 мс в исследованной проверке |
Для контроля зависания обнаружены CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS и CLAUDE_ENABLE_STREAM_WATCHDOG, для автоматического ухода в фон - CLAUDE_AUTO_BACKGROUND_TASKS. Эти параметры реализации не следует принимать за стабильный пользовательский контракт без проверки установленной версии.
8. Возобновление, выключение и пользовательские права
Три разных состояния продолжения
Завершившийся субагент может продолжить сохранённый диалог через ветвь agent-stopped. Для выгруженного участника внутри процесса предусмотрен другой путь - resumeInProcessTeammate.
Выбор этого пути опирается на соседний с историей файл .meta.json с типом задачи in_process_teammate, а не только на запись config.json. При восстановлении проверяются доверие к каталогу определения агента, ограничения его типа и обработчики расширений. Устаревшие управляющие сообщения удаляются; история продолжается с тем же resumableAgentId, а идентификаторы записей защищают от повторного добавления. Одновременные попытки восстановить одного участника объединяются. Если история пуста, он продолжает без прежних сообщений.
Это не восстановление всей пользовательской сессии. Документация прямо предупреждает: /resume и /rewind не восстанавливают участников in-process. Если оркестратор обращается к отсутствующим участникам после восстановления, рекомендуется создать новых.
Скрытая строка участника в интерфейсе - третья ситуация. Простаивающий участник может оставаться доступным для сообщений, даже когда строка не отображается. Скрытие, выгрузка памяти, завершение хода и пользовательская отмена не должны трактоваться как одно состояние.
Штатное завершение
Командный протокол завершения кооперативен:
Оркестратор отправляет участнику
shutdown_requestс идентификатором запроса.Участник отвечает
shutdown_approvedилиshutdown_rejectedс объяснением.При подтверждении участник прекращает собственное выполнение.
Оркестратор обрабатывает ответ, при необходимости закрывает панель, удаляет участника из списка и снимает назначения его задач; затем формируется
teammate_terminated.
Отклонённый запрос оставляет участника работающим. Но из кооперативного протокола не следует невозможность принудительной остановки: текущая документация отдельно описывает остановку выбранного участника клавишей x. Она также предупреждает, что штатное завершение может ждать окончания текущего запроса или вызова инструмента.
Разрешения и песочницы
Отдельный контекст не создаёт независимых прав. В исследовании обычных субагентов описаны слои разрешений, наследование запретов и ограничение доступного режима при запуске. Обнаруженные внутренние режимы включают plan, bubble, default, acceptEdits, auto, bypassPermissions; их нельзя превращать в универсальную пользовательскую шкалу для всех видов агентов.
Для участников команды применяются собственные правила. Текущая документация Permissions описывает наследование режима ведущего, включая широкие разрешения, и различия между in-process и отдельными панелями. Поведение зависит от версии. Поэтому вывод «дочерний агент всегда получает более строгие права» для любой команды неверен.
На уровне инструментов и ОС в исследовании выделены разные защитные слои: ограничения набора инструментов, диалоги разрешений и песочницы. Описаны macOS SBPL, Linux bwrap и Windows srt-win; для сетевого доступа - фильтрующий локальный прокси и ограничения платформы. Проверка политики песочницы может отказать до диалога разрешений. Наличие этих ветвей не подтверждает одинаковую активную конфигурацию на всех ОС и в каждом запуске.
Общая граница сформулирована однозначнее: сообщение агента не является пользовательским согласием. Участник не может одобрить действие от вашего имени или обойти отказ передачей действия другому агенту. При разработке своего координатора сохраняйте происхождение сообщения отдельно от канала подтверждений пользователя.
9. Смежные механизмы: обработчики событий и Workflow
Agent Teams - не единственный механизм оркестрации в исследованной сборке. Важно отделять его от расширений, режима координатора и программного Workflow.
Обработчики событий и режим координатора
В исследовании расширений описаны слои prepend → user → append → builtin → core. Через события проходят не только действия агента, но и внешние операции модификаций - например, fs.read, http.fetch, process.run. Сведения о происхождении origin.tier выставляет хост. Для защитного слоя sec-default описан отказ при невозможности разрешить действие, а не автоматическое продолжение.
Инвентаризация первого прохода насчитала 33 классических и 45 движковых событий, а также 60 внешних вызовов. Это состав исследованной реализации расширений, не список стабильных публичных событий Agent Teams. В пользовательской документации для команд отдельно описаны обработчики TeammateIdle, TaskCreated и TaskCompleted, которыми можно ограничивать переходы состояний задач и участников.
В режиме координатора управляющему агенту выделена ограниченная роль, а исполнители выполняют работу и присылают уведомления. Разрешённое пользователем действие нельзя просто «узаконить» пересланным сообщением: в исследованной инструкции предусмотрен новый запуск с одобренным действием в исходном поручении. Это частный механизм, не замена настройкам разрешений.
Workflow: очередь вместо отказа
В исследовании Workflow описана среда node:vm, ограничения на Date.now и Math.random для воспроизводимости и журнал journal.jsonl. Продолжение привязано к наиболее длинному неизменившемуся префиксу программы.
В отличие от отказа при переполнении обычных запусков субагентов, локальные вызовы Workflow могут ожидать освобождения семафора. Это другая семантика параллельности.
| Ограничение Workflow | Значение первого прохода | При превышении |
|---|---|---|
| Одновременные локальные агенты | min(16, max(2, CPUs − 2)) | Ожидание в очереди |
| Одновременные удалённые агенты | 50 | Ожидание в очереди |
Всего вызовов agent() за выполнение | 1000 | Ошибка |
Число элементов для parallel() или pipeline() | 4096 | Ошибка, а не незаметная обрезка |
Эти константы прочитаны в первом проходе, но не прошли повторную сверку по единому корпусу. Их нельзя подавать как дополнительно подтверждённые пределы Agent Teams.
Отдельная рабочая копия git также не означает автоматического объединения результатов. В исследованных сценариях пакетной работы описан отдельный PR на единицу работы, а для опасных операций - привязанные к действию capability-токены, например с идентификатором коммита. Это основание планировать проверку и объединение изменений явно, а не обещать автоматическое разрешение конфликтов.
Что можно перенести в собственную агентную систему
В рамках исследования описан перенос ряда механизмов в экспериментальный форк omp - среды выполнения агентов: ограничения входящих сообщений, явные отказы, напоминание о бюджете, структурированный возврат отчёта, продолжение Workflow по журналу и разрешения на опасные операции.
Реализация аналога помогает проверить понимание интерфейса, но не доказывает тождество поведения Claude Code. Кроме того, описания исходного состояния omp и экспериментального форка различаются: категоричную таблицу «в omp этого нет» нельзя считать сравнением актуальных релизов.
Для собственного координатора из разбора следуют конкретные проектные решения:
адресовать агента с учётом идентичности и состояния, а не только имени;
разделять запись сообщения, его обработку и подтверждение результата;
хранить историю отдельно от транспортной очереди;
ограничивать частоту, повторы и цепочки пересылок;
отличать происхождение текста от разрешения пользователя;
возвращать модели отказ с причиной и допустимым следующим действием.
Это выводы из разобранных механизмов, а не новый набор гарантий Claude Code.
10. А как использовать у себя?
Включение и исходные условия
Agent Teams - экспериментальная возможность, отключённая по умолчанию. Добавьте следующую настройку в существующий settings.json, сохранив остальные поля и уже заданные переменные в env:
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
}
}| Настройка | Значение по умолчанию | Действие |
|---|---|---|
env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS | Возможность отключена | "1" включает команды, "0" отключает |
teammateMode | "in-process" | Участники отображаются внутри основного терминала; для отдельных панелей нужны поддерживаемые средства терминала |
Запускайте интерактивную сессию: в режиме -p, в том числе в соответствующих сессиях Agent SDK, участники команды не создаются.
Состав команды предельно прост: оркестратор создаёт участников, но участники не создают собственные команды. Для in-process дополнительно ограничен запуск фоновых субагентов. Документация предусматривает одну команду на сессию и не поддерживает назначение участника новым ведущим.
Задание для команды
Для первого запуска подходит анализ без изменения файлов. Он позволяет проверить обмен находками без риска перезаписи правок. В открытом проекте передайте ведущему следующее задание:
Создай Agent Team для анализа обработки ошибок в этом проекте.
Участник contracts: проверь публичные контракты и ответы при ошибках.
Участник execution: проверь отмену, таймауты и освобождение ресурсов.
Участник verification: проверь, какие из найденных рисков покрыты тестами.
Файлы не изменять. Каждому передай цель, границы и формат отчёта.
Обменивайтесь находками, если они меняют выводы другого участника.
Каждая находка: файл и символ, условие ошибки, последствия, доказательство.
Отделяйте проверенные факты от гипотез; не считайте согласие доказательством.
Оркестратор: сведи результаты, разреши противоречия, отметь непроверенное.При запуске участник получает проектные инструкции, инструменты и исходное поручение, но не историю вашего разговора с ведущим. Поэтому существенные условия должны входить в задания явно.
Отправлять стоит сведения, меняющие работу получателя: новое ограничение, опровергнутую гипотезу, согласованный формат или готовый результат. Уведомлять всех о каждом промежуточном шаге обычно не требуется.
Перед переходом к правкам назначьте каждому участнику отдельные файлы и определите, кто объединяет изменения. Блокировка при назначении задач предотвращает конкурирующее получение одной задачи, но не конфликты правок одного файла. Рост числа участников сам по себе эту проблему не решает.
Отключение и безопасность состояния
Сначала завершите текущих участников. Затем задайте "0" у CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS в настройках. По документации, изменение применяется без обязательного перезапуска и влияет на последующие именованные запуски. Настройки проекта или организации могут иметь больший приоритет.
Изменение переменной не следует использовать как команду остановки работающих участников. Не удаляйте активные почтовые ящики и не редактируйте служебный список вручную. Отключение возможности не отменяет внесённые в проект изменения.
11. Хочу проверить выводы исследования сам!
Для проверки реализации нужны соответствующий бинарник и извлечённый корпус; приведённые здесь смещения не заменяют эти артефакты.
В исследовании применялись два разных способа извлечения: распаковка графа модулей через tools/bun_graph.py и извлечение единого текстового региона через tools/extract_corpus.py из исследовательского проекта claude-giga. Это вспомогательные скрипты проекта исследования, не команды стандартной установки Claude Code.
Для корпуса второго прохода указаны границы байтового региона [216 880 000, 267 160 000) в бинарнике 2.1.311 и проверка SHA-256. Контрольное значение не опубликовано в исходном описании, поэтому воспроизведение идентичного корпуса только по этой статье подтвердить нельзя. Для других сборок описано автоматическое обнаружение по маркеру // Version:, но прежние координаты после этого недействительны.
Порядок независимой сверки:
Зафиксировать точную сборку и контрольные суммы бинарника и результата извлечения.
Найти строковые константы интересующего механизма и прочитать окружающие ветви, включая условия применения.
Сопоставить код запуска, доставки и обработки результата: наличие константы в одном месте не доказывает единый предел для всех каналов.
Для эксплуатационных гарантий отдельно проверить работающего, завершившегося, отменённого и выгруженного агента, а также ошибки записи и повторные сообщения.
Для навигации по соответствующему корпусу полезны следующие координаты:
| Механизм | Координаты исследования |
|---|---|
| Пользовательские определения агентов | corpus@12019928 |
| Обработчик передачи отчёта | corpus@4855500–4858436 |
| Проверка отчётов в автоматическом режиме | corpus@18110400–18113000 |
| Командные фреймы и очистка их полей | corpus@9226300–9227500, corpus@9219600 |
| Запуск участников | corpus@34242950–34255500 |
| Обработка завершения | corpus@32521400–32523600 |
| Сообщение о возобновлении участника | binary@106154755 |
Это указатели из статического исследования. Новая версия, иной способ извлечения или другая платформа требуют собственной проверки.
Ограничения и итог
Не изучались ибо небыли интересны: терминальный интерфейс и внутренние инструкции классификатора безопасности, а облачная авторизация, телеметрия и часть платформенных песочниц изучены лишь частично; смешанная команда с разными способами выполнения не проверена запуском. В исследовательских материалах встречаются процентные оценки покрытия, но они субъективны и не являются измерением корректности или надёжности системы.
Практическая ценность Agent Teams определяется зависимостями между задачами. Команда полезна, когда участники получают самостоятельные результаты и уточняют их через обмен сообщениями. Для последовательной работы, правок одного файла или небольшого поручения с одним отчётом её координация может оказаться избыточной.
Системная модель здесь конкретна: отдельные контексты, адресуемые исполнители, очереди, файлы, ограничения и границы доверия. Зная её, проще отличить недоставленное сообщение от невыполненной задачи, восстановление истории от восстановления команды и отчёт агента от пользовательского разрешения.