بناء موقع بـClaude Code، من وكالة تشحنها

معظم الأدلة المنشورة لبناء موقع بـClaude Code خاطئة في فقرتها الأولى. فهي تخبرك بالتثبيت عبر npm. ولم يكن ذلك مسار التثبيت منذ فترة، وانتقل التوثيق من docs.claude.com إلى code.claude.com، وصارت الأداة تعمل على خمسة أسطح لا واحد. وهذا ما تبدو عليه سير العمل فعلاً في نوفمبر 2026، مكتوباً من بناء مواقع إنتاجية وشحنها به لا من تجربة عطلة نهاية أسبوع.

ما هو Claude Code فعلاً

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

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

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

اختر المنصة التقنية مرة وقلها

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

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

دعه يخطط قبل أن يكتب

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

الجزء الذي يتخطاه الجميع: التحقق

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

وما يعنيه ذلك عملياً مشمول بإسهاب في ما تفحصه قبل أن تصدق أن الوكيل بناه، فهو الفارق بين موقع يبدو منتهياً وموقع منتهٍ.

أين تخسر المواقع المبنية بوكيل في البحث

تخسر في المواضع التي لا ينظر إليها أحد على الشاشة. بيانات وصفية موروثة من مسار أب فتشترك كل صفحة ابنة في صورة اجتماعية واحدة. وخريطة موقع لم تُولَّد قط. وبيانات منظمة تصح وتصف الشيء الخطأ. وصور تُقدَّم بالحجم الخطأ لأن قائمة سماح في الإعداد لم تُوسَّع. ولا يظهر أي من ذلك في مراجعة تصميم ويظهر كله في Search Console بعد ستة أسابيع. والقائمة الكاملة في قائمة فحص السيو لموقع بناه وكيل.

غلّف الأجزاء القابلة للتكرار

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

متى تكون هذه الأداة الخطأ

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

وإن أردت التعمق في الأداة نفسها، فـAnthropic تقدم دورات مجانية ذاتية الوتيرة في Claude Academy، وفهرس التوثيق الكامل منشور ملفاً قابلاً للقراءة آلياً في code.claude.com/docs/llms.txt.

بقيّة هذه السلسلة

كل مقال أدناه يأخذ مرحلة واحدة من سير العمل أعلاه ويتعمّق أكثر مما تسمح هذه الصفحة. الإعداد أولاً: CLAUDE.md يغيّر القرارات، والمهارات الجديرة بالاقتناء، وكتابة واحدة بنفسك، وسيرفرات MCP الثلاثة الجديرة بالربط. ثم الحلقة نفسها: الـhooks التي تُحكِم مستودع موقع، وما يُفوَّض للوكلاء الفرعيين، وكيف تتحقّق من عمل الوكيل. ثم الإطلاق: قائمة الـSEO، وCore Web Vitals في موقع بناه وكيل، والشحن إلى الإنتاج بلا مفاجآت.