Tips & Tricks Claude Code: субагенты и параллельная работа
Представьте: у вас монорепо на 15 сервисов, и нужно найти все места где используется устаревший API-метод. Можно запустить одну команду и ждать пока Claude последовательно пройдётся по каждой директории. А можно сказать ему «разделяй и властвуй» — и он буквально клонирует себя на несколько параллельных процессов.
Звучит как фантастика? Не, это субагенты в Claude Code.
Что такое субагенты
Субагенты — это способность Claude Code порождать свои копии, каждая из которых работает в изолированом контексте. Грубо говоря вы просите: «Эй, мне нужно проверить 5 директорий» — и вместо одного агента который ходит по ним по очереди, запускаются 5 параллельных «работников».
Самый простой пример:
> use subagents to search these 5 directories for deprecated API calls: src/api, src/utils, src/cli, src/auth, src/workers
В терминале вы увидите что-то типа:
╭──────────────────────────────────────────────╮ │ ◐ agent-1 · scanning api │ │ ◐ agent-2 · scanning utils │ │ ◐ agent-3 · scanning cli │ │ ◐ agent-4 · scanning auth │ │ ◐ agent-5 · scanning workers │ ╰──────────────────────────────────────────────╯
Каждый агент работает независимо, результаты собираются в один отчёт. Вместо 5 минут последовательного сканирования — всё за одну.
Тут есть нюанс: субагенты работают в изолированном контексте. Agent-1 не знает что нашёл agent-3. Они не общаются между собой, только отдают результат «наверх».
Кастомные агенты: собираем свою команду
Теперь самое интересное. Можно не просто запускать паралельный поиск, а создать специализированных агентов — каждый со своей ролью, инструментами и инструкциями.
Для этого в корне проекта создаём директорию .claude/agents/ и кладём туда файлы:
.claude/agents/ ├── test-runner.md ├── code-reviewer.md └── docs-writer.md
Каждый файл описывает поведение агента. Вот например code-reviewer.md:
Code Reviewer Agent You are a senior code reviewer. Focus on: - Security vulnerabilities - Performance bottlenecks - Naming conventions and code style - Missing error handling When reviewing, always check for: - SQL injection possibilities - Unvalidated user input - Memory leaks in event listeners Output format: list issues by severity (critical, warning, info)
test-runner.md может выглядеть так:
Test Runner Agent You run and analyze test suites. Your workflow: - Identify test files related to changed code - Run relevant tests - If tests fail, analyze the failure and suggest fixes - Report coverage changes
Дальше управлять агентами можно через команду /agents прямо в Claude Code.
Devhack: хороший паттерн — создать агента-«тимлида», который распределяет задачи между другими агентами. Он анализирует PR и решает кого из специалистов вызвать: ревьюера, тестировщика или документатора. На практике это реально экономит кучу времени.
Параллельные сессии с worktree
Ок субагенты — это параллелизм внутри одной сессии. Но иногда нужно больше: работать на разных git-ветках одновременно.
Для этого есть флаг --worktree:
claude --worktree
Что происходит под капотом: Claude создаёт git worktree — полноценную рабочую копию репозитория в отдельной директории. Это уже не изолированный контекст а полноценная параллельная сессия с отдельной веткой.
Когда это полезно:
- Фиксите баг в hotfix ветке, пока другая сессия пишет фичу в feature/new-ui
- Параллельно тестируете два разных подхода к решению задачи
- Один агент рефакторит модуль, другой обновляет тесты под новый API
Терминал 1: работаем над фичей claude --worktree "implement caching layer for /api/users" # Терминал 2: фиксим баг на проде claude --worktree "fix race condition in payment processing"
Имейте в виду — worktree создаёт реальные копии файлов на диске. На больших репозиториях это может занять ощутимое место, так что не забывайте чистить неиспользуемые worktree через git worktree remove.
Когда что использовать
Короткая шпаргалка:
Субагенты (параллелизм внутри сессии) — для задач которые можно разбить на независимые части в рамках одной ветки. Поиск по коду, анализ нескольких модулей, массовый рефакторинг однотипных файлов.
Кастомные агенты (.claude/agents/) — когда нужны специализированые роли с разным поведением. Ревью, тесты, документация — каждый знает своё дело.
Worktree (--worktree) — когда задачи требуют разных git-веток. Параллельная разработка фич, A/B-тестирование подходов одновременная работа над hotfix и feature.
Практический пример: ревью PR силами команды агентов
Допустим прилетел большой PR. Вместо того чтобы просить Claude «посмотри PR», можно организовать полноценое ревью:
Review this PR using subagents: - agent 1: check for security issues in src/ - agent 2: run and analyze test results - agent 3: review API contract changes in api/ - agent 4: check for breaking changes in public interfaces
Каждый агент фокусируется на своей области и выдаёт заключение. На выходе — структурированный отчёт, а не простыня текста.
Субагенты — это как по мне одна из самых недооценённых возможностей Claude Code. Большинство разработчиков юзают его как «умный автокомплит», хотя на деле это целый оркестр которым можно дирижировать. Попробуйте начать с простого — запустите параллельный поиск по нескольким директориям — и сразу почувствуете разницу.