Claude Code وسير عمل التطوير بمساعدة الذكاء الاصطناعي

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

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

إعداد البيئة

يعمل Claude Code في طرفيتك (terminal). لديه وصول مباشر إلى نظام ملفاتك، ويمكنه قراءة وكتابة الملفات، وتشغيل أوامر shell، والتفاعل مع Git. هذا يختلف جوهريًا عن الذكاء الاصطناعي القائم على الدردشة الذي يعمل على مقتطفات الكود التي تلصقها — Claude Code يرى مشروعك بأكمله، ويفهم بنية دليل ملفاتك، ويمكنه إجراء تغييرات عبر ملفات متعددة في عملية واحدة.

الإعداد الذي يجعل هذا مثمرًا:

ملفات CLAUDE.md هي أهم إعداد ستكتبه. هذه ملفات تعليمات يقرأها Claude Code تلقائيًا — ملف عام في ~/.claude/CLAUDE.md للمعايير التي تنطبق على جميع مشاريعك، وملف خاص بكل مشروع في جذر المستودع للاتفاقيات الخاصة بالمشروع.

يحدد ملف CLAUDE.md العام الخاص بي معايير الترميز: الحد الأقصى لحجم الملف (~300 سطر)، وقواعد استخراج المكونات، ومتطلبات الاختبار، واتفاقيات الالتزام (commit). يحدد الملف على مستوى المشروع المكدس التقني، وأنماط البنية، واتفاقيات التسمية، وأي قواعد خاصة بالمجال. هذا ليس اختياريًا — بدون هذه الملفات، يولد Claude Code كودًا يعمل ولكنه لا يتطابق مع أسلوب مشروعك أو اتفاقياته.

خوادم MCP توسع ما يمكن لـ Claude Code الوصول إليه. أقوم بتوصيل خادم قاعدة بيانات (حتى يتمكن Claude من الاستعلام عن قاعدة بيانات التطوير الخاصة بي مباشرة)، وخادم بحث عن الملفات، وخوادم خاصة بالمشروع لأشياء مثل بيانات التحليلات. يعيش تكوين MCP في .mcp.json في جذر المشروع. كل خادم هو عملية منفصلة يتواصل معها Claude Code عبر بروتوكول Model Context Protocol.

تكامل Git مدمج ولكنه يحتاج إلى حواجز حماية. أقوم بتكوين Claude Code لعدم إجراء force-push أبدًا، وعدم تعديل الالتزامات (commits) دون طلب، وعدم تخطي خطافات ما قبل الالتزام (pre-commit hooks) أبدًا. هذه هي أنواع الإجراءات المدمرة التي يسهل التراجع عنها عندما تقوم بها بنفسك ولكنها كارثية عندما يقوم بها الذكاء الاصطناعي دون أن تدرك.

دمج سير العمل اليومي

نمط الصباح

أبدأ كل جلسة ترميز بفتح Claude Code في دليل المشروع وإعطائه سياقًا حول ما أعمل عليه اليوم. ليس مواصفات مفصلة — جملة أو اثنتين حول الميزة أو الخطأ أو إعادة الهيكلة التي أتعامل معها.

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

هذا يحدد النية. ثم يمتلك Claude Code السياق لاتخاذ قرارات أفضل بشأن مواقع الملفات، والتسمية، والبنية لكل طلب لاحق في الجلسة.

أنماط توليد الكود

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

طلب جيد: "أضف نقطة نهاية PATCH إلى موجه إعدادات المستخدم تقبل نص JSON مع تفضيلات الإشعارات. تحقق من أن كل مفتاح تفضيل هو أحد الأنواع المسموح بها. استمر في جدول user_settings. أعد التفضيلات المحدثة."

طلب سيء: "أنشئ دالة تسمى updateNotificationPrefs تأخذ req و res، وتفكك body.preferences، وتتكرر خلالها، وتستدعي db.update لكل واحدة، وتعيد 200."

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

عمليات الملفات المتعددة

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

"أضف عمود notification_preferences من نوع JSONB إلى جدول المستخدمين، وأنشئ ترحيلًا له، وأضف طريقة خدمة لتحديث التفضيلات مع التحقق، واكشفها عبر موجه API، وأنشئ مكون React لصفحة الإعدادات الذي يستدعي نقطة النهاية."

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

التحسين التفاعلي

تأتي أفضل النتائج من المحادثة التكرارية، وليس الطلبات الفردية. أقوم بتوليد التنفيذ الأولي، ومراجعته، ثم تحسينه:

"يبدو مكون تفضيلات الإشعارات جيدًا، ولكن يجب أن يستخدم تحديثات متفائلة — تحديث واجهة المستخدم فورًا والتراجع إذا فشلت مكالمة API. أيضًا، أضف حالة تحميل للجلْب الأولي."

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

تصحيح الأخطاء بالذكاء الاصطناعي

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

تشخيص الأخطاء

عندما أواجه خطأ، ألصق تتبع المكدس (stack trace) أو رسالة الخطأ وأقول "يحدث هذا الخطأ عندما أحاول حفظ تفضيلات الإشعارات بعد تبديل خيار الملخص الأسبوعي." يمكن لـ Claude Code أن:

1. قراءة ملفات المصدر ذات الصلة لفهم مسار الكود
2. تحديد الأسباب المحتملة بناءً على تتبع المكدس والمحفز الموصوف
3. التحقق من المشكلات الشائعة مثل عدم تطابق الأنواع، أو عمليات التحقق من القيم الفارغة المفقودة، أو حالات السباق (race conditions)
4. اقتراح إصلاح مع شرح سبب عمله

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

تحليل السجلات

"إليك آخر 50 سطرًا من سجل الخادم. تعيد واجهة برمجة التطبيقات أخطاء 500 بشكل متقطع على نقطة النهاية /api/settings. ما الخطأ الذي يحدث؟"

يقرأ Claude Code السجلات، ويحدد الأنماط (يحدث الخطأ دائمًا عندما يتجاوز نص الطلب حجمًا معينًا، أو عندما يصل طلبان إلى نفس المورد في وقت واحد)، ويقترح تشخيصًا. يمكنه بعد ذلك إجراء الإصلاح مباشرة — تعديل حد محلل النص (body parser)، أو إضافة قفل (mutex)، أو إصلاح حالة سباق.

تصحيح الأخطاء الموجه بالاختبار

عندما أواجه خطأ لا يمكنني إعادة إنتاجه بسهولة في المتصفح، أطلب من Claude Code كتابة اختبار فاشل يلتقط السيناريو الدقيق:

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

يمر الاختبار إما (مما يدحض فرضيتي) أو يفشل (مما يؤكد الخطأ ويعطيني حالة قابلة لإعادة الإنتاج). في كلتا الحالتين، لدي اختبار يمكنني الاحتفاظ به.

استراتيجيات إعادة الهيكلة

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

استخراج المكونات

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

يقرأ Claude Code المكون، ويحدد الحدود المنطقية، ويستخرج كل قسم إلى ملفه الخاص بواجهات الخصائص المناسبة، ويحدث لوحة التحكم لتكوين المكونات الجديدة. يتعامل مع الاستيرادات، وتعريفات الأنواع، والحالة التي تحتاج إلى رفعها أو تمريرها.

إعادة التسمية وإعادة الهيكلة

"أعد تسمية الوحدة user إلى account عبر المشروع بأكمله. يتضمن ذلك اسم الدليل، وجميع أسماء الملفات، وجميع مسارات الاستيراد، وجميع المراجع في قاعدة الكود، واسم الجدول المستعار في طبقة الاستعلام."

هذا عمل يدوي ممل وعرضة للأخطاء. يقوم Claude Code بذلك في تمريرة واحدة، ويلتقط المراجع التي قد تفوتك، ويمكنه تشغيل مجموعة الاختبار بعد ذلك للتحقق من عدم كسر أي شيء.

ترحيل الأنماط

"نحن ننتقل من نمط معالجة الأخطاء القديم (try/catch في كل معالج مسار) إلى نمط وسيط الأخطاء المركزي. إليك مثال على النمط الجديد. طبقه على جميع معالجات المسارات في دليل /api/settings."

يقرأ Claude Code المثال، ويفهم النمط، ويطبقه بشكل متسق عبر جميع الملفات. يتعامل مع الحالات الهامشية — المسارات التي تحتوي على كتل try/catch متعددة، والمسارات التي تحتوي على منطق تنظيف يحتاج إلى البقاء، والمسارات التي تلتقط أنواع أخطاء محددة.

الحفاظ على السياق في المشاريع الكبيرة

أكبر تحدٍ في التطوير بمساعدة الذكاء الاصطناعي هو السياق. لدى Claude Code نافذة سياق — حد لكمية المعلومات التي يمكنه أخذها في الاعتبار في وقت واحد. في مشروع صغير، يمكنه قراءة كل شيء. في مستودع أحادي كبير (monorepo)، لا يمكنه ذلك.

CLAUDE.md كتوثيق معماري

ملف CLAUDE.md الخاص بك ليس فقط لمعايير الترميز. استخدمه لوصف بنية مشروعك على مستوى عالٍ:

## Architecture
- API routes are in /src/routes, one file per resource
- Business logic is in /src/services, called by route handlers
- Database access uses Drizzle ORM, schemas in /src/db/schema
- Frontend components are in /src/components, organized by feature
- Shared UI components are in /src/components/ui
- State management uses Zustand, stores in /src/stores

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

قراءة الملفات الاستراتيجية

لا تطلب من Claude Code "قراءة المشروع بأكمله". بدلاً من ذلك، وجهه إلى الأجزاء ذات الصلة:

"اقرأ خدمة إعدادات المستخدم، ومسار API للإعدادات، ومكون تفضيلات الإشعارات. أرغب في إضافة تحديد معدل (rate limiting) إلى نقطة نهاية تحديث التفضيلات."

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

استمرارية الجلسة

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

1. الحفاظ على تحديث CLAUDE.md بقرارات التصميم المعمارية الحديثة
2. بدء كل جلسة ببيان سياق موجز حول ما أعمل عليه
3. استخدام رسائل التزام Git التي يمكن لـ Claude Code قراءتها لفهم التغييرات الأخيرة

سجل Git هو مصدر سياق لا يحظى بالتقدير الكافي. عندما يقرأ Claude Code آخر 10 رسائل التزام، فإنه يفهم ما تغير مؤخرًا ويمكنه تجنب التعارضات مع العمل الجاري.

ما ينجح وما لا ينجح

حيث تتفوق مساعدة الذكاء الاصطناعي

الأكواد النمطية وعمليات CRUD. إنشاء نقطة نهاية API جديدة مع التحقق، ومعالجة الأخطاء، والاختبارات هو 80% ميكانيكي. يولد Claude Code هذا بشكل أسرع وأكثر اتساقًا مما أكتبه.

الاتساق عبر الملفات. عندما يحتاج تغيير ما إلى لمس 8 ملفات (تعريف النوع، المخطط، الترحيل، الخدمة، المسار، المكون، الاختبار، التوثيق)، يحافظ Claude Code على الاتساق عبرها جميعًا. أنا حتمًا أنسى تحديث أحدها.

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

مراجعة الكود وتحليله. "هل هناك أي حالات سباق محتملة في هذا الملف؟" أو "ماذا يحدث إذا تم استدعاء هذه الدالة بمستخدم فارغ؟" يحلل Claude Code الكود ويحدد المشكلات التي يسهل تفويتها أثناء المراجعة اليدوية.

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

حيث تقصر مساعدة الذكاء الاصطناعي

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

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

القرارات المعمارية. يمكن لـ Claude Code تنفيذ أي بنية تصفها، لكن لا ينبغي أن يختار البنية لك. المفاضلات بين الخدمات المصغرة (microservice) والكتلة المتجانسة (monolith)، بين SQL و NoSQL، بين العرض من جانب الخادم والعرض من جانب العميل — هذه تتطلب فهم فريقك، وحجمك، وجدولك الزمني، ومستخدميك. الذكاء الاصطناعي لا يمتلك هذا السياق.

الكود الحساس للأمان. تدفقات المصادقة، التشفير، التحكم في الوصول — أكتب هذه يدويًا وأجعلها تراجع من قبل إنسان. يمكن لـ Claude Code توليد كود مصادقة يعمل، لكن "يعمل" و "آمن" هما معياران مختلفان.

متى لا تستخدم مساعدة الذكاء الاصطناعي

هناك حالات حيث يؤدي اللجوء إلى Claude Code إلى الإضرار بإنتاجيتك بشكل فعال:

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

عندما تستغرق المهمة أقل من 30 ثانية. إعادة تسمية متغير، إصلاح خطأ إملائي، تعديل قيمة CSS — فقط افعلها. التكلفة الإضافية لوصف التغيير لـ Claude Code تتجاوز الوقت اللازم لإجرائه بنفسك.

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

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

نصائح عملية

بعد أشهر من الاستخدام اليومي، هذه هي الأنماط التي تنتج أفضل النتائج باستمرار:

كن صريحًا بشأن الاتفاقيات. "استخدم نمط معالجة الأخطاء الحالي" أفضل من