كل الدروس / Claude Code/3 min/Beginner

Claude Code tutorial

كيفية تثبيت Claude Code CLI على Mac و Windows

تعرف على كيفية تثبيت أداة Anthropic Claude Code CLI بسرعة على Mac أو Windows باستخدام npm. أوامر قابلة للنسخ للتثبيت الشامل والمصادقة في الطرفية.

٤ خطواتأوامر قابلة للنسخClaude Code
Interactive tutorial

تسلسل الأوامر السريع

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

/ar/tutorials/install-claude-code-cli-mac-windows

Interactive command lab

1/4

Step 1

التحقق من تثبيت Node.js

يتطلب Claude Code وجود بيئة Node.js (الإصدار 18 فما فوق). إذا لم تظهر أرقام الإصدارات، قم بتنزيل Node.js أولاً.

Checkpoint

node -v

zsh — tutorial-lab

Command tray

$ node -v && npm -v

➜ v20.10.0

➜ 10.2.3

تعليمات خطوة بخطوة

  1. 1

    Step

    التحقق من تثبيت Node.js

    يتطلب Claude Code وجود بيئة Node.js (الإصدار 18 فما فوق). إذا لم تظهر أرقام الإصدارات، قم بتنزيل Node.js أولاً.

    node -v && npm -v
  2. 2

    Step

    التثبيت الشامل عبر NPM

    يضمن استخدام العلامة -g إضافة claude إلى مسار النظام للعمل في أي مجلد.

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

    Step

    التحقق من التثبيت

    إذا ظهر لك 'command not found'، قد تحتاج إلى إعادة تشغيل الطرفية أو إضافة NPM إلى مسارك.

    claude --version
  4. 4

    Step

    المصادقة مع Claude

    ستفتح نافذة متصفح تطلب منك تسجيل الدخول إلى Anthropic Console. يجب تفعيل الفوترة للعمل.

    claude

لماذا هذا مهم

يضمن لك استخدام حزمة NPM الرسمية @anthropic-ai/claude-code الحصول على الإصدار الأصلي من Anthropic مع أحدث قدرات Claude 3.7. قد تفتقر الأغلفة غير الرسمية إلى التحديثات الأمنية الأساسية.

استكشاف الأخطاء وإصلاحها

  • رفض الإذن EACCES: إذا واجهت خطأ في الأذونات على جهاز Mac أثناء التثبيت الشامل، استخدم مدير إصدارات Node مثل nvm أو ضع sudo قبل الأمر.
  • الأمر غير موجود: في نظام Windows، تأكد من إضافة مسار التثبيت الشامل لـ NPM إلى متغيرات مسار بيئة النظام.
  • حلقة المصادقة اللانهائية أو خطأ 401: إذا فشل Claude في المصادقة، اجبر عملية تسجيل دخول جديدة بتشغيل claude login وتحقق من إعداد الفوترة في Anthropic Console.

FAQ

ما هو أمر npm لـ Claude Code؟

أمر التثبيت الرسمي هو npm install -g @anthropic-ai/claude-code. يقوم العلم -g بتثبيته بشكل عام لكي يعمل من أي مسار.

هل يتطلب Claude Code بايثون أو Node.js؟

يتطلب Claude Code إصدار Node.js 18 فما فوق. ولا يتطلب بايثون لتشغيله الأساسي.

هل يمكنني تشغيل Claude Code على Windows؟

نعم، Claude Code يعمل عبر المنصات على Windows و Mac و Linux طالما أن Node.js مثبت.

كيف أوثّق Claude Code في الطرفية؟

بعد التثبيت، ببساطة قم بتشغيل الأمر claude. سيطلب منك الضغط على Enter، مما يفتح متصفحك الافتراضي لعملية مصادقة آمنة.

هل استخدام Claude Code مجاني؟

في حين أن الأداة نفسها مجانية للتنزيل، إلا أنها تستخدم واجهة Anthropic API. يجب أن يكون لديك حساب مفعل للفوترة لدفع ثمن الرموز المستخدمة.

دروس ذات صلة

Copilot

How to Install GitHub Copilot CLI on Mac and Windows

Step-by-step guide to installing the GitHub Copilot CLI extension. Learn how to authenticate and run gh copilot suggest and explain in your terminal.

Aider

كيفية تثبيت Aider AI Coding CLI على Mac و Windows

دليل خطوة بخطوة لتثبيت Aider AI pair programming CLI على macOS و Windows. تعلم كيفية تكوين مفاتيح API لـ Claude 3.7 و GPT-4o.