سلسلة دروس Claude Code 4: ما هي حالات استخدام Claude Code؟

حالات الاستخدام النموذجية

أقسم حالات الاستخدام إلى أربع فئات، مرتبة من الأعلى تكرارًا إلى الأقل.

الفئة الأولى: فهم الكود

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

الطريقة المحددة:

claude "ما هو هذا المشروع؟ أين نقطة الدخول؟" — سيقرأ package.json، وهيكل الدليل، والملفات الرئيسية، ويعطي ملخصًا.
افتح دالة واطلب منه شرح المنطق ورسم سير العمل (بوصف نصي).
اطلب منه تتبع مسار طلب API بالكامل من الواجهة الأمامية إلى قاعدة البيانات.

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

البديل لهذه الفئة هو: التصفح اليدوي في قاعدة الكود، وتدوين الملاحظات، ورسم مخططات الاستدعاء.

الفئة الثانية: كتابة الكود وتعديله

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

إضافة ميزة جديدة: "أضف واجهة لتغيير البريد الإلكتروني تحت وحدة user، تحقق من تنسيق البريد الإلكتروني، واكتب اختبارات وحدة."
إعادة هيكلة عبر الملفات: "استبدل جميع استخدامات moment() في هذه الملفات الثلاثة بـ dayjs()، دون تغيير أي منطق آخر."
الترقية والتحويل: "حول هذا المكون من Vue 2 إلى أسلوب Composition API في Vue 3."

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

البديل لهذه الفئة هو: كتابة الكود المتكرر يدويًا، والبحث والاستبدال اليدوي عبر الملفات.

الفئة الثالثة: التصحيح والإصلاح

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

الاستخدام النموذجي:

ألقِ إليه مخرجات اختبار فاشل، سيقرأ الكود ذي الصلة، ويقدم حلاً، ثم يعيد تشغيل الاختبار ليرى ما إذا كان ناجحًا.
عند مواجهة خطأ في CI، الصق السجل، دعه يصلحه، ثم شغّل git diff لتأكيد التغييرات.

هنا دوره أقرب إلى "محقق أول". أنت تفكر في المشكلة، لكنه هو من يبحث في الملفات ويقارن الاختلافات وينفذ أوامر التحقق.

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

الفئة الرابعة: أتمتة متنوعة

هذه الفئة هي الأقل وضوحًا، لكن تراكمها يوفر أكبر قدر من الوقت.

أمثلة:

كتابة رسالة Git: claude "اكتب رسالة التزام بتنسيق Conventional Commits بناءً على الـ git diff الحالي"
إنشاء وصف PR: دعه يقارن الاختلافات بين الفرع الحالي و main، ويولد ملخصًا ووصفًا للاختبارات.
كتابة ملاحظات الإصدار: دعه يقرأ سجل الالتزامات للأسبوع الماضي ويولد CHANGELOG.
الإجابة على مشاكل البيئة: "هذا الاعتماد يسبب خطأ أثناء التثبيت، ساعدني في تحليل مخرجات الطرفية وإيجاد السبب."

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

البديل لهذه الفئة هو: تحرير النص يدويًا، كتابة وثائق منسقة، البحث عن مشاكل تكوين البيئة.

"خريطة"

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

استلام مشروع غير مألوف
    │
    ▼
[فهم الكود] ─── توضيح الهيكل، نقطة الدخول، المنطق الرئيسي
    │
    ▼
البدء في كتابة ميزة جديدة أو تعديل وحدة
    │
    ▼
[كتابة/تعديل الكود] ─── توليد التنفيذ، إعادة الهيكلة عبر الملفات
    │
    ▼
تشغيل الاختبارات، ظهور خطأ
    │
    ▼
[التصحيح والإصلاح] ─── تحليل الخطأ، تحديد الموقع، الإصلاح، إعادة التشغيل
    │
    ▼
التحضير للالتزام
    │
    ▼
[الأتمتة المتنوعة] ─── كتابة الالتزام، وصف PR، ملاحظات الإصدار
    │
    ▼
الالتزام، الانتهاء

لست بحاجة لاستخدامه في جميع هذه الأرباع. بعض الفرق تستخدمه فقط لفهم الكود، والبعض الآخر فقط لكتابة الاختبارات وإرسال PRs. أي جزء يسبب لك الإزعاج، ابدأ منه.

معياران مفيدان للاختيار

إذا لم تكن متأكدًا مما إذا كان يجب أن تعهد بمهمة إلى Claude Code، اسأل نفسك سؤالين:

1. هل هذه المهمة "آلية" أكثر منها "إبداعية"؟

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

2. هل "تكلفة التحقق" لهذه المهمة مرتفعة؟

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