كاين بزاف ديال المبرمجين اللي كيقضيو وقت طويل فمهام متكررة: البحث فكودباز كبير باش يفهموه، تتبع bug صغير دايخهم ساعات، أو كتابة اختبارات روتينية مامعندهاش حتى متعة. إلا كنتي كتحس بهاد الإحباط، فأنت لست الوحيد. أنا شخصياً، أول مرة جربت فيها أداة مساعدة فالطرفية، فكرت غادي تكون غير “شات بوت خفيف” زيادة، لكن سرعان ما تبين لي أن الموضوع مختلف تماماً. تثبيت Claude Code هو أول خطوة باش تجرب هاد التجربة بنفسك: أداة سطر أوامر من Anthropic كتخدم مباشرة فمشروعك، كتقرا الكود، كتصلح الأخطاء، وكتنفذ المهام نيابة عنك.
فهاد الدليل، غادي ناخذوك خطوة بخطوة: من فهم شنو هي هاد الأداة بالضبط، لمتطلبات النظام، لكل طرق التثبيت المتاحة فسنة 2026، وصولاً للتحقق أن كلشي خدام مزيان. خاصك غير تتبع الترتيب.
محتويات المقال
ما هو Claude Code ولماذا يستحق التثبيت؟
خطوات تثبيت Claude Code خطوة بخطوة
التحقق من التثبيت وتسجيل الدخول
الأسئلة الشائعة حول تثبيت Claude Code
ما هو Claude Code ولماذا يستحق التثبيت؟
الفرق بين Claude Code وتطبيق Claude العادي
خلينا نبسطو الصورة بمثال يومي: تخيل عندك مساعد شخصي. إلا كنت كتستعمل Claude.ai من المتصفح، فهذا كيفما تكون كتكلم المساعد عبر الهاتف — كتشرح لو المشكل، وهو كيعطيك نصيحة أو كود جاهز، لكن خاصك نتا تنسخو وتلصقو فمشروعك بيدك. أما Claude Code، فهذا كيفما المساعد جالس جنبك فالمكتب: عندو وصول مباشر للملفات ديالك، كيقرا الكودباز كامل، كيكتب ويعدل بنفسو، كيشغل الاختبارات، وكيدير commits على Git — كلشي من داخل الطرفية أو من داخل VS Code وJetBrains.
لمن هذه الأداة بالضبط؟
الجواب البسيط: لأي شخص كيخدم بالكود، بغض النظر على المستوى. طالب الإعلاميات اللي باغي يفهم مشروع تخرج معقد بسرعة، الفريلانسر اللي كيقلب بين عدة مشاريع فنفس اليوم، أو حتى فريق تقني كبير باغي يسرّع مراجعة الكود والـ onboarding ديال الأعضاء الجدد — كلهم كيلقاو فيها فائدة مختلفة. المهم غير تكون عندك فكرة بسيطة على الطرفية، والباقي كيتعلم بسرعة وهو كيخدم.
| 1. المدخل تكتب طلبك بلغة عادية (“أصلح هاد الخطأ فالدالة”) | 2. المعالجة Claude Code كيقرا الملفات، كيفهم السياق، كيخطط للحل | 3. المخرج كود مصحح، تعديل جاهز، أو حتى commit مباشر |
رسم توضيحي: طريقة عمل Claude Code من المدخل حتى المخرج
متطلبات النظام قبل التثبيت
قبل ما تبدا التثبيت، تأكد أن الجهاز ديالك عامر بهاد الشروط البسيطة:
- نظام التشغيل: macOS 13.0 فما فوق، Windows 10 (البناء 1809 فما فوق) أو Windows Server 2019 فما فوق، Ubuntu 20.04 فما فوق، Debian 10 فما فوق، أو Alpine Linux 3.19 فما فوق.
- العتاد: 4 جيجابايت RAM على الأقل، ومعالج x64 أو ARM64.
- الاتصال بالإنترنت: واجب، لأن الأداة كتخدم عبر الـ API ديال Anthropic.
- الـ Shell: Bash، Zsh، PowerShell، أو CMD.
- الموقع الجغرافي: خاصك تكون ساكن فبلد مدعوم من طرف Anthropic.
الحساب اللي غادي تحتاجو
Claude Code خاصو حساب Pro، Max، Team، Enterprise، أو Console — الخطة المجانية ديال claude.ai ماكتدعمش الأداة. إلا كنتي كتخدم فمؤسسة، تقدر كذلك تربطو بمزود API خارجي كيفاش Amazon Bedrock، Google Cloud’s Agent Platform، أو Microsoft Foundry.
شنو غادي تربح بعد التثبيت
باش تكون الصورة واضحة قبل ما تدخل للتثبيت، هاكا كيف كيتبدل الوقت ديالك على بعض المهام اليومية، حسب تجربة مستخدمين آخرين (الأرقام تقريبية وكتختلف حسب تعقيد المشروع):
| المهمة | بالطريقة التقليدية | مع Claude Code |
| فهم كودباز جديد | ساعة إلى ساعتين | 10 إلى 15 دقيقة |
| تتبع وإصلاح bug بسيط | 20 إلى 40 دقيقة | 5 إلى 10 دقائق |
| كتابة اختبارات (tests) لملف | 30 دقيقة | 5 دقائق + مراجعة |
| مراجعة Pull Request | 15 إلى 25 دقيقة | دقائق معدودة |
مقارنة تقريبية للوقت: قبل وبعد استعمال Claude Code
خطوات تثبيت Claude Code خطوة بخطوة
كاين عدة طرق باش تثبت Claude Code، وكلها كتوصل لنفس النتيجة. هنا غادي نشرح ليك الطريقة الموصى بيها (Native)، وبعدها البدائل حسب الأداة اللي كتفضل.
التثبيت على macOS وLinux وWSL
حل الطرفية، ولصق هاد الأمر:
curl -fsSL https://claude.ai/install.sh | bash
منين كيسالي التثبيت، حل نافذة طرفية جديدة واكتب claude –version باش تتأكد. إلا قال ليك command not found، معناها مسار التثبيت ماشي مزاد للـ PATH ديالك؛ شوف قسم الأسئلة الشائعة فالأسفل.
التثبيت على Windows (PowerShell وCMD)
إلا كنتي خدام على Windows مباشرة بلا WSL، اختار واحد من هاد الأوامر حسب الطرفية اللي عندك:
PowerShell (البرومبت كيبدا بـ PS C:\):
irm https://claude.ai/install.ps1 | iex
CMD (البرومبت كيبدا بـ C:\ بلا PS):
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
نصيحة: تثبيت Git for Windows اختياري لكن محبب، لأنه كيعطي Claude Code إمكانية استعمال Git Bash. إلا ماكانش مثبت، الأداة غادي تستعمل PowerShell بدلو، وهذا خدام فبزاف الحالات.
طرق بديلة: Homebrew، WinGet، وnpm
إلا كنت كتفضل أدوات إدارة الحزم اللي عارفها، كل واحدة فيهم عندها ميزة وجمهور مستهدف خاص بيها:
- Homebrew — brew install –cask claude-code. الميزة: بسيطة وسريعة إلا كنتي ديجا كتستعمل Homebrew فـ macOS أو Linux. تناسب: المطورين اللي عندهم بيئة Homebrew جاهزة.
- WinGet — winget install Anthropic.ClaudeCode. الميزة: مدمجة فـ Windows بلا حاجة لتثبيت أداة خارجية. تناسب: مستخدمي Windows اللي كيفضلو سير العمل الرسمي ديال مايكروسوفت.
- npm — npm install -g @anthropic-ai/claude-code (خاصو Node.js 22 فما فوق). الميزة: نفس الثنائي (binary) فجميع الأنظمة، وسهل الدمج فمشاريع Node.js ديجا موجودة. تناسب: مطوري JavaScript/Node اللي ديجا كيخدمو بـ npm يومياً.
الفرق المهم: التثبيت الـ Native كيتحدث تلقائياً فالخلفية، بينما Homebrew وWinGet وnpm خاصك تحدثهم يدوياً من وقت لوقت:
| طريقة التثبيت | الأنظمة المدعومة | التحديث التلقائي |
| Native (موصى بها) | macOS، Linux، WSL، Windows | نعم، تلقائي |
| Homebrew | macOS، Linux | لا، يدوي |
| WinGet | Windows | لا، يدوي |
| npm | جميع الأنظمة (Node.js 22+) | لا، يدوي |
جدول مقارنة بين طرق التثبيت المختلفة
التحقق من التثبيت وتسجيل الدخول
التأكد أن التثبيت نجح
- حل الطرفية واكتب claude –version. إلا بان ليك رقم نسخة (مثلاً 2.1.211)، فالتثبيت نجح.
- إلا بغيتي تشيك أعمق على الإعدادات، جرب claude doctor — كيعطيك تشخيص كامل: صحة التثبيت، أي مشاكل فملفات الإعدادات، واقتراحات للحل، بلا ما يبدا جلسة جديدة.
- إلا ظهرت ليك رسالة خطأ، دوز على قسم الأسئلة الشائعة فالأسفل قبل ما تعاود التثبيت من الصفر.
هاكا كيبان مثال على المخرج المتوقع بعد تشغيل الأمرين (ماشي صورة شاشة حقيقية، بل مثال نصي توضيحي):
$ claude –version
2.1.211 (Claude Code)
$ claude doctor
(Y) Installation: healthy
(Y) Settings file: valid
(Y) Auto-updates: enabled
تسجيل الدخول وربط الحساب
- اكتب claude فالطرفية باش تحل أول جلسة.
- تبع الرابط اللي غادي يبان ليك، وهو غادي يحل المتصفح الافتراضي ديالك تلقائياً.
- سجل الدخول بالحساب ديال Anthropic (Pro، Max، Team، Enterprise، أو Console)، ووافق على الربط.
- رجع للطرفية؛ غادي تلقى الجلسة ديالك بدات مباشرة.
إلا كان عندك متغير ANTHROPIC_API_KEY معرّف من قبل فالنظام ديالك، Claude Code غادي يسولك مرة وحدة باش توافق عليه بدل ما يحل المتصفح — خطوة واحدة أقل.
الأسئلة الشائعة حول تثبيت Claude Code
هل Claude Code مجاني؟
لا. خاصو حساب Pro، Max، Team، Enterprise، أو Console. الخطة المجانية ديال claude.ai ماكتدعموش.
ما هو الفرق بين التثبيت الـ Native وnpm؟
التثبيت الـ Native كيحمّل ثنائياً (binary) مباشرة وكيتحدث تلقائياً فالخلفية بلا ما تديرلو حتى حاجة. التثبيت عبر npm كيحتاج Node.js 22 فما فوق مثبت من قبل، لكن الثنائي النهائي اللي كيتشغل هو نفسو بالضبط، وماكيستعملش Node.js فوقت التشغيل الفعلي.
هل Claude Code يدعم Windows بدون WSL؟
إيه، يخدم مباشرة فـ Windows (Native) عبر PowerShell أو CMD بلا ما تحتاج WSL. الاستثناء الوحيد: ميزة الـ Sandboxing (العزل الآمن لتنفيذ الأوامر) متوفرة غير فـ WSL 2، فإلا كانت هاد الميزة مهمة ليك، فكر فيها.
كيف نحدث Claude Code لآخر نسخة؟
إلا كان التثبيت ديالك Native، التحديث كيوقع تلقائياً فالخلفية بلا تدخل منك. إلا كنتي مثبت عبر Homebrew أو WinGet أو npm، خاصك تدير التحديث يدوياً: npm install -g @anthropic-ai/claude-code@latest بالنسبة لـ npm، وbrew upgrade claude-code بالنسبة لـ Homebrew.
ماذا تفعل إذا طلب منك ‘command not found’ بعد التثبيت؟
هاد المشكل عادة كيوقع ولا مسار التثبيت ماشي مزاد للـ PATH ديالك. أول حاجة، حل نافذة طرفية جديدة (بزاف المرات كيحل المشكل وحدو). إلا بقا المشكل قائم، تأكد من مسار التثبيت يدوياً أو راجع دليل حل المشاكل الرسمي ديال Claude Code.
خلاصة
دبا عندك كل اللي خاصك باش تثبت Claude Code: من متطلبات النظام، لخطوات التثبيت حسب نظام التشغيل ديالك، حتى التحقق النهائي وتسجيل الدخول. المعادلة بسيطة: اختار الطريقة اللي كتناسبك، نفذ الأمر، وتأكد بـ claude –version.
جربتي Claude Code؟ شاركنا تجربتك فالتعليقات — واش سهلات عليك الخطوات، ولا طرا ليك شي مشكل ماذكرناهوش هنا؟ وإلا بغيتي تعمق أكثر فالموضوع، اقرا مقالنا حول أفضل الممارسات لاستعمال Claude Code فمشاريعك اليومية.
