Навыки, CLAUDE.md, под-агенты, хуки или MCP: когда что использовать

Claude Code имеет пять уровней кастомизации. CLAUDE.md, Skills, под-агенты, хуки и MCP-серверы. Выберите не тот, и вы получите Skill, который никогда не срабатывает, хук, выполняющий работу под-агента, или CLAUDE.md настолько раздутый, что он съедает половину вашего контекста до того, как вы начнете печатать.

Вот где находится каждый из них.

CLAUDE.md

Загружается в каждый разговор. Используйте его для правил, которые вы никогда не хотите пропускать, например, «строгий режим TypeScript» или «никогда не трогайте схему базы данных».

Если правило имеет значение только иногда, оно не должно быть здесь. Вы заплатите токенами за него при каждом запросе.

Рекомендация Anthropic — держать CLAUDE.md менее чем в 200 строк. Для каждой строки спросите, приведет ли ее удаление к ошибкам Claude. Если нет, удалите ее. Раздутый CLAUDE.md не заставляет Claude соблюдать больше правил, он заставляет Claude игнорировать половину из них, потому что важные теряются в шуме.

Если он вырастет более чем на 200 строк, официальное руководство предлагает переместить справочный контент в Skills или разделить на файлы .claude/rules/, которые загружаются только тогда, когда Claude работает с соответствующими путями.

Skills

Markdown-файлы, которые Claude автоматически загружает, когда запрос соответствует описанию в их frontmatter. Правильное место для чек-листов обзора PR, процедур выпуска, соглашений по библиотекам, всего, что связано с конкретной задачей.

Описание должно охватывать две вещи: что делает навык и когда его использовать. Пропустите «когда», и Claude никогда не загрузит навык, какой бы хорошей ни была его основная часть. Поставьте основной вариант использования первым, поскольку описание ограничено 1536 символами в списке навыков.

У основной части есть свой лимит. Anthropic рекомендует держать SKILL.md менее чем в 500 строк и перемещать длинный справочный материал в отдельные файлы, на которые ссылается навык. Как только навык загружен, его контент остается в контексте до конца сессии, поэтому каждая строка — это повторяющаяся стоимость токенов.

Subagents

Работают в своем собственном контекстном окне. Вы передаете им задачу, они работают независимо со своим собственным бюджетом токенов, и вы получаете результат обратно.

Лучше всего подходит для параллельных исследований, изоляции шумной работы или задач, требующих инструментов, которые вы не хотите иметь в основной сессии. Координация нескольких одновременно требует некоторой осторожности, поскольку они не разделяют состояние.

Под-агенты также могут использовать Skills, но их нужно явно подключать с помощью поля skills в frontmatter. В отличие от основной сессии, описания навыков не загружаются автоматически в под-агент, поэтому срабатывание по совпадению описания не происходит само по себе.

Hooks

Инструкции CLAUDE.md носят рекомендательный характер, Claude решает, следовать ли им. Хуки детерминированы. Событие срабатывает, хук выполняется, без каких-либо суждений. Это единственные из пяти, которые полностью обходят модель.

События, на которые большинство людей реагируют, это PreToolUse (проверка или блокировка вызова инструмента перед его выполнением), PostToolUse (реакция после вызова инструмента, например, линтинг файлов, которые Claude только что отредактировал), UserPromptSubmit (перехват того, что отправляется Claude) и SessionStart (загрузка контекста один раз за сессию).

Вот почему хуки — правильное место для защитных механизмов. «Никогда не редактируйте .env» в CLAUDE.md или Skill — это запрос. Хук PreToolUse, который блокирует редактирование, — это принуждение.

Если ваше правило гласит: «выполнять X каждый раз, когда Claude делает Y», это хук. Линтеры, форматтеры, валидаторы, аудит логов.

MCP servers

Остальные четыре формируют мышление Claude. MCP дает Claude новые возможности, такие как взаимодействие с API, базами данных или внутренними системами. Иногда достаточно CLI, иногда вам действительно нужен MCP-сервер.

Как они сочетаются

• CLAUDE.md для жестких правил
• Skills для процедур и знаний предметной области
• Subagents для делегированной работы
• Hooks для автоматических побочных эффектов
• MCP servers для внешнего мира

Ловушка в том, чтобы сваливать все в Skills. Ограничение, которое всегда применяется, по-прежнему относится к CLAUDE.md. Побочный эффект при сохранении файла по-прежнему относится к хуку.

Для полной версии бесплатный курс Anthropic «Введение в навыки агентов» на Skilljar охватывает всю рубрику, а трехминутное видео охватывает ее за то время, которое требуется для заваривания кофе.