Навыки Claude Code: как сократить расход контекста

Теперь можно увидеть, какие навыки Claude Code расходуют место в контексте, не принося пользы, и убрать эту нагрузку, не отказываясь от инструкций, которые нужны в реальных рабочих процессах. Новый отчёт /skill-doctor превращает очистку навыков из игры в догадки в измеримую и обратимую рабочую практику.

Если коротко: запустите /skill-doctor, оцените каждый неиспользуемый навык по цене возможной потери, примените самое щадящее изменение видимости и проверьте результат в новой сессии. Не начинайте с удаления папок. Навык, который не подавал признаков жизни неделю, всё ещё может быть тем самым инструментом, который обеспечивает безопасность развёртывания или реагирования на инцидент.

В Claude Code 2.1.261, выпущенном 4 сентября 2026 года, появилась команда /skill-doctor: она показывает, какие загруженные навыки не используются и сколько места каждый из них занимает в контексте. Это важно, потому что каждый навык из списка добавляет своё название и, как правило, описание в каждый ход — даже если Claude ни разу не загружает его полные инструкции.

Как навыки Claude Code расходуют контекст

У контекста навыков две статьи расходов. Если их перепутать, легко отключить не то.

Первая — расходы на список. Ещё до первого запроса Claude видит названия и описания доступных навыков, чтобы выбрать подходящий. По умолчанию Anthropic ограничивает этот список 1% контекстного окна модели, а совокупный объём полей description и when_to_use для каждого навыка — 1,536 символами.

Вторая — расходы на вызов. Полное содержимое SKILL.md загружается только тогда, когда навык вызываете вы или Claude. После загрузки оно остаётся в беседе на последующих ходах. После сжатия контекста Claude Code может заново прикрепить до 5,000 токенов из каждого вызванного навыка; общий лимит для таких повторно прикреплённых навыков составляет 25,000 токенов.

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

От этого различия зависит способ оптимизации. Длинное описание неиспользуемого навыка постоянно увеличивает стоимость списка. Большое тело часто вызываемого навыка надолго занимает место в сессии. /skill-doctor лучше всего решает первую проблему, а со второй помогает грамотная архитектура навыка.

Расходы возникают на каждом ходе, а не при установке

Бездействующий навык — не разовая плата за настройку. По мере развития беседы текст из его записи в списке показывается снова и снова. Для практической оценки подойдёт формула:

Избыточный контекст за день = токены неиспользуемых записей на один ход × количество ходов Claude за день

Например, если отчёт обнаружил 2,000 токенов неиспользуемого контекста списка, а за рабочий день набирается 40 ходов модели, суммарно за день будет передано 80,000 входных токенов. Это пример, а не эталонный показатель. Кэширование промптов может снизить стоимость повторяющегося текста в счёте, но сам контекст от этого не исчезает.

У пользователей API и облачных провайдеров лишние токены отражаются на счёте. У подписчиков они расходуют лимит тарифа и сокращают рабочий запас до сжатия контекста. По данным Anthropic, в корпоративных внедрениях Claude Code средние расходы составляют около $13 на разработчика за активный день и от $150 до $250 на разработчика в месяц. Лишние навыки — лишь одна часть этих затрат, зато теперь это одна из немногих частей, которую можно измерить поимённо.

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

Как безопасно отключать, проверять и возвращать навыки

Самый надёжный процесс состоит из семи шагов.

1. Начните с актуальной терминальной сессии

Обновите Claude Code до версии 2.1.261 или новее и проверьте установленную версию командой claude --version. В справочнике Anthropic указано, что для /skill-doctor требуется версия 2.1.252 или новее, тогда как команда была анонсирована в журнале изменений версии 2.1.261.

Запустите /skill-doctor в терминале на компьютере, где работает сессия. В интерактивной сессии отчёт откроется на вкладке Stats менеджера /plugin. В неинтерактивном режиме с флагом -p он выводится текстом, поэтому результат удобно сохранить для локального аудита. Через Remote Control получить отчёт нельзя.

2. Зафиксируйте исходные показатели

До любых изменений сохраните три вещи: общую стоимость списка навыков, крупнейшие неиспользуемые источники расходов и перечень навыков или плагинов, которые планируете изменить. Кроме того, запустите /context, чтобы увидеть строку Skills после применения бюджета, и /doctor, чтобы найти самые объёмные элементы списка.

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

3. Разделите кандидатов по цене ошибки

Распределите каждый навык-кандидат по одной из трёх категорий:

Здесь отчёту не обойтись без человеческого решения. Метка “Never invoked” говорит о частоте, а не о ценности. Огнетушителем тоже можно ни разу не воспользоваться — и всё же его стоит держать под рукой.

4. Выбирайте самое щадящее управление

Для локальных, личных, проектных и синхронизируемых навыков меню /skills позволяет записать обратимое изменение skillOverrides в .claude/settings.local.json.

• Выберите name-only, если Claude достаточно знать о существовании навыка, а его полное описание в списке не требуется.
• Выберите user-invocable-only, если команда /skill-name должна остаться доступной вам, но автоматически выбирать навык не следует.
• Выбирайте off, только если навык не должны видеть ни вы, ни Claude.
• Чтобы вернуть исходное поведение, выберите on.

Если навык принадлежит вам, параметр disable-model-invocation: true задаёт переносимый авторский вариант политики «только для пользователя». Описание исчезает из списка Claude, но прямой вызов остаётся доступным.

С навыками плагинов всё иначе: skillOverrides на них не действует. Отключите плагин без удаления командой /plugin disable plugin-name@marketplace-name, а затем верните его командой /plugin enable plugin-name@marketplace-name. Не забывайте, что плагин может также добавлять агентов, хуки, MCP-серверы или языковые инструменты, поэтому перед отключением проверьте его состав.

5. Уменьшайте тело, не урезая возможности

Если у полезного навыка слишком большое тело, оставьте SKILL.md в роли навигационной карточки, а подробные примеры, справочники API и пограничные случаи вынесите во вспомогательные файлы. Anthropic рекомендует держать SKILL.md короче 500 строк. Вспомогательные файлы загружаются лишь тогда, когда Claude они нужны, а служебные скрипты могут выполняться без добавления их исходного кода в промпт.

В начале файла разместите задачу, триггер, непреложные правила и карту вспомогательных материалов. Это защитит самое важное и после сжатия контекста, когда от каждого повторно прикреплённого навыка сохраняются только первые 5,000 токенов.

6. Проверяйте результат в новой сессии

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

Anthropic рекомендует сравнивать именно новые сессии: остаточный контекст от разработки или предыдущего вызова навыка способен скрыть его реальный вклад. Если после изменений плагина требуется /reload-plugins, учтите расход токенов на следующем запросе и возможную перестройку кэша промпта, когда плагин предоставляет MCP-инструменты без отложенной загрузки.

7. Верните то, чего не хватает, и повторите аудит

Если качество снизилось, отступите на один уровень: с off на user-invocable-only, с режима «только для пользователя» на name-only или с отключённого плагина на включённый. Если качество сохранилось, оставьте более компактную конфигурацию и снова запустите /skill-doctor после репрезентативного периода реальной работы.

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

Кому такая оптимизация принесёт больше всего пользы

Ниже сценарии расположены по вероятному экономическому эффекту.

1. Платформенные команды с общей конфигурацией Claude Code

Руководитель платформенной команды с десятками разработчиков может попросить пилотную группу экспортировать локальные отчёты /skill-doctor, найти навыки, которые присутствуют у всех, но нигде не вызываются, и перевести необязательные процессы в режим ручного вызова или доступности только в конкретных проектах. Экономия суммируется на каждом ходе каждого разработчика, а файл восстановления делает эксперимент обратимым. Управляемые на уровне предприятия навыки в отчёт не попадают, поэтому он даёт локальную выборку по парку, а не полный аудит политик.

2. Инженерные команды с большим числом плагинов

Команда может установить плагин ради одной миграции, а затем месяцами держать включёнными его навыки, агентов, хуки и MCP-инструменты. /skill-doctor показывает плагины, которые в последнее время не использовались, а менеджер плагинов позволяет отключить их без удаления. Выигрыш не ограничивается описанием навыка: ненужный плагин способен добавлять сразу несколько компонентов, занимающих контекст. Но и риск столь же широк — вместе с ним можно отключить полезные компоненты, не связанные с навыками.

3. Консультанты, работающие с разными стеками клиентов

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

4. Сопровождающие крупных монорепозиториев

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

5. Команды с редкими, но критически важными командами

Навыки развёртывания, отката, миграции данных и реагирования на инциденты могут не вызываться неделями. Удалять их только из-за пометки отчёта о бездействии не следует. Ручной режим убирает их описания из постоянно повторяющегося списка Claude, сохраняя точную аварийную команду /skill-name. Обычные сессии потребляют меньше контекста, а во время инцидента не нужно заново создавать рабочую инструкцию.

6. Авторы навыков с объёмными справочниками

Автор может с помощью отчёта обнаружить дорогой навык, а затем вынести длинные примеры и спецификации во вспомогательные файлы. Основной файл превратится в компактную карту решений. Расход контекста будет отложен: детали появятся только тогда, когда процесс дойдёт до требующей их ветки.

7. Независимые разработчики с лимитом подписки

Независимый разработчик может не увидеть прямой экономии денег, поскольку в Pro и Max использование входит в подписку. Практический результат — больше работы в рамках того же лимита и больше пространства до сжатия контекста. Совместите /skill-doctor с аккуратной настройкой Claude Code и очищайте сессию при переходе к несвязанной задаче.

Три продукта, которые стоит создать

Поисковый рынок шире, чем можно судить по новизне запроса. Согласно DataForSEO, claude code skills получает 12,100 поисковых запросов в месяц в США при CPC $8.26. Для узких фраз о сокращении контекста навыков сервис не нашёл подсказок. Это открывает возможность занять новую нишу внутри сформировавшегося рынка навыков, а не доказывает существование зрелой самостоятельной категории.

1. Skill Budget Guard — самый сильный вариант

Создайте локальный CLI и CI-проверку, которые читают навыки репозитория, настройки видимости и экспортированный отчёт /skill-doctor, а затем показывают изменение контекста для каждого pull request. Платформенные команды будут платить за инструмент, который превращает разовую уборку одного разработчика в воспроизводимую политику для всей команды.

Сигнал спроса на редкость ясен: claude code skills получает 12,100 запросов в месяц, CPC составляет $8.26, а Anthropic оценивает средние корпоративные расходы на Claude Code в сумму от $150 до $250 на разработчика в месяц. Минимальной продаваемой версии нужны локальный парсер, хранящийся в репозитории файл бюджета, GitHub Action и обратимые рекомендации вроде “move to user-only” или “split references.”

Но есть существенный платформенный риск. Anthropic может расширить /skill-doctor, а её Analytics API уже бесплатно доступен подходящим организациям. Защитным преимуществом станут история политик, сравнение между репозиториями и доказательство того, что сокращение контекста не снизило успешность задач.

2. Project Skill Profile Switcher

Создайте именованные профили — например, frontend, data, incident и release, — которые применяют изменения skillOverrides, включают или отключают плагины, а затем одной командой восстанавливают предыдущее состояние. Покупателями станут консультанты и команды, работающие с монорепозиториями.

DataForSEO сообщает о 590 запросах best claude code skills в месяц, коммерческом интенте и CPC $11.91. MVP должен включать манифест, предварительный просмотр различий, безопасную запись локальных настроек, команды управления плагинами и точку восстановления. Слабое место — невысокий порог копирования. Встроенные меню Claude Code уже дают доступ к базовым элементам управления, а перезагрузка плагинов может увеличить расходы на кэш на один ход.

3. Skill Outcome Lab

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

DataForSEO сообщает о 110 запросах claude code skills best practices в месяц, коммерческом интенте и ставках для верхних позиций от $4.14 до $6.01. Практичному MVP нужны наборы тестовых запросов, проверки ожидаемого результата, изоляция новых сессий и простой отчёт «до и после».

Но ограничение здесь решающее: официальный плагин skill-creator от Anthropic уже сравнивает запуски с навыком и без него. Поэтому такой инструмент должен стать функцией Skill Budget Guard, а не отдельной компанией.

Если команда распространяет навыки между разными продуктами или агентами, сравнение Notion Skills и Claude Skills API дополнит картину вопросами управления.

Чего /skill-doctor не решает

/skill-doctor — профилировщик потерь в списке навыков, а не универсальный оптимизатор стоимости Claude Code.

• Он не проверяет встроенные и управляемые на уровне предприятия навыки.
• Он не удаляет из текущей беседы уже загруженное тело навыка.
• Он не измеряет CLAUDE.md, историю старых бесед, выбор модели, токены рассуждения, многословный вывод инструментов или накладные расходы MCP.
• Он не может возвращать отчёты об использовании через Remote Control.
• Он не способен определить, предотвратил ли редкий навык дорогостоящую ошибку.
• Он не делает кэшированный контекст бесплатным. Цена кэша и место в контексте — разные вопросы.

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

Другая ошибка — сразу удалять плагины. Сначала отключите плагин и проверьте результат; удаляйте его лишь после того, как убедитесь, что остальные компоненты тоже не нужны.

Что сделать в понедельник

Выберите один реальный репозиторий и одного разработчика, который активно пользуется Claude Code. Запустите /skill-doctor, зафиксируйте пять крупнейших неиспользуемых источников расходов и измените только два: один редкий процесс переведите в режим ручного вызова, а один действительно ненужный плагин отключите. Откройте новую сессию, повторите три обычные задачи и верните всё, что повлияло на результат. Так к пятнице появится обоснованная политика экономии контекста, а не просто более аккуратная конфигурация, которая незаметно ухудшила работу агента.

Как сделать так, чтобы Claude Code использовал меньше контекста?

Запустите /skill-doctor, чтобы найти расходы на неиспользуемые записи навыков, используйте /context для общей разбивки, скройте ненужные навыки, оставьте редкие процессы только для ручного вызова, вынесите длинные справочники во вспомогательные файлы и выполняйте /clear между несвязанными задачами.

Как снизить стоимость Claude Code?

Сначала сократите повторяющийся контекст, затем займитесь выбором модели, длинными сессиями, настройками рассуждения, многословным выводом инструментов и неиспользуемыми MCP-серверами. /skill-doctor охватывает только ту часть расходов, которая связана с навыками.

Навыки Claude Code бесплатны?

В документации Anthropic по навыкам не указана отдельная плата за локальный SKILL.md, однако его название и описание могут расходовать контекст на каждом ходе, а полное тело — после вызова. Пользователи API платят за токены, а подписчики расходуют включённый в тариф лимит.

Как сжимать контекст Claude Code?

Используйте /compact, когда в длинной задаче важно сохранить непрерывность, и /clear, когда переходите к несвязанной работе. После сжатия тела вызванных навыков могут прикрепляться снова — не более 5,000 токенов на навык и 25,000 токенов суммарно.

Нужно ли очищать контекст в Claude Code?

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

Если вашей инженерной команде нужен измеримый процесс управления навыками, обратите внимание на промышленные системы ИИ.