الدرس 0. تثبيت Claude Code — ما تستخدمه قد لا يكون Claude Code

نصيحة ذهبية — هذا كل ما تحتاج معرفته للبدء

سطر تحقق واحد يكفي.

افتح الطرفية وأدخل:

claude --version

إذا ظهر رقم إصدار مثل 2.1.x — فهذا Claude Code الحقيقي. ستسير دروس الدورة من 1 إلى 11 بلا عوائق.

أما إذا قالت الطرفية إن الأمر غير موجود، أو كنت تستخدم نافذة الدردشة داخل Cursor أو Antigravity أو Windsurf — فذاك ليس Claude Code. حتى لو استخدم نفس نموذج Claude فهو برنامج مختلف. القيادة الذاتية في هذه الدورة لا تعمل هناك.

الجملة التي يجب حفظها:

الوكيل ≠ النموذج. حتى مع نفس Opus، إذا اختلف البرنامج المُشغِّل اختلفت القدرات.

التثبيت في سطر واحد (Mac / Ubuntu / WSL):

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

مستخدمو Windows يحتاجون WSL أو Docker أولاً. يأتي الشرح في المتن أدناه.

تجربة سريعة

نُكلّف بنفس المهمة لنرى بأم أعيننا الفرق بين CLI وبين دردشة IDE. ثلاث دقائق تكفي.

في Claude Code (CLI):

“أنشئ ملف hello.py في مجلد فارغ. ضع فيه خطأً نحوياً عمداً، شغّله وتحقق من الخطأ، ثم صلحه بنفسك وشغّله مجدداً. حتى يظهر ‘Hello’.”

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

ضع نفس الجملة في دردشة IDE (Cursor/Antigravity/Windsurf) — يقترح الكود لكنك تضغط الزر للتشغيل، وتنسخ الخطأ وتلصقه، وتنتظر موافقتك في كل خطوة. الحلقة لا تُغلق إلا بك.

هذا الفرق هو جوهر الدرس 0. وعليه بُنيت الدورة كاملة — تفترض الأول.

لماذا يجب أن تأمر بهذه الطريقة

ربما جربت “Claude Code” من قبل. شاهدت درساً على يوتيوب، كتبت في نافذة الدردشة، ورأيت كوداً يخرج.

لكن أسألك سؤالاً واحداً: هل ما استخدمته فعلاً هو Claude Code؟

إذا بدا السؤال هيّناً، استمع إلى قصة من الواقع.

الوكيل ≠ النموذج

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

لم يكن الخطأ في حكمه. ما كان يستخدمه هو دردشة Claude داخل إضافة Antigravity للـ IDE، وليس CLI Claude Code. كلاهما يستخدم نموذج Claude Opus. النموذج واحد. لكن النتيجة مختلفة تماماً.

لماذا؟ لأن النموذج واحد والوكيل مختلف.

• النموذج (Model): الدماغ كـ Opus وSonnet — قدرة القراءة والكتابة ذاتها.
• الوكيل (Agent): البرنامج الذي يُشغّل ذلك الدماغ. ما الـ system prompt الذي يُعطَى؟ ما الأدوات (قراءة/كتابة ملفات/تنفيذ أوامر) الممنوحة؟ ما مدى استقلاليته دون موافقة بشرية؟ — كل ذلك يحدده الوكيل.

نفس الحصان (النموذج)، لكن الفرق بين إطلاقه في الحقل بلا قيود وبين تسريجه وامتطائه — الوجهة تختلف. الوكيل هو ذلك السرج واللجام — الجهاز الذي يُمكّن من وضع لجام (reins). (نلتقيه مجدداً في الدرس 5.)

لماذا يجب أن يكون الوكيل بهذا المستوى

للوكلاء درجات. والمعيار الفاصل في هذه الدورة (الدروس 1-11) واحد:

جوهر الدورة في جملة:

الذكاء الاصطناعي يكتب الكود، الآلة تتحقق، وأنت تسأل فقط “هل نجح؟”

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

حلقة ذاتية ممكنة:
  الذكاء الاصطناعي يشغّل validate → يقرأ الخطأ → يصلح → validate مجدداً → نجاح → التالي
  (صفر تدخل بشري)

وساطة بشرية في كل خطوة:
  الذكاء الاصطناعي: "شغّل validate هكذا" → تنسخ وتشغّل →
  تنسخ النتيجة → تلصقها للذكاء الاصطناعي → يقترح تصحيحاً → تشغّل مجدداً...

الدرس 3 (Hurl)، الدرس 4 (yongol)، الدرس 6 (tsma)، الدرس 8 (filefunc) — كلها أدوات CLI. لا معنى لها إلا إن شغّلها الذكاء الاصطناعي باستقلالية. الوكيل العاجز عن هذه الحلقة يُعطّل نصف الدورة.

إذاً المعيار ليس العلامة التجارية بل هذا السؤال:

هل يُشغّل هذا الوكيل yongol validate / hurl / tsma بنفسه، يقرأ النتيجة ويقرر الخطوة التالية؟ أم تحتاج أن تنسخ وتوافق في كل خطوة؟

• الأول — وكيل يقبل اللجام. (CLI Claude Code ينتمي إليه.)
• الثاني — وكيل قاصر. مهما كان النموذج ذكياً يتوقف هنا.

تنبيه: “IDE = لا يصلح” ليست قاعدة مطلقة. بعض IDE كـ Cursor وWindsurf لها وضع وكيل يُشغّل أوامر باستقلالية ويدور في حلقة. في المقابل وضع الدردشة البسيط في نفس المنتج يمر بالإنسان في كل خطوة. الحُكم بالمعيار أعلاه لا بالاسم. ما حدث في الواقع لم يكن “لأنه IDE” بل لأن وضع الدردشة المستخدم لم يستطع تدوير حلقة CLI ذاتياً.

لذا فالدرس 0 هو مدخل الدورة. اختر الأداة غلطاً وسيصبح كل الدروس الأحد عشر كذباً.

فخ يوتيوب

المشكلة هي هذه: معظم دروس البرمجة بالإحساس على يوتيوب والمجتمعات لا تفرق بين الوكيل الذاتي الحلقة ووضع الدردشة البسيط، وتسمّي الاثنين “Claude Code”.

فلا يعرف المبتدئ الفرق. يكتب في الدردشة ويظن أنه “يستخدم Claude Code”. ثم يُلقي بالسبب على نفسه حين لا يجري الدرس كما شرح.

لا. الأداة غُلط في اختيارها. أدقّ: يوتيوب أخطأ في تعريف الأداة. معيار واحد تحمله — “هل يُشغّل CLI بنفسه؟” — يكفي لتجنّب هذا الفخ.

تثبيت Claude Code

تعتمد هذه الدورة على بيئة Ubuntu (أو WSL). معظم الأوامر تعمل لمستخدمي Mac أيضاً.

المتطلبات المسبقة

1. حساب Anthropic: سجّل في https://console.anthropic.com
2. خطة اشتراك: اختر بين Claude Pro ($20/شهر) أو Max ($100/شهر أو $200/شهر). Max أكثر سخاءً في حدود الاستخدام
3. Ubuntu / Mac / WSL أو Docker: مستخدمو Windows يختارون أحد المسارين أدناه

Mac · Ubuntu · WSL — التثبيت الأصلي (موصى به)

الطريقة الأبسط ولا تحتاج Node.js.

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

بعد انتهاء التثبيت تحقق:

claude --version

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

Windows المسار أ: WSL (موصى به)

افتح Windows PowerShell بصلاحيات المسؤول ونفّذ:

wsl --install

هذا السطر الواحد يُفعّل WSL ويحمّل نواة Linux ويثبّت Ubuntu. بعد إعادة التشغيل يُفتح Ubuntu ويسأل عن اسم المستخدم وكلمة المرور. أدخل اسماً قصيراً بالأحرف الصغيرة.

تنبيه: جميع العمليات التالية تتم داخل طرفية Ubuntu. تثبيت Claude Code من PowerShell أو CMD يُنتج خطأ “Windows is not supported”.

بعدها نفّذ سطر التثبيت الأصلي أعلاه داخل Ubuntu.

نصيحة WSL: ضع المشروع حتماً في نظام ملفات Linux (/home/اسم_المستخدم/). وضعه في جهة Windows (/mnt/c/) يجعل قراءة الملفات بطيئة للغاية.

Windows المسار ب: Docker (حين يتعذّر WSL)

إذا منعت سياسة الشركة أو ظروف البيئة تثبيت WSL، شغّل حاوية Linux عبر Docker واستخدم Claude Code داخلها.

# من مجلد المشروع، شغّل حاوية ubuntu وشارك المجلد الحالي
docker run -it -v "$(pwd)":/work -w /work ubuntu:24.04 bash

# داخل الحاوية
apt update && apt install -y curl
curl -fsSL https://claude.ai/install.sh | bash
claude --version

-v "$(pwd)":/work يربط مجلد مشروعك بـ /work داخل الحاوية. ما تصنعه داخلها يبقى في مجلدك.

طريقة بديلة: التثبيت عبر npm

هذه الطريقة لمن لديه خبرة سابقة بـ Node.js. إذا كنت مبتدئاً استخدم التثبيت الأصلي أعلاه.

# تثبيت nvm ثم Node.js LTS
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
source ~/.bashrc
nvm install --lts

# تثبيت Claude Code
npm install -g @anthropic-ai/claude-code

تنبيه: لا تستخدم sudo npm install -g. يسبب مشاكل في الصلاحيات ومخاطر أمنية.

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

# انتقل لمجلد المشروع (أنشئه إن لم يكن موجوداً)
mkdir -p ~/projects/my-first-app
cd ~/projects/my-first-app

# شغّل Claude Code
claude

عند التشغيل لأول مرة يُفتح المتصفح ويطلب تسجيل الدخول في Anthropic. بعد تسجيل الدخول تكتمل المصادقة، وفي المرات التالية يتصل تلقائياً.

قائمة التحقق من التثبيت

هذه النقاط الثلاث مجتمعة تعني أنك جاهز للدرس 1.

• هل يُخرج claude --version رقم إصدار 2.1.x
• هل يظهر موجه الأوامر (نافذة المحادثة) عند تشغيل claude
• هل اكتملت المصادقة عبر تسجيل دخول المتصفح
• في التجربة السريعة أعلاه، هل أنشأ الذكاء الاصطناعي الملف وشغّله وصلحه بنفسه (دون أن يطلب موافقتك في كل خطوة)

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

إضافات IDE كأداة مساعدة فقط

لا يعني هذا أن Cursor أو Antigravity أو Windsurf أدوات رديئة. للنظر في الكود وتعديله سطراً سطراً فهي ممتازة. أداة مثالية للمبرمج.

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

التطبيق: التحقق من الحقيقة

الهدف: التأكد من أن ما تستخدمه هو CLI Claude Code، وتدوير حلقة ذاتية مرة واحدة.

الخطوة 1 — التحقق من التثبيت

claude --version

تحقق أن الإصدار يبدأ بـ 2.1.x. إن لم يظهر ارجع لإجراء التثبيت أعلاه. مستخدمو Windows يُعدّون WSL (المسار أ) أو Docker (المسار ب) أولاً.

الخطوة 2 — مراقبة الحلقة الذاتية

شغّل claude في مجلد فارغ وأعطِه:

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

ما تراقبه:

• هل أنشأ الذكاء الاصطناعي الملف مباشرة؟ (أنت لم تنسخ الكود وتلصقه)
• هل شغّل python hello.py بنفسه؟
• عند ظهور خطأ، هل قرأه وصلحه وحده؟
• كل ما فعلته في العملية كلها هو الجملة الافتتاحية و(إن طُلب) إذن التشغيل؟

إذا كانت الإجابات كلها “نعم” — اجتزت البوابة. انتقل للدرس 1.

(إن كنت تستخدم دردشة IDE) ضع نفس الجملة في دردشة IDE أيضاً وقارن أين يتوقف. حين تشعر بهذا الفرق مرة واحدة لن تنسى لماذا كان الدرس 0 ضرورياً.

ملخص

1. الوكيل ≠ النموذج. نفس نموذج Claude مع برنامج مُشغِّل (وكيل) مختلف يعني قدرات مختلفة تماماً.
2. كثير مما يسمّيه يوتيوب “Claude Code” هو وضع دردشة بسيط لا يدور في حلقة ذاتية. المعيار الفاصل ليس العلامة التجارية بل “هل يُشغّل CLI بنفسه؟”
3. هذه الدورة مبنية على CLI. الدرس 3 (Hurl)، الدرس 4 (yongol)، الدرس 6 (tsma)، الدرس 8 (filefunc) — كلها أدوات CLI يجب أن يُشغّلها الذكاء الاصطناعي باستقلالية.
4. التثبيت في سطر. curl -fsSL https://claude.ai/install.sh | bash. مستخدمو Windows يحتاجون WSL أو Docker أولاً.
5. معيار اجتياز البوابة: يُخرج claude --version الرقم 2.1.x، والذكاء الاصطناعي يُنشئ الملفات ويشغّلها ويصلحها بنفسه.

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

توطئة للدرس التالي: “كيف تأمر الذكاء الاصطناعي.” الآن وقد امتلكت Claude Code الحقيقي، تعلم ما تطلبه منه وكيف — لمن لا يعرف البرمجة.

الواجب

1. التحقق من هوية أداتك: ما كنت تظنه “Claude Code” حتى الآن — هل هو CLI أم دردشة IDE؟ claude --version يجيبك.
2. تدوير حلقة ذاتية واحدة: أكمل تمرين hello.py أعلاه حتى النهاية وعُدّ كم خطوة أنجزها الذكاء الاصطناعي دون تدخلك.
3. (مستخدمو Windows) اختر بيئتك: WSL أو Docker — اختر ما يناسب بيئتك وأكمل الإعداد.

مقالات ذات صلة

• لماذا تعمل وكلاء البرمجة ولماذا تنهار — شروط عمل وانهيار حلقة التحقق الذاتي للوكلاء. الخلفية النظرية لـ “لماذا الحلقة الذاتية في CLI؟” في الدرس 0.
• Reins Engineering — الذكاء الاصطناعي باللجام — الفرق بين الحاجز (harness) واللجام (Reins)، وإطار النظر للوكيل كمنصة للجام.

للمزيد من القراءة (مصادر خارجية)

• Agent Harness Engineering — Addy Osmani. “نموذج معقول + حاجز ممتاز يتغلب على نموذج ممتاز + حاجز رديء.” حالات قُلبت فيها ترتيبات المعيار بتغيير الحاجز وحده مع تثبيت النموذج. الدليل القاطع على الوكيل ≠ النموذج.
• Agents are models using tools in a loop — Simon Willison. التعريف المعياري للوكيل. “الحلقة” التي تُعيد نتائج الأدوات للنموذج هي ما يفصل الوكيل الحقيقي عن مصطلح التسويق.
• Which AI Coding Harness Actually Works Without You? — Paweł Józefiak. تصنيف أدوات الكود إلى Orchestrator (ذاتي) / Pair Programmer (تعليمات خطوة بخطوة) / Supervised IDE (يرفض القرار المنفرد). الخلط بينها هو الخطأ الجوهري — يتطابق تماماً مع “فخ يوتيوب” في الدرس 0.

سلسلة دروس Reins Engineering الكاملة

المصادر

• Anthropic. “Claude Code overview.” Anthropic Documentation. link
• Anthropic. “Set up Claude Code.” Anthropic Documentation. link
• Karpathy, A. (2025). “Vibe coding” — أصل مصطلح البرمجة بالإحساس: كتابة الكود بالشعور لا بالقراءة.