AI خزنة
أدلة

كيف تبني تطبيقك الأول مع كلود كود خطوة بخطوة

طريق عملي من مجلد فارغ إلى تطبيق منشور، للمؤسسين الذين لا يعملون مبرمجين بدوام كامل

ATAI Khazna Team7 دقيقة قراءة

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

ما هو كلود كود

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

الكلمة المهمة هنا هي «وكيل». فكلود كود لا يكتفي بالإجابة عن الأسئلة، بل يعمل على ملفاتك مباشرة. هذا مصدر فائدته، وهو أيضا سبب بقائك صاحب القرار في كل تعديل.

ما تحتاجه قبل البدء

  • حساب يشمل كلود كود. بحسب توثيق أنثروبيك، يعني ذلك اشتراك Pro أو Max أو Team أو Enterprise في كلود، أو حساب Claude Console برصيد مدفوع مسبقا. الخطة المجانية لا تشمل كلود كود.
  • جهاز كمبيوتر. إصدار حديث من نظام ماك، أو ويندوز 10 أو 11، أو توزيعة لينكس شائعة، بذاكرة 4 جيجابايت على الأقل واتصال بالإنترنت.
  • طرفية. تطبيق Terminal على ماك، أو باورشيل على ويندوز. إن لم تفتح طرفية من قبل، ففي توثيق أنثروبيك دليل قصير لذلك.
  • جيت (Git). يحفظ جيت كل نسخة من شيفرتك لتتمكن من التراجع عن الأخطاء. ثبته من git-scm.com. وعلى ويندوز توصي أنثروبيك أيضا بتثبيت Git for Windows ليستطيع كلود كود استخدام أداة Bash.
  • حساب مجاني على جيت هب أو جيت لاب أو بيت باكت لحفظ الشيفرة على الإنترنت وربطها بخدمة الاستضافة لاحقا.

الخطوة 1: ثبت كلود كود

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

  • ماك أو لينكس أو WSL: curl -fsSL https://claude.ai/install.sh | bash
  • باورشيل على ويندوز: irm https://claude.ai/install.ps1 | iex

يمكنك التثبيت أيضا عبر هوم برو (brew install --cask claude-code) أو وين جيت (winget install Anthropic.ClaudeCode)، لكن هاتين الطريقتين لا تحدثان البرنامج تلقائيا. بعد انتهاء التثبيت افتح نافذة طرفية جديدة ونفذ claude --version. إذا ظهر رقم إصدار فأنت جاهز. الأوامر تتغير مع الوقت، فارجع إلى صفحة الإعداد إن اختلف ما تراه عما هو مكتوب هنا.

الخطوة 2: ابدأ داخل مجلد المشروع

أنشئ مجلدا فارغا لتطبيقك، وادخل إليه، ثم شغل كلود كود:

mkdir my-first-app ثم cd my-first-app ثم claude

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

الخطوة 3: اكتب خطة من صفحة واحدة

قبل أي شيفرة، اكتب خطة في ملف اسمه PLAN.md لا تتجاوز صفحة واحدة:

  • ماذا يفعل التطبيق، في جملتين.
  • من يستخدمه، وثلاثة أو أربعة أمور يجب أن يستطيع إنجازها.
  • ما الذي لن يدخل في النسخة الأولى.
  • التقنيات المستخدمة إن كان لديك تفضيل (مثل Next.js مع قاعدة بيانات مستضافة)، أو اطلب من كلود كود أن يقترحها ويشرح سبب اختياره.

ثم اطلب من كلود كود قراءة الخطة والإشارة إلى ما ينقصها، فإصلاح خطة غامضة أرخص بكثير من إصلاح شيفرة غامضة. مثال على طلب جيد: «اقرأ PLAN.md، واذكر الأسئلة التي تحتاج إلى إجاباتها قبل البناء، ثم اقترح أصغر نسخة أولى مفيدة». ويمكنك أيضا الضغط على Shift+Tab للتنقل بين أوضاع الأذونات حتى تصل إلى وضع التخطيط، وفيه يفكر كلود كود ويقترح دون أن يعدل الملفات.

الخطوة 4: أضف ملف CLAUDE.md

يبدأ كلود كود كل جلسة بسياق جديد لا يتذكر فيه ما سبق. ملف CLAUDE.md في جذر المشروع يقرأ في بداية كل جلسة، ويحمل ما يجب أن يعرفه دائما: التقنيات، والأوامر، وتنظيم المجلدات، وقواعدك. نفذ /init داخل كلود كود ليكتب مسودة أولى من واقع مشروعك، ثم عدلها. توصي أنثروبيك بأن يبقى كل ملف CLAUDE.md دون 200 سطر تقريبا. ويشرح دليلنا عن ملف القواعد ما تضعه فيه مع مثال عملي.

الخطوة 5: ابن ميزة واحدة في كل مرة

اختر الميزة الأولى من خطتك واطلبها وحدها: «ابن صفحة التسجيل الواردة في PLAN.md، ولا شيء غيرها الآن». الطلبات الصغيرة تنتج تعديلات صغيرة يمكنك فحصها فعلا. وإذا طالت الجلسة واضطربت، اكتب /clear وابدأ من جديد، فملفا CLAUDE.md وPLAN.md ينقلان السياق المهم إلى الجلسة الجديدة.

الخطوة 6: راجع كل تعديل

بحسب وضع الأذونات، يستأذنك كلود كود قبل تعديل أي ملف ويعرض عليك الفرق بين النسختين (diff)، أي الأسطر المحذوفة والأسطر المضافة. اقرأه حتى لو لم تكن مبرمجا، واسأل نفسك: هل يعدل الملفات التي توقعتها؟ هل أضاف حزمة أو خدمة لم أطلبها؟ هل كتبت كلمة مرور أو مفتاح داخل الشيفرة؟ وإذا غمض عليك شيء فاسأل: «اشرح هذا التعديل بكلمات بسيطة». لست مضطرا لفهم كل سطر، لكن يجب أن تفهم ما يفعله كل تعديل.

الخطوة 7: شغل التطبيق واختبره

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

الخطوة 8: احفظ النسخة بجيت

كلما عملت ميزة، احفظ تلك النسخة بجيت. يمكنك أن تطلب ذلك من كلود كود مباشرة: «احفظ تعديلاتي في commit برسالة واضحة». كل commit نقطة رجوع، فإن ساءت الميزة التالية عدت إلى آخر نسخة سليمة. ثم ارفع المشروع إلى مستودع خاص على جيت هب أو خدمة مماثلة ليبقى محفوظا. ولا تحفظ أبدا ملفات الأسرار مثل .env، واطلب من كلود كود التأكد من إدراجها في .gitignore.

الخطوة 9: انشر التطبيق

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

مهارات تساعدك في الطريق

المهارات تعليمات مجمعة يحملها كلود كود حين تحتاجها المهمة. وفي كتالوج AI خزنة بعض المهارات التي تناسب هذا المسار: Writing Plans وExecuting Plans لتحويل الخطة إلى خطوات مرتبة وتنفيذها، وCode Review لفحص التعديلات وفق معاييرك، وGit Guardrails Claude Code التي تمنع أوامر جيت المدمرة قبل تنفيذها. اقرأ كل مهارة قبل تثبيتها كما تقرأ أي شيفرة، وتصفح المزيد في كتالوج المهارات.

خطوتك التالية

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

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

هل أحتاج إلى معرفة البرمجة لاستخدام كلود كود؟
لا، لكن يجب أن تبقى صاحب القرار. خطط بخطوات صغيرة، واقرأ كل تعديل يقترحه، واطلب منه شرح ما لا تفهمه قبل أن توافق عليه.
ما الاشتراك الذي أحتاجه لكلود كود؟
يذكر توثيق أنثروبيك اشتراكات Pro وMax وTeam وEnterprise في كلود، أو حساب Claude Console برصيد مدفوع مسبقا. الخطة المجانية لا تشمل كلود كود.
هل يستطيع كلود كود نشر التطبيق بنفسه؟
يستطيع تنفيذ الأوامر ومساعدتك في إعداد الاستضافة، لكن أبسط طريق هو ربط مستودع جيت بخدمة مثل فيرسل تنشر التطبيق مع كل دفع للتعديلات. وتبقى الحسابات والمفاتيح السرية تحت سيطرتك.
ماذا لو أفسد كلود كود شيئا كان يعمل؟
لهذا تحفظ commit بعد كل ميزة تعمل. اطلب من كلود كود عرض ما تغير منذ آخر commit، ثم أصلح الخلل أو ارجع إلى تلك النسخة.
claude codevibe codingbeginnersgitdeployment