Claude Code بلا سحر: Habr يحلل المعمارية وضوضاء السياق والممارسات الهندسية

تم نشر ترجمة نص عملي كبير عن Claude Code على Habr، استنادًا إلى ستة أشهر من العمل المكثف مع الوكيل. هذا ليس ملخصًا للميزات، بل تحليل لسبب بدء أداة الذكاء الاصطناعي لتطوير البرامج في الفشل عندما يتم إعطاؤها الكثير من السياق والقواعد والحرية في نفس الوقت.

حيث يُفقد السياق

الفكرة الرئيسية للمقالة بسيطة: Claude Code لا ينهار لأن النموذج "ليس ذكيًا بما يكفي"، بل لأن بيئة الهندسة المحيطة به منظمة بشكل سيء. يصف المؤلف الوكيل بأنه دورة جمع السياق والعمل والتحقق من النتائج. إذا تم الإفراط في تحميل حتى طبقة واحدة في هذه الدورة، فإن الجودة تنخفض بشكل حاد: يخلق CLAUDE.md الطويل ضوضاء، وتعقد العشرات من الأدوات اتخاذ القرارات، وينقل عدم وجود التحقق السريع كل تعديل إلى مقامرة. في هذا الوضع، يبدأ المطور في تعديل الأوامر بلا نهاية، على الرغم من أن المشكلة تكون أعمق.

يتم مناقشة تكلفة السياق بشكل منفصل. من الناحية الرسمية، Claude Code له نافذة كبيرة، لكن جزء كبير من الرموز ينفق قبل أن يبدأ العمل حتى: على تعليمات النظام ووصفات المهارات ووصفات أدوات MCP وحالة LSP والذاكرة و CLAUDE.md للمشروع. يقدم المؤلف حسابًا ملفتًا للنظر: يمكن لخادم MCP واحد نموذجي أن يشغل آلاف الرموز فقط لمخططات الأدوات، وتستهلك عدة خوادم متصلة بسهولة جزءًا ملحوظًا من النافذة المتاحة. أضف إلى ذلك نتائج الاختبارات الطويلة و grep وسجلات—والتاريخ الحواري المفيد يبدأ في الزحزحة بنفسه.

• تعليمات النظام والقواعد الأساسية
• أوصاف المهارات وأدوات MCP
• ذاكرة المشروع ومحتويات CLAUDE.md
• نتائج استدعاءات shell والاختبارات والبحث
• سجل الجلسة المضغوط، لكن ليس دقيقًا دائمًا

من هذا تأتي خلاصة عملية: المعرفة المستخدمة بندرة لا ينبغي أن تعيش في سياق يتم تحميله باستمرار. عند تبديل المهام، من الأفضل استخدام تنظيف الجلسة بشكل متكرر أكثر؛ للمتابعة في اتجاه واحد—الضغط المُدار. نصيحة أخرى من المقالة: اطلب من الوكيل قبل جلسة جديدة جمع HANDOFF.md مع التقدم والطرق المسدودة وحالة التحقق. هذا أرخص وأكثر موثوقية من الأمل بأن الضغط التلقائي سيحافظ على القرارات المعمارية المهمة حقًا.

المهارات والخطافات والوكلاء

القسم الثاني المهم مخصص للفصل بين الأدوار. يقترح المؤلف عدم خلط MCP والأدوات والمهارات والخطافات والمكونات والوكلاء الفرعيين في كومة واحدة. المنطق هو: تقدم الأداة قدرة جديدة، وتعيّن المهارة سير العمل، والخطاف يدمج التحقق الآلي الإلزامي، والوكيل الفرعي ينقل مهمة منفصلة إلى سياق معزول. هذا توضيح مفيد لأن العديد من الفرق تحاول إصلاح أي فشل بموجه جديد أو أداة أخرى، عندما يمكن حل المشكلة على مستوى مختلف تماما.

تشرح المقالة بشكل منفصل ما يجب أن تكون عليه المهارة الجيدة. لديها وصف قصير وموجز وزناد استخدام مفهوم ومدخلات موثقة ومخرجات وشرط إيقاف. كل ما هو ثقيل—أمثلة وكتيبات التشغيل والملفات المساعدة—يجب سحبه عند الطلب، وليس معلقًا في SKILL.md الرئيسي. بالنسبة للإجراءات ذات الآثار الجانبية، ينصح المؤلف بتعطيل التنفيذ الآلي من قبل النموذج بشكل صريح. الفكرة هي أن يرى الوكيل أولاً الفهرس والمسار، ثم يحمل التفاصيل فقط عندما يكونان مطلوبين حقًا.

يتم عرض الوكلاء الفرعيين في هذا التحليل ليس كطريقة "لتسريع كل شيء بالتوازي"، بل كوسيلة للعزل. يتم إرسال بحث قاعدة البيانات والمراجعة وتشغيل الاختبارات والعمليات الأخرى الضوضائية بشكل أفضل إلى خيوط فرعية بأذونات محدودة ونموذج منفصل وتنسيق استجابة ثابت. الخطافات، على العكس من ذلك، يجب أن تمسك بالأشياء الحتمية في أقرب وقت ممكن: قم بتشغيل فحص سريع بعد تحرير الملف، وحظر التغييرات الخطيرة، ومزج السياق التقني في بداية الجلسة. كلما أمسك النظام بخطأ مبكرًا، كلما قل استنزاف الرموز والوقت والتعديلات غير الضرورية.

الذاكرة المؤقتة والتحقق والعقد

أحد أكثر الأجزاء إثارة للاهتمام في النص هو شرح مدى اعتماد معمارية Claude Code على prompt caching. يكتب المؤلف أن بادئة الموجه المستقرة توفر ليس فقط المال بل تقلل أيضًا الاحتكاك مع الحدود. من هذا تأتي عدة قواعد غير واضحة: لا تدرج بيانات ديناميكية في موجه النظام، لا تخلط ترتيب التعليمات، لا تبدل النماذج في منتصف جلسة طويلة بدون حاجة، ومتى أمكن، أرجل تحميل مخططات الأدوات النادرة بشكل كامل. حتى Plan Mode، كما هو مذكور في المقالة، أكثر ملاءمة للتنفيذ دون تغيير مجموعة الأدوات بأكملها، لتجنب كسر الذاكرة المؤقتة.

يتم التركيز النهائي على التحقق ودور CLAUDE.md. يسمي المؤلف هذا الملف ليس قاعدة معرفية، بل عقدًا بين المشروع والوكيل: كيف تجمع وكيف تختبر وما الحدود التي لا يمكن انتهاكها وما الذي يجب الحفاظ عليه عند الضغط وما الحظر الذي ينطبق دائمًا. لا تحتاج CLAUDE.md إلى مراجع API وتعريفات طويلة؛ فقط القواعد الحرجة في كل جلسة يجب أن تعيش هناك. نصيحة منفصلة: بعد كل خطأ متكرر، اطلب من الوكيل تحديث عقده حتى لا تعود الأخطاء النموذجية مرة أخرى.

"إذا لم تتمكن من شرح كيفية معرفة أن

Claude فعل ذلك بشكل صحيح، فالمهمة على الأرجح غير مناسبة للتنفيذ التلقائي بالكامل."

ما يعني ذلك

هذه المادة مهمة ليس فقط لمستخدمي Claude Code. في الأساس، هي تعليمات لنضج أي وكلاء ذكاء اصطناعي لتطوير البرامج: أقل سحرًا، عزل أكثر، تحقق صريح وسيطرة على السياق. كلما انتقلت الفرق بشكل أكثر نشاطًا من "chatbot الكود" إلى المهندس شبه المستقل، أصبحت هذه الممارسات بالذات أكثر قيمة، بدلاً من مجموعة أخرى من الأوامر.