Untuk pengguna Claude Code

Claude mula setiap sesi secara buta.

CLAUDE.md beritahu Claude macam mana nak berkelakuan. Ia tak beritahu Claude apa yang ada dalam repo anda. Maguyva indeks pangkalan kod dan sampaikannya semula melalui MCP, supaya Claude sunting macam ia dah pun baca kod itu.

Mula percuma Baca persediaan Claude Code

Peringkat Free: 3 repositori, Sehingga 50K baris repo terindeks, tanpa kad.

Guna CLAUDE.md untuk kelakuan. Guna Maguyva untuk fakta pangkalan kod terkini.

CLAUDE.md ialah amalan terbaik. Gunakannya.

> cat CLAUDE.md
# project conventions, commands, scoped rules

Arahan kekal patut berada dalam CLAUDE.md. Ia tempat yang betul untuk:

Arahan binaan, ujian, dan lint yang ejen patut jalankan.
Peraturan gaya kod dan konvensyen penamaan.
Sekatan “sentiasa buat X / jangan sekali buat Y” yang skop kepada satu direktori.
Petunjuk kepada dokumen kanonik dan log keputusan.

Dokumen memory Anthropic terangkan ini dengan baik. Kekalkan ia ringkas. Skopkan ia. Commit ia.

Tapi CLAUDE.md tak pernah dimaksudkan untuk jadi peta pangkalan kod anda.

Di mana CLAUDE.md berhenti mencukupi

Empat mod kegagalan yang markdown sahaja tak boleh betulkan.

// fail itu bukan pangkalan kod

Beritahu Claude macam mana nak berkelakuan tak beritahu ia apa yang wujud. Suntingan pertama pada repo yang tak biasa adalah tekaan tentang laluan fail, nama fungsi, dan tapak panggilan. CLAUDE.md tak boleh senaraikan setiap simbol, dan anda pun tak nak ia begitu.

// dokumen jadi basi, kod tidak

Blok CLAUDE.md yang terangkan aliran auth anda betul sehingga seseorang refactor auth. Kod kini punca kebenaran dan dokumen itu salah dengan yakin. Claude baca yang salah.

// kebergantungan tiada dalam markdown

“Apa yang rosak kalau saya ubah fungsi ini?” ialah soalan graf. Ia tak boleh dijawab oleh fail dokumen. Claude sama ada grep-and-berharap atau minta anda tampal fail ke dalam chat.

// context window ada bajet

Menyumbat CLAUDE.md sehingga Claude “cukup tahu” makan token yang patut dibayar untuk penaakulan. Lepas beberapa KB anda tukar kualiti jawapan dengan jumlah konteks.

Maguyva ialah lapisan yang tak diliputi CLAUDE.md

Pelayan MCP jauh yang bagi Claude Code:

Carian semantik, AST, graf, dan teks atas repo anda yang diindeks, dipulangkan dengan laluan fail dan nombor baris.
Carian kebergantungan, jenis, dan tapak panggilan soalan yang graf boleh jawab tapi fail dokumen tak boleh.
Keputusan sedar cabang (branch) supaya Claude nampak versi kod yang ia betul-betul sunting.
Harga ikut ruang kerja bukan ikut seat. Indeks 1 repo atau 50; ejen tak bayar seat.

CLAUDE.md beritahu Claude macam mana nak berkelakuan.
Maguyva bagi Claude peta kod yang boleh ditanya.

Tiga aliran kerja

Bernombor, banyak blok kod. Soalan yang anda dah pun tanya Claude, terbukti berdasarkan baris sebenar.

// workflow 01

Cari implementasi sebenar, bukan stub ujian

Anda: "Macam mana retry berfungsi dalam payment client kita?"

Tanpa Maguyva → Claude grep retry, jumpa 14 padanan, pilih satu (selalunya mock ujian).
Dengan Maguyva    → Maguyva pulangkan definisi simbol, tapak panggilan, dan
                   file:line implementasi sebenar, disusun.

// workflow 02

Semak blast radius sebelum anda refactor

Anda: "Apa yang panggil normalizePhoneNumber?"

Maguyva pulangkan: 7 tapak panggilan merentasi 4 pakej, termasuk satu dalam servis Python
yang import melalui stub gRPC. Claude cadangkan perubahan dengan senarai
migrasi terus, bukan selepas CI jadi merah.

// workflow 03

Sahkan ejen sebelum anda terima diff

Claude: "Saya sunting src/auth/session.ts:142 untuk betulkan token refresh."

Tanya Maguyva: "Tunjuk saya session.ts:130-160 dan apa jua yang import session."

Maguyva pulangkan potongan fail sebenar + 3 pengimport. Diff itu kini terbukti
berdasarkan baris sebenar, bukan ingatan Claude daripada token #11,000.

Sediakan Claude Code

Tiga langkah. Peringkat Free: 3 repositori, Sehingga 50K baris repo terindeks, tanpa kad.

// step 01
Indeks repo di maguyva.ai
Pilih satu yang anda kenal dengan baik supaya anda boleh mengesahkan jawapannya. Peringkat Free merangkumi 3 repositori, Sehingga 50K baris repo terindeks.

// step 02

Pasang plugin Maguyva dalam 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

// step 03
Tanya satu soalan yang anda dah tahu jawapannya
Mula dengan satu repo dan satu soalan yang boleh disahkan, bukan seluruh syarikat anda. Kalau jawapannya sepadan dengan apa yang anda akan cakap, anda dah sedia.