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

Canonical source: https://maguyva.ai/ru/for-claude-code

License: text under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); code samples under [MIT-0](https://opensource.org/license/mit-0); the Maguyva name, logos, brand assets and other code are not covered. Details: [maguyva.ai/license](https://maguyva.ai/license).

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

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

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

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

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

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

[Документация Anthropic по памяти](https://code.claude.com/docs/en/memory) хорошо это описывает. Держите его кратким. Ограничивайте область применения. Коммитьте.

Но `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, — с опорой на реальные строки кода.

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

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

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

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

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

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

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

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

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

Maguyva возвращает актуальный фрагмент файла + 3 импортирующих модуля. Теперь дифф опирается
на реальные строки, а не на воспоминания Claude из токена №11 000.
```

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

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

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

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

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

```text
/plugin marketplace add maguyva/agent-plugins
/plugin install maguyva@maguyva

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

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

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

Полные инструкции — в [документации Maguyva](https://maguyva.ai/ru/docs).

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

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