كيفية تثبيت Claude Code من الموقع الرسمي

ما Claude Code، ولماذا يعمل في الطرفية؟#

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

تصف Anthropic المنتج على النحو الآتي.

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

إذا كنت لا تريد استخدام الطرفية إطلاقًا، توفر Anthropic تطبيقًا لسطح المكتب بنافذة عادية ونسخة ويب على claude.ai/code تعمل مباشرة في المتصفح. لكن الخيار الأقوى والأكثر مرونة هو إصدار الطرفية، وهو موضوع هذا المقال بالكامل.

أين الموقع الرسمي لـ Claude Code، وما الذي ينبغي تنزيله؟#

أول ما يربك المبتدئين هو مكان الموقع الرسمي لـ Claude Code وما الذي ينبغي النقر عليه لتنزيله. إليك جدولًا بكل عناوين Anthropic الرسمية، حتى لا تضطر إلى التخمين.

لا تنزّل مثبّتًا من الموقع كما تفعل مع البرامج العادية، وهذا يخالف ما يتوقعه الناس. بل تثبّته بأمر في الطرفية ينزّل الإصدار المناسب لنظامك. يتضمن هذا المقال الأوامر الدقيقة لأجهزة Mac وWindows وLinux.

من الأخطاء الشائعة في الاسم أن الناس يكتبونه clode code أو clade code أو слод код أو clode design. اسم المنتج هو Claude Code، ويُكتب بحرفي au. تذكّر ذلك عند البحث عن الموقع الرسمي: النطاقات ذات التهجئات المتشابهة مملوكة لجهات أخرى.

ومن المفيد أيضًا معرفة اسم حزمة npm بدقة. الحزمة المعتمدة هي @anthropic-ai/claude-code، مع السابقة @anthropic-ai/. تملك Anthropic الاسم المختصر claude-code من دون السابقة، وهو مرجعها الرسمي إلى الحزمة نفسها. القاعدة البسيطة: يجب أن يكون الناشر Anthropic، وأن يتضمن الاسم المستخدم للتثبيت السابقة.

ما الذي تحتاج إليه لتثبيته: متطلبات الكمبيوتر#

متطلبات Claude Code بسيطة: تتولى خوادم Anthropic الجزء الأكبر من العمل، ولا يفعل جهازك سوى إرسال الطلبات وتلقي الردود.

ملاحظة منفصلة عن Node.js، إذ تحيط به معظم الخرافات. المثبّت الأصلي، الذي توصي به Anthropic نفسها، لا يحتاج إلى Node.js إطلاقًا: فهو يثبّت البرنامج كملف مستقل واحد. لا تحتاج إلى Node.js إلا إذا ثبّت Claude Code عبر npm، وعندئذٍ تحتاج إلى الإصدار 22 أو أحدث. تقول المقالات القديمة «Node 18 أو أحدث»، لكن ذلك لم يعد حديثًا؛ اعتمد الإصدار 22 أو أحدث.

تحتاج إلى طرفية لاستخدام الإصدار الرئيسي. إذا كنت لا تريد استخدامها، فثبّت تطبيق سطح المكتب ذي النافذة العادية أو استخدم نسخة الويب على claude.ai/code. يظل إصدار الطرفية أغنى بالميزات، لذا يشرح باقي المقال كيفية تثبيته.

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

كيف تثبّت Claude Code على macOS؟#

افتح Terminal (وهو موجود على كل أجهزة Mac: اضغط Cmd+Space في Spotlight واكتب «Terminal») والصق هذا السطر:

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

ينزّل الأمر المثبّت من العنوان الرسمي لـ Anthropic ويثبّت Claude Code. لا تحتاج إلى Node.js. وتمتاز الطريقة الأصلية أيضًا بسهولة التحديثات.

إذا كنت تستخدم Homebrew بالفعل، فهناك خيار ثانٍ:

brew install --cask claude-code

يكمن الفرق في آلية التحديث: يحدّث المثبّت الأصلي نفسه، بينما لا يفعل Homebrew ذلك، وعليك تحديثه يدويًا باستخدام الأمر brew upgrade claude-code. البرنامج نفسه في الحالتين، لذا اختر الطريقة التي اعتدت عليها. وإذا لم تكن متأكدًا، فاستخدم الطريقة الأولى.

كيف تثبّت Claude Code على Windows؟#

أولًا، حدّد البيئة التي تعمل فيها. لدى Windows صدفتان ولكل منهما أمرها. افتح نافذة وانظر إلى بداية المحث: PS C:\> تعني PowerShell، أما C:\> من دون PS فتعني موجّه الأوامر (CMD).

في PowerShell (أسهل طريقة لفتحه هي النقر بزر الفأرة الأيمن على زر Start واختيار «Terminal»):

irm https://claude.ai/install.ps1 | iex

في موجّه الأوامر (CMD):

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

وهناك خيار ثالث باستخدام مدير الحزم المضمّن WinGet:

winget install Anthropic.ClaudeCode

إذا كان لديك بالفعل بيئة WSL (Linux داخل Windows) تعمل، فثبّت Claude Code داخل WSL مباشرة باستخدام الأمر نفسه المستخدم على Linux. وهناك مسألة منفصلة تتعلق بـ Node في WSL، وسأشرحها أدناه في قسم الأخطاء الشائعة.

كيف تثبّت Claude Code على Linux؟#

الطريقة الأساسية واحدة لأي توزيعة شائعة: استخدم المثبّت المستقل التالي:

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

لا يلزم Node.js؛ فالبرنامج يأتي في ملف واحد ويحدّث نفسه بعد ذلك.

إذا كنت معتادًا على تثبيت البرامج عبر مدير حزم النظام فقط، فيمكنك إضافة مستودعات Anthropic الرسمية: apt لـ Debian وUbuntu، وdnf لـ Fedora وRHEL، وapk لـ Alpine. وهي موقعة بمفتاح وتوفر قناتي stable وlatest. هذا أكثر مما يحتاج إليه المبتدئ، لذا أترك التفاصيل للوثائق في قسم المصادر وأوصي افتراضيًا بالأمر أعلاه.

قد تواجه مشكلة على الخوادم الرخيصة. إذا كانت الذاكرة الحرة في الجهاز قليلة جدًا، فقد يتوقف التثبيت وتظهر كلمة Killed (الرمز 137)، أي إن النظام أنهى العملية بسبب نفاد الذاكرة. الحل هو إضافة ملف swap: يحتاج Claude Code إلى نحو 512 MB من الذاكرة الحرة للتثبيت.

كيف تشغّل Claude Code للمرة الأولى؟#

يستغرق التشغيل الأول بضع دقائق. إليك الخطوات.

1. انتقل إلى مجلد المشروع

   استخدم الأمر cd path-to-project في الطرفية للانتقال إلى المجلد الذي تريد العمل فيه، ثم اكتب claude.

2. سجّل الدخول إلى حسابك

   ستُفتح نافذة تسجيل الدخول في المتصفح. إذا لم تُفتح تلقائيًا، فاضغط c لنسخ الرابط والصقه يدويًا في المتصفح. وإذا عرض المتصفح رمزًا (قد يحدث ذلك في WSL والخوادم البعيدة)، فأعد لصق الرمز في الطرفية.

3. انتظر التأكيد

   بعد تسجيل الدخول، ستعرض الطرفية Login successful وتطلب منك الضغط على Enter.

4. اطرح سؤالك الأول

   اسأل سؤالًا بسيطًا عن المشروع، مثل «ما وظيفة هذا المشروع؟». سيقرأ Claude الملفات ويجيبك.

5. وافق على التغيير الأول

   عندما تطلب منه تغيير شيء ما، سيعرض Claude التغييرات المقترحة ويطلب موافقتك. يمكنك التبديل بين أوضاع الوصول باستخدام Shift+Tab.

من المفيد تعلّم بعض الأوامر الأساسية داخل الجلسة مباشرة: يعرض /help قائمة الأوامر، ويمسح /clear سجل المحادثة، ويُنهي /exit الجلسة (كما تفعل مرتان من Ctrl+D). سيعرض Claude كل ذلك بنفسه إذا كتبت /help.

تسجيل الدخول باشتراك أم بمفتاح API: أيهما تختار؟#

هذا أول سؤال يطرأ عند تسجيل الدخول.

هناك طريقتان لتسجيل الدخول، وتختلفان في طريقة الدفع.

لتسجيل الدخول باشتراك، استخدم حساب Claude.ai. ولتسجيل الدخول بمفتاح API، احصل على مفتاح من Claude Console (platform.claude.com)؛ وتُخصم الرسوم من رصيدك المدفوع مسبقًا أثناء العمل. عيّن المفتاح في متغير البيئة ANTHROPIC_API_KEY، وعندها لن يفتح Claude Code المتصفح في كل مرة.

يمكنك تبديل الحسابات داخل الجلسة باستخدام /login وتسجيل الخروج باستخدام /logout.

لكن Claude Code لن يعمل من دون وصول مدفوع. إذا لم يكن لديك حساب بعد، فتحقّق أولًا من عنوان البريد الإلكتروني الذي ينبغي استخدامه للتسجيل، إذ لن تتمكن من تغييره لاحقًا.

كيف تتحقق من أن التثبيت تم بنجاح؟#

هناك ثلاثة أوامر يجدر بك معرفتها منذ البداية.

الأول يتحقق من الإصدار:

claude --version

يعرض التثبيت السليم رقمًا بالتنسيق X.Y.Z (Claude Code). تختلف الأرقام المحددة من إصدار إلى آخر؛ والمهم أن يعرض الأمر رقم إصدار. أما ظهور «command not found» فيعني وجود مشكلة أخرى، وسأشرحها في القسم التالي.

الثاني للتشخيص إذا حدث خطأ ما.

أما الثالث فهو /status داخل الجلسة: يعرض طريقة تسجيل الدخول، والبريد الإلكتروني أو المؤسسة المرتبطة، وما إذا كان الوصول قد انتهت صلاحيته. ويطبّق claude update أحدث تحديث فورًا بدلًا من انتظار التحديث في الخلفية.

لماذا يتعذر العثور على الأمر claude بعد التثبيت؟#

هذه أكثر الشكاوى شيوعًا بين المبتدئين، وهي أقل خطورة مما تبدو. لا تبحث الطرفية عن الأوامر في الكمبيوتر كله؛ بل تتحقق فقط من المجلدات الموجودة في PATH. يضع Claude Code نفسه في ~/.local/bin/claude (على Mac وLinux) أو %USERPROFILE%\\.local\\bin\\claude.exe (على Windows)، وإذا لم يكن ذلك المجلد في PATH فلن تتمكن الطرفية من رؤية البرنامج.

على Mac وLinux، أضف المجلد إلى القائمة. افتح ملف إعدادات الصدفة (~/.zshrc لـ Zsh، أو ~/.bashrc لـ Bash) وأضف هذا السطر في النهاية:

export PATH="$HOME/.local/bin:$PATH"

ثم أغلق الطرفية وأعد فتحها (أو نفّذ source ~/.zshrc). بعد ذلك سيُعثر على claude.

أخطاء شائعة في التثبيت والتشغيل الأول#

لنستعرض هذه الحالات بالترتيب؛ فجميعها واردة في دليل Anthropic الرسمي لاستكشاف الأخطاء وإصلاحها.

1. إصدار Node قديم عند التثبيت عبر npm. تتطلب حزمة @anthropic-ai/claude-code الإصدار 22 أو أحدث من Node.js. على Windows، قد يفشل npm برسالة تفيد بتعطيل البرامج النصية، لأن سياسة PowerShell تمنع تشغيلها. في WSL، من الأخطاء الشائعة exec: node: not found: إذ يستخدم WSL إصدار Node الخاص بـ Windows بدلًا من إصدار Linux. إذا واجهت مشكلات مع npm، فانتقل إلى المثبّت الأصلي؛ فهو لا يحتاج إلى Node.
2. مثبّت غير مناسب للصدفة. تعني رسالة 'irm' is not recognized أنك لصقت أمر PowerShell في موجّه الأوامر. وتعني رسالة The token '&&' is not a valid statement separator أنك فعلت العكس ونفذت أمر CMD في PowerShell. أما A parameter cannot be found that matches parameter name 'fsSL' فتعني أنك نفذت أمر Mac/Linux في PowerShell. تحقق من بداية المحث: PS C:\ يعني PowerShell، وC:\ يعني CMD.
3. مفتاح API قديم يتجاوز الاشتراك. إذا كان اشتراكك فعالًا ولا يزال مفتاح قديم مضبوطًا في البيئة، فستظهر الرسالة API Error: 400 ... This organization has been disabled. تكون الأولوية لتسجيل الدخول بالمفتاح على تسجيل الدخول بالاشتراك. أزل المفتاح باستخدام unset ANTHROPIC_API_KEY (وفي PowerShell استخدم Remove-Item Env:ANTHROPIC_API_KEY)، ثم تحقق من ~/.zshrc و~/.bashrc واكتب /status.
4. نقص الذاكرة على خادم ضعيف. يتوقف التثبيت مع ظهور كلمة Killed والرمز 137، ما يعني عدم وجود RAM كافية. تحتاج إلى نحو 512 MB من الذاكرة الحرة؛ وإضافة swap تحل المشكلة.
5. أعاد المثبّت شيئًا آخر. يعني الخطأ syntax error near unexpected token '<' أو ظهور <!DOCTYPE html> أن عنوان التثبيت أعاد صفحة ويب بدلًا من نص المثبّت، وغالبًا ما يكون السبب منطقتك أو جدار حماية الشركة أو انقطاعًا مؤقتًا. جرّب طريقة أخرى (Homebrew أو WinGet)، أو أعد المحاولة بعد بضع دقائق.

الخطوة الأولى في التعامل مع أي من هذه الأخطاء واحدة: شغّل claude doctor. سيعرض ما الذي تعطل ويقترح أين تبحث.

وهناك تفصيل تشخيصي: قد يرجع الخطأ 403 وحده أثناء التثبيت إلى جدار حماية الشركة أو خادم وكيل. لذا إذا كنت على شبكة المكتب، فتحقق أولًا مما إذا كانت تحجب الاتصال.

ما الذي تفعله بعد التثبيت: الخطوات الأولى#

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

لذلك فإن الخطوة العملية الأولى بعد التثبيت هي إنشاء ملف CLAUDE.md في جذر المشروع. إنه ملف نصي يضم قواعد المشروع وسياقه، ويقرأه Claude Code عند كل تشغيل. اشرح مرة واحدة ما الذي تفعله، وكيف نُظّم المشروع، وما الأمور المهمة، ولن تضطر إلى تكرار ذلك في كل محادثة.

أشرح كيفية إعداد هذا الملف وتخصيص Claude في دليل منفصل: كيفية تخصيص Claude. كما أعددت خريطة عامة لأدوات vibe coding لعام 2026.

ما الأسئلة الأخرى التي يطرحها الناس؟#

إطار العمل الكامل لـ vibe coding: نسخة مستنسخة من الذكاء الاصطناعي + دماغ ثانٍ + هندسة السياق.