كيف توفّر 70% من رموز Claude عبر الوصول الموجَّه إلى الشيفرة
طوّر مبرمج أداة بلغة PHP وقاعدة SQLite لتحسين أداء Claude Code عند العمل على المشاريع الكبيرة. يبني سكربتان، هما buildGraph وclaudeSearch، رسمًا بيانيًا لتبعيات المشروع، ويمنحان الوكيل وصولًا موجَّهًا إلى الشيفرة: دالة محددة، أو حقول فئة، أو سلسلة وراثة، أو استعلامات SQL على جدول معيّن. وبدل قراءة الملفات بالكامل، بلغ التوفير في نافذة السياق 70%.
معالج بواسطة الذكاء الاصطناعي من Habr AI؛ بتحرير Hamidun News
طوّر مبرمج أداة توفّر 70% من نافذة السياق في Claude عند العمل على المشاريع الكبيرة. فبدل أن يقرأ وكيل الذكاء الاصطناعي الملفات بالكامل، يحصل على وصول موجَّه إلى الشيفرة المطلوبة، أي ما تحتاجه المهمة بالضبط.
المشكلة: سياق ثمين يُهدَر
يعرف Claude Code بنية المشروع من ملف CLAUDE.md ويفهم الملفات المسؤولة عن كل جزء. لكنه عمليًا يقرأ الملفات بالكامل. فإذا احتاج إلى دالة واحدة، قرأ الفئة كلها بجميع دوالها. وإذا أراد معرفة مواضع استدعاء دالة ما، قرأ مجلدًا بعد مجلد بحثًا عن الأنماط. وهكذا يتبدد السياق بسرعة قبل أن يُنجَز أي عمل مفيد.
من السيناريوهات المعتادة أن يطلب المطوّر من Claude العثور على حقل في كيان (Entity). يفتح الوكيل الملف كاملًا، مع أن المطلوب هو أول 20 سطرًا فقط، وفيها وصف الحقول والمُنشئ. أو أن يحتاج إلى فهم بنية العلاقات بين جداول قاعدة البيانات، فيقرأ Claude ملفات SQL بالكامل، مع أن أسماء الجداول والمفاتيح كانت كافية للإجابة.
نافذة السياق هي المورد الرئيسي عند العمل مع الذكاء الاصطناعي على المشاريع الكبيرة. ومن أصل 200K رمز، قد يذهب 100K منها في قراءة شيفرة كان يمكن الحصول عليها بطريقة أذكى.
الحل: رسم بياني للتبعيات ووصول موجَّه
كتب المطوّر سكربتين بلغة PHP يعملان معًا:
buildGraph.php يمسح المشروع مرة واحدة ويبني رسمًا بيانيًا للتبعيات في SQLite. يحلّل الشيفرة بلغتي PHP وJavaScript، ويستخرج الفئات والدوال والتوابع وعمليات الاستيراد وسلاسل الوراثة. والتشغيل تزايدي (incremental)، أي أنه عند إعادة التشغيل يحدّث الملفات التي تغيّرت فقط. ويستغرق ذلك من 100 إلى 200 ميلي ثانية لمشروع متوسط الحجم.
claudeSearch.php هو واجهة CLI للوكلاء. بأمر واحد يمنح Claude ما يحتاجه بالضبط:
- دالة محددة في فئة، مع توقيعها وجسمها
- جميع حقول الفئة ومُنشئها
- سلسلة الوراثة كاملة لكيان ما
- جميع استعلامات SQL على جدول معيّن
- قائمة بكل استدعاءات دالة في المشروع بأكمله
- التبعيات بين الوحدات
بدل Read(path/to/huge-file.php) يكتب Claude الآن search("User", "fields") ويحصل على 15 سطرًا. وبدل قراءة ثلاثة مجلدات، يكتب search("saveOrder()", "calls") فيرى جميع المواضع التي تُستخدم فيها هذه الدالة.
دعم اللغات والسرعة
تدعم الأداة حاليًا PHP وJavaScript بالكامل. وقد أُضيف دعم Go بالفعل، أما C فسيأتي لاحقًا.
سرعة التحليل أمر حاسم، فالرسم البياني يجب ألا يتأخر في التحديث عن وتيرة تعديل المطوّر للشيفرة. والتحديث التزايدي يحل هذه المشكلة: يحلّل المرور الأول المشروع كله (وقد يستغرق بضع ثوانٍ في مستودع كبير)، أما المرور اللاحقة فتحدّث الملفات المتغيّرة فقط خلال 100–200 ميلي ثانية.
ماذا يعني ذلك عمليًا
بحسب حسابات المؤلف، تخفّض الأداة استهلاك الرموز بنسبة 70% في مشروع متوسط نموذجي. وهذا لا يعني أن كل طلب منفرد يوفّر 70%، بل يعني أن السياق يُستخدم خلال جلسة تطوير واحدة بكفاءة أعلى بثلاثة أضعاف. فبدل إنفاق 150K رمز على القراءة ثم 50K على العمل، يمكن للمطوّر إنفاق 70K على البحث و80K على العمل.
والأداة مفيدة خصوصًا لمساعدات CLI والروبوتات التي لا ترى نظام الملفات بنفسها. فيصبح الرسم البياني بالنسبة إليها مصدر الحقيقة حول بنية المشروع.
الخلاصة
تُظهر الأداة اتجاهًا واضحًا: قابلية التوسع في العمل مع Claude على المشاريع الكبيرة لا تقتصر على القرارات المعمارية وملف CLAUDE.md المكتوب بإتقان، بل تتطلب وصولًا ذكيًا إلى الشيفرة. قراءة موجَّهة بدل القراءة الكاملة، ورسم بياني بدل نظام الملفات. وحين يصبح السياق قيدًا، ينبغي ألا تُقرأ الشيفرة بحسب حجمها، بل بحسب ما تحتاجه المهمة فعلًا.
- 21 نوفمبر 2026عدد وظائف FDE تضاعف 4.6 مرة خلال عام: ماذا يفعل المهندس في موقع العميل
- 21 نوفمبر 2026Anthropic تخفض سعر Claude Fable 5.2 بنسبة 20%، وفي اختبار البرمجة يكاد يعادل Opus 5.5
- 21 نوفمبر 2026Dreamteam تجمع 53 مليون دولار لنظام CRM يملأ بياناته تلقائيًا من البريد والمكالمات
- 21 نوفمبر 2026الذكاء الاصطناعي Claude Opus 5.5 يكمل لعبة الرعب Dimension 9 انطلاقًا من 15 غرفة صمّمها المطوّر
أسئلة وأجوبة حول الخبر
ما أبرز التفاصيل حول المشكلة: سياق ثمين يُهدَر؟
يعرف Claude Code بنية المشروع من ملف CLAUDE.md ويفهم الملفات المسؤولة عن كل جزء. لكنه عمليًا يقرأ الملفات بالكامل. فإذا احتاج إلى دالة واحدة، قرأ الفئة كلها بجميع دوالها. وإذا أراد معرفة مواضع استدعاء دالة ما، قرأ مجلدًا بعد مجلد بحثًا عن الأنماط. وهكذا يتبدد السياق بسرعة قبل أن يُنجَز أي عمل مفيد. من السيناريوهات المعتادة أن يطلب المطوّر من Claude العثور على حقل في كيان (Entity). يفتح الوكيل الملف كاملًا، مع أن المطلوب هو أول 20 سطرًا فقط، وفيها وصف الحقول والمُنشئ.
ما أبرز التفاصيل حول الحل: رسم بياني للتبعيات ووصول موجَّه؟
كتب المطوّر سكربتين بلغة PHP يعملان معًا: buildGraph.php يمسح المشروع مرة واحدة ويبني رسمًا بيانيًا للتبعيات في SQLite. يحلّل الشيفرة بلغتي PHP وJavaScript، ويستخرج الفئات والدوال والتوابع وعمليات الاستيراد وسلاسل الوراثة. والتشغيل تزايدي (incremental)، أي أنه عند إعادة التشغيل يحدّث الملفات التي تغيّرت فقط. ويستغرق ذلك من 100 إلى 200 ميلي ثانية لمشروع متوسط الحجم. claudeSearch.php هو واجهة CLI للوكلاء.
ما أبرز التفاصيل حول دعم اللغات والسرعة؟
تدعم الأداة حاليًا PHP وJavaScript بالكامل. وقد أُضيف دعم Go بالفعل، أما C فسيأتي لاحقًا. سرعة التحليل أمر حاسم، فالرسم البياني يجب ألا يتأخر في التحديث عن وتيرة تعديل المطوّر للشيفرة. والتحديث التزايدي يحل هذه المشكلة: يحلّل المرور الأول المشروع كله (وقد يستغرق بضع ثوانٍ في مستودع كبير)، أما المرور اللاحقة فتحدّث الملفات المتغيّرة فقط خلال 100–200 ميلي ثانية.
Build & Ship Production AI Agents Without Boilerplate Code
Start your free 72-hour trial at Hamidun Academy (academy.hamidun.com) — interactive lessons on Claude Code & Cursor, live Tech Radar, and production agent templates.
أهم ما في عالم الذكاء الاصطناعي — مرة كل أسبوع
سبع قصص مهمة فعلاً هذا الأسبوع، مختارة بعناية. بلا ضجيج ولا بيانات صحفية.
تم! تحقق من بريدك للتأكيد.