شرح Claude Code من الصفر: التثبيت وأول مهمة

يأخذك هذا الشرح لـ Claude Code من الصفر حتى أول جلسة تعمل فعلًا: أمر تثبيت واحد، وتسجيل الدخول بحساب Claude، وأول مهمة في مشروعك، وملف CLAUDE.md الذي يجعل الوكيل يتذكر قواعد مشروعك. تحتاج إلى طرفية (Terminal)، وأي مشروع برمجي، واشتراك Claude مدفوع (Pro أو Max أو Team أو Enterprise) أو حساب Claude Console برصيد API. يستغرق الأمر كله ربع ساعة.

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

ما هو Claude Code

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

المحرك نفسه يعمل أيضًا خارج الطرفية: في VS Code وJetBrains، وفي تطبيق سطح المكتب، وفي المتصفح على claude.ai/code، وفي تطبيق الهاتف. في هذا الشرح أبقى مع الطرفية، لأنها المكان الذي ترى فيه أكثر.

شرح Claude Code: التثبيت بأمر واحد

الطريقة الموصى بها هي المثبّت الأصلي، الذي يحدّث نفسه تلقائيًا في الخلفية.

macOS وLinux وWSL:

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell:

irm https://claude.ai/install.ps1 | iex

Windows CMD:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

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

claude --version

إذا رأيت رقم إصدار متبوعًا بـ (Claude Code)، فكل شيء يعمل. أما رسالة أن claude غير معروف فتعني عادةً أن مجلد التثبيت غير موجود في PATH؛ وللتوثيق قسم مخصص لذلك.

البدائل: brew install --cask claude-code على macOS وwinget install Anthropic.ClaudeCode على Windows. هاتان الطريقتان لا تحدّثان نفسيهما تلقائيًا. وعلى Windows من دون WSL يُستحسن تثبيت Git for Windows ليتمكن Claude من الوصول إلى Bash.

تسجيل الدخول وأول جلسة

ادخل إلى مجلد المشروع وشغّل الوكيل:

cd /path/to/project
claude

عند التشغيل الأول سيطلب منك Claude Code تسجيل الدخول عبر المتصفح. تسجّل الدخول بحساب Claude (اشتراك Pro أو Max أو Team أو Enterprise) أو بحساب Claude Console، أي وصول إلى API برصيد مدفوع مسبقًا. تُحفظ بيانات الدخول، لذا تفعل ذلك مرة واحدة فقط. وإذا كان المتغير ANTHROPIC_API_KEY مضبوطًا، سيسألك Claude إن كان يستخدمه ويتخطى تسجيل الدخول.

بعد تسجيل الدخول سترى موجّهًا (prompt) فيه رقم الإصدار واسم النموذج ومجلد العمل. اكتب /help لرؤية الأوامر المتاحة.

أول مهمة

ابدأ بالأسئلة قبل أن تسمح للوكيل بتغيير أي شيء. يقرأ Claude الملفات بنفسه، فلا داعي للصقها:

ماذا يفعل هذا المشروع؟
أين نقطة الدخول الرئيسية؟
اشرح بنية المجلدات

ثم تغيير صغير:

أضف دالة hello world إلى الملف الرئيسي

سيجد Claude الملف المناسب ويعرض لك الـ diff. إذا طلب الإذن، فوافق. ما يجب على الوكيل أن يستأذن فيه يحدده وضع الأذونات، وتبدّل بينه بالمفتاحين Shift+Tab. في الإصدارات الأحدث يكون الوضع التلقائي (auto) هو الافتراضي، وفيه يفحص نموذج مصنِّف منفصل الإجراءات ولا يحظر إلا الخطرة منها.

ويمكنك التعامل مع Git بجمل عادية أيضًا:

ما الملفات التي غيّرتها؟
أنشئ commit برسالة وصفية
أنشئ فرعًا باسم feature/quickstart

CLAUDE.md، ذاكرة المشروع

تبدأ كل جلسة بسياق فارغ. وحتى لا تشرح في كل مرة كيف يُبنى المشروع وما الأعراف التي تتبعونها، اكتب ذلك في ملف CLAUDE.md في المجلد الجذر للمستودع. يقرأه Claude في بداية كل محادثة.

أسرع بداية هي الأمر /init: يحلل Claude المستودع وينشئ ملفًا فيه أوامر البناء والاختبارات والأعراف التي يكتشفها بنفسه. بعد ذلك تضيف ما لا يمكن استنتاجه من الكود.

ما يستحق أن يوضع فيه بحسب التوثيق:

• الأوامر التي لن يخمّنها Claude (البناء، الاختبارات، lint)،
• قواعد الأسلوب التي تختلف عن الافتراضي،
• آداب المستودع (أسماء الفروع، أعراف طلبات الدمج PR)،
• القرارات المعمارية والمطبات الخاصة بالمشروع.

ما لا يجب كتابته: ما يستنتجه Claude بنفسه من الكود، والعموميات من قبيل «اكتب كودًا نظيفًا». ينصح التوثيق بإبقاء الملف أقل من 200 سطر. فالملفات الأطول تستهلك السياق ويُلتزم بها بدرجة أقل.

بعض الحقائق التي ستوفر عليك البحث:

• ~/.claude/CLAUDE.md هو قواعدك الشخصية لكل المشاريع، و./CLAUDE.md هو قواعد المشروع المشتركة مع الفريق، و./CLAUDE.local.md هو ملاحظاتك الخاصة بمستودع معيّن (أضفه إلى .gitignore).
• يمكن للملف تضمين ملفات أخرى بالصيغة @path/to/file.
• إذا كان في المستودع ملف AGENTS.md لوكلاء آخرين، فسيقرأه Claude Code بدلًا من CLAUDE.md.
• يعرض /context ملفات الذاكرة التي تم تحميلها.

أوامر تستحق المعرفة

الأمر	ماذا يفعل
claude	يبدأ جلسة تفاعلية
claude "مهمة"	يبدأ مباشرة بأول تعليمات
claude -p "سؤال"	استعلام واحد من دون جلسة، والنتيجة في الطرفية
claude -c	يواصل آخر محادثة في هذا المجلد
claude -r	يختار محادثة سابقة لاستئنافها
/init	ينشئ ملف CLAUDE.md أوليًا
/clear	يمسح السياق بين المهام غير المترابطة
/compact	يلخّص المحادثة لتحرير مساحة في السياق
/rewind (أو Esc مرتين)	يعيد المحادثة وتغييرات الملفات إلى نقطة تختارها
/permissions	قائمة الأدوات الموثوقة، وطلبات إذن أقل
Shift+Tab	يبدّل وضع الأذونات، بما في ذلك وضع التخطيط
/exit	الخروج

وضع -p مفيد بشكل خاص في السكربتات: الأمر cat error.log | claude -p "اشرح هذا الخطأ" يرسل الملف مباشرة إلى النموذج.

خمس عادات تصنع الفرق

معظم النصائح في أفضل الممارسات الرسمية تعود إلى قيد واحد: نافذة السياق تمتلئ بسرعة، ومعها تنخفض الجودة.

1. الاستكشاف والتخطيط أولًا، ثم الكود. في التغييرات الأكبر فعّل وضع التخطيط (Shift+Tab حتى يظهر plan mode on). يقرأ Claude الملفات ويقترح خطة، لكنه لا يغيّر شيئًا حتى توافق عليها. أما في الإصلاحات المكوّنة من سطر واحد فالخطة عبء لا داعي له.
2. كن محددًا. بدلًا من «أصلح خطأ تسجيل الدخول»، اكتب ما هو العَرَض، وأين يُرجَّح أن يكون السبب، وماذا تعني كلمة «تم الإصلاح». أشر إلى الملفات بـ @اسم-الملف.
3. أعطِ الوكيل طريقة للتحقق من عمله. اختبارات، أو بناء، أو lint، أو لقطة شاشة للمقارنة. من دون ذلك تكون «يبدو جاهزًا» الإشارة الوحيدة، وتصبح أنت المختبِر.
4. نظّف السياق. استخدم /clear بين المهام غير المترابطة. وإذا صحّحت Claude مرتين في المسألة نفسها، فابدأ من جديد بموجّه أفضل.
5. تراجع من دون خوف. كل موجّه ينشئ نقطة استعادة. عندما تفشل تجربة، يعيد /rewind المحادثة والملفات. هذا لا يغني عن git، لكنه يشجع على محاولات أكثر جرأة.

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

هل Claude Code مجاني؟

لا. يشترط التوثيق اشتراك Claude مدفوعًا (Pro أو Max أو Team أو Enterprise) أو حساب Claude Console تدفع فيه مقابل رموز API. الأسعار الحالية للاشتراكات موجودة على claude.com/pricing.

هل يعمل Claude Code على Windows؟

نعم، بشكل أصلي (PowerShell أو CMD) وفي WSL. على Windows الأصلي يُستحسن وجود Git for Windows، لأن الوكيل يستخدم حينها Bash؛ ومن دونه يستخدم PowerShell.

هل يجب أن أستخدم الطرفية؟

لا. الوكيل نفسه متاح كإضافة لـ VS Code وJetBrains، وكتطبيق سطح مكتب، وكنسخة في المتصفح. وتعمل ملفات CLAUDE.md والإعدادات وخوادم MCP بالطريقة نفسها على كل هذه الواجهات.

ما الفرق بين Claude Code ودردشة Claude؟

الدردشة تجيب عن الأسئلة. أما Claude Code فيعمل داخل مستودعك: يقرأ الملفات ويعدّلها، وينفّذ الأوامر والاختبارات، وينشئ الـ commits ويفتح طلبات الدمج (pull requests). أي أنه يتلقى مهمة، لا سؤالًا.