Claude Code: CLAUDE.md, слэш-команды, субагенты, skills — в чём разница и когда что использовать
Claude Code даёт кучу способов «научить» его своему проекту. Но документация размазана, примеры абстрактные, и непонятно, зачем четыре разных механизма, если все вроде делают одно и то же?
Сам путался, пока не разобрался детально.
Проблема
Claude Code из коробки не знает специфику твоего проекта. Какую версию библиотеки используешь, какие паттерны приняты в команде, где лежит актуальная документация, ему неизвестно.
Результат: генерит устаревший код, игнорирует твои конвенции, каждый раз начинает с чистого листа.
Четыре способа это исправить
CLAUDE.md — файл, который загружается автоматически при каждом запуске. Это «память» проекта: правила, конвенции, ссылки на документацию. Один минус, в длинных сессиях Claude может «забывать» ранние инструкции.
Слэш-команды — сохранённые промпты, которые вызываешь через /имя-команды. Аналог макросов. Удобно для повторяющихся задач: загрузить доки, проверить код по чеклисту, сгенерить что-то по шаблону.
Субагенты — отдельные «агенты» с изолированным контекстом. Claude делегирует им задачу и получает сжатый результат обратно. Главный плюс — не засоряют основной контекст. Идеально для задач, где нужно много читать и анализировать.
Skills — структурированные воркфлоу, которые Claude обнаруживает автоматически по описанию задачи. Могут включать несколько файлов: документацию, скрипты, шаблоны.
Когда что использовать
Правила, которые Claude должен знать всегда → CLAUDE.md
Повторяемый воркфлоу по запросу → слэш-команда
Задача с большим объёмом чтения/анализа → субагент
Автоматический воркфлоу с доп. файлами → skill
Это краткая выжимка. В полном гайде — примеры кода для каждого механизма, диаграммы, сравнительная таблица и рекомендации по выбору.
Полный материал → у меня в телеграм канале