شرح Claude Code بالعربي: التثبيت على ويندوز وماك وأول مشروع

آخر تحديث: 2026/11/02 · بقلم سامح · من قسم شروحات أدوات الذكاء الاصطناعي

لو جربت Claude في المحادثة قبل كده، فـ Claude Code حاجة مختلفة. هنا مش بتنسخ كود من الشات وتلصقه، الأداة نفسها بتدخل فولدر مشروعك على جهازك، تقرا الملفات اللي محتاجاها، تقترح التعديل وتنفذه بعد إذنك، وتشغل الأوامر زي الاختبارات وGit. في الشرح ده هنمشي خطوة بخطوة من فحص جهازك لحد أول تعديل حقيقي في مشروع، على ويندوز وماك، وكل أمر هنا متاخد من صفحة التثبيت الرسمية ومجرب في تيرمنال حقيقي يوم 2 نوفمبر 2026.

لو لسه مش عارف Claude نفسه إيه، ابدأ بـ شرح Claude بالعربي وارجع هنا.

يعني إيه Claude Code وبيفرق إيه عن شات Claude

Claude Code هو وكيل برمجة (Agent) بيشتغل من سطر الأوامر. الفرق الأساسي إنه شايف مشروعك كله، مش بس الجزء اللي إنت لصقته. لما تقوله مثلا اعمل validation لفورم التسجيل، هو اللي بيدور على الملف المناسب ويعرض عليك التعديل، ولو وافقت بينفذه.

• في الشات: إنت بتنقل الكود رايح جاي، والنموذج مش شايف باقي الملفات.
• في Claude Code: الأداة بتقرا الملفات بنفسها حسب الحاجة، وتشغل الأوامر، وتتعامل مع Git بالكلام.
• التحكم معاك: فيه وضع صلاحيات (Permission mode) بيحدد إيه اللي يتعمل من غير ما يسألك، وبتغيره بـ Shift+Tab في أي وقت.

وكمان Claude Code موجود كتطبيق ديسكتوب لو مش مرتاح للتيرمنال، وكإضافة في VS Code وJetBrains، بس الشرح هنا على نسخة التيرمنال لأنها الأساس. ولو بتقارن بين محررات الكود الذكية، عندنا شرح Cursor AI بفكرة مختلفة، لأنه محرر كامل مش أداة تيرمنال.

متطلبات الجهاز والحساب

دي المتطلبات زي ما هي مكتوبة في صفحة التثبيت الرسمية:

الخطط اللي فيها Claude Code وأسعارها

Claude Code مش متاح في الخطة المجانية. صفحة الأسعار الرسمية بتقول إنه داخل في كل الخطط المدفوعة، واستهلاكه بيتحسب من نفس رصيد الاستخدام بتاع الشات، يعني لو اشتغلت كتير في التيرمنال هتقرب من الحد أسرع في المحادثة كمان.

الأسعار دي من غير الضرايب. ولو شغلك تقيل ومش عايز حدود الاشتراك، فيه بديل إنك تستخدم حساب Console وتدفع حسب الاستهلاك بأسعار الـ API. للمبتدئ، Pro كفاية جدا علشان تتعلم وتشتغل على مشاريع صغيرة.

علشان تشترك، افتح صفحة أسعار Claude واختار الخطة واعمل حساب أو سجل دخول، والدفع بيكون بالكارت.

تثبيت Claude Code على ويندوز

على ويندوز عندك اختيارين: تشغله على ويندوز مباشرة، أو جوه WSL. الأسهل للمبتدئ هو التشغيل المباشر، ومش محتاج تفتح التيرمنال كـ Administrator.

1. افتح قايمة ابدأ واكتب PowerShell وافتحه. هتعرف إنك في PowerShell لو السطر بيبدأ بـ PS C:\.
2. الصق الأمر ده واضغط Enter:

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

لو بتستخدم CMD بدل PowerShell، والسطر بيبدأ بـ C:\ من غير PS، استخدم الأمر ده:

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

الأمر مش بيعرض نسبة تحميل، فاستنى لحد ما يخلص وبعدين افتح نافذة تيرمنال جديدة. ولو حابب طريقة WinGet فيه أمر winget install Anthropic.ClaudeCode، بس خلي بالك إن النسخة دي مش بتتحدث لوحدها، ولازم تشغل winget upgrade Anthropic.ClaudeCode كل فترة. التثبيت العادي بالأمر الأول بيحدث نفسه تلقائيا في الخلفية.

Git for Windows: مهم بس مش إجباري

من غير Git for Windows، Claude Code بيشغل الأوامر عن طريق PowerShell. ولو نزلته، بيستخدم Git Bash، وده بيخلي أوامر كتير في الشروحات والمشاريع تشتغل زي ما هي. علشان تنزله افتح صفحة تحميل Git for Windows ونزل النسخة وثبتها بالإعدادات الافتراضية، وبعدها اقفل التيرمنال وافتحه تاني.

امتى أختار WSL

لو مشروعك بيعتمد على أدوات لينكس، أو محتاج ميزة العزل (Sandboxing) اللي بتقفل الأوامر في مساحة محمية، استخدم WSL 2، لأن التشغيل المباشر على ويندوز مش بيدعم العزل. في الحالة دي تفتح توزيعة لينكس بتاعتك وتشغل أمر ماك ولينكس جواها، وتشغل claude من جوه WSL نفسه مش من PowerShell.

تثبيت Claude Code على ماك

1. افتح تطبيق Terminal من Launchpad أو بالبحث بـ Spotlight.
2. الصق الأمر ده واضغط Enter:

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

ده نفس الأمر على لينكس وWSL. ولو بتحب Homebrew فيه أمر brew install --cask claude-code، والنسخة دي بتتبع قناة stable اللي بتتأخر حوالي أسبوع عن آخر إصدار، ومش بتتحدث لوحدها، فتحدثها بـ brew upgrade claude-code.

ولو عايز تشوف الأوامر بنفسك أو عندك نظام تاني، افتح صفحة تثبيت Claude Code الرسمية وانسخ الأمر من التاب المناسب لجهازك.

اتأكد إن التثبيت نجح

افتح نافذة تيرمنال جديدة واكتب:

claude --version

لو طلع رقم إصدار ومعاه (Claude Code) يبقى كله تمام. إحنا جربنا التثبيت على جهاز لينكس يوم 2 نوفمبر 2026 وطلع الإصدار 2.1.316، وده شكل الشاشة الحقيقي:

ولفحص أعمق للتثبيت والإعدادات من غير ما تفتح جلسة، اكتب claude doctor، وده بيطبع حالة التثبيت وأي أخطاء في ملفات الإعدادات ومعاها الحل المقترح.

أول مشروع مع Claude Code خطوة بخطوة

هنعمل تجربة بسيطة على مشروع صغير. لو معندكش مشروع، اعمل فولدر جديد اسمه مثلا my-first-app.

الخطوة 1: ادخل فولدر المشروع وشغل الأداة

cd my-first-app
claude

على ويندوز ممكن تكتب المسار كامل زي cd C:\Users\Name\my-first-app.

الخطوة 2: سجل الدخول مرة واحدة

أول مرة هيطلب منك تسجل دخول، وهيفتح المتصفح علشان توافق بحساب Claude المدفوع. بعد كده بيحفظ بيانات الدخول ومش هيطلبها تاني. ولو عايز تغير الحساب بعدين اكتب /login جوه الجلسة.

الخطوة 3: اسأله عن المشروع

ممكن تكتب بالعربي أو بالإنجليزي. أمثلة من التوثيق الرسمي:

what does this project do?
explain the folder structure
where is the main entry point?

في الفولدر الفاضي اطلب منه يعمل حاجة، مثلا: اعمل صفحة HTML فيها آلة حاسبة بسيطة بالعربي. هيعرض عليك الملفات اللي هيعملها ويستأذنك، اختار Yes علشان يكمل.

الخطوة 4: أول تعديل وأول commit

بعد ما الملف يتعمل، اطلب تعديل صغير زي إضافة زر مسح، وبعدين اطلب منه يحفظ الشغل في Git:

add a clear button to the calculator
commit my changes with a descriptive message

Claude Code بيكتب رسالة الـ commit بنفسه. ولو المشروع مش عليه Git، اطلب منه يعمل git init الأول.

أهم الأوامر اللي هتحتاجها

نصايح علشان النتيجة تطلع صح

• كن محدد: بدل صلح الغلط، اكتب صلح مشكلة إن صفحة الدخول بتظهر فاضية بعد كلمة سر غلط.
• قسم الشغل الكبير: اكتب الخطوات مترقمة، جدول بيانات الأول، وبعده الـ API، وبعده الصفحة.
• خليه يفهم قبل ما يعدل: اطلب منه يحلل الكود الأول، وبعدين اطلب التعديل.
• راجع قبل ما توافق: متغيرش وضع الصلاحيات للموافقة التلقائية على كل حاجة غير لما تتعود على الأداة.
• اعمل commit قبل أي تعديل كبير: علشان تقدر ترجع لو حاجة باظت.

مشاكل التثبيت الشائعة وحلها

ولو بتستخدم أدوات OpenAI كمان وعايز تعرف الفرق في الاشتراكات، راجع أسعار خطط ChatGPT.

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

المصادر: صفحة تثبيت Claude Code ودليل البداية السريعة وصفحة أسعار Claude.