Кастомизация Claude Code - CLAUDE.md, слэш-команды, субагенты и навыки, как «научить» Claude Code вашему проекту

Кастомизация 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

Кастомизация Claude Code - CLAUDE.md, слэш-команды, субагенты и навыки, как «научить» Claude Code вашему проекту
Начать дискуссию