Субагенты vs Skills — когда что использовать (Гайд и обучение Claude Code)

В Claude Code два механизма расширяют возможности модели: субагенты и skills. Оба полезны, но решают разные задачи. Путаница между ними — главная причина, почему у людей «не работает ни то, ни другое».

Канал с гайдами и контентом по claude code, выкладываем новости (когда режут лимиты в 10 раз) и какие инструменты через claude реализуем для проектов, канал: https://t.me/claudedevolper

Короткое различие

Субагент — отдельный «подпроцесс» Claude с собственным контекстом. Ты даёшь ему задачу, он её решает изолированно и возвращает результат.
Skill — набор инструкций + файлов, который Claude подхватывает сам, когда видит подходящую задачу. Без изоляции контекста.

Простая аналогия: субагент — это подрядчик, которому ты делегируешь задачу. Skill — справочник, который лежит на полке, и Claude открывает его когда нужно.

Субагенты живут в отдельных файлах .claude/agents/*.md:

--- name: code-reviewer description: Reviews code for quality and security tools: Read, Grep, Glob, Bash --- Ты ревьюер. Проверяй код на: - Security issues (OWASP Top 10) - Performance проблемы - Читаемость - Покрытие тестами Возвращай отчёт в формате: ## Critical ... ## High ... ## Medium ...

Вызывается явно: «используй code-reviewer на файлах в src/auth/». Claude запускает субагента с чистым контекстом — он не видит историю твоего диалога.

Плюсы:

Чистый контекст — субагент не отвлекается на предыдущие задачи
Можно запустить несколько параллельно
У каждого свой набор разрешённых инструментов

Минусы:

Больше токенов (каждый субагент — отдельная сессия)
Нельзя запустить автоматически — только через явный вызов лидом

Skills лежат в .claude/skills/<name>/SKILL.md + опциональные файлы:

.claude/skills/tdd/ SKILL.md # инструкция templates/ test-template.ts

SKILL.md объявляет, когда скилл активируется:

--- name: tdd description: Test-driven development workflow triggers: ["TDD", "write test first", "red-green-refactor"] --- Когда пользователь просит TDD — следуй циклу: 1. RED: напиши падающий тест, не имплементируй 2. GREEN: минимум кода для прохождения теста 3. REFACTOR: убери дублирование ...

Claude сам решает, когда подключить скилл, по фразе-триггеру или явной команде /skill.

Плюсы:

Активируется автоматически по контексту
Шарится в команде через git
Легко читать и обновлять — это просто markdown

Минусы:

Работает в основной сессии — съедает общий контекст
Не подходит для тяжёлых задач с большим объёмом выгрузки файлов

| Задача | Механизм | |---|---| | Код-ревью на чистую голову | Субагент | | Параллельный дебаг с несколькими гипотезами | Субагенты | | Общий процесс разработки (TDD, commit-style) | Skill | | Генерация фронтенд-дизайна | Skill (как у frontend-design) | | Тяжёлая архитектурная задача на 30+ файлов | Субагент | | Шорткат для частой команды («перевод текста») | Skill |

Subagent model — отдельная настройка. По умолчанию у него та же модель что у лида, но можно зашить CLAUDE_CODE_SUBAGENT_MODEL=claude-sonnet-4-6 — дешевле.
Skills активируются не всегда. Исследования показывают ~20% срабатывания без hooks-принуждения. Для критичных скиллов нужен hook.
Нельзя из скилла вызвать субагента. А из субагента скилл — можно.

1. Начни со скилла: создай .claude/skills/quick-review/SKILL.md с короткой инструкцией 2. Потом сделай субагента: .claude/agents/security-check.md 3. Запусти обе на одном файле и сравни — что ловит каждый

Субагенты vs Skills — когда что использовать (Гайд и обучение Claude Code)

Субагент — когда грязный контекст мешает

Skill — когда нужна переиспользуемая экспертиза

Когда что выбирать

Подводные камни

Как попробовать