# Claude починає кожну сесію наосліп.

Canonical source: https://maguyva.ai/uk/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, як поводитися. Але не каже 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. Перевірте агента, перш ніж прийняти diff

```text
Claude: "Я відредагував src/auth/session.ts:142, щоб виправити оновлення токена."

Запитайте Maguyva: "Покажи мені session.ts:130-160 і все, що імпортує session."

Maguyva повертає актуальний зріз файлу + 3 імпортери. Diff тепер обґрунтований
реальними рядками, а не спогадом 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/uk/docs).

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

Перевірте одне запитання, відповідь на яке можна підтвердити. Ось і весь онбординг.