Субагенти в Claude Code для дизайнерів: шо це, нашо це, і три пастки, в які може влетіти кожен

💡 Усі статті, обговорення, новини про AI — в одному місці. Приєднуйтесь до AI спільноти!

всім привіт 🧡

бачу, шо про субагентів у Claude Code всі чули, але коли питаєш «а шо це і коли їх брати», починається туман. я довго з цим розбиралась, набила своїх шишок і зібрала все у великий гайд. сюди винесу базу, яка зекономить вам кілька вечорів.

Проблема, яку це вирішує

ви працюєте з Claude Code і впираєтесь у дві стіни.

перша: щоразу пояснюєте те саме. «не роби так», «перевір оце», «не вигадуй, якщо не знаєш». нова сесія, і все спочатку.

друга: просите прочитати тридцять файлів і знайти всі хардкоджені значення, і основна розмова тоне в логах. за десять хвилин Claude уже не пам’ятає, з чого ви починали.

на обидві стіни є відповідь: субагенти і скіли. і головне тут не плутати одне з іншим.

Субагент vs скіл: різниця, яку треба засвоїти першою

субагент це окрема голова для брудної роботи. він працює у власному контекстному вікні: свій системний промпт, свої інструменти, свої дозволи. Claude делегує йому задачу, той перелопачує гору файлів у себе, а вам повертає тільки підсумок. тридцять прочитаних файлів лишаються в його контексті. ваша розмова чиста.

скіл це пакет знань, який працює у вашій основній голові. папка з файлом SKILL.md, де лежить ваша процедура («як я роблю код-ревью», «як я роблю аудит»). написали один раз, і Claude підтягує сам, коли задача релевантна. без копіпасту в чат.

плутанина між цими двома збиває з пантелику найчастіше. запам’ятайте так: гора побічної роботи, яку вам потім не треба бачити, це субагент. інструкція, яку ви застосовуєте тут і зараз, це скіл.

Як виглядає субагент

це просто Markdown-файл у папці .claude/agents/ вашого проєкту: 👇

name: code-critic
description: Жорстка критика коду. Шукає проблеми, не хвалить.
Use PROACTIVELY після написання будь-якого коду.
tools: Read, Grep, Glob
model: sonnet
Ти безжальний критик. Твоя робота: знайти проблеми, не похвалити.
Для кожної проблеми: що конкретно, чому це проблема, одне виправлення.

все. поле description найважливіше в усьому файлі: саме за ним Claude вирішує, коли делегувати. розпливчасте «helps with code» не спрацює ніколи, пишіть тригерні фрази.

а тіло після frontmatter стає системним промптом агента. пишіть у наказовому: «ти робиш X, спочатку Y».

Тепер три пастки, на яких спотикаються всі

1. дефолтна модель НЕ sonnet, а inherit. субагент без явного model: бере модель основної сесії. сидите на opus, і ваш «дешевий» помічник мовчки побіжить на opus і спалить бюджет. ставте модель явно скрізь, де хочете контролювати витрати 🫣
2. пропустили tools, і агент успадкує ВСІ інструменти сесії. критик із правом Write почне «лагодити» код замість називати проблеми, і так їх від вас приховає. для критиків і аудиторів свідомо ріжте до read-only: Read, Grep, Glob.
3. створили папку .claude/agents/ посеред сесії, а Claude її не бачить. Claude Code стежить тільки за папками, які існували на старті сесії. правки в наявних файлах агентів підхоплюються на льоту, за кілька секунд, без перезапуску. а от якщо папки agents не було, коли ви запустили сесію, перший агент у ній не завантажиться, поки не перезапуститесь. виглядає як «я все зробила правильно, а воно не працює», і люди йдуть переписувати description, хоча треба просто рестартнути.

І чесне слово про економію

виклик субагента не безкоштовний: перед роботою він вантажить свій промпт плюс усю ієрархію CLAUDE.md. на малих задачах (прочитати два файли, переписати рядок) субагент ДОРОЖЧИЙ за пряме виконання. делегуйте, коли брудної роботи реально багато: десяток+ файлів або гора логів, які вам потім не знадобляться. тоді стартовий оверхед окупається.

і в системному промпті агента прямо пишіть: «поверни тільки список знахідок, не дамп логів». бо його відповідь усе одно вливається назад у вашу розмову. конвеєр з трьох агентів по 2000 токенів на звіт за десять циклів з’їсть 60к вашого вікна.

от і все з базою.

у повному гайді є ментальна модель «субагент vs скіл vs слеш-команда vs CLAUDE.md vs MCP» з картою рішень, вісім готових субагентів і п’ять скілів copy-paste, і розбір, де це все ламається насправді.
повний гайд можна прочитати в моєму каналі 🧡