Несколько агентов Claude Code параллельно: как запустить

Запуск нескольких агентов Claude Code параллельно через терминалы, tmux, git worktree или десктопное приложение, без конфликтов слияния, лимитов и лишних токенов.

Solviera Teknoloji 7 мин чтения

Одна сессия Claude Code выполняет задачу шаг за шагом. Пока она читает файлы и запускает тесты, вы ждёте. Если запустить несколько агентов Claude Code параллельно, это время превращается в работу: один агент строит API, другой пишет тесты, третий чинит баг, не связанный ни с тем ни с другим.

В статье мы идём от самой простой настройки к самой удобной: обычные терминалы, tmux, git worktree, собственные параллельные сессии Claude Code и, наконец, AgentVera. Каждый шаг добавляет то, чего не хватало предыдущему. В конце список подводных камней, которые обычно кусаются: конфликты слияния, лимиты и токены.

Можно ли запускать больше одного агента Claude Code одновременно?

Да. Claude Code — это CLI; каждый запуск claude открывает независимую сессию со своим диалогом и контекстом. Ничто не мешает запустить пять. Проблемы возникают не при запуске, а при координации: две сессии в одной папке с удовольствием отредактируют один и тот же файл, а все сессии, вошедшие в один аккаунт, делят его лимиты.

Так что настоящий вопрос в том, как разделить агентов и как за ними следить.

Вариант 1: отдельные окна терминала

Самая быстрая настройка — вкладка терминала на каждого агента:

# tab 1
cd ~/code/acme-web && claude
# tab 2
cd ~/code/acme-web && claude

Это работает для небольших, чётко разделённых задач. В первом сообщении скажите каждому агенту, какие папки ему можно трогать («только src/api/», «только tests/»).

Минусы проявляются быстро: вы не видите, какая вкладка ждёт подтверждения, обе сессии делят одну рабочую копию, а когда один агент выполняет git checkout, другой внезапно оказывается на другой ветке.

Вариант 2: tmux

tmux сохраняет сессии, когда вы закрываете терминал, и показывает несколько панелей сразу:

tmux new-session -d -s agents -c ~/code/acme-web
tmux split-window -h -t agents -c ~/code/acme-web
tmux send-keys -t agents:0.0 'claude' Enter
tmux send-keys -t agents:0.1 'claude' Enter
tmux attach -t agents

Теперь оба агента видны рядом и переживают закрытую крышку ноутбука (пока машина остаётся включённой). tmux решает вопрос обзора, но не изоляции: обе панели по-прежнему правят одну папку.

Вариант 3: git worktree на каждого агента

Git worktree — стандартный ответ на «два агента, один репозиторий». Worktree — это вторая рабочая папка на своей ветке, использующая ту же историю .git:

cd ~/code/acme-web
git worktree add ../acme-web-api -b feat/api
git worktree add ../acme-web-tests -b feat/tests

cd ../acme-web-api && claude     # agent 1
cd ../acme-web-tests && claude   # agent 2

Теперь у каждого агента свои файлы и своя ветка. git checkout или недописанный файл одного агента не влияют на другого. Когда агент закончил, его ветка сливается как любая feature-ветка.

Несколько практических замечаний:

  • Устанавливайте зависимости в каждом worktree. node_modules, виртуальные окружения и результаты сборки не общие. Запустите pnpm install (или аналог) в каждой новой папке.
  • Копируйте локальную конфигурацию. Файлы .env обычно игнорируются git, поэтому в новом worktree их нет.
  • Порты конфликтуют. Два dev-сервера на порту 3000 не запустятся; дайте каждому worktree свой порт.
  • Убирайте за собой. git worktree remove ../acme-web-api после слияния ветки и git worktree prune для папок, удалённых вручную.

Подробности в статье о git worktree для параллельных агентов.

Вариант 4: собственные параллельные сессии Claude Code

Десктопное приложение Claude Code от Anthropic умеет запускать параллельные сессии Claude, каждую в своём worktree, и вам не нужно вводить git-команды. Если вы пользуетесь только Claude и хотите официальный инструмент, это разумная остановка. Оно закрывает изоляцию и базовый обзор.

Чего оно не пытается делать: запускать рядом с Claude другие CLI, такие как Codex или Gemini CLI, автоматически передавать вывод одного агента другому или переводить агента на другой аккаунт, когда лимит заканчивается. Здесь на сцену выходит специальное приложение для нескольких агентов. Сравнение вариантов смотрите в статье лучшие инструменты для параллельного запуска ИИ-агентов.

Вариант 5: AgentVera

AgentVera открывает команду claude на вашей машине в настоящих терминалах и раскладывает агентов сеткой по проектам. Он использует собственный вход Claude Code, так что ваш тариф Pro или Max работает как есть. Вот как прежние проблемы сопоставляются с его функциями:

ПроблемаВ AgentVera
Не видно, какому агенту вы нужныСетка от 1×1 до 5×4; каждая панель показывает статус и размер контекста в реальном времени; агенты, ждущие подтверждения, перечислены в строке состояния
Агенты правят одни и те же файлыПанель worktree: создайте worktree из ветки и запустите агента сразу в нём
Два агента всё равно трогают один файлПредупреждение о конфликте файлов: когда два агента правят один файл в одной папке, об этом узнают и агент, и вы; ничего не блокируется
Вывод приходится копировать вручнуюFlows отправляют ответ одного агента другому через шаблон
Лимит заканчивается посреди задачиПереключение аккаунтов переводит агента на следующий аккаунт Claude и копирует диалог
Контекст растёт с каждым ходомАвтоматический /compact по заданному вами порогу, плюс профили контекста

Шаг за шагом

  1. Добавьте папку проекта. Выберите её на экране проектов. Рекомендуется репозиторий Git.

  2. Создайте worktree. В правой панели откройте список worktree и создайте по одному на задачу из новой ветки, например feat/api и feat/tests.

  3. Откройте агентов. В разделе New agent выберите Claude Code, укажите worktree и дайте агенту имя, модель, effort и короткую роль:

    Work only under src/api/. Don't change tests.
    Run pnpm test api after each change.
    Finish with a bullet list of what you changed.
  4. Разложите сетку. Раскладка 2×2 подходит для двух агентов Claude, ревьюера Codex и терминала с dev-сервером.

  5. Свяжите их при необходимости. Flow может отправить итоговое сообщение агента API агенту тестов, когда тот закончит ход. Лимит ходов не даёт двум агентам зациклиться.

  6. Проверьте и слейте. Автоматическое ревью кода проверяет каждый завершённый ход. Панель Git показывает изменения каждого worktree и насколько он опережает main; сливайте по одной ветке.

Сетка, worktree и ревью кода есть в бесплатном тарифе. Flows и переключение аккаунтов — в Pro.

Подводные камни и как их обойти

Конфликты слияния

Worktree не дают агентам перезаписывать друг друга во время работы; они не предотвращают конфликты при слиянии. Два агента, правящих src/routes.ts в разных ветках, всё равно получат конфликт в конце.

  • Делите задачи по папкам или модулям, а не только по веткам.
  • Общие файлы (таблицы маршрутов, схемы, lock-файлы) отдавайте одному агенту.
  • Сначала сливайте меньшую ветку, затем сделайте rebase другого worktree на main и пусть его агент исправит конфликт: git rebase main внутри этого worktree, затем попросите агента разрешить конфликт и снова запустить тесты.

Лимиты использования

Все сессии одного аккаунта делят одни и те же 5-часовой и недельный лимиты. Четыре агента не получают в четыре раза больше квоты; они упираются в лимит в четыре раза быстрее. Регулярно проверяйте /usage в Claude Code и планируйте тяжёлые параллельные сессии в начале окна лимита. Если у вас законно больше одного аккаунта (скажем, личный и рабочий) и условия провайдера это разрешают, переключение аккаунтов продолжает задачу, когда один заканчивается. Подробнее в статье о лимитах использования Claude Code.

Расход токенов

У каждого агента свой контекст: системный промпт, описания инструментов, CLAUDE.md, MCP-серверы и каждый прочитанный файл. Эта база перечитывается на каждом ходу, для каждого агента.

  • Давайте агентам узкие, конкретные задачи, чтобы они читали меньше файлов.
  • Запускайте /compact, пока длинный диалог не стал дорогим, или пусть он срабатывает автоматически по порогу.
  • Отключайте MCP-серверы, которые агенту не нужны.
  • При передаче вывода между агентами отправляйте итог, а не весь транскрипт.

Измеренные цифры смотрите в статье как снизить расход токенов в Claude Code.

Подтверждения, которые блокируют

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

Слишком много агентов слишком рано

Узкое место смещается от агентов к вам. Ревью четырёх веток занимает больше времени, чем одной. Начните с двух агентов на явно разных задачах и добавьте третьего, когда это заработает.

Минимальный чек-лист

  • Один worktree на каждого агента, который может затронуть общий код
  • Зависимости установлены, а .env скопирован в каждый worktree
  • Роль каждого агента называет его папки и цель
  • Отдельные порты для dev-серверов
  • План слияния: какая ветка первой, кто разрешает конфликты
  • Глаз на /usage и размере контекста

Итоги

Параллельный запуск нескольких агентов Claude Code — это в основном изоляция и внимание. Worktree дают каждому агенту свои файлы; tmux или сетка позволяют видеть всех; короткие роли и план слияния делают результат проверяемым. Для старта хватит обычных терминалов и worktree. Когда понадобятся сетка, flows между агентами и помощь с лимитами, скачайте AgentVera бесплатно и откройте первых двух агентов Claude Code. Об общем методе читайте в статье параллельные кодинг-агенты.

Вопросы

Можно ли запустить две сессии Claude Code в одной папке?

Да, Claude Code запустится, но обе сессии будут править одни и те же файлы и видеть чужие недописанные изменения. Дайте каждой сессии свой git worktree или хотя бы строгую границу по папкам.

Делят ли несколько агентов Claude Code один лимит использования?

Да. Все сессии, вошедшие в один аккаунт, расходуют одни и те же 5-часовой и недельный лимиты, поэтому четыре агента исчерпывают их примерно в четыре раза быстрее.

Сколько агентов Claude Code можно запускать одновременно?

Жёсткого ограничения в самом Claude Code нет. На практике один человек успевает следить за двумя-четырьмя; реальный потолок задают лимиты и время на ревью.

Как слить работу параллельных агентов Claude Code?

Относитесь к каждому worktree как к обычной ветке: запустите там тесты, сделайте push и откройте pull request или слейте локально. Сливайте по одной ветке и после каждой снова запускайте тесты.

Соберите своих агентов за одним столом.

Скачайте AgentVera бесплатно; ваши установленные CLI уже готовы к работе.

Другие статьи