Кастомизация Claude Code - CLAUDE.md, слэш-команды, субагенты и навыки, как «научить» Claude Code вашему проекту
CLAUDE.md, слэш-команды, субагенты и навыки — как «научить» Claude Code вашему проекту
Канал с гайдами и контентом по ИИшкам и что с ними можно реализовывать, мы выписываем абсолютно всю базу по ИИ в наш канал и там другие полезные материалы: https://t.me/claudedevolper
00 Введение
Claude Code предлагает несколько способов «обучить» его контексту проекта и автоматизировать рабочие процессы. Но не всегда очевидно, когда какой механизм использовать. В этом гайде мы разберём все четыре подхода на конкретном примере.
Проблема
Claude Code не имеет актуальных данных для каждой библиотеки — он не может «помнить», что написано на сайте документации сегодня. Рассмотрим конкретный сценарий:
Пример: приложение с Reatom v1000
Вы разрабатываете SPA с Reatom — мощным стейт-менеджером для React. Claude не знает про новые API v1000: reatomComponent, расширения через .extend(), встроенные формы и роутинг.
Давайте решим эту задачу четырьмя способами и сравним их.
Краткий обзор механизмов
CLAUDE.md
Загружается автоматически при каждом запуске
Слэш-команды
Вызываются вручную через /команда
Субагенты
Отдельное контекстное окно для задачи
Навыки (Skills)
Автообнаружение по описанию задачи
01 CLAUDE.md — память проекта
Что это такое
Markdown-файл, который автоматически загружается при каждом запуске Claude Code. Это «карта памяти» вашего проекта — всё, что Claude должен знать с самого начала.
Где располагается
Вложенные CLAUDE.md
Claude Code обнаруживает файлы CLAUDE.md в подкаталогах. Когда Claude читает файлы из директории с собственным CLAUDE.md, он автоматически добавляется в контекст. Полезно для специфичных инструкций: tests/CLAUDE.md — правила тестирования, src/store/CLAUDE.md — паттерны работы со стейтом.
Решение для Reatom
CLAUDE.md## Стейт-менеджмент Мы используем Reatom v1000 для управления состоянием. Перед написанием любого кода для стейта:
1. Загрузи документацию: https://v1000.reatom.dev/llms.txt
2. Используй `reatomComponent` вместо обычных хуков
3. Расширяй атомы через `.extend()` для добавления методов
4. Используй `computed` для производных состояний
5. Следуй паттернам в `src/store/`
Что происходит
Каждый разговор начинается с того, что Claude знает: «загрузи документацию Reatom перед написанием кода для стейта».
Context Drift (Дрейф контекста)
В длинных сессиях модель может постепенно «забывать» ранние инструкции в пользу недавней истории разговора. Для критичных правил рассмотрите другие механизмы.
- Без усилий — загружается автоматически
- Шарится через git между командой
- Простота поддержки
- Дрейф контекста в длинных сессиях
- Нет отдельного окна — конкурирует с разговором
- Нет принуждения — Claude решает, следовать ли
02 Слэш-команды
Что это такое
Сохранённый промпт, который вызывается командой /имя-команды. Аналог макроса или горячей клавиши для промптов. Слэш-команды можно вызывать явно (вы вводите /команда) или они могут автоматически срабатывать, если описание команды совпадает с задачей.
Где располагается
Решение для Reatom
---description: Помощь по Reatom с актуальной документацией allowed-tools: Read, Grep, Glob, WebFetch--- Сначала загрузи документацию Reatom v1000: https://v1000.reatom.dev/llms.txt Затем, исходя из вопроса пользователя, загрузи соответствующие страницы документации. Наконец, ответь на вопрос, используя актуальную документацию: $ARGUMENTS
Как использовать
/reatom-help как создать форму с валидацией?
Оркестрация через слэш-команды
Слэш-команды могут запускать субагентов, вызывать навыки и организовывать пайплайны (исследование → сканирование кодовой базы → написание документа) вместо выполнения всего за один шаг.
- Полный контроль момента запуска
- Поддержка аргументов для вопросов
- Простая настройка одним файлом
- Нужно помнить команду
- Разовый запуск — не сохраняет знания
- Автозапуск зависит от описания
03 Субагенты
Что это такое
Специализированная AI-«персона» с собственным контекстным окном. Claude делегирует ей целые задачи и получает результаты обратно.
Ключевое преимущество
Субагенты сохраняют ваш основной контекст чистым. Поскольку загрузка документации создаёт много «шума», изоляция в субагенте предотвращает переполнение лимитов контекста в основном чате.
Где располагается
Диаграмма взаимодействия
Решение для Reatom
---name: reatom-specialist description: Эксперт по Reatom и реактивному стейту allowed-tools: Read, Grep, Glob, WebFetch---# Специалист по Reatom Ты — эксперт по Reatom v1000. При получении задачи: 1. Загрузи https://v1000.reatom.dev/llms.txt 2. Найди релевантные страницы документации 3. Загрузи только необходимые страницы 4. Используй паттерны: atom, computed, effect, extend 5. Верни сжатый ответ с примерами кода
Асинхронные агенты
Claude Code поддерживает асинхронных агентов: запустите агента и продолжайте работать, пока он выполняется в фоне. Для отправки в фон используйте Ctrl + B.
- Автоделегирование по типу задачи
- Изолированный контекст — не засоряет основной
- Можно использовать другую модель (opus)
- Ограничение инструментов для безопасности
- Тяжелее — запуск отдельного агента
- Результаты приходят как саммари
- Нет прямого взаимодействия с агентом
- Сложнее в настройке
04 Навыки (Skills)
Что это такое
Структурированная возможность с опциональными вспомогательными файлами, которую Claude автоматически обнаруживает и использует в основном разговоре. В отличие от простых слэш-команд, навыки могут включать несколько файлов: справочную документацию, скрипты, шаблоны.
Где располагается
Как Claude видит навыки
Claude решает, применять ли навык, основываясь на его description. Вы можете спросить Claude Code:
> "покажи мне как выглядит ?"
Он покажет структурированные блоки:
reatom-expert Помощь по Reatom v1000. Используй при работе с атомами, computed, формами, роутингом...
Решение для Reatom
---name: reatom-expert description: Помощь по Reatom v1000. Используй при работе с атомами, computed, effect, формами, роутингом или расширениями. allowed-tools: Read, Grep, Glob, WebFetch---# Эксперт по Reatom Когда пользователю нужна помощь с Reatom: 1. Загрузи https://v1000.reatom.dev/llms.txt 2. Загрузи только релевантные страницы 3. Применяй паттерны: atom, computed, reatomComponent 4. Используй .extend() для добавления методов к атомам
- Автообнаружение по описанию
- Работает в основном разговоре — живое взаимодействие
- Поддержка вспомогательных файлов и скриптов
- Глубокая упаковка воркфлоу
- Занимает место в основном контексте
- Claude решает, когда применять
- Больше настройки, чем слэш-команды
- Нельзя вызвать через
06 Выводы
Главный инсайт
Для задач с загрузкой документации субагенты выигрывают, потому что сохраняют ваш основной контекст чистым. В plan mode Claude Code обычно делегирует сканирование репозитория Explore-субагенту.
Рекомендации
Субагенты
Используйте (особенно Explore в plan mode) для сохранения контекста маленьким и сфокусированным
Слэш-команды
Когда нужна явная, повторяемая точка входа в терминале
Навыки
Когда Claude должен автоматически применять богатый воркфлоу (часто с доп. файлами)
CLAUDE.md
Для коротких, всегда-истинных конвенций и стандартов проекта
Канал с гайдами и контентом по claude code, выкладываем новости (когда режут лимиты в 10 раз) и какие инструменты через claude реализуем для проектов, канал: https://t.me/claudedevolper