Перейти до вмісту

Для користувачів Claude Code

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

CLAUDE.md каже Claude, як поводитися. Але не каже Claude, що є у вашому репозиторії. Maguyva індексує кодову базу і повертає її через MCP, тож Claude редагує так, ніби вже прочитав код.

Почати безкоштовноЧитати про налаштування 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 повертає визначення символу, місця виклику й
                   файл:рядок реальної реалізації, відсортовані.

// workflow 02

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

Ви: "Що викликає normalizePhoneNumber?"

Maguyva повертає: 7 місць виклику в 4 пакетах, зокрема одне в Python-сервісі,
що імпортує її через gRPC-стаб. Claude пропонує зміну з переліком міграції
прямо тут, а не після того, як CI загориться червоним.

// workflow 03

Перевірте агента, перш ніж прийняти diff

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

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

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