# Claude เริ่มทุกเซสชันแบบมองไม่เห็นอะไรเลย

Canonical source: https://maguyva.ai/th/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
# project conventions, commands, scoped rules
```

คำสั่งที่ต้องคงอยู่ถาวรควรอยู่ใน `CLAUDE.md` มันคือที่ที่เหมาะสำหรับ:

- คำสั่งบิลด์ เทสต์ และ lint ที่เอเจนต์ควรรัน
- กฎการเขียนโค้ดและข้อตกลงการตั้งชื่อ
- กฎแบบ “ต้องทำ X เสมอ / ห้ามทำ Y” ที่จำกัดขอบเขตไว้ในไดเรกทอรีหนึ่งๆ
- ลิงก์ไปยังเอกสารมาตรฐานและบันทึกการตัดสินใจ

[เอกสารเรื่องความจำ](https://code.claude.com/docs/en/memory)ของ Anthropic อธิบายเรื่องนี้ไว้ดีมาก เขียนให้กระชับ จำกัดขอบเขตไว้ แล้ว commit มันเก็บไว้

แต่ `CLAUDE.md` ไม่เคยถูกออกแบบมาให้เป็นแผนที่ของโค้ดเบสคุณ

## จุดที่ CLAUDE.md เพียงลำพังไม่พอแล้ว

สี่รูปแบบความล้มเหลวที่ markdown เพียงลำพังแก้ไม่ได้

### // ไฟล์ไม่ใช่โค้ดเบส

การบอก Claude ว่า*ต้องทำตัวยังไง* ไม่ได้บอกว่า*มีอะไรอยู่จริง* การแก้ไขครั้งแรกในรีโพที่ไม่คุ้นเคยคือการเดาพาธไฟล์ ชื่อฟังก์ชัน และจุดเรียกใช้ CLAUDE.md ไม่สามารถลิสต์ทุกสัญลักษณ์ได้ และคุณก็ไม่อยากให้มันเป็นแบบนั้นด้วย

### // เอกสารล้าสมัย แต่โค้ดไม่เคยล้าสมัย

บล็อกใน `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 อยู่แล้ว แต่อ้างอิงจากบรรทัดโค้ดจริง

### 01. หาการอิมพลีเมนต์จริง ไม่ใช่ test stub

```text
คุณ: "retry ใน payment client ของเราทำงานยังไง?"

ถ้าไม่มี Maguyva → Claude ก็ grep หา retry เจอ 14 จุด แล้วเลือกมาหนึ่งจุด (ส่วนใหญ่มักเป็น test mock)
ถ้ามี Maguyva    → Maguyva คืนคำนิยามของสัญลักษณ์ จุดเรียกใช้ และ
                   file:line ของการอิมพลีเมนต์จริง พร้อมจัดอันดับให้
```

### 02. เช็ครัศมีผลกระทบก่อนรีแฟกเตอร์

```text
คุณ: "มีอะไรเรียก normalizePhoneNumber บ้าง?"

Maguyva ตอบว่า: มีจุดเรียกใช้ 7 จุด ครอบคลุม 4 แพ็กเกจ รวมถึงจุดหนึ่งในบริการ Python
ที่นำเข้าผ่าน gRPC stub Claude เสนอการเปลี่ยนแปลงพร้อมรายการย้าย
แบบอินไลน์ ไม่ใช่หลัง CI ขึ้นแดง
```

### 03. ตรวจสอบเอเจนต์ก่อนรับ diff

```text
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 บรรทัด ไม่ต้องใช้บัตรเครดิต

### 01. ทำดัชนีรีโพที่ maguyva.ai

เลือกรีโพที่คุณรู้จักดีเพื่อให้ตรวจสอบคำตอบได้ แผน Free ครอบคลุม รีโพซิทอรี 3 แห่ง, บรรทัดที่ทำดัชนีสูงสุด 50,000 บรรทัด

### 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/th/docs)

## ทำดัชนีรีโพเดียวที่คุณรู้จักดีอยู่แล้ว

ลองถามคำถามเดียวที่คุณตรวจสอบคำตอบได้ แค่นี้ก็คือการเริ่มต้นใช้งานทั้งหมดแล้ว