ملخص سريع: يمكن تثبيت Claude Code عبر مثبتات أصلية على macOS و Windows و Linux من موقع Claude Code الرسمي. يجب على مستخدمي Windows تثبيت WSL2 أولاً قبل تشغيل Claude Code. بعد التثبيت، قم بالمصادقة باستخدام حساب Claude الخاص بك عندما يفتح Claude Code نافذة متصفح لتسجيل الدخول عند التشغيل الأول لبدء البرمجة بمساعدة الذكاء الاصطناعي مباشرة من طرفية الأوامر أو تطبيق سطح المكتب.
يمثل Claude Code دفعة Anthropic في أدوات تطوير الذكاء الاصطناعي الوكيلة. يساعد مساعد سطر الأوامر هذا في قراءة قواعد الأكواد، وتحرير الملفات، وتشغيل الأوامر، والتكامل مع سير عمل التطوير.
لكن تثبيته ليس دائمًا مباشرًا. تتطلب المنصات المختلفة طرقًا مختلفة. يحتاج Windows إلى إعداد إضافي. والوثائق، رغم شمولها، يمكن أن تربك الوافدين الجدد.
هذا الدليل يتجاوز التعقيدات. يغطي متطلبات النظام، وخطوات التثبيت الخاصة بالمنصة، والمصادقة، والتحقق - كل ما يلزم لتشغيل Claude Code بشكل صحيح.
متطلبات النظام قبل التثبيت
وفقًا للوثائق الرسمية لـ Claude Code، تدعم الأداة macOS و Windows و Linux. ومع ذلك، كل منصة لها متطلبات مسبقة محددة.
بالنسبة لنظام macOS، المتطلبات قليلة. يحتاج النظام إلى macOS 13.0 أو أحدث. تعمل كل من شرائح Intel و Apple Silicon بشكل جيد.
يقدم Windows المزيد من التعقيد. يجب أن يكون نظام التشغيل Windows 10 Build 19041 أو أحدث، أو Windows 11. ولكن إليك المفاجأة - Claude Code لا يعمل أصليًا على Windows.
نظام Windows الفرعي لنظام Linux 2 (WSL2) إلزامي. هذا ينشئ بيئة Linux حيث يعمل Claude Code فعليًا. بدون WSL2، يفشل التثبيت.
يحتاج مستخدمو Linux إلى توزيعة 64 بت. تؤكد الوثائق الرسمية على الدعم لـ Ubuntu و Debian و Fedora وتوزيعات رئيسية أخرى. يتطلب Alpine Linux والأنظمة المستندة إلى musl تكوينًا إضافيًا.
تحتاج جميع المنصات إلى اتصال إنترنت مستقر أثناء التثبيت. تختلف أحجام التنزيل ولكنها تتراوح عادةً من 50 ميجابايت إلى 500 ميجابايت اعتمادًا على ما تم تثبيته بالفعل.
| المنصة | الحد الأدنى للإصدار | متطلبات خاصة |
|---|---|---|
| macOS | 13.0 | لا شيء |
| Windows | 10 Build 19041 أو 11 | مطلوب WSL2 |
| Linux | توزيعة 64 بت | مفضل مبني على glibc |
تثبيت Claude Code على macOS
تستخدم عملية تثبيت macOS مثبتًا أصليًا. هذا هو المسار الأبسط بين جميع المنصات.
أولاً، قم بتنزيل المثبت من موقع Claude Code الرسمي. تقوم صفحة التنزيل بالكشف عن macOS تلقائيًا وتقديم الحزمة المناسبة.
افتح ملف .dmg الذي تم تنزيله. اسحب تطبيق Claude Code إلى مجلد التطبيقات. تثبيت macOS قياسي - لا شيء غير عادي هنا.
يواجه بعض المستخدمين مطالبة أمنية عند التشغيل لأول مرة. يمنع macOS التطبيقات من المطورين غير المحددين افتراضيًا. انقر بزر الماوس الأيمن على تطبيق Claude Code وحدد "فتح" لتجاوز هذا التحذير لمرة واحدة.
يتم تثبيت أداة سطر الأوامر تلقائيًا مع تطبيق سطح المكتب. افتح Terminal واكتب claude --version للتحقق. إذا ظهر رقم الإصدار، فقد نجح التثبيت.
التحقق من تثبيت macOS
قم بتشغيل هذه الأوامر للتأكد من أن كل شيء يعمل:
| claude --version claude --help |
يجب أن تُرجع كلتا الأمرين مخرجات دون أخطاء. يعرض أمر الإصدار إصدار Claude Code المثبت. يعرض أمر المساعدة الخيارات والأوامر المتاحة.
إنشاء دليل اختبار يساعد في التحقق من الوظائف الكاملة. انتقل إلى مجلد مشروع وقم بتشغيل claude لبدء جلسة تفاعلية. يجب أن تقوم الأداة بالتهيئة والمطالبة بالمصادقة إذا لم تكن مسجلاً الدخول بالفعل.
تثبيت Windows باستخدام WSL2
يتطلب تثبيت Windows خطوات متعددة. تستغرق العملية وقتًا أطول من macOS ولكنها تظل قابلة للإدارة.
يجب تثبيت WSL2 أولاً. افتح PowerShell كمسؤول وقم بتشغيل:
| wsl --install |
يقوم هذا الأمر بتثبيت WSL2 و Ubuntu افتراضيًا. سيحتاج النظام إلى إعادة تشغيل. بعد إعادة التشغيل، يتم تشغيل Ubuntu تلقائيًا لإكمال الإعداد الأولي.
قم بإنشاء اسم مستخدم وكلمة مرور Unix عند المطالبة. هذه الاعتمادات منفصلة عن بيانات اعتماد تسجيل دخول Windows.
بمجرد تشغيل WSL2، تنطبق عملية تثبيت Linux. افتح طرفية Ubuntu (المثبتة مع WSL2) وقم بتنزيل مثبت Claude Code لنظام Linux.
تثبيت Claude Code في WSL2
وفقًا للوثائق الرسمية، يقوم أمر التثبيت بتنزيل وتشغيل المثبت الأصلي:
| curl -o- raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash |
يتعامل هذا النص البرمجي مع التبعيات تلقائيًا. يقوم بتثبيت Node.js إذا لزم الأمر، ويقوم بإعداد ثنائي Claude Code، ويهيئ متغيرات PATH.
يستغرق التثبيت بضع دقائق. تشير أشرطة التقدم ورسائل الحالة إلى ما يحدث. عند الانتهاء، أغلق وأعد فتح الطرفية لتحديث متغيرات البيئة.
اختبار التثبيت يتبع نفس العملية كما في macOS. قم بتشغيل claude --version للتحقق.
عملية تثبيت Linux
يتمتع مستخدمو Linux بأبسط مسار تثبيت. يعمل المثبت الأصلي مباشرة بدون طبقات إضافية مثل WSL2.
قم بتنزيل وتشغيل نص تثبيت البرنامج:
| curl -fsSL claude.ai/install.sh | bash |
يقوم هذا بتنزيل ثنائي Claude Code، وتثبيت التبعيات، وتهيئة بيئة shell. يكتشف النص البرمجي التوزيع ويقوم بالتعديل وفقًا لذلك.
بالنسبة للأنظمة المستندة إلى Ubuntu و Debian، يقوم النص البرمجي بتهيئة التثبيت. تؤكد الوثائق الرسمية على الدعم لـ Ubuntu 20.04+، و Debian 10+، والتوزيعات الأخرى.
اعتبارات Alpine Linux
يحتاج Alpine Linux والتوزيعات المستندة إلى musl إلى خطوات إضافية. تشير الوثائق الرسمية إلى أن هذه الأنظمة تتطلب تهيئة يدوية.
قد يفشل المثبت القياسي على Alpine. بدلاً من ذلك، قم بتنزيل الثنائي المتوافق مع musl مباشرة من صفحة الإصدارات. قم باستخراجه إلى دليل في مسار النظام، عادةً /usr/local/bin.
قم بتعيين أذونات التنفيذ:
| chmod +x /usr/local/bin/claude |
يجب على مستخدمي Alpine التحقق من التوافق قبل المتابعة. قد لا تعمل بعض الميزات بنفس الطريقة التي تعمل بها التوزيعات المستندة إلى glibc.
المصادقة وإعداد الحساب
بعد تثبيت Claude Code، قم بتشغيل claude في طرفية الأوامر الخاصة بك. عند التشغيل الأول، يفتح Claude Code نافذة متصفح لتسجيل الدخول.
يفتح هذا صفحة مصادقة Claude. قم بتسجيل الدخول باستخدام حساب Claude موجود أو أنشئ حسابًا جديدًا.
يعرض المتصفح رمز تفويض. انسخ هذا الرمز وارجع إلى طرفية الأوامر. الصق الرمز عند المطالبة.
تقوم المصادقة الناجحة بتخزين بيانات الاعتماد محليًا. لن تتطلب الجلسات المستقبلية تسجيل الدخول إلا إذا انتهت صلاحية بيانات الاعتماد أو تم مسحها يدويًا.
مصادقة الفرق والمؤسسات
وفقًا للوثائق الرسمية للمصادقة، فإن الفرق التي تستخدم Claude for Teams أو Enterprise لديها خيارات إضافية. يمكن للمؤسسات تكوين تسجيل الدخول الأحادي (SSO) أو مصادقة موفر سحابة.
يتطلب إعداد SSO تكوين المسؤول. ثم يقوم المطورون الأفراد بالمصادقة من خلال موفر الهوية الخاص بمؤسستهم بدلاً من حسابات Claude الشخصية.
تعمل مصادقة موفر السحابة مع عمليات نشر AWS و Google Cloud و Azure. تستخدم هذه الطريقة بيانات اعتماد السحابة الحالية بدلاً من حسابات Claude منفصلة.
| طريقة المصادقة | حالة الاستخدام | تعقيد الإعداد |
|---|---|---|
| حساب شخصي | المطورون الأفراد | بسيط |
| فرق/مؤسسات SSO | المؤسسات | يتطلب المسؤول |
| موفر سحابة | مستخدمو AWS/GCP/Azure | متوسط |
تثبيت تطبيق سطح المكتب
يقدم Claude Code كلاً من تطبيقات سطر الأوامر وسطح المكتب. يوفر تطبيق سطح المكتب واجهة رسومية مع الحفاظ على وظائف طرفية كاملة.
قم بتنزيل مثبت سطح المكتب من موقع Claude الرسمي. يقدم الموقع إصدارات macOS و Windows و Windows ARM64. اختر الإصدار المناسب للنظام.
يتبع تثبيت macOS نفس عملية .dmg الموضحة سابقًا. يمكن لمستخدمي Windows تنزيل تطبيق سطح المكتب لواجهة رسومية دون الحاجة إلى إعداد WSL2.
يتضمن تطبيق سطح المكتب وصولاً متكاملاً إلى طرفية الأوامر. يمكنه تشغيل جلسات Claude Code دون التبديل إلى تطبيقات طرفية خارجية.
إحدى مزايا تطبيق سطح المكتب هي توفره في الخلفية. وفقًا لصفحة التنزيل الرسمية، "يبقى التطبيق جاهزًا في الخلفية" ويمكن استدعاؤه من أي تطبيق دون تبديل النوافذ أو فقدان التركيز.
استخدم Get AI Perks للعثور على أرصدة لمجموعة Claude Code الخاصة بك
التثبيت هو الجزء السهل. التكلفة الحقيقية تأتي عادة من كل ما يحيط به: البنية التحتية، والأدوات الداعمة، والخدمات المدفوعة المستخدمة أثناء الإعداد والاختبار. يمكن أن تساعد Get AI Perks عن طريق سرد أرصدة وخصومات الشركات الناشئة في مكان واحد، إلى جانب إرشادات حول كيفية التقديم.
مع Get AI Perks، يمكنك:
- العثور على أرصدة لأدوات السحابة وأدوات الذكاء الاصطناعي
- التحقق من شروط العروض قبل التقديم
- تجنب إضاعة الوقت على العروض التي قد لا تكون مؤهلاً لها
- خفض تكلفة إعداد بيئتك
قم بزيارة Get AI Perks لمعرفة ما إذا كانت العروض المتاحة تتطابق مع الأدوات التي تخطط لاستخدامها مع Claude Code.
ملحقات IDE والتكاملات
بالإضافة إلى التثبيت المستقل، يتكامل Claude Code مع بيئات التطوير الشائعة. توجد ملحقات لـ Visual Studio Code و JetBrains IDEs.
يتم تثبيت ملحق VS Code عبر المتجر. ابحث عن "Claude Code" في لوحة الملحقات وانقر فوق تثبيت. يتطلب الملحق تثبيت أداة سطر الأوامر أولاً.
يبلغ بعض المستخدمين عن مشاكل مع ملف ملحق VS Code المجمع. إذا فشل التثبيت التلقائي بخطأ "End of central directory record signature not found"، فقد يكون ملف .vsix المجمع تالفًا.
يتضمن الحل البديل تثبيت الملحق يدويًا من متجر VS Code بدلاً من الاعتماد على الإصدار المجمع من CLI. هذا يفصل المكونين ويمنع تعارضات التثبيت.
يعمل تكامل JetBrains بشكل مشابه. قم بتثبيت الملحق من متجر JetBrains داخل IntelliJ IDEA أو PyCharm أو WebStorm أو منتجات JetBrains الأخرى.
التحقق من نجاح التثبيت
يضمن التحقق الصحيح أن Claude Code يعمل بشكل صحيح قبل البدء في مهام التطوير الفعلية.
تتحقق عمليات التحقق الأساسية من توفر الأوامر:
| claude --help claude --version |
يجب أن تنفذ هذه الأوامر دون أخطاء. يسرد أمر المساعدة الخيارات المتاحة. يعرض أمر الإصدار الإصدار المثبت.
يتطلب الاختبار الوظيفي بدء جلسة. قم بإنشاء دليل اختبار:
| mkdir test-project cd test-project claude |
هذا يقوم بتهيئة جلسة Claude Code تفاعلية. يجب أن تقوم الأداة بتحليل الدليل (فارغ في هذه الحالة) وتقديم مطالبة.
جرب الأوامر الأساسية داخل الجلسة. اكتب help لرؤية الإجراءات المتاحة. اطلب مهام بسيطة مثل "إنشاء ملف README" أو "اشرح ما يمكنك القيام به".
تشير الاستجابات الناجحة إلى تثبيت صحيح. إذا حدثت أخطاء، فعادة ما تتعلق بالمصادقة أو اتصال الشبكة أو التبعيات المفقودة.
إدارة التحديثات والإصدارات
يتم تحديث Claude Code تلقائيًا بشكل افتراضي. تشرح الوثائق الرسمية أن الأداة تتحقق من الإصدارات الجديدة وتقوم بتثبيتها دون تدخل المستخدم.
يمكن تكوين سلوك التحديث من خلال إعدادات Claude Code. تغطي الوثائق الرسمية تكوين قناة الإصدار وخيارات التحديث اليدوي.
تتطلب التحديثات اليدوية تشغيل نص التثبيت مرة أخرى. نفس الأمر المستخدم للتثبيت الأولي يقوم بسحب أحدث إصدار:
| curl -fsSL claude.ai/install.sh | bash |
يمكن تثبيت إصدارات محددة لأغراض الاختبار أو التوافق. تغطي وثائق الإعداد المتقدم تثبيت الإصدارات وتكوين قناة الإصدار.
تشمل قنوات الإصدار المستقرة، والبيتا، والليلة. يوصى بالمستقرة لأعمال الإنتاج. توفر قنوات البيتا والليلة وصولاً مبكرًا إلى الميزات الجديدة ولكن قد تحتوي على أخطاء.
مشاكل التثبيت الشائعة
تظهر العديد من المشاكل بشكل متكرر في مناقشات المجتمع حول تثبيت Claude Code.
يسبب تكوين PATH العديد من المشاكل. إذا لم يتم العثور على الأمر claude بعد التثبيت، فإن دليل الثنائي ليس في مسار النظام.
على macOS و Linux، يتضمن إضافة الدليل إلى PATH عادةً تحرير ~/.bashrc أو ~/.zshrc أو ملفات تكوين shell مماثلة. يقوم نص التثبيت عادةً بذلك تلقائيًا، ولكن التحقق اليدوي يساعد في استكشاف الأخطاء وإصلاحها.
قد يحتاج مستخدمو Windows في WSL2 إلى إغلاق وإعادة فتح الطرفية بعد التثبيت. لا يتم تحديث متغيرات البيئة في الجلسات الحالية.
تقوم قيود الشبكة بمنع بعض عمليات التثبيت. قد تمنع جدران الحماية الخاصة بالشركات أو خوادم الوكيل تنزيل المثبت أو الاتصال بخوادم المصادقة.
يتطلب تكوين الوكيل متغيرات البيئة:
| export HTTP_PROXY= proxy.example.com:8080 export HTTPS_PROXY= proxy.example.com:8080 |
تحدث أخطاء الأذونات عند التثبيت في أدلة محمية. يحتاج المثبت إلى حق الكتابة في /usr/local/bin أو المواقع المكافئة. يؤدي التشغيل بـ sudo إلى حل ذلك ولكنه يجب تجنبه ما لم يكن ضروريًا.
أسئلة متكررة
هل يمكن لـ Claude Code العمل بدون اتصال بالإنترنت؟
لا. يتطلب Claude Code اتصالاً بالإنترنت ليعمل. ترسل الأداة الأكواد والاستفسارات إلى خوادم Anthropic للمعالجة. قد تسمح التخزين المؤقت المحلي لبعض العمليات بالعمل مؤقتًا دون اتصال، لكن الوظائف الكاملة تتطلب اتصالاً نشطًا.
هل يعمل Claude Code مع أدوات الترميز الحالية للذكاء الاصطناعي؟
نعم. يمكن لـ Claude Code العمل جنبًا إلى جنب مع GitHub Copilot أو Cursor أو أدوات تطوير الذكاء الاصطناعي الأخرى. تعمل هذه الأدوات بشكل مستقل ولا تتعارض. ومع ذلك، قد يؤدي استخدام مساعدي ذكاء اصطناعي متعددين في وقت واحد إلى خلق ارتباك حول الأداة التي تتعامل مع أي مهمة.
هل WSL2 مطلوب لجميع ميزات Windows؟
تتطلب أداة سطر الأوامر WSL2 على Windows. ومع ذلك، يعمل تطبيق سطح المكتب أصليًا على Windows بدون WSL2. يوفر تطبيق سطح المكتب وظائف مماثلة من خلال واجهة رسومية بدلاً من تفاعل سطر الأوامر البحت.
كم يكلف استخدام Claude Code؟
تختلف الأسعار بناءً على الاستخدام ومستوى الاشتراك. تحقق من موقع Claude الرسمي للحصول على الأسعار الحالية، حيث تتغير التكاليف وهياكل الخطط بمرور الوقت. تتطلب بعض الميزات اشتراكات Claude Pro أو Enterprise.
هل يمكن لـ Claude Code تعديل ملفات خارج دليل المشروع؟
بشكل افتراضي، يقيد Claude Code الوصول إلى الملفات للدليل الحالي للمشروع من أجل الأمان. يمكن لتعيينات التكوين توسيع الأذونات، ولكن القيام بذلك يتطلب تفويضًا صريحًا. تغطي وثائق العزل الأمني إدارة الأذونات بالتفصيل.
ما هو الفرق بين Claude Code و Claude API؟
Claude Code هي أداة تطوير للمساعدة التفاعلية في البرمجة. يوفر Claude API وصولاً برمجياً لبناء تطبيقات تستخدم قدرات الذكاء الاصطناعي لـ Claude. تخدم هذه الأدوات أغراضًا مختلفة - أحدهما للمطورين الذين يكتبون الأكواد، والآخر للتطبيقات التي تدمج ميزات الذكاء الاصطناعي.
هل إلغاء التثبيت يزيل جميع بيانات Claude Code؟
يزيل إلغاء التثبيت ثنائي التطبيق ولكنه قد يترك ملفات التكوين وبيانات التخزين المؤقت. الإزالة الكاملة تتطلب حذف دليل ~/.claude يدويًا على macOS و Linux، أو موقع AppData المكافئ على Windows.
البدء بعد التثبيت
مع تثبيت Claude Code والتحقق منه، تتمثل الخطوة التالية في فهم كيفية استخدامه بفعالية.
توصي وثائق البدء السريع بالبدء بمهام بسيطة. انتقل إلى مشروع موجود وقم بتشغيل claude لبدء جلسة تفاعلية.
اطلب من Claude شرح هيكل المشروع. اطلب ملخصًا لما يفعله الكود. تساعد هذه الاستعلامات الاستكشافية في فهم كيفية تفسير الأداة للكود.
جرب إجراء تغييرات صغيرة. اطلب من Claude إضافة تعليقات توضيحية للدوال، أو إنشاء ملفات اختبار بسيطة، أو إعادة هيكلة مقاطع كود أساسية. توضح هذه المهام قدرات التحرير دون مخاطر.
يعمل تكامل Git تلقائيًا إذا كان المشروع يستخدم التحكم في الإصدار. يمكن لـ Claude Code إنشاء التزامات، وشرح الاختلافات، واقتراح تحسينات بناءً على التغييرات.
تتضمن الوثائق الرسمية أمثلة لسير العمل لمهام التطوير الشائعة. تغطي هذه إصلاح الأخطاء، وتنفيذ الميزات، ومراجعة الأكواد، والاختبار الآلي.
Claude Code أداة متطورة. التثبيت هو مجرد الأساس. يتطلب فهم قدراته وقيوده وأفضل الممارسات التجريب والممارسة.
هل أنت جاهز لتثبيت Claude Code؟ قم بتنزيل المثبت المناسب لمنصتك من الموقع الرسمي واتبع الخطوات الموضحة في هذا الدليل. قم بالمصادقة باستخدام حساب Claude الخاص بك، وتحقق من أن التثبيت يعمل بشكل صحيح، وابدأ في استكشاف التطوير بمساعدة الذكاء الاصطناعي.
