Перейти к основному содержанию

Как сжать контекст в Claude Code: MCP, Tool Search и большие ответы

Сначала определите, когда расходуется контекст: до вызова MCP, после большого ответа или за время долгой сессии. Затем измените только этот источник нагрузки и повторите исходную задачу, сохранив нужный доступ и доказательства.

LaoZhang AI TeamОпубликованоОбновлено 7 мин чтения
Содержание
Схема расхода контекста Claude Code при работе с MCP

Чтобы сжать контекст в Claude Code, сначала определите источник нагрузки. До первого вызова MCP проверяйте загрузку инструментов; после большого ответа — фильтры и размер выдачи; после долгого расследования — накопившуюся историю. Отключение всех серверов не поможет закончить задачу, если среди них был единственный доступ к нужному документу или журналу ошибок.

Практический критерий успеха: Claude по-прежнему находит нужную запись, объясняет причину сбоя и может продолжить работу, а ненужных данных в разговоре стало меньше. Число подключений само по себе этого не показывает.

Найдите момент, в который заполняется окно

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

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

Когда возникает проблемаЧто проверитьПервое действие
Контекст уже занят до получения внешних данныхЗагруженные определения инструментов и прочие начальные инструкцииРазберите настройку Tool Search и обязательную загрузку серверов
После одного запроса к логам или документам расход заметно выросСам ответ: полный журнал, таблица, повторяющийся текстЗапросите нужный период, событие или раздел вместо всей выгрузки
Окно заполняется после множества попытокСтарые ответы, повторное чтение файлов, отвергнутые версии решенияЗафиксируйте рабочее состояние и сократите историю
Инструмент вообще не вызываетсяСостояние соединения, наличие инструмента и доступСначала восстановите необходимое подключение; уменьшение ответа здесь не решает проблему

В /mcp различайте отключение, подключение, запрос авторизации и отсутствие инструмента. Доступность MCP. Не приписывайте медленную работу контексту только по времени ожидания: сначала определите, где остановился запрос.

Tool Search: проверьте режим, затем уберите лишнюю загрузку

На совместимом подключении, если ENABLE_TOOL_SEARCH не задана, определения откладываются; имена и инструкции остаются. auto откладывает, когда определения занимают 10 % окна; auto:N задаёт 0–100 %. false загружает сразу, true запрашивает откладывание. alwaysLoad и anthropic/alwaysLoad исключают сервер или инструмент из откладывания. Настройка Tool Search.

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

У стороннего ANTHROPIC_BASE_URL поиск по умолчанию выключен; true требует поддержки tool_reference со стороны прокси и модели. Agent Platform: Claude 4.5 и новее поддержаны с v2.1.221, более ранние нельзя принудительно переключить. Foundry на Azure тоже нельзя; отключение экспериментальных beta блокирует поиск, кроме применимого переопределения управляемой политикой. Условия совместимости.

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

Для одной проверочной сессии на совместимом подключении значение можно передать при запуске:

bash
ENABLE_TOOL_SEARCH=true claude

Это пример для вашей среды; запуск Claude и измерение его расхода здесь не выполнялись.

В /mcp отключение обратимо, сохраняет конфигурацию и действует для проекта. Отключение без удаления.

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

Большой ответ: уменьшайте выдачу, сохраняя путь к подробностям

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

Схема различий между загрузкой инструментов и объёмом полученных данных

Предупреждение Claude Code: 10 000 токенов; стандартный предел: 25 000. Успешный текст без изображений сохраняется со ссылкой при превышении этого лимита или 50 000 символов. isError свыше примерно 11 000 символов оставляет первые/последние 5 000. Изображения под токенным лимитом. _meta["anthropic/maxResultSizeChars"] заменяет текстовый порог, максимум 500 000 символов, независимо от MAX_MCP_OUTPUT_TOKENS. Обработка вывода.

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

Начните с конкретного вопроса. Вместо «прочитай все логи» используйте, например:

Найди причину неудачного развёртывания deploy-42 сервиса payments.
Выбери ошибки этого развёртывания за указанный период.
Сначала дай количество совпадений, идентификаторы и короткие сообщения.
Если причина требует полного stack trace, прочитай только его.
Не объявляй причину найденной, если просмотрена лишь часть совпадений.

Здесь дата и идентификатор должны быть вашими. Фильтр по развёртыванию важнее случайного ограничения «первые 20 строк»: нужная ошибка могла появиться значительно позже.

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

Собственный MCP-сервер: не теряйте причину сбоя за лимитом строк

Хороший короткий ответ позволяет решить, что читать дальше. Для расследования развёртывания полезнее инструмент find_deployment_errors(deployment_id, cursor, limit), чем универсальный dump_logs(): первый привязывает выборку к вопросу, второй переносит отбор в контекст модели.

Схема компактного ответа MCP-сервера и получения подробностей по запросу

В спецификации MCP 2025-11-25 предусмотрены structuredContent, outputSchema и resource_link. Но JSON сам по себе не гарантирует компактность, а URI должен быть доступен клиенту. Формат результата инструмента.

Ниже — пример нашей формы ответа, не обязательные поля протокола:

json
{
  "deployment_id": "deploy-42",
  "matched": 3,
  "returned": 2,
  "complete": false,
  "next_cursor": "page-2",
  "items": [
    {"id": "E-137", "message": "Migration failed: missing column"},
    {"id": "E-138", "message": "Deployment aborted after migration failure"}
  ]
}

matched относится ко всей отфильтрованной выборке, returned — к этой странице. complete: false запрещает делать вывод о полноте по двум сообщениям. Следующий запрос получает оставшееся совпадение; отдельное чтение E-137 возвращает подробную ошибку миграции. Сервисная запись «развёртывание остановлено» не должна заслонять первоначальную причину.

Для такого инструмента определите, какие фильтры обязательны, как упорядочены результаты и сколько живёт курсор. Если данные меняются во время чтения, курсор должен ссылаться на стабильную выборку либо явно сообщать об изменении. Пустая страница, конец выборки и ошибка доступа должны различаться. Путь вида file:// на машине сервера нельзя считать рабочим способом чтения с удалённого клиента без проверки доступности.

Проверьте отбор отдельно от Claude

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

python
import json

rows = [
    {"id": f"E-{i}", "deployment": "other", "level": "INFO",
     "message": "heartbeat " * 20}
    for i in range(180)
]
for i, message in [
    (137, "Migration failed: missing column"),
    (138, "Deployment aborted after migration failure"),
    (139, "Rollback failed: missing column"),
]:
    rows[i].update(deployment="deploy-42", level="ERROR", message=message)

# Фильтр предшествует ограничению страницы.
matches = [r for r in rows
           if r["deployment"] == "deploy-42" and r["level"] == "ERROR"]
limit = 2
pages = [matches[i:i + limit] for i in range(0, len(matches), limit)]
seen = [r for page in pages for r in page]

assert not any(r["id"] == "E-137" for r in rows[:20])
assert len(matches) == 3
assert [r["id"] for r in seen] == ["E-137", "E-138", "E-139"]
assert seen[0]["message"] == "Migration failed: missing column"

print(json.dumps({"matched": len(matches), "pages": len(pages),
                  "cause": seen[0]["message"]}, ensure_ascii=False))

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

При обработке больших массивов полезен подход «вычислить рядом с данными, вернуть вывод». Anthropic описывает его в материале о выполнении кода с MCP. Пример выше реализует только фильтрацию; полноценное исполнение кода требует отдельной инфраструктуры, а не одного компактного JSON.

Как сжать накопившийся контекст и продолжить работу

Если определения и отдельные ответы уже разумного размера, а окно всё равно заполнено, зафиксируйте состояние задачи перед сокращением истории. Например:

Задача: найти причину сбоя deploy-42, не выполнять новое развёртывание.
Подтверждено: E-137 сообщает об отсутствии столбца при миграции.
Проверено: просмотрены все три совпадения; откат тоже завершился ошибкой.
Нужно: сопоставить сообщение с файлом миграции в текущем коммите.
Доступ: журнал ошибок и чтение репозитория должны остаться доступны.
Подробности: идентификатор E-137; полный trace пока не прочитан.

Записывайте только подтверждённое. Не переносите в такое резюме уверенную «причину», если она пока лишь гипотеза.

/compact сокращает текущий разговор; /clear начинает пустой контекст, сохраняя память проекта. Можно передать /compact инструкции о том, что сохранить. Команды управления разговором.

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

Для отдельного шумного исследования можно использовать подагента: у него свой контекст, а основной получает итог. Уже накопленный контекст основного разговора при этом не исчезает. Как используется контекст.

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

Проверьте ту же задачу после изменения

Сравнивайте не абстрактное «стало легче», а воспроизводимый результат. В примере с развёртыванием проверьте следующее:

  1. Используются тот же идентификатор, период и набор данных. Расход до вызова и после него записан через /context.
  2. Нужный инструмент находится и вызывается. Отключение лишнего сервера не лишило Claude доступа к журналу или репозиторию.
  3. Причина E-137 найдена, а не заменена общим сообщением об остановке. Все совпадения просмотрены либо явно обозначено, что ещё не просмотрено.
  4. Полный trace можно получить по необходимости. Claude связывает ошибку с нужным файлом, не загружая всё хранилище.
  5. После сокращения истории сохранились цель и запрет на новое развёртывание. Следующий полезный шаг выполняется без повторной полной выгрузки.

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

Короткие ответы на частые вопросы

Сколько MCP-серверов можно оставить включёнными?

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

«Claude server is overloaded» означает переполненный MCP-контекст?

Не обязательно. В прямом Claude API HTTP 529 с overloaded_error означает временную перегрузку сервиса. Описание ошибок API. Сначала установите, кто вернул ошибку, проверьте статус, тип и request ID. Само сообщение прокси или оболочки не доказывает ту же причину. Сокращение истории и отключение MCP не являются исправлением перегрузки провайдера.

Можно ли начать диагностику с /doctor?

Можно, если требуется более широкая диагностика, но текущий /doctor — встроенный skill, который может предлагать изменения с подтверждением. Терминальная команда claude doctor выводит диагностику установки без запуска сессии. Различие команд. Для проверки расхода начните с /context; не принимайте предложенные изменения автоматически как обязательное лечение MCP.

Ссылка на файл вместо ответа — это провал вызова?

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

Источники7

Внешние страницы, на которые ссылается это руководство, в порядке упоминания. Последнее обновление: 6 окт. 2026 г..

  1. 1.Описание контекстного окнаcode.claude.com/docs/en/context-window
  2. 2.справочник командcode.claude.com/docs/en/commands
  3. 3.Доступность MCPcode.claude.com/docs/en/mcp
  4. 4.Формат результата инструментаmodelcontextprotocol.io/specification/2025-11-25/server/tools
  5. 5.материале о выполнении кода с MCPanthropic.com/engineering/code-execution-with-mcp
  6. 6.Описание ошибок APIplatform.claude.com/docs/en/api/errors
  7. 7.Различие командcode.claude.com/docs/en/troubleshooting
Ещё по теме Claude Code
Выбор первого MCP для Claude Code по рабочей задаче
Claude Code

Лучшие MCP для Claude Code, которые стоит подключать первыми в 2026 году

GitHub нужен для работы с PR и задачами, Context7 — для документации библиотек, Playwright — для проверки интерфейса, Sentry — для разбора ошибок. Начните с недостающего доступа и проверьте один полезный результат, прежде чем добавлять следующий сервер.

11 мин