Перейти к основному содержанию
Claude Code объединяет модель, которая рассуждает о вашем коде, с встроенными инструментами для операций с файлами, поиска, выполнения и веб-доступа. Встроенные инструменты охватывают большинство задач кодирования. Это руководство охватывает уровень расширения: функции, которые вы добавляете для настройки того, что знает Claude, подключения его к внешним сервисам и автоматизации рабочих процессов.
Информацию о том, как работает основной цикл агента, см. в разделе How Claude Code works.
Новичок в Claude Code? Начните с CLAUDE.md для соглашений проекта. Добавляйте другие расширения по мере необходимости.

Обзор

Расширения подключаются к различным частям цикла агента:
  • CLAUDE.md добавляет постоянный контекст, который Claude видит в каждой сессии
  • Skills добавляют переиспользуемые знания и вызываемые рабочие процессы
  • MCP подключает Claude к внешним сервисам и инструментам
  • Subagents запускают свои собственные циклы в изолированном контексте, возвращая резюме
  • Agent teams координируют несколько независимых сессий с общими задачами и обменом сообщениями между участниками
  • Hooks работают полностью вне цикла как детерминированные скрипты
  • Plugins и marketplaces упаковывают и распространяют эти функции
Skills — это наиболее гибкое расширение. Skill — это файл markdown, содержащий знания, рабочие процессы или инструкции. Вы можете вызывать skills с помощью команды типа /deploy, или Claude может загружать их автоматически, когда они релевантны. Skills могут работать в вашем текущем разговоре или в изолированном контексте через subagents.

Сопоставьте функции с вашей целью

Функции варьируются от всегда включённого контекста, который Claude видит в каждой сессии, до возможностей по требованию, которые вы или Claude можете вызвать, до фоновой автоматизации, которая работает при определённых событиях. Таблица ниже показывает, что доступно и когда каждое имеет смысл.
ФункцияЧто она делаетКогда её использоватьПример
CLAUDE.mdПостоянный контекст, загружаемый в каждом разговореСоглашения проекта, правила “всегда делай X""Используйте pnpm, а не npm. Запускайте тесты перед коммитом.”
SkillИнструкции, знания и рабочие процессы, которые может использовать ClaudeПереиспользуемый контент, справочные документы, повторяющиеся задачи/deploy запускает ваш контрольный список развёртывания; skill с документацией API с шаблонами конечных точек
SubagentИзолированный контекст выполнения, который возвращает обобщённые результатыИзоляция контекста, параллельные задачи, специализированные работникиЗадача исследования, которая читает много файлов, но возвращает только ключевые выводы
Agent teamsКоординируют несколько независимых сессий Claude CodeПараллельное исследование, разработка новых функций, отладка с конкурирующими гипотезамиЗапустите рецензентов для одновременной проверки безопасности, производительности и тестов
MCPПодключение к внешним сервисамВнешние данные или действияЗапрос к вашей базе данных, отправка в Slack, управление браузером
HookДетерминированный скрипт, который работает при событияхПредсказуемая автоматизация, без участия LLMЗапуск ESLint после каждого редактирования файла
Plugins — это уровень упаковки. Plugin объединяет skills, hooks, subagents и MCP servers в единый устанавливаемый модуль. Plugin skills имеют пространство имён (например, /my-plugin:review), поэтому несколько plugins могут сосуществовать. Используйте plugins, когда вы хотите переиспользовать одну и ту же настройку в нескольких репозиториях или распространять другим через marketplace.

Сравните похожие функции

Некоторые функции могут казаться похожими. Вот как их различить.
Skills и subagents решают разные проблемы:
  • Skills — это переиспользуемый контент, который вы можете загрузить в любой контекст
  • Subagents — это изолированные работники, которые работают отдельно от вашего основного разговора
АспектSkillSubagent
Что этоПереиспользуемые инструкции, знания или рабочие процессыИзолированный работник со своим собственным контекстом
Ключевое преимуществоПоделитесь контентом между контекстамиИзоляция контекста. Работа происходит отдельно, возвращается только резюме
Лучше всего дляСправочный материал, вызываемые рабочие процессыЗадачи, которые читают много файлов, параллельная работа, специализированные работники
Skills могут быть справочными или действенными. Справочные skills предоставляют знания, которые Claude использует на протяжении вашей сессии (например, ваше руководство по стилю API). Action skills говорят Claude сделать что-то конкретное (например, /deploy, который запускает ваш рабочий процесс развёртывания).Используйте subagent, когда вам нужна изоляция контекста или когда ваше окно контекста переполняется. Subagent может читать десятки файлов или выполнять обширные поиски, но ваш основной разговор получает только резюме. Поскольку работа subagent не потребляет ваш основной контекст, это также полезно, когда вам не нужно, чтобы промежуточная работа оставалась видимой. Пользовательские subagents могут иметь свои собственные инструкции и могут предварительно загружать skills.Они могут объединяться. Subagent может предварительно загружать определённые skills (поле skills:). Skill может работать в изолированном контексте, используя context: fork. Подробнее см. в разделе Skills.

Поймите, как функции слоятся

Функции могут быть определены на нескольких уровнях: для всех пользователей, для каждого проекта, через plugins или через управляемые политики. Вы также можете вложить файлы CLAUDE.md в подкаталоги или разместить skills в определённых пакетах monorepo. Когда одна и та же функция существует на нескольких уровнях, вот как они слоятся:
  • Файлы CLAUDE.md являются аддитивными: все уровни одновременно вносят контент в контекст Claude. Файлы из вашего рабочего каталога и выше загружаются при запуске; подкаталоги загружаются по мере работы в них. Когда инструкции конфликтуют, Claude использует суждение для их согласования, при этом более специфичные инструкции обычно имеют приоритет. Подробнее см. в разделе как загружаются файлы CLAUDE.md.
  • Skills и subagents переопределяют по имени: когда одно и то же имя существует на нескольких уровнях, одно определение побеждает на основе приоритета (управляемый > пользователь > проект для skills; управляемый > флаг CLI > проект > пользователь > plugin для subagents). Plugin skills имеют пространство имён для избежания конфликтов. Подробнее см. в разделах обнаружение skills и область subagent.
  • MCP servers переопределяют по имени: локальный > проект > пользователь. Подробнее см. в разделе область MCP.
  • Hooks объединяются: все зарегистрированные hooks срабатывают для своих соответствующих событий независимо от источника. Подробнее см. в разделе Hooks.

Объедините функции

Каждое расширение решает разную проблему: CLAUDE.md обрабатывает всегда включённый контекст, skills обрабатывают знания и рабочие процессы по требованию, MCP обрабатывает внешние подключения, subagents обрабатывают изоляцию, а hooks обрабатывают автоматизацию. Реальные настройки объединяют их на основе вашего рабочего процесса. Например, вы можете использовать CLAUDE.md для соглашений проекта, skill для вашего рабочего процесса развёртывания, MCP для подключения к вашей базе данных и hook для запуска линтинга после каждого редактирования. Каждая функция обрабатывает то, в чём она лучше всего.
ПаттернКак это работаетПример
Skill + MCPMCP обеспечивает подключение; skill учит Claude, как его хорошо использоватьMCP подключается к вашей базе данных, skill документирует вашу схему и шаблоны запросов
Skill + SubagentSkill запускает subagents для параллельной работыSkill /audit запускает subagents безопасности, производительности и стиля, которые работают в изолированном контексте
CLAUDE.md + SkillsCLAUDE.md содержит всегда включённые правила; skills содержат справочный материал, загружаемый по требованиюCLAUDE.md говорит “следуйте нашим соглашениям API”, skill содержит полное руководство по стилю API
Hook + MCPHook запускает внешние действия через MCPHook после редактирования отправляет уведомление Slack, когда Claude изменяет критические файлы

Поймите стоимость контекста

Каждая функция, которую вы добавляете, потребляет часть контекста Claude. Слишком много может заполнить ваше окно контекста, но это также может добавить шум, который делает Claude менее эффективным; skills могут не срабатывать правильно, или Claude может потерять из виду ваши соглашения. Понимание этих компромиссов помогает вам построить эффективную настройку.

Стоимость контекста по функциям

Каждая функция имеет разную стратегию загрузки и стоимость контекста:
ФункцияКогда загружаетсяЧто загружаетсяСтоимость контекста
CLAUDE.mdНачало сессииПолный контентКаждый запрос
SkillsНачало сессии + при использованииОписания в начале, полный контент при использованииНизкая (описания каждый запрос)*
MCP serversНачало сессииВсе определения инструментов и схемыКаждый запрос
SubagentsПри запускеСвежий контекст с указанными skillsИзолирован от основной сессии
HooksПри срабатыванииНичего (работает внешне)Ноль, если hook не возвращает дополнительный контекст
*По умолчанию описания skills загружаются в начале сессии, чтобы Claude мог решить, когда их использовать. Установите disable-model-invocation: true в frontmatter skill, чтобы скрыть его от Claude полностью до тех пор, пока вы не вызовете его вручную. Это снижает стоимость контекста до нуля для skills, которые вы только вызываете сами.

Поймите, как загружаются функции

Каждая функция загружается в разные точки вашей сессии. Вкладки ниже объясняют, когда загружается каждая и что входит в контекст. Загрузка контекста: CLAUDE.md и MCP загружаются в начале сессии и остаются в каждом запросе. Skills загружают описания в начале, полный контент при вызове. Subagents получают изолированный контекст. Hooks работают внешне.
Когда: Начало сессииЧто загружается: Полный контент всех файлов CLAUDE.md (управляемые, пользовательские и уровни проекта).Наследование: Claude читает файлы CLAUDE.md из вашего рабочего каталога вверх до корня и обнаруживает вложенные в подкаталогах по мере доступа к этим файлам. Подробнее см. в разделе How CLAUDE.md files load.
Держите CLAUDE.md под ~500 строк. Переместите справочный материал в skills, которые загружаются по требованию.

Узнайте больше

Каждая функция имеет своё собственное руководство с инструкциями по настройке, примерами и параметрами конфигурации.

CLAUDE.md

Сохраняйте контекст проекта, соглашения и инструкции

Skills

Дайте Claude экспертизу в области и переиспользуемые рабочие процессы

Subagents

Перенесите работу в изолированный контекст

Agent teams

Координируйте несколько сессий, работающих параллельно

MCP

Подключите Claude к внешним сервисам

Hooks

Автоматизируйте рабочие процессы с помощью hooks

Plugins

Упакуйте и поделитесь наборами функций

Marketplaces

Размещайте и распространяйте коллекции plugins