في الدرس السابق ثبّتنا Claude Code وسجّلنا الدخول وشغّلنا أول أمر. عند بعض الناس تمشي العملية من أول مرة خلال دقيقتين. وعند بعضهم الآخر تظهر رسالة حمراء غريبة، أو يكتب claude فيرد عليه الـ Terminal بأن الأمر غير معروف.
إذا كنت من المجموعة الثانية: المشكلة ليست فيك، وجهازك ليس معطلاً. كل المشاكل تقريباً في هذه المرحلة تعود إلى أربعة أسباب فقط، وكلها تُحل في دقائق.
هذا الدرس مكتوب ليكون مرجعاً ترجع إليه وقت الحاجة. لا تحتاج قراءته كاملاً الآن — ابحث عن الرسالة التي ظهرت عندك واقرأ قسمها.
بنهاية هذا الدرس، رح تكون قادر على:
claude فقال لي الأمر غير معروفهذه أشهر مشكلة على الإطلاق، وشكلها كالتالي على Windows:
'claude' is not recognized as an internal or external command,
operable program or batch file.أو على Mac:
command not found: claudeماذا تعني هذه الرسالة؟ أن التثبيت نجح فعلاً، لكن الـ Terminal لا يعرف أين وُضع البرنامج. تخيّل أنك ركّبت تطبيقاً على جهازك لكن لم يظهر له اختصار على سطح المكتب — التطبيق موجود، أنت فقط لا تملك طريقة لتشغيله بالاسم.
المكان الذي يبحث فيه الـ Terminal عن البرامج اسمه PATH، وهو ببساطة قائمة مجلدات. إذا لم يكن مجلد Claude Code ضمن هذه القائمة، فلن يجده.
عند انتهاء التثبيت، يطبع لك الـ Terminal مساراً يشبه هذا:
C:\Users\Shadow\.local\bin\claudecode.exeانسخه، ثم:
claudecode.exe من نهاية المسار. الـ PATH قائمة مجلدات، وليس قائمة ملفات. المسار الصحيح ينتهي عند bin:
text C:\Users\Shadow\.local\bin
إذا تركت اسم الملف في النهاية، ستضيف السطر بنجاح ولن يتغير شيء، وستظن أن الحل لم ينفع.بعد الحفظ، أغلق الـ Terminal تماماً وافتحه من جديد. الـ Terminal يقرأ الـ PATH مرة واحدة عند فتحه فقط، فالنافذة المفتوحة حالياً ما زالت تعمل بالقائمة القديمة. هذه الخطوة وحدها تحل نصف الحالات التي يقول أصحابها "عملت كل شيء ولم ينفع".
على Mac غالباً تكون المشكلة أن التثبيت وضع البرنامج في مجلد غير مضاف للـ PATH. تأكد أولاً أن الملف موجود فعلاً:
ls ~/.local/binإذا رأيت الملف هناك، أضف المجلد إلى الـ PATH:
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrcثم أغلق الـ Terminal وافتحه من جديد، أو نفّذ:
source ~/.zshrcقد تنجح في التثبيت وتسجيل الدخول، ثم تصطدم برسالة تخبرك أن حسابك لا يسمح باستخدام الأداة.
السبب: Claude Code يحتاج اشتراكاً مدفوعاً — Pro أو Max أو Team. الحساب المجاني لا يشغّل الأداة، مهما كان التثبيت صحيحاً.
هذه ليست مشكلة تقنية تُحل بأمر في الـ Terminal، وليس فيها التفاف. إما اشتراك مدفوع، أو استخدام API Key بحساب فيه رصيد. عند تشغيل الأداة لأول مرة سيسألك أيهما تريد، ويمكنك اختيار الـ API Key بدل تسجيل الدخول بالحساب.
عند اختيار تسجيل الدخول بالحساب، يفتح Claude Code المتصفح تلقائياً ويطلب منك الموافقة على الصلاحيات (Authorize). أحياناً تظهر رسالة النجاح في المتصفح، لكن الـ Terminal يبقى ينتظر.
جرّب بالترتيب:
claude من جديد.على Mac قد تظهر رسالة Permission denied، أو تحذير بأن التطبيق من مطوّر غير موثوق.
للحالة الأولى، امنح الملف صلاحية التنفيذ:
chmod +x ~/.local/bin/claudeأما التحذير الأمني، فهو من macOS نفسه وليس من الأداة: افتح System Settings ثم Privacy & Security، وستجد في الأسفل زراً يسمح بتشغيل التطبيق الذي مُنع للتو.
إذا توقف التثبيت أو ظهرت رسالة عن انقطاع الاتصال أو انتهاء المهلة، فالمشكلة غالباً في الشبكة لا في جهازك:
قبل أن تبحث عن حل، اسأل نفسك هذه الأسئلة الأربعة بالترتيب:
وإذا وصلت إلى هنا ولم تُحل المشكلة: انسخ الأمر الذي كتبته والرسالة كاملة — هما كل ما يحتاجه أي شخص لمساعدتك، وبدونهما لا أحد يستطيع تخمين ما حدث.
رسالة command not found تعني أن التثبيت نجح والـ Terminal لا يجد البرنامج. المشكلة في الـ PATH، وليست في التثبيت نفسه.
المسار في الـ PATH يجب أن ينتهي عند المجلد bin، لا عند claudecode.exe. هذا الخطأ يبدو صحيحاً ولا يعطي أي رسالة، ولذلك يضيّع وقتاً أطول من غيره.
أغلق الـ Terminal وافتحه من جديد بعد أي تعديل على الإعدادات. النافذة المفتوحة تعمل بالقائمة القديمة.
الاشتراك المجاني لا يشغّل Claude Code. تحتاج Pro أو Max أو Team، أو API Key فيه رصيد — وهذه نقطة تُحسم قبل التثبيت لا بعده.
مشاكل تسجيل الدخول غالباً سببها المتصفح أو الـ VPN، وليس الأداة: كن مسجّلاً الدخول مسبقاً، وأغلق الـ VPN وقت التحقق.
التوقف في منتصف التحميل مشكلة شبكة. جرّب شبكة أخرى، وأعد تشغيل الأمر — التثبيت آمن للإعادة.
في الدرس الجاي: بنبدأ نشغّل الـ Agent على شغل حقيقي — أول مهمة رح تكون مسح أخبار الصبح وتلخيصها لك جاهزة.
يلا، نلتقي بالدرس الجاي!