تثبيت Claude Code
من الصفر إلى الاستخدام — خطوة بخطوة
مصمم لكل شخص، حتى لو هذي أول مرة تفتح ترمنال في حياتك
أنت على أي نظام؟
الخطوات تختلف بناءً على جهازك. اختر واحد:
أنت على ماك أو لينكس — ممتاز!
الأمور سهلة جداً هنا. ما في أخطاء معقدة. اختر الطريقة اللي تناسبك:
الإضافة أو الترمنال؟
الإضافة أسهل للمبتدئين. الترمنال أقوى للمحترفين. كلاهما ممتاز.
قبل أي شيء: ويندوز يحتاج Git
على ماك ولينكس ما تحتاج هذا. على ويندوز، Claude Code يحتاج برنامج اسمه Git عشان يشتغل. البرنامج مجاني ويتحمل مرة وحدة بس.
أولاً: حمّل Git
افتح المتصفح وادخل على هذا الرابط
اضغط على الزر الكبير لتحميل Git
راح ينزل ملف اسمه شيء مثل Git-2.x.x-64-bit.exe
افتح الملف وثبّته
مهم: لا تغير أي إعداد.
فقط اضغط Next → Next → Next → Install → Finish. خلّ كل شيء على الإعدادات الافتراضية.
تأكد من التثبيت
افتح PowerShell (ابحث عنه في شريط البحث أسفل الشاشة). الصق هذا:
إذا طلع شيء مثل: git version 2.x.x — مبروك! Git جاهز.
ثانياً: اختر طريقة التثبيت
Git جاهز — الآن اختر كيف تبي تستخدم Claude Code:
ماك / لينكس — الإضافة
ستحتاج برنامج VS Code
برنامج مجاني من Microsoft لكتابة الأكواد. حمّله من code.visualstudio.com إذا ما عندك.
(يمكنك أيضاً استخدام Cursor أو Windsurf، لكن VS Code هو ما سنستخدمه هنا.)
افتح VS Code على جهازك
افتح قسم الإضافات
على الشريط الجانبي الأيسر، دور على أيقونة فيها أربع مربعات (Extensions). اضغط عليها.
اختصار: Cmd+Shift+X
ابحث عن Claude Code
ثبّت الإضافة
راح يطلع نتيجة اسمها Claude Code من شركة Anthropic. اضغط Install.
الآن جرّب إنه يشتغل
بعد التثبيت، راح يطلع لك Panel جديد على الجانب فيه شعار Claude.
اكتب أي رسالة بسيطة في الخانة (مثلاً "مرحبا") واضغط Enter.
أول مرة راح يطلب منك تسجيل دخول بحسابك على claude.ai — اتبع الخطوات اللي تطلع على الشاشة. بعدها إذا رد عليك، يعني كل شيء تمام.
مبروك! انتهيت!
أنت الآن تقدر تستخدم Claude Code مباشرة داخل VS Code.
ماك / لينكس — الترمنال
افتح الترمنال
على الماك: ابحث عن Terminal في Spotlight (اضغط Cmd+Space). على لينكس: Ctrl+Alt+T في الغالب.
انسخ هذا الأمر والصقه
اضغط Enter وانتظر — التحميل أقل من دقيقة.
أغلق الترمنال وافتحه من جديد
هذي الخطوة مهمة جداً
أغلق نافذة الترمنال بالكامل وافتح نافذة جديدة. ما يكفي تفتح تاب جديد.
الآن جرّب إنه يشتغل
افتح VS Code (أو أي ترمنال على جهازك). داخل VS Code، افتح الترمنال من القائمة العلوية: Terminal → New Terminal. في الترمنال اللي طلع، اكتب:
واضغط Enter.
✅ إذا طلعت شاشة Claude Code ورد عليك
مبروك! أول مرة راح يطلب تسجيل دخول عن طريق المتصفح — اتبع الخطوات اللي تطلع. بعدها أنت جاهز تستخدمه في أي مجلد.
❌ إذا طلع "command not found"
لا تقلق. Claude محمل بنجاح، لكن الترمنال ما يعرف وين يلاقيه. الحل سهل — الصق هذا:
ثم اكتب claude مرة ثانية.
مستخدمو Linux (Bash):
استبدل ~/.zshrc بـ ~/.bashrc
مبروك!
أنت الآن تقدر تستخدم Claude Code من الترمنال في أي مكان.
ويندوز — الإضافة
ستحتاج VS Code
حمّله من code.visualstudio.com إذا ما عندك. (أو Cursor أو Windsurf، لكن VS Code هو ما سنستخدمه.)
افتح VS Code
افتح قسم الإضافات
على الشريط الجانبي الأيسر، أيقونة المربعات الأربعة. Ctrl+Shift+X
ابحث وثبّت
اضغط Install على النتيجة من Anthropic.
الآن جرّب إنه يشتغل
بعد التثبيت، راح يطلع لك Panel جديد على الجانب فيه شعار Claude.
اكتب أي رسالة بسيطة (مثلاً "مرحبا") واضغط Enter.
أول مرة راح يطلب منك تسجيل دخول — اتبع اللي يطلع على الشاشة.
✅ إذا رد عليك برسالة
مبروك! كل شيء تمام وأنت جاهز تستخدم Claude Code. ما تحتاج تسوي أي شيء ثاني.
❌ إذا طلع خطأ عن "git-bash"
الخطأ يكون شكله كذا:
هذي مشكلة معروفة ومنتشرة. الحل بسيط — نحتاج نقول لـ Windows وين يلاقي Git Bash.
اتبع هذي الخطوات بالترتيب:
أ — افتح نافذة الإعدادات
اضغط زر Windows + حرف R في نفس الوقت. في النافذة الصغيرة اكتب:
اضغط Enter.
ب — افتح متغيرات البيئة
في أسفل النافذة، راح تشوف زر "Environment Variables..." — اضغط عليه.
ج — أضف متغير جديد
في القسم الفوقي (User variables)، اضغط "New..."
⚠️ القسم الفوقي فقط — القسم اللي تحت لا تلمسه.
الخانة الأولى (Variable name):
الخانة الثانية (Variable value):
د — احفظ وأغلق
اضغط OK ثلاث مرات لإغلاق كل النوافذ.
أغلق VS Code بالكامل (مش بس التاب — البرنامج كله، اضغط X).
افتح VS Code من جديد وجرّب Claude Code.
إذا ما اشتغل حتى بعد هذا:
أعد تشغيل الكمبيوتر (Restart كامل)، ثم افتح VS Code من جديد.
مبروك!
Claude Code جاهز داخل VS Code على ويندوز.
ويندوز — الترمنال
افتح PowerShell
ابحث عن PowerShell في شريط البحث أسفل الشاشة، ثم افتحه.
انسخ هذا الأمر والصقه
اضغط Enter وانتظر حتى يخلص التحميل. في الغالب يشتغل بدون مشاكل.
إذا طلع خطأ أحمر (نادر) — جرب نفس الشيء من CMD بدل PowerShell: اضغط Win+R، اكتب cmd، والصق:
أغلق PowerShell وافتحه من جديد
هذي الخطوة مهمة جداً — ترمنال جديد كامل.
الآن جرّب إنه يشتغل
افتح VS Code (أو PowerShell جديد). داخل VS Code، افتح الترمنال من القائمة: Terminal → New Terminal. في الترمنال اللي طلع، اكتب:
واضغط Enter.
✅ إذا طلعت شاشة Claude Code ورد عليك
مبروك! أول مرة راح يطلب تسجيل دخول عن طريق المتصفح — اتبع الخطوات. بعدها أنت جاهز.
❌ إذا طلع "claude is not recognized"
Claude محمل بنجاح، لكن Windows ما يعرف وين يلاقيه. نحتاج نقول له.
أ — افتح نافذة الإعدادات
اضغط Win+R، اكتب:
اضغط Enter.
ب — افتح Environment Variables
اضغط "Environment Variables..." في أسفل النافذة.
ج — عدّل Path
في القسم الفوقي (User variables)، دور على سطر اسمه Path. اضغط عليه ثم اضغط "Edit..."
في النافذة الجديدة، اضغط "New"، ثم اكتب:
د — احفظ وأغلق
اضغط OK ثلاث مرات. أغلق PowerShell وافتحه من جديد. اكتب claude.
إذا ما اشتغل حتى بعد هذا:
أعد تشغيل الكمبيوتر (Restart كامل)، ثم افتح PowerShell من جديد.
مبروك!
Claude Code جاهز في الترمنال على ويندوز.
أسئلة شائعة
هل لازم أدفع عشان أستخدم Claude Code؟
نعم. Claude Code يحتاج اشتراك. أرخص اشتراك هو Claude Pro بـ 20 دولار شهرياً.
هل أحتاج أحمل Node.js؟
لا. الطريقة الحديثة (Native Installer) ما تحتاج Node.js. الأوامر اللي ذكرناها في الدليل وخلاص.
ليش ماك ولينكس أسهل من ويندوز؟
لأن ماك ولينكس عندهم ترمنال مدمج في النظام من الأساس (Bash / Zsh). ويندوز ما عنده هذا افتراضياً، فيحتاج Git Bash كبديل.
أنا على ويندوز وما قدرت أحمل بسبب الشبكة
شغّل هوت سبوت من جوالك واتصل عليه من الكمبيوتر. بعض شبكات الشركات والجامعات تمنع التحميل.
سويت كل الخطوات وما اشتغل
جرب هذا بالترتيب:
- تأكد إنك أغلقت البرنامج أو الترمنال بالكامل وفتحته من جديد
- جرب Restart كامل للكمبيوتر
- تأكد إن Git محمل: git --version
- تأكد إن Claude محمل: Test-Path "$env:USERPROFILE\.local\bin\claude.exe"