Claude Code объединяет модель, которая рассуждает о вашем коде, с встроенными инструментами для операций с файлами, поиска, выполнения и веб-доступа. Встроенные инструменты охватывают большинство задач кодирования. Это руководство охватывает уровень расширения: функции, которые вы добавляете для настройки того, что знает Claude, подключения его к внешним сервисам и автоматизации рабочих процессов.Documentation Index
Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
Информацию о том, как работает основной цикл агента, см. в разделе How Claude Code works.
Обзор
Расширения подключаются к различным частям цикла агента:- CLAUDE.md добавляет постоянный контекст, который Claude видит в каждой сессии
- Skills добавляют переиспользуемые знания и вызываемые рабочие процессы
- MCP подключает Claude к внешним сервисам и инструментам
- Subagents запускают свои собственные циклы в изолированном контексте, возвращая резюме
- Agent teams координируют несколько независимых сессий с общими задачами и обменом сообщениями между участниками
- Hooks срабатывают при событиях жизненного цикла и могут запустить скрипт, HTTP запрос, prompt или subagent
- Plugins и marketplaces упаковывают и распространяют эти функции
/deploy, или Claude может загружать их автоматически, когда они релевантны. Skills могут работать в вашем текущем разговоре или в изолированном контексте через subagents.
Сопоставьте функции с вашей целью
Функции варьируются от всегда включённого контекста, который Claude видит в каждой сессии, до возможностей по требованию, которые вы или Claude можете вызвать, до фоновой автоматизации, которая работает при определённых событиях. Таблица ниже показывает, что доступно и когда каждое имеет смысл.| Функция | Что она делает | Когда её использовать | Пример |
|---|---|---|---|
| CLAUDE.md | Постоянный контекст, загружаемый в каждом разговоре | Соглашения проекта, правила “всегда делай X" | "Используйте pnpm, а не npm. Запускайте тесты перед коммитом.” |
| Skill | Инструкции, знания и рабочие процессы, которые может использовать Claude | Переиспользуемый контент, справочные документы, повторяющиеся задачи | /deploy запускает ваш контрольный список развёртывания; skill с документацией API с шаблонами конечных точек |
| Subagent | Изолированный контекст выполнения, который возвращает обобщённые результаты | Изоляция контекста, параллельные задачи, специализированные работники | Задача исследования, которая читает много файлов, но возвращает только ключевые выводы |
| Agent teams | Координируют несколько независимых сессий Claude Code | Параллельное исследование, разработка новых функций, отладка с конкурирующими гипотезами | Запустите рецензентов для одновременной проверки безопасности, производительности и тестов |
| MCP | Подключение к внешним сервисам | Внешние данные или действия | Запрос к вашей базе данных, отправка в Slack, управление браузером |
| Hook | Скрипт, HTTP запрос, prompt или subagent, запущенные событиями | Автоматизация, которая должна работать при каждом соответствующем событии | Запуск ESLint после каждого редактирования файла |
/my-plugin:review), поэтому несколько plugins могут сосуществовать. Используйте plugins, когда вы хотите переиспользовать одну и ту же настройку в нескольких репозиториях или распространять другим через marketplace.
Сформируйте вашу настройку со временем
Вам не нужно настраивать всё заранее. Каждая функция имеет узнаваемый триггер, и большинство команд добавляют их примерно в таком порядке:| Триггер | Добавить |
|---|---|
| Claude дважды неправильно применяет соглашение или команду | Добавьте в CLAUDE.md |
| Вы постоянно вводите один и тот же prompt для начала задачи | Сохраните как вызываемый пользователем skill |
| Вы вставляете один и тот же playbook или многошаговую процедуру в чат в третий раз | Захватите как skill |
| Вы постоянно копируете данные из вкладки браузера, которую Claude не видит | Подключите эту систему как MCP server |
| Побочная задача заполняет ваш разговор выводом, на который вы больше не будете ссылаться | Маршрутизируйте через subagent |
| Вы хотите, чтобы что-то происходило каждый раз без запроса | Напишите hook |
| Второй репозиторий нуждается в одной и той же настройке | Упакуйте как plugin |
Сравните похожие функции
Некоторые функции могут казаться похожими. Вот как их различить.- Skill vs Subagent
- CLAUDE.md vs Skill
- CLAUDE.md vs Rules vs Skills
- Subagent vs Agent team
- MCP vs Skill
- Hook vs Skill
Skills и subagents решают разные проблемы:
Skills могут быть справочными или действенными. Справочные skills предоставляют знания, которые Claude использует на протяжении вашей сессии (например, ваше руководство по стилю API). Action skills говорят Claude сделать что-то конкретное (например,
- Skills — это переиспользуемый контент, который вы можете загрузить в любой контекст
- Subagents — это изолированные работники, которые работают отдельно от вашего основного разговора
| Аспект | Skill | Subagent |
|---|---|---|
| Что это | Переиспользуемые инструкции, знания или рабочие процессы | Изолированный работник со своим собственным контекстом |
| Ключевое преимущество | Поделитесь контентом между контекстами | Изоляция контекста. Работа происходит отдельно, возвращается только резюме |
| Влияние на окно контекста | Добавляется в ваше основное окно | Использует отдельное окно со своими входными и выходными токенами |
| Лучше всего для | Справочный материал, вызываемые рабочие процессы | Задачи, которые читают много файлов, параллельная работа, специализированные работники |
/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 + MCP | MCP обеспечивает подключение; skill учит Claude, как его хорошо использовать | MCP подключается к вашей базе данных, skill документирует вашу схему и шаблоны запросов |
| Skill + Subagent | Skill запускает subagents для параллельной работы | Skill /audit запускает subagents безопасности, производительности и стиля, которые работают в изолированном контексте |
| CLAUDE.md + Skills | CLAUDE.md содержит всегда включённые правила; skills содержат справочный материал, загружаемый по требованию | CLAUDE.md говорит “следуйте нашим соглашениям API”, skill содержит полное руководство по стилю API |
| Hook + MCP | Hook запускает внешние действия через MCP | Hook после редактирования отправляет уведомление Slack, когда Claude изменяет критические файлы |
Поймите стоимость контекста
Каждая функция, которую вы добавляете, потребляет часть контекста Claude. Слишком много может заполнить ваше окно контекста, но это также может добавить шум, который делает Claude менее эффективным; skills могут не срабатывать правильно, или Claude может потерять из виду ваши соглашения. Понимание этих компромиссов помогает вам построить эффективную настройку. Для интерактивного представления того, как эти функции объединяются в работающей сессии, см. Explore the context window.Стоимость контекста по функциям
Каждая функция имеет разную стратегию загрузки и стоимость контекста:| Функция | Когда загружается | Что загружается | Стоимость контекста |
|---|---|---|---|
| CLAUDE.md | Начало сессии | Полный контент | Каждый запрос |
| Skills | Начало сессии + при использовании | Описания в начале, полный контент при использовании | Низкая (описания каждый запрос)* |
| MCP servers | Начало сессии | Имена инструментов; полные схемы по требованию | Низкая до использования инструмента |
| Subagents | При запуске | Свежий контекст с указанными skills | Изолирован от основной сессии |
| Hooks | При срабатывании | Ничего (работает внешне) | Ноль, если hook не возвращает дополнительный контекст |
disable-model-invocation: true в frontmatter skill, чтобы скрыть его от Claude полностью до тех пор, пока вы не вызовете его вручную. Это снижает стоимость контекста до нуля для skills, которые вы только вызываете сами. Для skill, который вы не писали, установите skillOverrides в settings, чтобы сделать то же самое без редактирования его файла.
Поймите, как загружаются функции
Каждая функция загружается в разные точки вашей сессии. Вкладки ниже объясняют, когда загружается каждая и что входит в контекст.
- CLAUDE.md
- Skills
- MCP servers
- Subagents
- Hooks
Когда: Начало сессииЧто загружается: Полный контент всех файлов CLAUDE.md (управляемые, пользовательские и уровни проекта).Наследование: Claude читает файлы CLAUDE.md из вашего рабочего каталога вверх до корня и обнаруживает вложенные в подкаталогах по мере доступа к этим файлам. Подробнее см. в разделе How CLAUDE.md files load.
Узнайте больше
Каждая функция имеет своё собственное руководство с инструкциями по настройке, примерами и параметрами конфигурации.CLAUDE.md
Сохраняйте контекст проекта, соглашения и инструкции
Skills
Дайте Claude экспертизу в области и переиспользуемые рабочие процессы
Subagents
Перенесите работу в изолированный контекст
Agent teams
Координируйте несколько сессий, работающих параллельно
MCP
Подключите Claude к внешним сервисам
Hooks
Автоматизируйте рабочие процессы с помощью hooks
Plugins
Упакуйте и поделитесь наборами функций
Marketplaces
Размещайте и распространяйте коллекции plugins