PurpleSchool — курсы программирования онлайн
  • Пути
    • Frontend React разработчик
    • Frontend Vue разработчик
    • Backend разработчик Node.js
    • Fullstack разработчик React / Node.js
    • Mobile разработчик React Native
    • Backend разработчик Golang
    • Devops инженер
    • Backend разработчик Python
  • Подписка
  • AI для кодаНовое
  • О нас
    • Отзывы
    • Реферальная программа
    • О компании
    • Контакты
  • Иконка открытия меню
    • PurpleFlow
    • Сообщество
    • PurpleПлюс
    • AI Собеседование
    • AI тренажёр
    • Проекты
PurpleSchool — платформа бесплатных roadmap и курсов для разработчиков
ютуб иконка
Telegram иконка
VK иконка
VK иконка
Курсы
ГлавнаяКаталог курсовFrontendBackendFullstack
Практика
КарьераПроектыPurpleПлюсPurpleMax
Материалы
БлогБаза знаний
Документы
Договор офертаПолитика конфиденциальностиПроверка сертификатаМиграция курсовРеферальная программа
Реквизиты
ИП Ларичев Антон АндреевичИНН 773373765379contact@purpleschool.ru

PurpleSchool © 2020 -2026 Все права защищены

  • Курсы
    • FrontendИконка стрелки
    • AI разработкаИконка стрелки
    • BackendИконка стрелки
    • DevOpsИконка стрелки
    • MobileИконка стрелки
    • ТестированиеИконка стрелки
    • Soft-skillsИконка стрелки
    • ДизайнИконка стрелки
    Иконка слояПерейти в каталог курсов
  • Бесплатно
    • Курсы
    • JavaScript Основы разработкиPython Основы PythonCSS CSS FlexboxКарта развитияВопросы для собеседований
    • База знанийИконка стрелки
    • Новостные рассылкиИконка стрелки
  • PurpleSchool — курсы программирования онлайн
    • Подписка
    • AI для кодаНовое
    • Сообщество
    Главная
    Сообщество
    Субагенты в Codex: как распараллелить работу агента

    Субагенты в Codex: как распараллелить работу агента

    Аватар автора Субагенты в Codex: как распараллелить работу агента

    Антон Ларичев

    Иконка календаря20 ноября 2026
    CodexAI-инструментыСубагентыmiddleИконка уровня middle
    Картинка поста Субагенты в Codex: как распараллелить работу агента

    Субагенты в Codex выполняют отдельные части задачи в собственных потоках и возвращают главному агенту короткий результат. Чтобы их запустить, прямо попросите об этом: например, «запусти двух агентов и дождись обоих». Лучше всего они подходят для задач, где нужно много читать: исследования кода, тестов и логов. Параллельная запись в одни и те же файлы создаёт конфликты, поэтому её нужно изолировать.

    Ниже — как запускать субагентов, как создать свою роль и когда параллельность только тратит токены.

    Зачем нужны субагенты

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

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

    Как запустить

    В актуальных версиях Codex субагенты включены по умолчанию. Хороший запрос объясняет, как разделить работу, нужно ли ждать всех и что вернуть:

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

    В CLI команда /subagents показывает потоки агентов и переключает между ними. Можно также попросить Codex направить работающего субагента, остановить его или закрыть завершённые потоки.

    Если делегирование нужно регулярно, опишите его в AGENTS.md или навыке: Codex учитывает такие инструкции.

    Встроенные агенты

    АгентДля чего
    defaultобщий запасной вариант
    workerреализация и исправления
    explorerчтение и исследование кода

    Как создать свою роль

    Свои агенты хранятся в TOML-файлах. Личные лежат в ~/.codex/agents/, а агенты проекта — в .codex/agents/. Обязательны три поля: name, description и developer_instructions.

    Создайте .codex/agents/test-scout.toml:

    name = "test_scout"
    description = "Находит тесты и команды запуска, не меняя файлы."
    model = "gpt-6-luna"
    model_reasoning_effort = "low"
    developer_instructions = """
    Не редактируй файлы.
    Найди тесты и команду их запуска.
    Верни короткий список: файл и что он проверяет.
    """

    Теперь к нему можно обратиться по имени:

    Запусти двух субагентов test_scout параллельно: первый ищет тесты,
    второй команду запуска. Дождись обоих и перескажи результат одной строкой.

    Мы проверили такую роль на Codex CLI 0.167. Описание description стоит писать конкретно: главный агент ориентируется на него при выборе роли.

    Какую модель выбрать

    Если модель не указана, субагент наследует модель и уровень рассуждений родителя. OpenAI предлагает простое разделение: gpt-6.1-sol для сложных задач с неоднозначностью, gpt-6-luna для быстрых, узких и повторяющихся.

    Такой подход помогает контролировать расход. Поиск по проекту не требует той же настройки, что архитектурное решение.

    Глобальные параметры находятся в разделе [agents] файла config.toml. Например, можно ограничить число одновременно открытых потоков:

    [agents]
    max_concurrent_threads_per_session = 4

    Что важно знать о правах

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

    Отсюда важный вывод: строка «не редактируй файлы» в роли — это просьба, а не техническое ограничение. Если изменения запрещены, запускайте родительскую сессию с --sandbox read-only.

    В интерактивном CLI запрос на подтверждение может прийти из неактивного потока. Окно покажет его источник, а клавиша o откроет этот поток. В неинтерактивном запуске действие, которому требуется новое подтверждение, завершится ошибкой, и она вернётся родителю.

    Запуск без интерфейса

    Субагентов можно использовать и в codex exec:

    codex exec --sandbox read-only \
      "Запусти двух субагентов test_scout, дождись обоих и верни итог." < /dev/null

    Здесь есть нюанс. В нашем тесте на Codex CLI 0.167 с флагом --ephemeral запуск субагента завершился ошибкой no rollout found for thread id. Без этого флага тот же запрос сработал. Перенаправление < /dev/null нужно, чтобы команда не ждала ввода из stdin.

    Как параллелить запись

    OpenAI советует начинать с задач на чтение и осторожно относиться к параллельным правкам. Если несколько агентов редактируют один код, возникают конфликты и лишние затраты на координацию.

    Безопасный порядок такой:

    1. Сначала разделите задачу на независимые части и назначьте каждой свои файлы.
    2. Запускайте запись в отдельных git worktree, чтобы агенты не мешали друг другу.
    3. Заранее определите способ объединения.
    4. После объединения запустите полную проверку.

    Если задачи затрагивают одни и те же файлы или зависят друг от друга, лучше выполняйте их последовательно.

    Когда субагенты не нужны

    ИспользуйтеНе используйте
    Ревью с разных сторонНебольшая правка в одном файле
    Поиск по большому репозиториюШаги, где каждый зависит от предыдущего
    Анализ длинных логовПравки одного участка кода
    Независимые модулиЗадача дешевле, чем её разделение

    Частые вопросы

    Сколько субагентов запускать? Столько, сколько есть действительно независимых частей. Лишний агент прибавит расход, но не качество.

    Может ли субагент вызывать MCP-инструменты? Да, он наследует MCP-серверы родителя.

    Видно ли, что делает субагент? Да, в CLI используйте /subagents.

    Работают ли субагенты через свой провайдер? Да, провайдер наследуется. Настройка провайдера из России описана в статье Как войти в Codex.

    Итог

    Начните с агентов только для чтения: они снижают шум в контексте и почти не создают рисков. Для повторяющихся задач оформите роль в .codex/agents/, а права задавайте на уровне родительской сессии. Свои роли, параллельные сценарии, хуки, worktree и паттерны оркестрации разбираем на практике в курсе «Продвинутый Codex».

    Иконка глаза7

    Комментарии

    0
    Бесплатный курс

    Учитесь программировать с AI-агентом — бесплатно

    Курс «AI в обучении: OpenCode и skills»: поставите агента и разберёте с ним любую тему — как эту статью.

    opencode

    >объясни этот код и дай задачу

    ◆Читаю src/server.ts…

    ✓Разбор готов: 4 шага

    ✓Задача → practice/01.md

    • Установка и настройка OpenCode
    • Агент и skills на практике
    • 13 уроков, 3 модуля
    Начать бесплатно

    0 ₽ · доступ сразу после регистрации

    Бесплатные лекции

    Лучшие курсы по теме

    изображение курса

    React и Redux Toolkit

    Антон Ларичев
    AI-тренажерыAI-тренажеры
    Практика в студииПрактика в студии
    Гарантия
    Бонусы
    иконка звёздочки рейтинга4.8
    3 999 ₽ 6 990 ₽
    Подробнее
    изображение курса

    Zustand

    Антон Ларичев
    AI-тренажерыAI-тренажеры
    Практика в студииПрактика в студии
    Гарантия
    Бонусы
    иконка звёздочки рейтинга4.8
    3 999 ₽ 6 990 ₽
    Подробнее
    изображение курса

    Neovim

    Антон Ларичев
    Гарантия
    Бонусы
    иконка звёздочки рейтинга4.8
    3 999 ₽ 6 990 ₽
    Подробнее

    Похожие статьи

    Картинка поста config.toml в Codex: настройки и профили
    Иконка аватараАнтон
    Иконка календаря19 ноября 2026
    CodexAI-инструментыНастройкаmiddleИконка уровня middle

    config.toml в Codex: настройки и профили

    Где находится config.toml в Codex, как устроен приоритет настроек, как создавать профили и менять значения для одного запуска.

    Иконка чипа0
    Иконка глаза59
    Иконка комментариев0
    Картинка поста /goal в Codex: как поручить агенту долгую задачу
    Иконка аватараАнтон
    Иконка календаря18 ноября 2026
    CodexAI-инструментыАвтоматизацияmiddleИконка уровня middle

    /goal в Codex: как поручить агенту долгую задачу

    Как работает /goal в Codex: включение, команды, формулировка цели с условием остановки и отличие от Ralph Loop.

    Иконка чипа0
    Иконка глаза114
    Иконка комментариев0
    Картинка поста Что такое Codex и как им пользоваться: руководство
    Иконка аватараАнтон
    Иконка календаря17 ноября 2026
    CodexOpenAIAI-инструментыjuniorИконка уровня junior

    Что такое Codex и как им пользоваться: руководство

    Что такое Codex от OpenAI, чем он отличается от чата, как поставить задачу и какие команды нужны в повседневной работе.

    Иконка чипа0
    Иконка глаза272
    Иконка комментариев0
    Иконка чипа0