الملخص التنفيذي

نحن ندير وكالة ويب بدون رأس حيث يتعامل Claude Code مع 60-70% من أعمال التنفيذ التي كانت تتطلب فريقًا كاملاً. انخفضت تكلفتنا لكل MVP من 35,000-50,000 دولار إلى 8,000-15,000 دولار. انخفض الوقت حتى الانتشار الأول من 6-8 أسابيع إلى 10-18 يومًا. لكن الذكاء الاصطناعي لم يحل محل كل شيء--بل حل محل مهام محددة ومحددة النطاق. إليك ما ينجح، وما لا ينجح، وما نزال ندفع للبشر مقابله.

جدول المحتويات

لماذا أعدنا بناء وكالتنا حول Claude Code

لم نخطط لهذا. في أواخر 2024، كنا متجرًا للتطوير بدون رأس مكونًا من 4 أشخاص يفرض رسومًا بقيمة 150 دولارًا في الساعة لعمل Next.js و headless CMS. بحلول مارس 2025، بعد دمج Claude Code--وتحديداً Claude 3.5 Sonnet في البداية، والآن Claude 4 Sonnet--في كل مشروع، غيّر دوران أساسيان. لم يتم حذفهما. تغيروا. أصبح أحد كبار المطورين مهندس موجه بالذكاء الاصطناعي بدوام كامل. تحول الآخر بالكامل إلى مراجعة التعليمات البرمجية والعمارة.

المحفز: مشروع Sanity + Next.js 14 حيث استخدمنا Claude Code لبناء طبقة المخطط بالكامل، وإنشاء استعلامات GROQ، وإنشاء 14 قالب صفحة، وكتابة خط أنابيب النشر. ما كان سيكون 120 ساعة قابلة للفواتير جاء بـ 34. نظرنا إلى بعضنا وقلنا: "نحتاج إلى إعادة هيكلة كل شيء."

هذا هو الأصل الصادق. ليس استراتيجية كبرى. مشروع انتهى بسرعة كبيرة.

كيف يبدو سير العمل الفعلي لوكالة Claude Code؟

إليك أسبوع نموذجي في بناء عميل نشط:

الاثنين: العمارة والانطلاق

  • أنا: ساعتان لتحديد معمارية المكون، نموذج البيانات، عقود API
  • أنا: ساعة واحدة لكتابة تعليمات مشروع CLAUDE.md (المزيد حول هذا أدناه)
  • Claude Code: ينشئ الدعامات الأولية للمشروع، يثبت التبعيات، ويعد نمط TypeScript الصارم، وينشئ linting

الثلاثاء-الخميس: سباق البناء

  • أنا: 1-2 ساعة يوميًا لمراجعة إخراج Claude Code، والقبض على الأخطاء، وإعادة التوجيه
  • Claude Code: 6-8 مهام يوميًا--مكونات الصفحة، طرق API، تعريفات مخطط CMS، وظائف الأداة، ملفات الاختبار
  • أنا: المحاور المعمارية، قرارات إدارة الحالة المعقدة، خيوط Slack للعميل

الجمعة: التكامل وضمان الجودة

  • أنا: 3-4 ساعات من اختبار الجودة اليدوي، تدقيق إمكانية الوصول، اختبار الأداء
  • Claude Code: إصلاح الأخطاء المحددة في ضمان الجودة، كتابة الاختبارات المفقودة، إنشاء التوثيق
  • أنا: تحضير العرض التوضيحي للعميل، النشر على الترتيب

إجمالي ساعات العمل البشرية في الأسبوع في بناء نشط: 18-24. انخفاض من 35-45 في سير عملنا السابق قبل الذكاء الاصطناعي.

ما الذي يتعامل معه الذكاء الاصطناعي في مشاريعنا

إليك قائمة المهام المحددة--الأشياء التي يقوم بها Claude Code في مشاريع العميل الحقيقية كل أسبوع:

توليد التعليمات البرمجية (70-80% مؤتمتة)

  • مكونات React/Next.js: تخطيطات الصفحات، مكونات واجهة المستخدم من مواصفات Figma الموصوفة في المطالبات، معالجات النماذج
  • مخططات CMS: أنواع مخطط Sanity، نماذج محتوى Contentful كنصوص ترحيل، تكوينات مجموعة Payload CMS
  • طرق API: معالجات مسار Next.js، إجراءات tRPC، نقاط نهاية webhook
  • عمليات قاعدة البيانات: تغييرات مخطط Prisma، ملفات الترحيل، نصوص البذرة
  • أنواع TypeScript: إنشاء أنواع من استجابات API، مخططات التحقق من Zod، حزم النوع المشتركة

تدقيق الأكواد (يوفر 4-6 ساعات/أسبوع)

  • مراجعة قواعد الأكواد الموجودة قبل مشاريع الإصلاح
  • تحديد التبعيات غير المستخدمة، الكود الميت، عدم تناسق النوع
  • إنشاء تقارير التدقيق مع مراجع file:line محددة

مسودات المحتوى (توفر 3-5 ساعات/أسبوع)

  • ردود RFP والاقتراحات التقنية
  • توثيق المشروع وملفات README
  • الشروحات التقنية الموجهة للعميل
  • مسودات SOW الأولى (يتم مراجعتها دائمًا وإعادة كتابتها من قبل الإنسان)

الاختبار (يوفر 5-8 ساعات/أسبوع)

  • اختبارات وحدة Vitest لوظائف الأداة
  • سقالات اختبار Playwright e2e
  • توليد بيانات الاختبار والإضاءات
  • تحديد حالات الحافة التي قد نفتقدها

ما الذي نزال نوظف البشر من أجله

المهمة لماذا لا يستطيع الذكاء الاصطناعي القيام به (حتى الآن) من نوظفه التكلفة المعتادة
استراتيجية العلامة التجارية يتطلب فهم موضع العميل في السوق والمنافسين وعلم نفس العملاء بمستوى يهلوس عليه الذكاء الاصطناعي استراتيجي علامة تجارية متعاقد 3,000-8,000 دولار/مشروع
اتجاه النسخ تتطلب النبرة والصوت وهندسة الإقناع حكمًا بشريًا كاتب مستقل 2,000-5,000 دولار/مشروع
مكالمات المبيعات يريد العملاء التحدث إلى شخص يفهم عملهم نحن نفعل هذا بأنفسنا وقتنا
التصميم البصري عمل Figma واتجاه الفن وأنظمة التصميم مصمم متعاقد 4,000-12,000 دولار/مشروع
DevOps المعقد تكوينات Kubernetes والنشر متعدد المناطق و CI/CD للصناعات المنظمة مهندس DevOps متعاقد 150-200 دولار/ساعة
المراجعة القانونية العقود والاتفاقيات الرئيسية وبنود الملكية الفكرية محام 350-500 دولار/ساعة
تدقيق إمكانية الوصول تأخذ الأدوات الآلية 30-40% من المشاكل؛ اختبار قارئ الشاشة الحقيقي يتطلب بشرًا متخصص في A11y 1,500-3,000 دولار/تدقيق
بحث المستخدم التحدث إلى المستخدمين الفعليين وتجميع الملاحظات باحث UX 100-150 دولار/ساعة

هذه 8 فئات حيث البشر غير قابل للتفاوض.

الأرقام الفعلية: تكلفة لكل MVP والوقت حتى الانتشار

إليك الأرقام الفعلية من آخر 6 مشاريع عميل لدينا (Q1-Q2 2025)، بدون الكشف عن الهوية:

المشروع الstack التقدير القديم التقدير المساعد بالذكاء الاصطناعي الفعلي الوقت حتى الانتشار
موقع تسويق SaaS Next.js 15 + Sanity v3 38,000 دولار 11,500 دولار 12 يومًا
واجهة متجر للتجارة الإلكترونية Next.js 15 + Shopify Storefront API 52,000 دولار 18,200 دولار 18 يومًا
المحفظة/CMS للوكالة الإبداعية Astro 5 + Payload CMS 3.0 28,000 دولار 8,400 دولار 10 أيام
لوحة معلومات MVP في SaaS Next.js 15 + Supabase + Prisma 45,000 دولار 14,800 دولار 16 يومًا
إعادة تصميم موقع منظمة غير ربحية Next.js 14 + Contentful 32,000 دولار 9,200 دولار 11 يومًا
موقع مستندات المطور Astro 5 + MDX + Algolia 22,000 دولار 7,600 دولار 8 أيام

"التقدير القديم" هو ما كنا سنقتبسه في 2023 مع هيكل فريقنا القديم. "التقدير المساعد بالذكاء الاصطناعي الفعلي" هو ما دفعه العميل في 2025.

تقليل التكاليف: 62%. الوقت حتى الانتشار الأول: 12.5 يومًا.

جميع هذه المشاريع في منطقة تخصصنا--مواقع CMS بدون رأس وتطبيقات Next.js. ستبدو أنظمة RBAC للمؤسسات أو أي شيء ينطوي على تطبيقات تعاونية في الوقت الفعلي أو أنظمة موزعة معقدة مختلفة.

إعداد مشروع Claude Code لدينا

كل مشروع يبدأ بملف CLAUDE.md في جذر الريبو. هذا هو الشيء الأكثر تأثيراً الذي فعلناه لتحسين جودة المخرجات. إليك هيكل القالب الخاص بنا:

# المشروع: [اسم العميل]

## Tech Stack
- Framework: Next.js 15.1 (App Router)
- CMS: Sanity v3.72
- Styling: Tailwind CSS v4.0
- Language: TypeScript 5.7 (strict mode)
- Package manager: pnpm 9.x
- Node: 22 LTS

## قرارات العمارة
- جميع جلبات البيانات في مكونات الخادم
- مكونات العميل فقط للتفاعل
- استعلامات GROQ المشترك مع مكونات الصفحة
- لا توجد صادرات برميل
- فضّل التصديرات المسماة

## اتفاقيات الكود
- استخدم أداة `cn()` للفئات الشرطية (موجودة بالفعل في lib/utils.ts)
- حدود الأخطاء على مستوى مقطع المسار
- جميع الصور من خلال next/image بأبعاد صريحة
- النماذج استخدم react-hook-form + zod

## هيكل الملفات
[إخراج الشجرة من دليل src/]

## القيود المعروفة
- يتطلب العميل WCAG 2.2 AA
- يجب أن يدعم IE-- فقط مزحة. Chrome 120+, Safari 17+, Firefox 121+
- هدف النشر: Vercel (Pro plan, us-east-1)

## لا تفعل
- تثبيت التبعيات الجديدة بدون السؤال
- إنشاء ملفات خارج src/
- استخدام التصديرات الافتراضية (باستثناء صفحات/تخطيطات Next.js)
- كتابة CSS خارج فئات Tailwind

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

نستخدم أيضًا claude --dangerously-skip-permissions أثناء مراحل الدعامات (أبدًا في فروع الإنتاج) ونتحول إلى وضع الموافقة التفاعلي بمجرد أن ننتقل عن الإعداد الأولي. التكلفة لكل مشروع في استخدام API: عادة 40-120 دولار لبناء كامل، يعمل على Claude 4 Sonnet.

هل شركة الشخص الواحد بقيمة مليار دولار حقيقية؟

لا. لكنها تجربة فكرية تكشف عن شيء حقيقي حول مكان وجودنا.

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

قطعة Henry (henrythe9th على Substack) عن مؤسس منفرد الذي "استنسخ نفسه" بوكلاء الذكاء الاصطناعي أكثر واقعية. مثال محدد لاستخدام الذكاء الاصطناعي للتعامل مع فرز دعم العملاء ومسودات الاستجابة الأولى يتردد صداه--نفعل شيئًا مشابهًا مع مسودات الاقتراحات التقنية. لكن الإطار "الاستنساخ" يبالغ فيه. ما حدث فعلاً هو تفويض المهام للذكاء الاصطناعي. لم تستنسخ حكمك. لقد قمت بإزاحة الكتابة الخاصة بك.

تقرير Nate التنفيذي حول الأعمال الفردية يتطرق إلى بيانات Carta التي تظهر نسبة متزايدة من الشركات الناشئة من مؤسسين منفردين. هذا حقيقي. بيانات Carta من أوائل 2025 أظهرت اتجاهًا تصاعديًا في الدمج المنفرد. لكن شركة مدمجة منفردة على Carta لا تساوي شركة مشغلة منفردة. معظم هؤلاء المؤسسين يوظفون مقاولين والوكالات (مثلنا) والأدوار الكسورية. إنهم منفردون على الجدول الرسملي وليسوا منفردين عمليًا.

وجهة نظرنا: النسخة الواقعية من هذا ليست شخص واحد يفعل مليار دولار. إنه شخص واحد (أو فريق صغير جداً) يفعل 1 مليون دولار-5 ملايين دولار في الإيرادات مع هوامش 70-80%، مما يتعامل مع العمل الذي اعتاد أن يتطلب 8-12 شخص. هذا ليس خيال. نحن نشاهده يحدث. لكنه يتطلب كفاءة الذكاء الاصطناعي والخبرة المجالية وشبكة مهنية موجودة. ليس فقط اشتراك ChatGPT.

ما الذي لا يزال لا ينجح

1. عمليات إعادة الهيكلة متعددة الملفات المعقدة

يمكن لـ Claude Code إعادة هيكلة ملف واحد بشكل رائع. لكن عندما تحتاج إلى تغييرات منسقة عبر 15+ ملف--مثلاً، تغيير نموذج بيانات يمس طرق API ومكونات وأنواع واختبارات ومخططات CMS في نفس الوقت--يفقد الاتساق حول الملف 8-10. حدث لنا أنه أدخل تبعيات دائرية كسرية، نسي تحديث الواردات في الملفات التي لمسها في وقت سابق في الجلسة، وتخطى بصمت الملفات. حلنا: كسر عمليات إعادة الهيكلة إلى 3-4 دفعات ملفات والتحقق من كل منها.

2. التصميم إلى الكود من Figma

رغم الضجة، فإن توليد مكونات الإنتاج من تصاميم Figma لا يزال مهمة دقة 60% في أحسن الأحوال. لا يمكن لـ Claude Code (أو أي LLM) رؤية ملف Figma الخاص بك مباشرة. أنت تصف التخطيطات بالكلمات أو تلصق لقطات الشاشة. يحصل الإخراج على الهيكل تقريباً ولكن ينقصه المسافة ونقاط الفاصل المستجيبة وحالات التفاعل. لا نزال نحصل على بشري لترجمة التصاميم إلى مكونات، ثم استخدم Claude Code لملء المتغيرات والحالات.

3. تحسين الأداء

سيخبرك Claude Code بإضافة React.memo() والانتهاء من اليوم. يتطلب عمل الأداء الحقيقي--تحديد عمليات إعادة التصيير غير الضرورية من خلال تنميط React DevTools، وتحسين استعلامات GROQ بتحليل خطط تنفيذ Sanity، وتقليل CLS بتدقيق البرامج النصية الخاصة بجهات خارجية--ملاحظة بشرية لسلوك وقت التشغيل. لا يمكن لـ AI تحديد ملف التعريف بتطبيقك.

4. تصحيح الأخطاء في مشاكل الإنتاج

عندما ينكسر شيء ما الساعة 2 صباحًا والخطأ هو انتهاء مهلة Vercel Edge Runtime الغامضة، يمكن لـ Claude Code أن يقترح احتمالات. لكنه لا يستطيع النظر إلى لوحة معلومات Datadog الخاصة بك، ربط الوقت بنشر، التحقق من تطهير ذاكرة التخزين المؤقت للشبكة، أو إدراك أن المشكلة هي في الواقع تأخر انتشار DNS من نقل مجال حدث قبل 48 ساعة. تصحيح أخطاء الإنتاج سياق ثقيل وتكون نوافذ السياق للذكاء الاصطناعي ضيقة جداً.

5. أي شيء يتطلب حكمًا بصريًا

هل هذه الحركة سريعة جداً؟ هل هذا المزيج من الألوان يشعر بأنه صحيح للعلامة التجارية الفاخرة؟ هل المسافة البيضاء متوازنة؟ لا تملك Claude Code آراء هنا. لا تسأل.

6. اتساق الجلسة طويلة المدى

بعد حوالي 45-60 دقيقة من العمل المستمر في جلسة Claude Code واحدة، نلاحظ تدهور الجودة. يبدأ في تكرار الأنماط من وقت سابق في الجلسة حتى عندما يتغير السياق. ينسى القيود من CLAUDE.md. نعيد تشغيل الجلسات كل 45 دقيقة كقاعدة. هذا ضريبة إنتاجية حقيقية--ربما 20-30 دقيقة من وقت إعادة التوجيه يوميًا.

كيف نحدد نطاق مشاريع العملاء الآن

تغيرت عملية تحديد النطاق لدينا بشكل جذري. إليك قبل وبعد:

قبل (2023)

  1. استدعاء اكتشاف (ساعة واحدة)
  2. نقاش معمارية داخلي (ساعتان)
  3. SOW مفصل مع تقديرات كل ساعة لكل ميزة (4-6 ساعات)
  4. دورة مراجعة العميل (أسبوع واحد إلى أسبوعين)
  5. عقد موقّع → الانطلاق

بعد (2025)

  1. استدعاء اكتشاف (45 دقيقة)
  2. Claude Code ينشئ مسودة SOW الأولى من ملاحظات المكالمة (15 دقيقة من الطلب)
  3. أراجع وأعيد كتابة SOW (ساعة واحدة)
  4. نبني نسخة اختبار من أصعب تحد تقني باستخدام Claude Code (ساعتان إلى 3 ساعات)
  5. يعتمد النطاق الآن على بيانات التنفيذ الفعلية وليس التخمينات
  6. مراجعة العميل (3-5 أيام)
  7. عقد موقّع → الانطلاق

الخطوة 4 هي الفرق الرئيسي. اعتدنا على تقدير "تكامل Shopify Storefront API: 40 ساعة" بناءً على الخبرة. الآن نبني فعلاً نسخة تقريبية بـ 2-3 ساعات ونعرف أنها 22 ساعة بمساعدة الذكاء الاصطناعي. تقديراتنا ضمن 15% من الفعليات. اعتادوا أن يكونوا ضمن 30-40%.

هذا يكلفنا 3-4 ساعات من عمل المبيعات غير المفوتر لكل مشروع. لكن معدل الإغلاق الخاص بنا انتقل من حوالي 35% إلى 55% لأن العملاء يرون نموذج عمل قبل التوقيع.

رياضيات المؤسس: تفصيل الساعات في الأسبوع

إليك كيف ينقسم أسبوعي بالفعل كمؤسس وكالة تستخدم Claude Code:

النشاط ساعات/أسبوع مساعد بالذكاء الاصطناعي؟
مكالمات العميل و Slack 6 لا
العمارة والقرارات التقنية 5 جزئياً (Claude Code للبحث)
مراجعة كود من مخرجات الذكاء الاصطناعي 8 لا
توجيه جلسات Claude Code 6 N/A (هذا هو عمل الذكاء الاصطناعي)
عمليات الأعمال (الفواتير والعقود والتخطيط) 3 جزئياً (مسودات)
المبيعات والاقتراحات 3 جزئياً (مسودات أولى)
اختبار وضمان الجودة يدويًا 3 لا
التعلم والبقاء محدثًا 2 لا
الإجمالي 36

36 ساعة في الأسبوع. ليس 80. ليس 20. وهذا يدير وكالة تحقق 60,000-80,000 دولار/شهر في الإيرادات مع 2 مشروع عميل نشط في أي وقت.

قبل الذكاء الاصطناعي، احتاج هذا الناتج نفسه إلى 3.5 موظفين بدوام كامل وأسابيع بـ 50 ساعة من جانبي. الرياضيات حقيقية. لكن لاحظ: 22 من تلك الـ 36 ساعة لا تزال عمل بشري بحت. لم يلغِ الذكاء الاصطناعي العمل. غيّر نسبة التفكير إلى الكتابة.

الأسئلة الشائعة

كم يكلف Claude Code شهريًا لعمل الوكالة؟ نصرف حوالي 180-300 دولار/شهر على استخدام Claude API لـ Claude Code عبر جميع المشاريع. هذا على نموذج Claude 4 Sonnet. تتراوح تكاليف المشروع الفردية من 40-120 دولار حسب النطاق وعدد الجلسات.

هل يمكن لـ Claude Code أن يحل محل مطور مبتدئ؟ يحل محل مخرجات مطور مبتدئ لكن ليس الدور. لا يزال يحتاج شخص ما إلى توجيه ومراجعة وتصحيح عمل الذكاء الاصطناعي. يجب أن يكون هذا الشخص حكمًا على مستوى أول. التعليمات البرمجية المولدة من الذكاء الاصطناعي بدون مراجعة الخبير تشحن الأخطاء بسرعة أكبر.

ما أفضل CMS للاقتران مع سير عمل Claude Code؟ Sanity v3، لأن تعريفات المخطط الخاصة به عبارة عن ملفات TypeScript التي يولدها Claude Code بشكل استثنائي. Payload CMS 3.0 هو خيار قريب. يعمل Contentful لكن واجهة الإدارة الخاصة به أكثر تعقيداً لـ AI للعمل معها بشكل موثوق.

هل يعمل Claude Code لتطوير تطبيقات الجوال؟ استخدمنا مشاريع React Native (Expo SDK 52) مع نتائج لائقة لتوليد المكونات وإعداد الملاحة. يكافح أكثر مع تكوين الوحدة النمطية الأصلية وتصحيح الأخطاء الخاص بالنظام الأساسي. تقريباً كسب إنتاجية 40-50% مقابل 60-70% لمشاريع الويب.

كيف تتعامل مع مخاوف ملكية العميل بشأن التعليمات البرمجية المولدة بالذكاء الاصطناعي؟ تتضمن اتفاقيتنا الرئيسية شرطًا ينص على أن جميع المسلمات هي عمل منتج أصلي بغض النظر عن الأدوات المستخدمة. تمنح شروط Anthropic (اعتباراً من يونيو 2025) للمستخدمين حقوقاً في المخرجات. لا نرسل بيانات الملكية من العميل إلى API--فقط أنماط التعليمات البرمجية والتطبيقات العامة.

ماذا يحدث عندما يولد Claude Code التعليمات البرمجية غير الصحيحة؟ يحدث على تقريباً 15-20% من المهام. يأخذ سير العملنا بعين الاعتبار مع مراجعة التعليمات البرمجية الإلزامية البشرية على كل PR. أنماط الفشل الشائعة: TypeScript generics غير صحيحة، أنماط API قديمة من بيانات التدريب، وفقدان معالجة الأخطاء لحالات الحافة. نقوم بدمج وقت المراجعة في كل تقدير.