سلسلة دروس Claude Code 5: كيفية تثبيت Claude Code؟

كيفية تثبيت Claude Code

تثبيت Claude Code لا يحتوي على واجهة رسومية مع أزرار "التالي"، بل يتم بالكامل في سطر الأوامر. إذا كنت تستخدم npm عادةً، فلن تستغرق العملية أكثر من دقيقتين.

المتطلبات الأساسية

قبل البدء، تأكد من توفر ما يلي:

• Node.js الإصدار 18 أو أحدث
  طريقة التحقق: نفذ node -v في الطرفية. إذا كان الإصدار أقل من 18، قم بترقيته باستخدام nvm أو fnm أو مباشرة من nodejs.org.
• حساب Anthropic
  رابط التسجيل: https://console.anthropic.com. سيوفر الحساب مفتاح API (API Key)، والذي ستحتاجه بعد التثبيت. التسجيل مجاني، والتكلفة الفعلية حسب الاستخدام.
• شبكة يمكنها الوصول إلى نقاط نهاية Anthropic API
  النطاق الافتراضي هو api.anthropic.com. إذا كانت البيئة تتطلب وكيلاً (proxy)، فتأكد من تعيين HTTP_PROXY أو HTTPS_PROXY في الطرفية.

طريقة التثبيت الأولى: التثبيت العمومي عبر npm

هذه هي الطريقة الأكثر شيوعًا، بعد التثبيت يمكن استخدامها في أي مكان.

npm install -g @anthropic-ai/claude-code

بعد الانتهاء، نفذ claude --version، إذا ظهر رقم إصدار، فالتثبيت ناجح. بعد التثبيت العمومي، يمكن استدعاء الأمر claude مباشرة من أي مجلد.

إذا واجهت خطأ في الصلاحيات (شائع في دليل /usr/local/lib على macOS)، هناك طريقتان:

1. استخدم sudo للتثبيت (سهل لكنه مثير للجدل أمنيًا).
2. قم بتكوين npm لاستخدام دليل المستخدم لتجنب sudo:
   bash mkdir -p ~/.npm-global npm config set prefix '~/.npm-global'
   ثم أضف ~/.npm-global/bin إلى متغير PATH، وأعد فتح الطرفية.

طريقة التثبيت الثانية: استخدام npx (استخدم وشغل)

إذا كنت لا ترغب في تثبيت أي شيء عموميًا، أو تريد تجربة مؤقتة، فاستخدم npx.

npx @anthropic-ai/claude-code

سينزل npx أحدث حزمة مؤقتًا، ويشغلها دون ترك أمر عمومي. كل استخدام يتحقق من التحديثات، لذا يبقى دائمًا على أحدث إصدار. العيب هو أنه أبطأ قليلاً (تحميل في كل مرة)، ولا يناسب الاستخدام المتكرر في السكربتات الآلية.

الاستخدامات المناسبة: التجربة الأولى، الاستخدام المؤقت على جهاز شخص آخر، أو الاستخدام النادر.

التحقق من القدرة على التشغيل

بعد التثبيت، لا تتسرع في المصادقة. قم بتشغيل جملة بسيطة لترى إن كان الأداة تعمل:

claude --help

إذا ظهرت معلومات المساعدة، فالملف الثنائي سليم. الخطوة التالية هي ربط حسابك، وسيتم شرحها لاحقًا.

كلا الطريقتين تؤديان إلى نفس الأداة، وطريقة المصادقة والاستخدام متطابقة تمامًا. اختر الطريقة التي تناسبك.

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

• إصدار Node منخفض جدًا
  أقل من 18 سيؤدي إلى خطأ مباشر، وليس تحذيرًا. ترقية Node هي الحل المباشر.
• انتهاء مهلة الشبكة
  سواء في سحب الحزمة من npm أو الاتصال بـ API لاحقًا، قد تتعطل بسبب وكيل أو جدار ناري. تأكد أولاً من أن curl https://api.anthropic.com يعمل، ثم تابع.
• استخدام cmd الأصلي على Windows
  رغم أنه ممكن نظريًا، يُنصح باستخدام Git Bash أو WSL2 أو Windows Terminal لتجنب مشاكل تحويل المسارات الغريبة.