Субагенти Claude Code та Команди Агентів: Практичний Посібник

Ви бачили слова "субагенти", "Команди Агентів", "оркестрація" і задаєтеся питанням, чи не пропустили ви щось. Коротка відповідь: для більшості ваших завдань, ні. Але для великих робіт, так, і це варто зрозуміти.

Давайте розберемо це без жаргону.

Що таке субагент насправді

Субагент: це спеціалізований помічник з власним контекстом, власним запитом і власними дозволами на інструменти.

Коли головний агент стикається з чітко визначеним підзавданням, він передає його субагенту. Цей субагент працює у власному вікні контексту, виконує свою роботу і повертає лише результат. Головний агент не отримує всю його історію, що забруднює його контекст, він отримує висновок.

Це і є суть: зберегти контекст головного агента чистим. Замість одного агента, який тоне в 50,000 токенах пошуку файлів, у вас є субагент, який виконує пошук і повідомляє три корисні рядки.

Ви оголошуєте своїх субагентів у папці .claude/agents/ вашого проєкту. Кожен має ім'я, опис, коли його використовувати, і системний запит.

---
name: test-writer
description: Використовуйте, коли потрібно написати або виправити тести
---
Ви пишете тести. Ви прагнете покриття крайніх випадків,
а не щасливого шляху. Ви ніколи не торкаєтеся до коду в продакшені.

Команди Агентів, наступний крок

Команди Агентів: це мультиагентний оркестратор, вбудований у Claude Code. Все ще експериментальний, за замовчуванням вимкнений, але надійна відправна точка.

Ідея: провідний агент розділяє велике завдання, делегує кожен шматок спеціалізованому агенту (з власною моделлю, запитами, інструментами), спеціалісти працюють паралельно на спільній файловій системі, і результати повертаються до провідного.

Якщо "делегувати спеціалісту" звучить як субагенти, це нормально. Команди Агентів: це ідея, доведена до запуску кількох агентів дійсно паралельно, а не просто один за іншим.

Крім вбудованого, існують сторонні оркестратори, такі як Multiclaude і Gas Town. Вони мають свою думку, що робить їх хорошими відправними точками, коли ви починаєте: вони вирішують за вас, поки ви не виробите власні звички.

Коли це потрібно (і коли ні)

Давайте будемо чесними: мультиагентна оркестрація безглузда для 95% завдань з підтримкою агентів. Для більшості вашої щоденної роботи один агент швидший і простіший.

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

Вам це потрібно, коли:

• Проєкт розділяється на дійсно незалежні частини, які торкаються різних файлів.
• Одне вікно контексту не може вмістити все.
• Ви хочете паралелізувати широке рефакторинг або міграцію по всьому репозиторію.

Вам це не потрібно для виправлення помилок, зосередженої функції або чогось, що вміщується в одну голову.

Пастка полягає в тому, щоб запускати команду з десяти агентів для чогось, що один агент зробив би за п'ять хвилин. Ви платите токенами і складністю за паралелізм, якого завдання ніколи не вимагало.

Справжня проблема: видимість

Ось що не обговорюється достатньо. У момент, коли ви запускаєте кілька субагентів або Команду Агентів, ви втрачаєте нитку.

Провідний делегує п'ятьом спеціалістам. Хто працює? Хто закінчив? Хто чекає на рішення? У терміналі ви бачите стіну прокручуваного тексту і не можете сказати, хто що робить.

Тут візуальна панель змінює все. AgentsRoom показує кожного агента і кожного субагента як окрему плитку, з чітким статусом. Ви спостерігаєте за делегуванням, бачите, хто чекає на вашу відповідь, бачите, хто зламався. Стіна тексту стає читабельною картою.

Без цього виду мультиагентна оркестрація залишається вражаючою демонстрацією, яка є некерованою день у день. З нею вона стає інструментом, який ви дійсно використовуєте.

З чого почати

Не стрибайте відразу до команди з восьми агентів.

Почніть з одного або двох субагентів для точних, повторюваних завдань: одного, що пише тести, одного, що шукає в кодовій базі. Ви швидко відчуєте вигоду для контексту вашого головного агента.

Коли цей механізм стане природним, увімкніть Команди Агентів для роботи, яка чітко розділяється. Слідкуйте за тим, хто що робить, затверджуйте плани перед виконанням і зупиняйтеся в момент, коли огляд стає вашим вузьким місцем.

Мультиагентний підхід винагороджує тих, хто структурує перед запуском. Не тих, хто запускає найбільше агентів.