Почему Claude Code перечитывает весь проект и как это исправить

Каждый день в Telegram-канале - что нового в вайб-кодинге: инструменты, приёмы, ошибки. Подпишись, чтобы ничего не пропустить.

Почему Claude Code каждый раз перечитывает проект заново?

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

Это осознанное решение команды. Ранние версии Claude Code держали векторную базу кода, но от неё отказались. Вот как объясняет это Борис Черни, создатель Claude Code.

У подхода есть реальные плюсы. Код всегда свежий - нет индекса, который отстал от реальности. Настраивать нечего. Твой код не уезжает ни в какую базу.

Но есть и обратная сторона: каждая новая задача - это новый прогон поиска и чтения файлов. Токены уходят на то, чтобы заново понять, где что лежит, хотя в прошлой сессии Claude это уже выяснял. Чем больше проект, тем дороже такая разведка. Именно этот механизм и стоит за ощущением, что агент «читает всё подряд».

Сколько токенов это реально сжигает?

Расход начинается ещё до твоего запроса. В июле 2026 разбор компании Systima собрал 698 голосов на Hacker News с простым замером: Claude Code шлёт около 33 тысяч токенов системного промпта и описаний инструментов до того, как прочитает первый символ твоего сообщения. Для сравнения, у OpenCode этот стартовый вес около 7 тысяч.

Дальше вступает перечитывание. Каждый поиск по файлам и каждое чтение добавляют токены в контекст. В официальной документации Claude Code это сказано прямо: чтение файлов доминирует в расходе контекста. Разбор auth.ts на 2400 токенов - это 2400 токенов, которые видит только Claude, и так на каждый файл, который он открывает в разведке.

Для нашей аудитории это переводится в деньги и лимиты. Страх номер один у тех, кто приходит в вайб-кодинг - «заплатил, а лимиты кончились впустую». Если агент на каждой задаче заново сканирует проект и перечитывает файлы, контекст выгорает вдвое быстрее: сначала на служебный вес, потом на разведку. Полную карту того, куда именно утекают токены, я разбирал в гайде «Куда уходят токены Claude Code» - перечитывание проекта там один из девяти паттернов.

Хочешь не просто срезать расход, а собрать систему, в которой Claude работает предсказуемо и не жжёт лимиты зря? Память кода - это часть контекст-инжиниринга: управления тем, что попадает в контекст до запроса. На практикуме за 3 эфира собираешь всю связку - ИИ-клон + Второй мозг + Контекст-инжиниринг. Именно она превращает Claude из «помощника, который каждый раз начинает с нуля» в инструмент, который держит контекст под контролем.

Практикум по вайб-кодингу

+Твой второй мозг

3 вечера - стек, метод, первый проект

Старт 14–16 июля  ·  2 000 ₽

Записаться →

Что такое постоянная память кода?

Память кода закрывает ровно тот разрыв, из-за которого Claude перечитывает проект. Идея простая: пусть кто-то один раз обойдёт весь код, построит из него карту и будет держать её под рукой. Тогда агенту не нужно каждый раз искать заново - он спрашивает карту.

Технически это работает так. Отдельный инструмент сканирует проект и раскладывает его на составные части: какие есть функции и классы, кто кого вызывает, какие файлы связаны между собой. Эта структура сохраняется на диске. Когда Claude нужно понять, где лежит логика оплаты или что сломается при правке функции, он делает один точечный запрос к карте вместо десятков чтений файлов.

Подключается такая карта через MCP - стандартный способ прицепить к Claude Code внешний инструмент (как подключаются другие серверы, я разбирал в гайде «MCP-серверы для Claude Code»). Инструмент памяти кода добавляет свои команды поиска по карте, и Claude пользуется ими сам, когда ему нужно сориентироваться в проекте.

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

Три подхода к памяти кода: чем они отличаются?

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

Числа звёзд на GitHub - на 15 июля 2026 (по данным GitHub API). Все три инструмента бесплатные и открытые, все три работают с Claude Code, и все три подключаются как MCP-сервер.

Короткий вывод для непрограммиста. codebase-memory-mcp - это карта проекта: он показывает Claude структуру и связи, ставится в одну команду и лучше всех экономит токены на вопросах «как тут всё устроено». Serena - руки хирурга: она нужна, когда правишь один и тот же кусок по всему проекту и важна точность. claude-context - поиск по смыслу: он находит код по описанию, но за это платишь настройкой облачной базы и ключом. Если ты только начинаешь и просто хочешь, чтобы Claude перестал жечь токены на разведке, бери первый.

Как поставить codebase-memory-mcp за 3 минуты?

Это моя основная рекомендация для старта: ставится в одну команду, а расход режет заметно. По описанию проекта, инструмент индексирует средний проект за миллисекунды, а ядро Linux на 28 миллионов строк - за три минуты.

Порядок установки на macOS или Linux:

1. Открой терминал в папке своего проекта.
2. Вставь и выполни установочную команду:

curl -fsSL https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh | bash

3. Дождись, пока установщик сам найдёт Claude Code и пропишет сервер. Docker, ключ и отдельная база не нужны - это один готовый файл.
4. Перезапусти Claude Code, чтобы он подхватил новый инструмент.
5. Напиши Claude простой запрос: «проиндексируй этот проект». Он построит карту кода один раз.

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

По замерам самого проекта, пять структурных вопросов о реальном коде стоили около 3400 токенов через карту против примерно 412 тысяч через обычный поиск и чтение файлов. Это красивая цифра на подобранных запросах, поэтому честнее держать в голове более скромную оценку из документации проекта: около 10 раз меньше токенов на 31 реальном проекте при 83% качества ответов. Даже нижняя граница - это очень много, когда ты считаешь каждую подписку.

Когда лучше взять Serena или claude-context?

Три инструмента - это не гонка за одним призом. Они запоминают разное, поэтому и выбор зависит от задачи.

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

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

Бери claude-context, если нужен поиск по смыслу и тебя не пугает настройка. Он превращает код в векторы (числовые отпечатки смысла) и ищет по описанию: «найди, где у нас логика оплаты», даже если ты не знаешь названий функций. Цена такого поиска - обвязка.

Для claude-context нужны внешняя векторная база, ключ провайдера эмбеддингов и свежая версия Node. Из трёх это самый тяжёлый по настройке вариант, поэтому новичку я советую начинать не с него.

Что можно сделать прямо в Claude Code без сторонних инструментов?

Прежде чем ставить сторонние инструменты, выжми из Claude Code то, что уже встроено. Эти команды бесплатны и работают из коробки.

1. /context - показывает живую разбивку, что занимает окно: системный промпт, CLAUDE.md, память, инструменты, файлы. Команда /mcp покажет стоимость каждого подключённого сервера, а /memory - что загрузилось на старте.
2. /compact - сжимает историю разговора в короткое резюме и продолжает ту же задачу. Можно навести фокус: /compact с уточнением, что сохранить.
3. /clear - выкидывает историю целиком. Официальная рекомендация - запускать его, когда переключаешься на несвязанную задачу, чтобы старый разговор не вытеснял нужные файлы.
4. /doctor (он же /checkup, появился 8 июля 2026) - диагностирует настройку и предлагает фиксы: чистит дубли в CLAUDE.md, находит неиспользуемые инструменты и серверы, ловит медленные обработчики.

Отдельно про CLAUDE.md. Этот файл загружается в контекст в начале каждой сессии и учитывается в каждом сообщении. Если он раздут, ты платишь за него постоянно. Официальная рекомендация - держать его короче 200 строк, а справочные детали выносить в навыки, которые подгружаются по требованию. Насколько это ощутимо: разработчик Джем Карача рассказал, как его CLAUDE.md съедал около 42 тысяч токенов на разговор, и после чистки задача «починить баг в стилях» упала с 42 200 до 2400 токенов. Как собрать CLAUDE.md правильно, я разбирал в отдельном гайде «Как настроить CLAUDE.md».

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

Не раздует ли лишний MCP-сервер контекст ещё больше?

Логика «ещё один сервер - ещё больше веса в контексте» была верна раньше, но Claude Code это поменял. Теперь описания инструментов MCP по умолчанию отложены: в контекст на старте попадают только имена серверов, а полные описания подгружаются, когда конкретный инструмент нужен для задачи. В документации это сказано прямо.

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

Пара честных оговорок, чтобы ты не ждал магии. Индекс нужно иногда пересобирать - карта отражает код на момент сканирования, и после крупных правок её обновляют (у разных инструментов это по-разному, где-то автоматически, где-то командой). И громкие цифры вроде «в 120 раз меньше токенов» - это лучший случай на подобранных запросах, а не то, что ты увидишь на каждой задаче. Реальная экономия скромнее, но всё равно ощутима. Если хочешь глубже разобраться, как в принципе не упираться в лимиты, у меня есть отдельный разбор «Как не сжечь лимиты Claude Code».

С чего начать сегодня?

Если убрать всё лишнее, план на сегодня простой:

1. Поставь codebase-memory-mcp одной командой и попроси Claude один раз проиндексировать проект. Это даёт агенту карту кода вместо перечитывания.
2. Прогони /doctor и почисти то, что он предложит: дубли в CLAUDE.md, неиспользуемые инструменты.
3. Ужми CLAUDE.md до 200 строк, вынеся справочное в навыки.

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

Полная схема по вайб-кодингу за вечер: ИИ-клон + Второй мозг + Контекст-инжиниринг. Память кода - лишь один кирпичик контекст-инжиниринга. На практикуме собираешь всю связку, из-за которой Claude перестаёт начинать с нуля.

Практикум по вайб-кодингу

+Твой второй мозг

3 вечера - стек, метод, первый проект

Старт 14–16 июля  ·  2 000 ₽

Записаться →

Новые материалы - дайджестом, без спама

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

Подписаться в Telegramили на email