Claude Code للمبتدئين: أول مشروع في 30 دقيقة

Claude Code يُغيّر طريقة البرمجة بشكل جذري. بدلاً من كتابة كل سطر بنفسك، تُخبر كلود بما تريد بناؤه وهو يكتب الكود، يُنفّذه، يُصحّح الأخطاء، ويواصل حتى تنجح المهمة.

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

ما هو Claude Code بالضبط؟

Claude Code هو أداة تعمل في Terminal أو Command Prompt — ليس في المتصفح. تفتحه في مجلد مشروعك وتبدأ المحادثة مع كلود. الفرق الجوهري عن claude.ai هو أن Claude Code:

يقرأ ملفاتك الفعلية — يرى الكود الموجود في مشروعك كاملاً. يُعدّل الملفات مباشرة — يكتب في ملفاتك ويُعدّلها. يُشغّل الأوامر — يُشغّل npm install أو python أو أي أمر تحتاجه. يتعامل مع Git — يعرف تاريخ مشروعك والتغييرات.

النتيجة: مساعد برمجة يعيش داخل مشروعك لا خارجه.

المتطلبات

التثبيت — دقيقة واحدة

# في Terminal أو PowerShell
npm install -g @anthropic-ai/claude-code

# تحقق من التثبيت
claude --version

إذا ظهر رقم الإصدار، التثبيت نجح.

أول تشغيل والمصادقة

# اذهب لأي مجلد
cd Desktop

# شغّل كلود
claude

في أول تشغيل سيطلب المصادقة. لديك خياران:

الأول: تسجيل الدخول عبر المتصفح — يفتح متصفحك تلقائياً لتسجيل الدخول بحساب Claude.ai. مناسب إذا لديك اشتراك Pro أو Max.

الثاني: API Key — أدخل مفتاح API من console.anthropic.com. مناسب إذا تفضّل الدفع بالـ tokens.

# إدخال API Key يدوياً
export ANTHROPIC_API_KEY=sk-ant-your-key-here

# أو أضفه لملف .bashrc أو .zshrc
echo 'export ANTHROPIC_API_KEY=sk-ant-your-key-here' >> ~/.zshrc

الأوامر الأساسية — تعلّمها قبل أي شيء

# داخل جلسة Claude Code

/help       — قائمة بكل الأوامر المتاحة
/clear      — مسح المحادثة والبدء من جديد
/compact    — تلخيص المحادثة الطويلة لتوفير context
/status     — معرفة استهلاك الـ tokens
/exit       — الخروج من الجلسة

# خارج الجلسة
claude --help           — دليل الاستخدام
claude -p "مهمة محددة"  — تنفيذ مهمة واحدة ثم خروج

بناء أول مشروع: موقع شخصي

الآن نبني موقعاً شخصياً بسيطاً من الصفر.

فهم نظام الأذونات

Claude Code لن يفعل أي شيء بدون إذنك. حين يريد كتابة ملف، تنفيذ أمر، أو حذف شيء — سيسألك أولاً.

الردود المتاحة حين يسأل كلود:

y / yes    — نعم، افعل هذه المرة
n / no     — لا، لا تفعل
a / always — نعم لهذا النوع من الأوامر دائماً في هذه الجلسة

هذا النظام يحميك. كلود لن يحذف ملفاً أو يُشغّل أمراً خطيراً دون علمك. في البداية، اقرأ ما يريد فعله قبل الموافقة.

الأخطاء الشائعة للمبتدئين

الخطأ الأول: طلبات غامضة جداً. "ابنِ لي موقعاً" — كلود سيبني شيئاً لكن قد لا يكون ما تريد. كن محدداً: "ابنِ موقع مطعم بـ 3 صفحات: رئيسية، قائمة الطعام، اتصل بنا. ألوان برتقالية وبيضاء."

الخطأ الثاني: عدم مراجعة الكود. كلود يُخطئ أحياناً. راجع الكود المُولَّد قبل إضافته لمشروع مهم.

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

الخطأ الرابع: عدم استخدام /compact. حين تطول المحادثة، الـ context يمتلئ وكلود يبدأ "ينسى" ما قيل في البداية. استخدم /compact لتلخيص الجلسة وتحرير مساحة.

الخطأ الخامس: تجاهل ملف CLAUDE.md. في أي مشروع جدي، أنشئ CLAUDE.md يشرح مشروعك لكلود. هذا يُحسّن جودة الكود بشكل كبير.

5 مشاريع مناسبة للمبتدئين

المشروع الأول: موقع شخصي بسيط — HTML وCSS فقط، لا backend. مثالي لأول تجربة.

المشروع الثاني: آلة حاسبة بـ JavaScript — اطلب من كلود بناء حاسبة في المتصفح. تعلّم كيف يتعامل مع الـ DOM.

المشروع الثالث: API بسيط بـ Python — FastAPI يُرجع بيانات JSON. تعلّم كيف يبني كلود backend.

المشروع الرابع: سكريبت أتمتة — سكريبت Python يُنظّم ملفات مجلد تلقائياً. مفيد وتطبيقي.

المشروع الخامس: صفحة هبوط لمنتج — تصميم جذاب بـ HTML وCSS وقليل من JS. مهارة قابلة للبيع.

الجواهر الخمسة — تصعيد سريع

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