كيفية تثبيت Claude Code على ويندوز (دليل 2026)

ملخص سريع: يتطلب تثبيت Claude Code على نظام Windows إعداد WSL2 (Windows Subsystem for Linux)، وتثبيت Ubuntu، وتشغيل برنامج نصي بسيط للتثبيت. تسمح هذه العملية لمستخدمي Windows بالوصول إلى مساعد الترميز الخاص بالذكاء الاصطناعي من Anthropic عبر محطتهم الطرفية. تتوفر ملفات ثنائية أصلية لنظام Windows، ومع ذلك، لا يزال WSL2 هو أفضل ممارسة للتثبيت على نظام Windows.

Claude Code هو مساعد ترميز مدعوم بالذكاء الاصطناعي يعمل مباشرة في محطة الأوامر، مما يساعد المطورين على بناء الميزات، وإصلاح الأخطاء، وأتمتة مهام التطوير. ولكن هناك مشكلة لمستخدمي Windows.

Claude Code متاح كملف تنفيذي أصلي لنظام Windows ويمكن تثبيته عبر npm أو تنزيل ثنائي مباشر بدون WSL2. ومع ذلك، فإنه يتطلب Windows Subsystem for Linux (WSL2)، ولا تزال طريقة التثبيت الرسمية تعتمد على WSL2.

إليك كيفية جعله يعمل على Windows 11 أو Windows 10.

متطلبات النظام

قبل البدء في التثبيت، تحقق من أن جهاز Windows يلبي هذه المتطلبات:

• Windows 10 1809+ أو Windows Server 2019+
• Windows 11 (أي إصدار)
• 4 جيجابايت على الأقل من ذاكرة الوصول العشوائي المتاحة
• امتيازات إدارية على النظام
• اتصال بالإنترنت لتنزيل WSL2 و Ubuntu

يتطلب التثبيت مساحة قرص لـ WSL2 و Ubuntu و Claude Code.

الخطوة 1: تمكين Windows Subsystem for Linux

يوفر WSL2 بيئة Linux مباشرة داخل Windows. إنها الأساس الذي يسمح لـ Claude Code بالعمل.

افتح PowerShell كمسؤول. انقر بزر الماوس الأيمن على زر البدء واختر "Windows PowerShell (Admin)" أو "Terminal (Admin)" على Windows 11.

قم بتشغيل هذا الأمر:

wsl --install

يقوم هذا الأمر بتمكين ميزات Windows اللازمة وتثبيت Ubuntu كتوزيعة Linux افتراضية. من المحتمل أن يطالبك النظام بإعادة التشغيل.

بعد إعادة التشغيل، يكمل WSL2 الإعداد تلقائيًا. يتم تشغيل Ubuntu ويطلب اسم مستخدم وكلمة مرور. هذه بيانات الاعتماد خاصة ببيئة Linux فقط - لا يلزم أن تتطابق مع بيانات اعتماد Windows.

الخطوة 2: التحقق من تثبيت WSL2

بمجرد إعادة تشغيل النظام وانتهاء Ubuntu من الإعداد الأولي، تحقق من أن WSL2 يعمل بشكل صحيح.

افتح محطة Ubuntu الطرفية (ابحث عن "Ubuntu" في قائمة البدء) وقم بتشغيل:

wsl --version

يعرض هذا معلومات إصدار WSL. ابحث عن "WSL version: 2.x.x" في الإخراج.

إذا أظهر الأمر WSL1 بدلاً من ذلك، قم بالترقية إلى WSL2 باستخدام:

wsl --set-default-version 2

الخطوة 3: تثبيت Claude Code

الآن للتثبيت الفعلي لـ Claude Code. توفر الوثائق الرسمية برنامجًا نصيًا للتثبيت في سطر واحد.

في محطة Ubuntu الطرفية، قم بتشغيل:

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

يقوم البرنامج النصي بتنزيل الملف الثنائي لـ Claude Code، ويقوم بإعداد الأذونات اللازمة، ويضيفه إلى مسار النظام. يختلف وقت التثبيت حسب سرعة الإنترنت ومواصفات النظام.

وفقًا للوثائق الرسمية لـ Claude Code، يقوم المثبت تلقائيًا بالكشف عن بنية النظام وتنزيل إصدار الملف الثنائي المناسب.

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

أبلغ بعض مستخدمي Windows عن رؤية "command not found: claude" بعد التثبيت. يحدث هذا عادةً لأن متغير المسار (PATH) لم يتم تحديثه.

أغلق محطة Ubuntu الطرفية وأعد فتحها، ثم حاول مرة أخرى. إذا استمرت المشكلة، فقد يساعد تكوين المسار هذا كحل بديل غير رسمي:

echo 'export PATH="$HOME/.claude/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

الخطوة 4: المصادقة على Claude Code

يتطلب Claude Code المصادقة باستخدام حساب Anthropic قبل الاستخدام.

قم بتشغيل هذا الأمر:

claude

تعرض المحطة الطرفية عنوان URL وتطلب المصادقة. تختلف العملية قليلاً للمستخدمين الأفراد مقابل حسابات الفرق:

افتح عنوان URL المقدم في المتصفح، وسجل الدخول إلى حساب Anthropic، وقم بتفويض Claude Code. تؤكد المحطة الطرفية نجاح المصادقة.

العمل مع مشاريع Windows في WSL2

هنا تصبح الأمور معقدة. أنظمة ملفات Windows وأنظمة ملفات WSL2 منفصلة.

يمكن الوصول إلى ملفات Windows من WSL2 في /mnt/c/ (للقيادة C:)، /mnt/d/ (للقيادة D:)، وما إلى ذلك. ولكن هناك تكلفة أداء. تشير مناقشات المجتمع إلى فروق في الأداء بين الأدلة المثبتة على Windows والأدلة الأصلية لـ WSL2.

لأفضل أداء، قم بنسخ ملفات المشروع إلى دليل المنزل الخاص بـ WSL2:

cp -r /mnt/c/Users/YourName/Projects/your-project ~/projects/your-project

المقايضة؟ يصبح تكامل IDE أكثر تعقيدًا. يتعامل Visual Studio Code مع هذا بشكل جيد مع امتداد Remote-WSL الخاص به، ولكن قد تواجه IDEs أخرى صعوبة.

اختبار التثبيت

تحقق من أن Claude Code يعمل بشكل صحيح مع اختبار بسيط.

انتقل إلى دليل مشروع (أو قم بإنشاء مجلد اختبار):

mkdir ~/claude-test
cd ~/claude-test
claude "create a simple hello world Python script"

يجب أن يستجيب Claude Code، وينشئ الملف، ويعرض الكود. يؤكد هذا نجاح التثبيت.

توقف عن الدفع المبالغ فيه، قم بالمطالبة بأرصدة الذكاء الاصطناعي المتاحة أولاً

تثبيت Claude Code على Windows سريع عادةً. تظهر التكلفة الحقيقية لاحقًا عندما يبدأ المطورون في اختبار المطالبات، وتشغيل البرامج النصية، ودمج النموذج في التطبيقات. يمكن أن تولد مرحلة التجريب هذه الكثير من استدعاءات API، ويدرك العديد من الفرق التكلفة فقط بعد أن يبدأوا في البناء.

قبل إنفاق الأموال على الاستخدام، يجدر التحقق مما إذا كنت مؤهلاً للحصول على أرصدة الذكاء الاصطناعي أو برامج الشركاء. يقوم Get AI Perks بجمع هذه الفرص في مكان واحد، حيث يسرد الأرصدة والخصومات من مزودي الذكاء الاصطناعي ومنصات الحوسبة السحابية وأدوات المطورين، جنبًا إلى جنب مع تعليمات بسيطة حول كيفية المطالبة بها.

قبل تشغيل مشروع Claude Code الأول الخاص بك، تحقق من Get AI Perks وقم بالمطالبة بأرصدة الذكاء الاصطناعي التي يمكن أن تغطي تكاليف التطوير الخاصة بك.

أسئلة متكررة

الخطوات التالية بعد التثبيت

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

جرب هذه الأوامر للتعرف عليها:

• claude "explain this function" -- الحصول على شروحات الكود
• claude commit -- إنشاء رسائل التزام Git
• claude -c -- متابعة آخر محادثة

توفر الوثائق الرسمية أدلة مفصلة لتكامل IDE، وتثبيت المكونات الإضافية، وخيارات التكوين المتقدمة. بالنسبة للفرق، توفر إعدادات إدارة الخادم وتتبع التحليلات تحكمًا إضافيًا في عمليات نشر Claude Code.

قد يبدو إعداد WSL2 وكأنه خطوات إضافية مقارنة بتطبيقات Windows الأصلية، ولكنه حاليًا هو الطريق الوحيد لتشغيل Claude Code على Windows. الخبر السار؟ بمجرد تكوينه، فإنه يعمل بسلاسة ويتكامل مع معظم سير عمل التطوير.