Субагенты Codex и Claude Code параллельно: промпты, настройки, команды

Расхожее мнение «Claude Code сам распараллеливает работу, а Codex — только если попросить» верно, но с оговорками. Приложение Codex, CLI и расширение для IDE запускают параллельных исполнителей (субагентов) по вашей просьбе или когда AGENTS.md либо навык (skill) велит разбить работу на субагентов. Claude Code же делегирует ещё и по собственному решению — исходя из содержания запроса и описания каждого субагента.

В этой статье на основе официальной документации OpenAI и Anthropic (проверено 26 октября 2026 года) сравнивается, как добиться параллельной работы от обоих инструментов, в таком порядке: триггеры, как писать инструкции, настройка, команды и затраты. Во всех разделах инструменты идут в одном и том же порядке и цвете: Codex → Claude Code. В конце — уроки, которые этот сайт извлёк из параллельного запуска субагентов в Claude Code.

1. Что запускает параллельную работу и что будет, если ничего не говорить

Субагент — это отдельный исполнитель, который берёт на себя часть работы основного диалога. Каждый выполняет исследование или тесты в собственном контексте и возвращает в основной диалог только сводку результатов. Параллельный запуск сокращает ожидание и не даёт основному диалогу забиться промежуточными логами. В этом оба инструмента сходятся.

Различается то, кто это запускает. Вот четыре ситуации.

Источники: OpenAI «Subagents»; Anthropic «Create custom subagents». Проверено 26 октября 2026 года.

Согласно официальной документации Codex, локальные версии Codex (приложение, CLI, расширение для IDE) делегируют «по прямой просьбе или когда этого требуют соответствующие инструкции в AGENTS.md или навыке». Функция не выключена: в текущих версиях система субагентов включена по умолчанию. Запускать ли их, зависит от ваших инструкций. В ChatGPT Work (веб) на большинстве уровней интеллекта нужна явная просьба, и только при выборе Ultra (Ultra доступен лишь подходящим аккаунтам и поддерживаемым моделям) он может делегировать сам, когда распараллеливание заметно повысит скорость или качество.

Официальное описание Claude Code: он «делегирует автоматически исходя из задачи в запросе, поля description в определении субагента и текущего контекста». Для субагентов, которых нужно задействовать активнее, рекомендуется вписать в описание фразы вроде «use proactively». Субагентов, которые наследуют диалог целиком (форки), Claude по умолчанию тоже запускает по своему усмотрению.

Тонкость: в журнале изменений Codex есть изменение, которое позволяет тем, кто встраивает Codex в свои продукты (клиентам app-server), выбирать режим делегирования: «отключено, только по явной просьбе или проактивно» (Codex CLI 0.142.0, 22 июня 2026 года). Для пользователей приложения, CLI и IDE поведение соответствует таблице выше.

2. Как устроены оба инструмента: сравнение

Ниже — как пишутся определения субагентов, сколько их может работать одновременно, как разделяются рабочие каталоги и другое. Если что-то описано в официальной документации только одной стороны, стоит пометка «Не документировано».

Источники: OpenAI «Subagents», «Configuration Reference», «Worktrees»; Anthropic «Create custom subagents», «Run parallel sessions with worktrees». Проверено 26 октября 2026 года.

Главных различий два. Первое — можно ли лишить субагента возможности записи. Codex использует права родителя как есть, поэтому «не редактируй» для субагента — лишь просьба. Claude Code может полностью убрать у субагента инструменты редактирования (Write, Edit). Чтобы заблокировать запись и из оболочки, уберите ещё и Bash. Второе — рабочая копия на каждого субагента: Claude Code умеет создавать для каждого субагента git worktree (отдельную рабочую копию того же репозитория), а worktree в Codex создаются на чат.

Помимо субагентов, у Claude Code есть и другие способы параллельной работы (agent view, где отдельные сессии идут на одном экране, и agent teams, где исполнители общаются друг с другом). Различия разобраны в статьях «Subagents против Agent Teams в Claude Code» и «Agent view в Claude Code».

3. Как писать инструкции: готовые промпты

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

1. Как разделить работуПо аспектам (безопасность, тесты, сопровождаемость), по месту (каталог, модуль) и так далее. Делите так, чтобы два субагента не смотрели на одно и то же
2. Что им можно трогать«Только чтение» или «редактировать можно только этот каталог». Никогда не давайте двум субагентам трогать один и тот же файл
3. Ждать ли всехСводить только когда пришли все результаты или разрешить двигаться дальше по ходу
4. Что вернутьФормат и объём («не больше 10 строк с именами файлов» и т. п.). Длинные ответы быстро забивают основной контекст
5. Чего не делатьКоммиты, push, запуск субагентами новых субагентов и так далее. Если не сказать, что запрещено, субагенты сделают это из лучших побуждений

Исследование и ревью только на чтение (начните с этого)

Проверь эту ветку относительно main. Запусти параллельно трёх субагентов:
одного на проблемы безопасности, одного на недостающие тесты и одного на сопровождаемость.
Никто из них не должен редактировать файлы.
Дождись, пока все трое закончат, и сведи итог по аспектам с именами файлов и номерами строк.

Исследуй модули аутентификации, базы данных и API параллельно с помощью отдельных субагентов.
Каждый субагент должен только читать, не изменяя никаких файлов.
Пусть каждый вернёт «файлы точек входа, основной поток обработки, опасения» не больше чем в 10 строк,
а сведи всё в один ответ только после того, как придут все результаты.

Разделение работы, которая меняет файлы

Обе официальные документации осторожно относятся к параллельной работе с большим объёмом записи. Выделите каждому субагенту свою зону, которую он может редактировать, а в Claude Code разделите и рабочие копии.

Выясни, почему не сохраняется страница настроек, и исправь это.
Пусть browser_debugger воспроизведёт проблему в браузере и запишет шаги,
а code_mapper найдёт, где находится виновный код (эти двое ничего не редактируют).
Когда причина станет ясна, пусть ui_fixer внесёт минимальное исправление. Не трогай посторонние файлы.

/batch перенеси JavaScript в src/ на TypeScript

Чтобы не повторять каждый раз

Если в Codex надоело каждый раз просить о параллельной работе, пропишите правила делегирования в AGENTS.md проекта. Официальная документация говорит, что он делегирует при наличии соответствующих инструкций в AGENTS.md или навыке. Какая формулировка срабатывает надёжно, там не сказано, поэтому после того, как пропишете правила, один раз проверьте, запускаются ли субагенты на ваших обычных запросах.

## Использование субагентов
- Для исследования, охватывающего три и более каталога, запускай по одному субагенту на каталог и исследуй параллельно
- Не давай субагентам редактировать файлы. Всё редактирование — в основном потоке
- Дождись всех результатов и сообщи только главное

В Claude Code, если хотите, чтобы определённый субагент использовался чаще, напишите в его description, когда его применять, и добавьте «use proactively» (пример определения — в следующем разделе). И наоборот: если он делегирует слишком много, Agent в permissions.deny запретит ему запускать субагентов.

4. Настройки и файлы определений субагентов

Codex config.toml и .codex/agents/

Общие настройки задаются в разделе [agents] файла config.toml (личный: ~/.codex/config.toml, проект: .codex/config.toml).

# .codex/config.toml
[agents]
max_concurrent_threads_per_session = 4     # Макс. число одновременно открытых потоков субагентов (основной поток не считается)
default_subagent_model = "gpt-6-luna"      # Модель субагентов по умолчанию
default_subagent_reasoning_effort = "high" # Уровень рассуждений субагентов по умолчанию

Источник: OpenAI «Configuration Reference». Проверено 26 октября 2026 года. «Multi agent v2», который часто встречается в результатах поиска, — это текущая версия этой системы; по журналу изменений она стала стабильной в Codex CLI 0.145.0 (21 июля 2026 года) (Changelog). В текущих версиях она включена и без того, чтобы самому писать multi_agent = true.

Собственные агенты кладутся в .codex/agents/, по одному TOML-файлу на агента. Имя агента берётся из name, а не из имени файла.

# .codex/agents/reviewer.toml
name = "reviewer"
description = "Ревьюер, сосредоточенный на корректности, безопасности и недостающих тестах"
model = "gpt-6.1-sol"
model_reasoning_effort = "medium"
developer_instructions = """
Не редактируй файлы.
В приоритете корректность, безопасность, регрессии поведения и недостающие тесты.
Замечания только о стиле оставляй лишь тогда, когда за ними скрывается настоящая ошибка.
"""

Адаптировано из официального примера. Названия моделей взяты из официального примера; доступные модели зависят от аккаунта и рабочего пространства. Официальная рекомендация — gpt-6.1-sol для агентов, которые принимают много решений, и gpt-6-luna для лёгких агентов с чётко очерченной зоной. Такие параметры, как sandbox_mode, approval_policy и mcp_servers, переопределяются настройками родителя, даже если прописать их в файле агента.

Claude Code .claude/agents/ и settings.json

Субагенты хранятся в .claude/agents/ в формате Markdown. Можно и просто попросить Claude «создать субагента, который делает X», и он сам напишет файл.

---
name: test-runner
description: Запускает набор тестов и сообщает только об упавших тестах с их ошибками. Use proactively после изменений кода.
tools: Read, Grep, Glob, Bash
model: haiku
---

Запусти тесты и верни только имена упавших тестов и суть их ошибок.
Не исправляй код. Не возвращай список прошедших тестов.

Поскольку в tools нет Write и Edit, по официальной документации этот субагент не может ни редактировать, ни записывать файлы. Однако Bash оставлен, чтобы запускать тесты, а это оставляет лазейку для записи через команды оболочки. «Не исправляй код» в теле — напоминание об этом. model принимает sonnet, opus, haiku, fable, ID модели или inherit (как в основном диалоге). Как выбрать модель для каждого субагента, разобрано в статье «Как запускать субагентов Claude Code на другой модели».

Лимит одновременных субагентов и глубина вложенности задаются переменными окружения, которые можно прописать в разделе env файла settings.json.

{
  "env": {
    "CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS": "5",
    "CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH": "1"
  }
}

Источники: Anthropic «Create custom subagents», «Orchestrate teams of Claude Code sessions». Проверено 26 октября 2026 года.

5. Справочник команд

Это команды, чтобы следить за работающими субагентами, разделять рабочие копии, ответвлять диалог и так далее. Некоторые называются одинаково, но делают разное, так что будьте внимательны.

Источники: OpenAI «Command line options, Slash commands», «Subagents»; Anthropic «Commands», «Run agents in parallel», «Create custom subagents» (несколько подходов с помощью форков). Проверено 26 октября 2026 года.

Путаницу вызывает /agents, потому что имена совпадают. В Codex /agents — это список чатов на сервере (командный центр). В Claude Code /agents подсказывает, где хранятся определения субагентов, а список сессий — это claude agents (запускается из оболочки).

6. Какие задачи подходят для параллельной работы, а какие нет

Обе официальные документации говорят почти одно и то же: начинайте с работы только на чтение, а с работой, где много записи, будьте осторожны.

Источники: OpenAI «Subagents» (Why subagent workflows help); Anthropic «Create custom subagents» (Choose between subagents and main conversation) и «agent teams» (Avoid file conflicts). Проверено 26 октября 2026 года.

7. Влияние на затраты (лимиты использования)

Параллельно — быстрее, но расходуется больше лимита, потому что каждый субагент сам обращается к модели и сам использует инструменты.

Источники: OpenAI «Subagents», «Changelog»; Anthropic «Manage costs effectively», «Create custom subagents». Проверено 26 октября 2026 года.

Ещё одно, что легко упустить: ответы субагентов тоже попадают в основной контекст. Документация Claude Code предупреждает, что множество субагентов с подробными результатами может съесть большую часть основного контекста. Формат ответа вроде «не больше 10 строк» помогает и с затратами. Общие способы экономии токенов в Claude Code разобраны в статье «Советы по экономии токенов в Claude Code».

8. Уроки из практики (примеры этого сайта)

Этот сайт (AI Arte) работает, параллельно поручая перевод и проверку статей субагентам Claude Code. Исследование и черновик этой статьи тоже написал один из субагентов, запущенных основной сессией. Ниже — то, что действительно случилось, и как этого избежать. Всё это записи из Claude Code; в Codex ничего не воспроизводилось. Тем не менее конфликты из-за одного файла и неточные отчёты о том, что вне зоны субагента, стоит учитывать и в Codex, раз механизм похож.

1. Июль 2026Задайте число одновременных субагентов под свои лимиты

   Что случилось

   При запуске шести и более одновременно субагенты падали из-за ограничений частоты запросов

   Как избежать

   Ограничьте пятью одновременно, а крупные задания запускайте по очереди партиями по 5. Задайте лимит под свои ограничения, ниже лимита Claude Code по умолчанию (20)

2. 22 сентября 2026Не давайте субагентам запускать новых субагентов

   Что случилось

   Субагент, которому поручили работу на 10 языков, сам запустил 5 субагентов-переводчиков. Вместе с 5 родительскими получилось 10 одновременно, лимит использования был исчерпан, и все они остановились на полпути

   Как избежать

   В разделе «чего не делать» инструкции напишите: «Не запускай субагентов. Работу распределяет родитель». Claude Code по умолчанию разрешает субагентам запускать субагентов (до 3 уровней), так что вложенность можно запретить и через CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH=1

3. 22 августа 2026Никогда не давайте двум субагентам трогать один файл

   Что случилось

   Предложение, которое родитель добавил в конец главы курса, другой субагент удалял как «отсутствующее в инструкции», потом его добавляли снова — и так по кругу

   Как избежать

   Закрепите за каждым субагентом файлы, которые ему можно трогать. Всё, что родитель потом добавит массово, либо упомяните и в инструкциях субагентов, либо добавляйте после того, как все закончат

4. 22 сентября 2026Разделите и место для временных файлов

   Что случилось

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

   Как избежать

   В инструкции выделите каждому субагенту собственную подпапку

5. 5 сентября 2026Не коммитьте всё разом, пока работают субагенты

   Что случилось

   Пока работали 5 субагентов, постороннее изменение закоммитили через git add -A (все изменения), и 100 файлов, законченных субагентами, попали в чужой коммит

   Как избежать

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

6. 22 августа 2026Перепроверяйте то, что субагенты сообщают за пределами своей зоны

   Что случилось

   Два субагента сообщили «24 пункта не проходят проверку» и «28», а на деле их было 16. Они додумали состояние файлов, которых не касались

   Как избежать

   Родитель сам запускает проверки и уточняет число и объекты. Находки в пределах собственной зоны субагента очень точны, им можно доверять

Взято из рабочих записей этого сайта (июль–сентябрь 2026 года). Приведены только числа, сохранившиеся в этих записях.

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

[Задача] Исследовать тему статьи 273 и написать черновик на ja
[Чего не делать]
- операции git (add, commit, checkout, restore, stash, push)
- Не запускать субагентов (работу распределяет родитель)
- Не редактировать другие статьи
- Временные файлы класть в scratch-folder/a273/
[Как исследовать] По оригинальному тексту официальной документации (записывать URL и даты проверки)
[Что вернуть] Созданные файлы, заголовок, всё, что не удалось проверить

Каркас (в кратком виде) инструкции, которую получил субагент, написавший эту статью, плюс два урока из списка выше (не запускать субагентов, куда класть временные файлы). Тот же формат подходит для инструкций субагентам и в Codex, и в Claude Code.

Итоги

Об общих различиях двух инструментов (цены, лимиты, где они работают) читайте в статье «Claude Code vs Codex: что выбрать?», а о настройках, приближающих субагентов к режиму только чтения, — в статье «Codex и Claude Code в режиме только чтения».

FAQ

Q. Сколько субагентов Codex может работать одновременно?

A. Лимит задаётся через agents.max_concurrent_threads_per_session в config.toml (основной поток не считается). Если его не указать, решает Codex, и это значение по умолчанию не опубликовано. В официальных примерах настроек используется 6 или 8. В Claude Code по умолчанию 20 одновременно, меняется через CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS. В обоих инструментах: чем больше запущено, тем быстрее тают лимиты использования.

Q. Можно ли использовать более дешёвую модель только для субагентов?

A. Да. В Codex — через default_subagent_model в разделе [agents] или через model и model_reasoning_effort в файле агента. Если не указано, наследуется модель родителя. В Claude Code — через model в определении субагента (haiku и т. п.) или переменную окружения CLAUDE_CODE_SUBAGENT_MODEL.

Q. Нужно ли писать «multi_agent = true» в настройках?

A. В текущем Codex — нет. В справочнике настроек features.multi_agent стабилен и включён по умолчанию, а agents.enabled тоже по умолчанию true. По журналу изменений multi-agent V2 появился как система по желанию (opt-in) и стал стабильным в Codex CLI 0.145.0 (21 июля 2026 года). Шаги «включите это» из старых руководств теперь дают то же состояние, что и пустая настройка. Чтобы отключить, напишите enabled = false в разделе [agents].

Q. Как запретить Claude Code самостоятельно запускать субагентов?

A. Чтобы заблокировать субагентов полностью, добавьте Agent в permissions.deny в настройках разрешений. Чтобы запретить только субагентов, наследующих диалог (форки), используйте Agent(fork) или переменную окружения CLAUDE_CODE_FORK_SUBAGENT=0. Если agent teams включены, названный субагент может запуститься как участник команды, поэтому, если вы не пользуетесь agent teams, оставьте их выключенными.