Перейти к содержимому

Для пользователей Claude Code

Claude начинает каждую сессию вслепую.

CLAUDE.md рассказывает Claude, как себя вести. Но не рассказывает, что находится в вашем репозитории. Maguyva индексирует кодовую базу и отдаёт её обратно через MCP, так что Claude редактирует так, будто уже прочитал весь код.

Начать с FreeЧитать про настройку Claude Code

Тариф Free: 3 репозитория, До 50 тыс. проиндексированных строк, без карты.

Используйте CLAUDE.md для поведения. Используйте Maguyva для актуальных фактов о кодовой базе.

CLAUDE.md — это лучшая практика. Используйте её.

> cat CLAUDE.md
# соглашения проекта, команды, ограниченные по области правила

Постоянные инструкции — место для них в CLAUDE.md. Это правильное место для:

  • Команд сборки, тестирования и линтинга, которые должен запускать агент.
  • Правил стиля кода и соглашений об именовании.
  • Ограничений вида “всегда делай X / никогда не делай Y”, привязанных к директории.
  • Ссылок на канонические документы и журналы решений.

Документация Anthropic по памяти хорошо это описывает. Держите его кратким. Ограничивайте область применения. Коммитьте.

Но CLAUDE.md никогда не задумывался как карта вашей кодовой базы.

Где CLAUDE.md перестаёт справляться

Четыре сценария сбоя, которые один markdown не исправит.

// файл — это не кодовая база

Рассказать Claude, как себя вести, не значит рассказать, что существует. Первая правка в незнакомом репозитории — это догадка о путях файлов, именах функций и местах вызова. CLAUDE.md не может перечислить каждый символ, да и не должен.

// документация устаревает, код — нет

Блок в CLAUDE.md, описывающий поток авторизации, верен, пока кто-то не сделает рефакторинг авторизации. Теперь источник истины — код, а документация уверенно ошибается. Claude читает не тот источник.

// зависимостей нет в markdown

«Что сломается, если я изменю эту функцию?» — это вопрос про граф. Документ на него не ответит. Claude либо делает grep и надеется на удачу, либо просит вас вставить файлы в чат.

// у окна контекста есть бюджет

Раздувание CLAUDE.md, пока Claude не «узнает достаточно», съедает токены, которые должны идти на рассуждение. После нескольких килобайт вы меняете качество ответа на объём контекста.

Maguyva — это слой, который не покрывает CLAUDE.md

Удалённый MCP-сервер, который даёт Claude Code:

  • Семантический, AST, графовый и текстовый поиск по вашему проиндексированному репозиторию, с путями к файлам и номерами строк.
  • Поиск зависимостей, типов и мест вызова вопросы, на которые отвечает граф, а не документ.
  • Результаты с учётом веток так что Claude видит ту версию кода, которую действительно редактирует.
  • Тарификация по рабочему пространству а не за место. Проиндексируйте 1 репозиторий или 50 — агенты не платят за места.

CLAUDE.md рассказывает Claude, как себя вести.

Maguyva даёт Claude карту кода с возможностью запроса.

Три сценария

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

// workflow 01

Найдите настоящую реализацию, а не тестовую заглушку

Вы: "Как работает retry в нашем платёжном клиенте?"

Без Maguyva → Claude делает grep по retry, находит 14 совпадений, выбирает одно (часто тестовый мок).
С Maguyva    → Maguyva возвращает определение символа, места вызова и
                   file:line настоящей реализации, отранжированные.

// workflow 02

Проверьте радиус влияния перед рефакторингом

Вы: "Что вызывает normalizePhoneNumber?"

Maguyva возвращает: 7 мест вызова в 4 пакетах, включая одно в сервисе на Python,
который импортирует функцию через gRPC-заглушку. Claude предлагает изменение со списком
миграции прямо в выводе, а не после того, как CI покраснеет.

// workflow 03

Проверьте агента, прежде чем принять дифф

Claude: "Я отредактировал src/auth/session.ts:142, чтобы исправить обновление токена."

Спросите Maguyva: "Покажи мне session.ts:130-160 и всё, что импортирует session."

Maguyva возвращает живой срез файла + 3 импортёра. Теперь дифф обоснован
реальными строками, а не воспоминаниями Claude из токена №11 000.

Настройка в Claude Code

Три шага. Тариф Free: 3 репозитория, До 50 тыс. проиндексированных строк, без карты.

  1. // step 01

    Проиндексируйте репозиторий на maguyva.ai

    Выберите тот, который хорошо знаете, чтобы проверить ответы. Тариф Free покрывает 3 репозитория, До 50 тыс. проиндексированных строк.

  2. // step 02

    Установите плагин Maguyva в Claude Code

    /plugin marketplace add maguyva/claude-code-plugin
/plugin install maguyva@maguyva

# the plugin reads your key from the environment
export MAGUYVA_API_KEY=mgv_xxxx

  3. // step 03

    Задайте один вопрос, ответ на который вы уже знаете

    Начните с одного репозитория и одного проверяемого вопроса, а не сразу со всей компании. Если ответ совпадает с тем, что сказали бы вы, — всё готово.

Полные инструкции — в документации Maguyva.

Самостоятельная регистрация открыта.

Проиндексируйте один репозиторий, который вы уже знаете.

Проверьте один вопрос, ответ на который можно перепроверить. Это весь онбординг.

Проиндексируйте первый репозиторийСмотреть документацию по совместимости

план Free: 3 репозитория, До 50 тыс. проиндексированных строк, без карты.