# Почему Claude Code перечитывает проект и расходует токены > Узнайте, почему Claude Code снова ищет и читает файлы проекта в каждой задаче, как работают встроенные команды и MCP-инструменты Serena и claude-context и что помогает расходовать контекст экономнее. Source: https://ailoot.ai/blog/ru/claude-code-rereads-project/ Canonical: https://ailoot.ai/blog/ru/claude-code-rereads-project/ Language: ru Publisher: Ailoot (https://ailoot.ai/) Translation: guide-200 Revision: sha256-4d62b2f9917dbae0f16cc4a5186c5396d7d7b92bc65a7c35333967eb998560a0
Главное Claude Code не сохраняет индекс исходного кода. При новой задаче он заново ищет нужные места и открывает файлы, поэтому часть токенов уходит на знакомство с проектом. Сократить повторную разведку помогают инструменты памяти кода, подключаемые через MCP: они дают агенту дополнительный способ ориентироваться в проекте.
[Документация Ailoot: API, ключи и подключение](https://ailoot.ai/docs/). ## Почему Claude Code каждый раз заново изучает проект?
Главное В Claude Code нет встроенного постоянного индекса проекта. Для поиска он использует инструменты, которые находят файлы по шаблону, ищут текст внутри них и читают содержимое. Модель сама выбирает, куда обратиться, и делает это заново для новой задачи: предыдущую сессию она не переносит в новую.
Такое поведение не обязательно означает неисправность. Claude Code устроен так, что при отсутствии готовой карты проекта агент выясняет, где находятся нужные файлы и строки, а затем читает их. Этот подход называют агентным поиском: модель сама выполняет поиск по мере необходимости. У такого устройства есть практические преимущества. Код читается в текущем состоянии, поэтому не возникает рассогласования с отдельным индексом. Специальная настройка для поиска не требуется, а проект не нужно передавать во внешнюю базу. Есть и издержки: при каждой новой задаче поиск и чтение могут повториться, даже если агент уже выполнял похожую разведку раньше. Чем крупнее проект и чем больше файлов приходится открывать, тем больше контекста может занять этот этап. Отсюда возникает впечатление, что Claude Code читает подряд всё содержимое проекта. ## Сколько токенов может уходить на работу?
Главное До начала работы над кодом запрос уже включает системные инструкции и описания инструментов. Затем контекст пополняют прочитанные файлы. Официальная документация Claude Code описывает чтение файлов как существенную часть расхода контекста; конкретный объём зависит от конфигурации и поставленной задачи.
Расход контекста складывается не только из текста запроса. В него входят служебные инструкции и сведения об инструментах, а затем — результаты поиска и содержимое файлов, которые агент открывает. Поэтому объём чтения зависит от размера проекта и от того, насколько широко Claude Code приходится искать нужный участок. Каждый открытый файл добавляет свой текст в контекст. Например, если в нём 2400 токенов, чтение такого файла может добавить примерно столько же содержимого. При работе с несколькими файлами эти объёмы суммируются. Для пользователя расход контекста связан с доступными лимитами и условиями тарифа. Если агент повторяет поиск и чтение на разных задачах, часть ресурсов регулярно тратится на ориентирование в коде. Чтобы понять общий расход, полезно учитывать и служебный контекст, и файлы, которые модель читает по ходу работы. ## Что называют постоянной памятью кода?
Главное Память кода — это дополнительное представление о проекте, по которому можно выполнять точечные запросы. Инструмент анализирует структуру исходников и сохраняет результаты, например сведения о функциях и связях. Благодаря этому агент может обратиться к карте проекта, когда ему нужно сориентироваться.
Идея памяти кода состоит в том, чтобы один раз построить полезное представление о проекте и затем обращаться к нему при поиске. Такой подход может уменьшить число повторных операций, но результат зависит от возможностей конкретного инструмента и от того, обновляется ли его представление после изменений в исходниках. Некоторые инструменты анализируют функции, классы, места вызова и связи между файлами. Полученная структура хранится отдельно от обычного диалога. Если Claude Code нужно найти, например, логику обработки оплаты, он может запросить сведения у такого инструмента, а не начинать поиск только с перебора файлов. Подключение внешних инструментов к Claude Code возможно через MCP — протокол взаимодействия с такими серверами. После настройки агенту доступны команды, предоставленные подключённым сервером. О том, какие именно функции доступны и как они работают, следует судить по официальной документации соответствующего инструмента. Практическая разница зависит от задачи: иногда достаточно найти имя функции или файл, в других случаях полезнее получить сведения о связях между символами или выполнить поиск по смыслу. ## Два инструмента памяти кода: чем они различаются?
Главное Serena предоставляет средства навигации и редактирования кода, в том числе работу с символами. claude-context предназначен для поиска по смыслу с использованием эмбеддингов. Для последнего может потребоваться внешняя база и ключ. Выбор зависит от задачи, зависимостей и опубликованных разработчиками условий.
Эти инструменты решают разные задачи. Serena ориентирована на навигацию по коду и операции с символами, а claude-context — на поиск по смысловому описанию. Перед установкой стоит сверить требования и актуальные инструкции в официальных репозиториях. | Что сравниваем | Serena | claude-context | |----|----|----| | Тип возможностей | Навигация по коду с использованием инструментов анализа | Поиск по смыслу с применением эмбеддингов | | Что помогает находить | Определения, места вызова и символы для работы с кодом | Код по описанию, например: «где находится логика оплаты» | | Внешние зависимости | Менеджер пакетов uv; для TypeScript и JavaScript также Node 20+ и npm | Внешняя база данных, ключ и Node 20+ | | Установка | Следуйте инструкции официального репозитория | Настройте параметры по инструкции официального репозитория | | Экономия токенов | Точный процент не опубликован | В описании проекта заявлено около 40% при сопоставимом качестве поиска | | Звёзды на GitHub | 26 468 | 12 138 | | Сильная сторона | Точные операции с кодом и символами | Поиск по описанию без знания точных имён | | Ограничение | Возможности и поддерживаемые языки зависят от проекта | Может потребоваться настройка внешнего сервиса | Указанные числа звёзд приведены на 15 июля 2026 года, согласно данным GitHub API. Оба инструмента распространяются с открытым исходным кодом и могут подключаться к Claude Code через MCP; условия использования уточняйте в соответствующих официальных репозиториях. Если нужно вносить точечные изменения в код, изучите возможности Serena. Если важнее находить нужный участок по его описанию, рассмотрите claude-context и заранее проверьте требования к внешним службам и настройке. ## Что можно сделать в Claude Code без дополнительных инструментов?
Главное Встроенные команды помогают следить за контекстом и историей разговора. `/context` показывает использование окна, `/compact` сокращает историю, а `/clear` очищает её перед отдельной задачей. `/doctor` проверяет настройку. Краткий файл `CLAUDE.md` также уменьшает объём постоянных инструкций.
Начните со встроенных возможностей Claude Code: они позволяют проверить состояние сессии и управлять её контекстом. 1. `/context` показывает сведения об использовании контекстного окна. Команды `/mcp` и `/memory` позволяют просмотреть информацию о подключённых MCP-серверах и загруженной памяти, если эти команды доступны в вашей версии. 2. `/compact` сокращает историю разговора до краткого представления и позволяет продолжить текущую задачу. При необходимости укажите, какую информацию следует сохранить. 3. `/clear` очищает историю текущего разговора. Это полезно при переходе к несвязанной задаче, чтобы прежний контекст не занимал место в новой работе. 4. `/doctor` проверяет конфигурацию и может подсказать, что требует внимания. Набор проверок зависит от версии Claude Code. Файл `CLAUDE.md` содержит инструкции, которые Claude Code может загружать для проекта. Если в нём много справочной информации, она увеличивает объём контекста. Размещайте там то, что действительно нужно учитывать регулярно, а подробные материалы выносите в подходящие документы или навыки, если ваша конфигурация их поддерживает. Субагенты могут выполнять отдельные задачи в собственном контексте, если такая функция доступна и подходит для работы. Общий принцип Anthropic для эффективной работы с контекстом — использовать достаточную для задачи информацию, избегая лишнего. ## Не увеличит ли MCP-сервер расход контекста?
Главное Подключение MCP-сервера добавляет сведения о доступных инструментах, а вызов инструмента может добавить его результаты в контекст. Размер этих данных зависит от конфигурации и конкретного сервера. Сопоставьте дополнительный расход с пользой от получаемой информации и проверьте актуальное поведение по документации Claude Code.
Само наличие сервера и использование его инструментов — разные вещи. Дополнительные описания и результаты вызовов могут влиять на контекст, но способ загрузки сведений зависит от версии Claude Code и настроек. В официальной документации MCP описаны доступные механизмы обнаружения и вызова инструментов; перед настройкой проверьте актуальные инструкции. Оценивать пользу памяти кода лучше на конкретной задаче: сколько контекста добавляет её настройка и использование, и помогает ли это сократить повторное чтение файлов. Нельзя заранее обещать одинаковый результат для всех проектов. Есть и другие ограничения. Сохранённое представление может требовать обновления, если исходники изменились; автоматическое обновление зависит от инструмента и его настроек. Заявленные показатели экономии также относятся к условиям измерений разработчика и не гарантируют такой же эффект на каждой задаче. ## С чего начать?
Главное Сначала проверьте доступные встроенные команды и текущие инструкции проекта. Затем определите, какая функция нужна: навигация по символам или поиск по смыслу. Выбранный MCP-инструмент устанавливайте по документации его разработчика, а его пользу оценивайте на своей задаче и конфигурации.
Для начала можно выполнить несколько простых шагов: 1. Проверьте, какие сведения о контексте показывает `/context`, и при необходимости используйте `/doctor` для диагностики настройки. 2. Сократите инструкции в `CLAUDE.md` до регулярно нужной информации, а справочные материалы разместите отдельно. 3. Если повторный поиск по проекту мешает работе, выберите инструмент по требуемой функции и настройте его по официальному руководству. Для навигации и операций с символами изучите Serena; для смыслового поиска — claude-context. Сравните их требования с вашими условиями и проверьте результат на характерной задаче.
### Источники - [Serena — официальный репозиторий Oraios AI](https://github.com/oraios/serena) - [claude-context — официальный репозиторий Zilliz](https://github.com/zilliztech/claude-context) - [Claude Code: контекстное окно, `/compact`, `/clear` и `/context` — документация Anthropic](https://code.claude.com/docs/en/context-window) - [Claude Code: подключение MCP и работа с инструментами — документация Anthropic](https://code.claude.com/docs/en/mcp) - [Anthropic: эффективная работа с контекстом ИИ-агентов](https://www.anthropic.com/engineering/effective-context-engineering-for-ai-agents)
Если вам нужен доступ к нейросетям через Ailoot, посетите [сайт Ailoot](https://ailoot.ai/). ## Вопросы и ответы ### Когда выбирать навигацию по символам вместо смыслового поиска по коду? Навигация по символам, как в Serena, подходит для определений, мест вызова и точного рефакторинга. Смысловой поиск, как claude-context, полезен, когда известно поведение, но не имя символа. Ему нужна дополнительная настройка базы и эмбеддингов. ### Можно ли доверять карте кода после изменений? Проверьте обновление индекса. Карта отражает просканированный код, а механизм обновления зависит от инструмента. Используйте карту для поиска нужного места, затем проверяйте текущие файлы перед правкой. ## Ailoot · Компания и портфель её проектов Ailoot опирается на накопленный опыт работы, большую клиентскую базу, стабильный сервис и постоянный контроль KPI. Компания и портфель её проектов: миллионы клиентов; продажи на миллиарды ежемесячно. Этот опыт Ailoot использует для API-доступа к нейросетям в продуктах клиентов, агентах, приложениях и автоматизациях.