# يبدأ Claude كل جلسة أعمى.

Canonical source: https://maguyva.ai/ar/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`. إنه المكان الصحيح لـ:

- أوامر البناء والاختبار والـlint التي ينبغي أن يشغِّلها الوكيل.
- قواعد أسلوب الترميز وأعراف التسمية.
- ضوابط “افعل X دائمًا / لا تفعل Y أبدًا” المحدَّدة النطاق لمجلد معيَّن.
- إشارات إلى الوثائق المرجعية وسجلّات القرارات.

تصف [وثائق الذاكرة](https://code.claude.com/docs/en/memory) من Anthropic هذا جيدًا. اجعله موجزًا. حدِّد نطاقه. أودعه في Git.

لكن `CLAUDE.md` لم يُقصَد به قط أن يكون خريطة لقاعدة الكود لديك.

## أين يتوقّف CLAUDE.md عن الكفاية

أربعة أنماط فشل لا يمكن لملف markdown وحده إصلاحها.

### ‏// الملف ليس قاعدة الكود

إخبار Claude *كيف يتصرَّف* لا يخبره *بما هو موجود*. التعديل الأول على مستودع غير مألوف هو تخمين لمسارات الملفات وأسماء الدوال ومواقع الاستدعاء. لا يمكن لـCLAUDE.md سرد كل رمز، ولن ترغب في ذلك أصلًا.

### ‏// الوثائق تصبح قديمة، والكود لا

قسم في `CLAUDE.md` يصف تدفق المصادقة لديك يكون صحيحًا إلى أن يعيد أحدهم هيكلة المصادقة. الكود الآن هو مصدر الحقيقة، والوثائق خاطئة بثقة زائفة. يقرأ Claude الوثيقة الخاطئة.

### ‏// التبعيات ليست في ملفات markdown

«ما الذي سيتعطَّل إن غيّرت هذه الدالة؟» سؤال يخص الرسم البياني. لا يمكن الإجابة عنه من ملف وثائقي. إما أن يبحث Claude بـgrep ويدعو أن ينجح، أو يطلب منك لصق الملفات في المحادثة.

### ‏// نوافذ السياق لها ميزانية

حشو CLAUDE.md إلى أن “يعرف Claude ما يكفي” يستهلك رموزًا (tokens) كان ينبغي أن تُنفَق على الاستدلال. بعد بضع كيلوبايتات، تستبدل جودة الإجابة بحجم السياق.

## Maguyva هو الطبقة التي لا يغطّيها CLAUDE.md

خادم MCP بعيد يمنح Claude Code:

- **بحث دلالي، وAST، ورسم بياني، ونصي**: عبر مستودعك المُفهرَس، تُعاد نتائجه مع مسارات الملفات وأرقام الأسطر.
- **عمليات بحث عن التبعيات، والأنواع، ومواقع الاستدعاء**: الأسئلة التي يجيب عنها الرسم البياني ولا يستطيع ملف وثائقي الإجابة عنها.
- **نتائج واعية بالفرع**: لذا يرى Claude نسخة الكود التي يحرِّرها فعليًا.
- **تسعير مساحة العمل**: لا لكل مقعد. افهرس مستودعًا واحدًا أو 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 ‏(stub). يقترح Claude التغيير مع قائمة
الترحيل مضمَّنة، لا بعد أن يتحوّل CI إلى الأحمر.
```

### 03. تحقّق من الوكيل قبل قبول الفرق

```text
Claude: "عدَّلت src/auth/session.ts:142 لإصلاح تجديد الرمز المميّز (token refresh)."

اسأل Maguyva: "أرِني session.ts:130-160 وأي شيء يستورد session."

يُرجع Maguyva شريحة الملف الحية + 3 مستوردين. الفرق الآن مؤسَّس
على أسطر حقيقية، لا على تذكُّر Claude من الرمز (token) رقم 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/ar/docs).

## افهرس مستودعًا واحدًا تعرفه جيدًا.

اختبر سؤالًا واحدًا يمكنك التحقق من إجابته. هذه هي التهيئة الأولية بأكملها.