// ไฟล์ไม่ใช่โค้ดเบส
การบอก Claude ว่าต้องทำตัวยังไง ไม่ได้บอกว่ามีอะไรอยู่จริง การแก้ไขครั้งแรกในรีโพที่ไม่คุ้นเคยคือการเดาพาธไฟล์ ชื่อฟังก์ชัน และจุดเรียกใช้ CLAUDE.md ไม่สามารถลิสต์ทุกสัญลักษณ์ได้ และคุณก็ไม่อยากให้มันเป็นแบบนั้นด้วย
สำหรับผู้ใช้ Claude Code
Claude เริ่มทุกเซสชันแบบมองไม่เห็นอะไรเลย
CLAUDE.md บอก Claude ว่าต้องทำตัวยังไง แต่ไม่ได้บอกว่ามีอะไรอยู่ในรีโพของคุณ Maguyva ทำดัชนีโค้ดเบสและส่งข้อมูลกลับผ่าน MCP ทำให้ Claude แก้ไขได้ราวกับอ่านโค้ดมาก่อนแล้ว
แผน Free: รีโพซิทอรี 3 แห่ง, บรรทัดที่ทำดัชนีสูงสุด 50,000 บรรทัด ไม่ต้องใช้บัตร
ใช้ CLAUDE.md สำหรับควบคุมพฤติกรรม ใช้ Maguyva สำหรับข้อเท็จจริงล่าสุดของโค้ดเบสCLAUDE.md คือแนวปฏิบัติที่ดี ใช้มันให้เต็มที่
> cat CLAUDE.md
# project conventions, commands, scoped rulesคำสั่งที่ต้องคงอยู่ถาวรควรอยู่ใน CLAUDE.md มันคือที่ที่เหมาะสำหรับ:
- คำสั่งบิลด์ เทสต์ และ lint ที่เอเจนต์ควรรัน
- กฎการเขียนโค้ดและข้อตกลงการตั้งชื่อ
- กฎแบบ “ต้องทำ X เสมอ / ห้ามทำ Y” ที่จำกัดขอบเขตไว้ในไดเรกทอรีหนึ่งๆ
- ลิงก์ไปยังเอกสารมาตรฐานและบันทึกการตัดสินใจ
เอกสารเรื่องความจำของ Anthropic อธิบายเรื่องนี้ไว้ดีมาก เขียนให้กระชับ จำกัดขอบเขตไว้ แล้ว commit มันเก็บไว้
แต่ CLAUDE.md ไม่เคยถูกออกแบบมาให้เป็นแผนที่ของโค้ดเบสคุณ
จุดที่ CLAUDE.md เพียงลำพังไม่พอแล้ว
สี่รูปแบบความล้มเหลวที่ markdown เพียงลำพังแก้ไม่ได้
// เอกสารล้าสมัย แต่โค้ดไม่เคยล้าสมัย
บล็อกใน CLAUDE.md ที่อธิบายโฟลว์การยืนยันตัวตนของคุณถูกต้องอยู่จนกว่าจะมีใครรีแฟกเตอร์ auth ตอนนี้โค้ดคือแหล่งความจริง ส่วนเอกสารผิดไปแล้วอย่างมั่นใจ Claude กลับอ่านอันที่ผิดอยู่
// การพึ่งพาไม่ได้อยู่ใน markdown
“ถ้าแก้ฟังก์ชันนี้ อะไรจะพังบ้าง?” คือคำถามของกราฟ ตอบไม่ได้จากไฟล์เอกสาร Claude ก็ต้อง grep แล้วภาวนา หรือไม่ก็ขอให้คุณวางไฟล์ลงในแชท
// คอนเท็กซ์วินโดว์มีงบจำกัด
การยัด CLAUDE.md จน Claude “รู้พอ” กินโทเคนที่ควรเอาไปใช้คิดวิเคราะห์แทน เกินไม่กี่ KB คุณก็แลกคุณภาพคำตอบกับปริมาณบริบทไปแล้ว
Maguyva คือชั้นที่ CLAUDE.md ไม่ครอบคลุมถึง
เซิร์ฟเวอร์ MCP ระยะไกลที่มอบสิ่งเหล่านี้ให้ Claude Code:
- ค้นหาเชิงความหมาย เชิง AST เชิงกราฟ และเชิงข้อความ ครอบคลุมรีโพที่ทำดัชนีไว้ พร้อมพาธไฟล์และเลขบรรทัด
- ค้นหาการพึ่งพา ประเภทข้อมูล และจุดเรียกใช้ คำถามที่กราฟตอบได้ แต่ไฟล์เอกสารตอบไม่ได้
- ผลลัพธ์ที่รับรู้แบรนช์ ทำให้ Claude มองเห็นโค้ดเวอร์ชันเดียวกับที่กำลังแก้ไขอยู่จริง
- ราคาแบบเวิร์กสเปซ ไม่ใช่ต่อที่นั่ง ทำดัชนี 1 รีโพหรือ 50 รีโพก็ได้ เอเจนต์ไม่ต้องจ่ายค่าที่นั่ง
CLAUDE.md บอก Claude ว่าต้องทำตัวยังไง
Maguyva มอบแผนที่ของโค้ดที่สอบถามได้ให้ Claude
สามเวิร์กโฟลว์
เรียงเป็นข้อ เน้นบล็อกโค้ด คำถามที่คุณถาม Claude อยู่แล้ว แต่อ้างอิงจากบรรทัดโค้ดจริง
// workflow 01
หาการอิมพลีเมนต์จริง ไม่ใช่ test stub
คุณ: "retry ใน payment client ของเราทำงานยังไง?"
ถ้าไม่มี Maguyva → Claude ก็ grep หา retry เจอ 14 จุด แล้วเลือกมาหนึ่งจุด (ส่วนใหญ่มักเป็น test mock)
ถ้ามี Maguyva → Maguyva คืนคำนิยามของสัญลักษณ์ จุดเรียกใช้ และ
file:line ของการอิมพลีเมนต์จริง พร้อมจัดอันดับให้// workflow 02
เช็ครัศมีผลกระทบก่อนรีแฟกเตอร์
คุณ: "มีอะไรเรียก normalizePhoneNumber บ้าง?"
Maguyva ตอบว่า: มีจุดเรียกใช้ 7 จุด ครอบคลุม 4 แพ็กเกจ รวมถึงจุดหนึ่งในบริการ Python
ที่นำเข้าผ่าน gRPC stub Claude เสนอการเปลี่ยนแปลงพร้อมรายการย้าย
แบบอินไลน์ ไม่ใช่หลัง CI ขึ้นแดง// workflow 03
ตรวจสอบเอเจนต์ก่อนรับ diff
Claude: "ผมแก้ไขsrc/auth/session.ts:142เพื่อแก้ปัญหา token refresh แล้ว" ถาม Maguyva: "ขอดูsession.ts:130-160และอะไรก็ตามที่นำเข้า session หน่อย" Maguyva คืนส่วนของไฟล์แบบสดพร้อมผู้นำเข้า 3 ราย ตอนนี้ diff อ้างอิงจาก บรรทัดจริง ไม่ใช่ความจำของ Claude จากโทเคนที่ #11,000
ตั้งค่าใน Claude Code
สามขั้นตอน แผน Free: รีโพซิทอรี 3 แห่ง, บรรทัดที่ทำดัชนีสูงสุด 50,000 บรรทัด ไม่ต้องใช้บัตร
// step 01
ทำดัชนีรีโพที่ maguyva.ai
เลือก repo ที่คุณรู้จักดีเพื่อให้ตรวจสอบคำตอบได้ แผน Free ครอบคลุม รีโพซิทอรี 3 แห่ง, บรรทัดที่ทำดัชนีสูงสุด 50,000 บรรทัด
// 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// step 03
ถามคำถามเดียวที่คุณรู้คำตอบอยู่แล้ว
เริ่มจากรีโพเดียวและคำถามเดียวที่ตรวจสอบได้ ไม่ใช่ทั้งบริษัทของคุณ ถ้าคำตอบตรงกับที่คุณจะตอบเอง ก็พร้อมใช้งานได้เลย