يدعم Claude Code الآن العمل عبر أدلة متعددة في جلسة واحدة باستخدام العلامة --add-dir والأمر التفاعلي /add-dir. هذا يلغي التبديل المستمر للسياق بين المشاريع.
ما هو دعم الأدلة المتعددة؟
الوظائف الأساسية
تضيف العلامة --add-dir /path/to/dir أدلة إلى جلسة Claude Code الخاصة بك دون تغيير دليل العمل الخاص بك. استخدم /add-dir <path> خلال الجلسات التفاعلية لتوسيع مساحة عملك ديناميكيًا.
يحافظ Claude Code على علاقات الملفات عبر هياكل الأدلة المختلفة مع الحفاظ على الأداء. يتعامل النظام مع حل المسار تلقائيًا عند الإشارة إلى الملفات من الأدلة المضافة.
حالات الاستخدام الرئيسية
المستودعات الموحدة (Monorepos)
اعمل عبر الوحدات الأمامية والخلفية والمشتركة دون تبديل الجلسات. تستفيد التطبيقات الكبيرة ذات الفصل المنطقي من الوصول الموحد إلى جميع المكونات.
ملفات التكوين المشتركة
الوصول إلى ملفات التكوين والوثائق ومخرجات التطوير المخزنة في مواقع منفصلة. تصبح ملفات الإنتاجية الشخصية ووثائق الفريق متاحة باستمرار عبر الجلسات.
التطوير عبر المشاريع
إدارة المستودعات المترابطة في وقت واحد. تظل عملاء واجهة برمجة التطبيقات (API) متزامنين مع تطبيقات الخادم. يتم تحديث الوثائق جنبًا إلى جنب مع تغييرات التعليمات البرمجية.
استراتيجيات التنفيذ
إعداد مساحة العمل
- حدد دليل العمل الأساسي الخاص بك
- أضف الأدلة ذات الصلة باستخدام
--add-dir - أنشئ اختصارات (aliases) للصدفة للتكوينات الشائعة
- ضع أنماط أدلة على مستوى الفريق
تحسين الأداء
- أضف فقط الأدلة التي تستخدمها بنشاط
- تجنب الأدلة التي تحتوي على مخرجات البناء (build artifacts)
- راقب استخدام رمز السياق (context token) مع التكوينات الكبيرة
- استخدم المسارات المطلقة للوصول الموثوق
تكامل التطوير
يعمل دعم الأدلة المتعددة مع سير عمل Git الحالي، وأنظمة التكامل المستمر (CI)، وخطوط أنابيب النشر. يمكن لأدوات تطوير واجهة برمجة التطبيقات مثل Apidog مراقبة المواصفات عبر أدلة المشاريع المتعددة.
أمثلة عملية
هندسة الخدمات المصغرة (Microservices)
الوصول إلى تطبيقات الخدمات والمكتبات المشتركة وقوالب التكوين ونصوص النشر في جلسة واحدة. ارجع إلى الأنماط الموجودة أثناء تطوير خدمات جديدة.
المساهمات مفتوحة المصدر
اعمل مع المستودعات المتفرعة (forked repositories)، والمصادر الأصلية (upstream sources)، والتكوينات الشخصية في وقت واحد. حافظ على مساهمات نظيفة أثناء الوصول إلى جميع قواعد التعليمات البرمجية ذات الصلة.
البنية التحتية كتعليمات برمجية (Infrastructure as Code)
إدارة تعريفات التطبيقات، وتكوينات النشر، وإعدادات المراقبة عبر مستودعات متعددة. حافظ على الاتساق أثناء تغييرات البنية التحتية.
أفضل الممارسات
إدارة التكوين
استخدم المسارات المطلقة لتجنب مشاكل الحل. تحقق من أذونات القراءة لجميع الأدلة. أنشئ إعدادات موحدة لاتساق الفريق.
اعتبارات الأمان
راجع محتويات الدليل قبل إضافتها. استبعد المعلومات الحساسة وبيانات اعتماد الإنتاج. استخدم أدلة تطوير مخصصة.
مراقبة الأداء
راقب استخدام الذاكرة مع هياكل الأدلة الواسعة. توفر الأدلة المحلية أداءً أفضل من تلك المثبتة عبر الشبكة. أزل الأدلة غير المستخدمة من الجلسات.
الميزات المتقدمة
تكامل سطر الأوامر
claude-code --add-dir /path/to/backend --add-dir /path/to/frontend
الأوامر التفاعلية
/add-dir /path/to/shared-config
/add-dir /path/to/documentation
سير عمل الفريق
توحيد تكوينات الأدلة المتعددة عبر الفرق. توثيق الأنماط الشائعة لتجربة مطور متسقة. التكامل مع عمليات الانضمام (onboarding).
سير عمل تطوير واجهة برمجة التطبيقات (API)
يعزز دعم الأدلة المتعددة تطوير واجهة برمجة التطبيقات أولاً (API-first). غالبًا ما توجد خدمات الواجهة الخلفية والوثائق ومجموعات تطوير البرامج للعملاء (SDKs) وحزم الاختبار في مستودعات منفصلة ولكنها تتطلب تحديثات متزامنة.
يوفر Apidog واجهات اختبار موحدة تعمل عبر مساحة عملك متعددة الأدلة. يضمن هذا اتساق واجهة برمجة التطبيقات أثناء تطوير الميزات التي تمتد عبر مشاريع متعددة.
استكشاف المشكلات الشائعة وإصلاحها
مشاكل حل المسار
- استخدم المسارات المطلقة بدلاً من المسارات النسبية
- تحقق من عمل الروابط الرمزية (symbolic links) بشكل صحيح
- تحقق من أذونات الدليل
مشاكل الأداء
- قصر الأدلة المضافة على الضرورية منها
- راقب موارد النظام
- أزل الأدلة غير المستخدمة خلال الجلسات الطويلة
التحكم في الوصول
- تأكد من أذونات القراءة الصحيحة
- تجنب إضافة أدلة تحتوي على بيانات حساسة
- استخدم هياكل أدلة خاصة بالتطوير
التحسينات المستقبلية
يطلب المجتمع ملفات تكوين لإعدادات مساحة العمل الدائمة. سيمكن هذا من التوحيد القياسي على مستوى الفريق ويقلل من مهام الإعداد المتكررة.
تستمر فرص التكامل مع منصات التطوير في التوسع. يمكن لأدوات تطوير واجهة برمجة التطبيقات وأنظمة إدارة المشاريع ومنصات التعاون الاستفادة من قدرات مساحة العمل المحسّنة.
الخلاصة
يزيل دعم الأدلة المتعددة في Claude Code الاحتكاك في سير العمل في التطوير الحديث. تصبح المستودعات الموحدة (Monorepos)، والخدمات المصغرة (microservices)، والتعاون عبر المشاريع سلسة دون تكلفة إضافية للتبديل بين السياقات.
ابدأ بتكوينات بسيطة ذات دليلين ووسعها بناءً على احتياجات المشروع. يوفر منحنى التعلم البسيط تحسينات كبيرة في الإنتاجية مع نمو تعقيد المشروع.
بالاقتران مع أدوات اختبار واجهة برمجة التطبيقات الشاملة مثل Apidog، يخلق دعم الأدلة المتعددة تجارب تطوير مبسطة وشاملة. جرب التكوينات التي تتوافق مع متطلبات مشروعك المحددة لتحقيق أقصى فائدة.