التثبيت والاستخدام

📚 التنقل في السلسلة: شرح المقال السابق 01 · مقدمة عن Claude Code ما هو وماذا يمكنه أن يفعل. سيأخذك هذا المقال في الواقع لتثبيته على جهاز الكمبيوتر الخاص بك، وتسجيل الدخول، وتشغيله، وشرح كيفية الترقية، وإلغاء التثبيت، واستكشاف الأخطاء وإصلاحها بدقة مرة واحدة. سيكشف المقال التالي 03 · كيف يعمل Claude Code الغطاء لإلقاء نظرة على حلقة الوكيل (agent loop).

إليك قصة محرجة شائعة. العديد من الأشخاص عند تثبيت Claude Code لأول مرة، يبحثون ببساطة عن برنامج تعليمي قديم، ويكتبون npm install -g @anthropic-ai/claude-code بناءً عليه، ويتعثرون في أخطاء الأذونات. في عجلة من أمرهم، يستخدمون sudo لفرضه - تم تثبيته بالفعل، لكن التحديثات التلقائية تفشل كل يوم لاحقًا، ويتحول claude doctor إلى اللون الأحمر بالكامل. يستغرق الأمر قرابة ساعة لإدراك: أن المسؤولين قد أدرجوا النص البرمجي الأصلي كخيار أول منذ فترة طويلة، ومسار npm مليء بالمزالق، وهو شيء يمكن إنجازه في ثلاثين ثانية بسطر واحد من نص curl، لكنهم سلكوا المسار الأكثر التفافًا وعرضة للخطأ.

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

بعد قراءة هذا المقال، ستحصل على:

• أمر واحد لتثبيت Claude Code على Mac / Windows / Linux / WSL (مع المخرجات المتوقعة، يمكنك التحقق بنفسك مما إذا كان التثبيت ناجحًا)
• مقارنة بين ثلاث طرق للتثبيت (النص البرمجي الرسمي / مدير الحزم / npm)، لتعرف أيهما تختار
• العمليات الكاملة لتسجيل الدخول، الترقية، وإلغاء التثبيت
• ورقة مرجعية سريعة لـ "الأخطاء → كيفية الإصلاح"، تغطي 90% من المزالق التي يواجهها المبتدئون

---

01 توضيح ثلاثة أشياء قبل التثبيت

لا تتسرع في كتابة الأوامر. يكتشف الكثير من الناس في منتصف التثبيت "أوه، هذا الحساب لا يمكن استخدامه"، فيضيع جهدهم سدى. تأكد من ثلاثة أشياء أولاً.

الشيء الأول: هل جهاز الكمبيوتر الخاص بك مؤهل

لا يتطلب Claude Code الكثير من جهازك، ولكن هناك بعض المتطلبات الأساسية الصارمة (بناءً على المتطلبات الرسمية):

العنصر	المتطلبات
نظام التشغيل	macOS 13.0+ / Windows 10 1809+ / Ubuntu 20.04+ / Debian 10+ / Alpine 3.19+
الذاكرة	أكثر من 4 GB من ذاكرة الوصول العشوائي (RAM) المتاحة
المعالج	x64 أو ARM64
الشبكة	يتطلب اتصالاً بالإنترنت
المحطة الطرفية (Terminal)	أي من Bash أو Zsh أو PowerShell أو CMD

ملاحظة لمستخدمي macOS أقل من 13.0: يمكنك تثبيته، لكنه سيتعطل بمجرد تشغيله، مبلغًا عن خطأ مثل dyld: cannot load - النظام القديم لا يدعم التعليمات المستخدمة في الملف الثنائي، ولا توجد طريقة لتجاوز ذلك، يمكنك فقط ترقية النظام (على الأجهزة التي لا تزال تعمل بنظام macOS 12، سيرفض العمل تمامًا، ولن يتحسن حتى ترقيته إلى 14).

الشيء الثاني: يجب أن يكون لديك حساب صالح للاستخدام

أكثر شيء يتجاهله المبتدئون: الحساب المجاني على Claude.ai لا يمكنه استخدام Claude Code.

المتطلب الرسمي هو أن يكون أحد حسابات Pro أو Max أو Team أو Enterprise أو Console (API). أنك تستخدم النسخة المجانية من Claude على الويب بسعادة لا يعني أن الحساب يمكنه تشغيل Claude Code - الفئة المجانية لا تعمل ببساطة.

أما بالنسبة لأولئك الذين يرغبون في استخدام النماذج المحلية (DeepSeek، GLM، Minimax) لتوفير المال، فتخطوا خطوة الحساب هذه في الوقت الحالي؛ حيث سيتم تخصيص المقال الخامس لشرح كيفية ربط النماذج التابعة لجهات خارجية. يفترض هذا المقال أنك تستخدم حسابًا رسميًا.

الشيء الثالث: من أين تنوي استخدامه

لدى Claude Code ثلاث طرق للاستخدام: CLI (واجهة سطر الأوامر) والتي تتميز بأكثر الميزات اكتمالاً وتتوافق مع نية التصميم الأصلية؛ تطبيق سطح المكتب (Desktop App) لا يتطلب لمس المحطة الطرفية، فقط قم بتنزيله واستخدامه؛ تكامل المحرر (VS Code / JetBrains) ليندمج في سير عمل التطوير الحالي لديك.

نصيحتي: تعلم CLI مباشرة. هذا المقال يتخذ أيضًا CLI كمسار رئيسي - فهو الأكثر استقرارًا وشمولية، وبمجرد أن تتعلمه، سيستغرق إتقان تطبيق سطح المكتب وإضافات المحرر بضع دقائق فقط (سيتم شرح ذلك في المقالات 08-10). إذا كنت تقاوم المحطة الطرفية حقًا، اذهب إلى https://claude.com/download وقم بتنزيل تطبيق سطح المكتب، ويمكنك استخدامه بنقرات قليلة.

💡 ملخص في جملة واحدة: تأكد من ثلاثة أشياء قبل التثبيت - إصدار النظام كافٍ، الحساب فئة مدفوعة أو Console، طريقة الاستخدام اختر CLI، بعد اجتياز هذه العقبات الثلاث يمكنك كتابة الأوامر.

---

02 تثبيته: أمر واحد لكل منصة

لنعطِ الاستنتاج أولاً: يجب أن تعطي جميع المنصات الأولوية لاستخدام نص التثبيت الرسمي (يطلق عليه رسميًا "التثبيت الأصلي / Native Install"، وهو الخيار الأكثر توصية الآن). الميزة الأكبر هي - بعد التثبيت، سيتم التحديث في الخلفية تلقائيًا، ولن تضطر تقريبًا للقلق بشأن الإصدارات مرة أخرى.

للتشبيه: التثبيت الأصلي يشبه تثبيت تطبيق من متجر التطبيقات. انقر فوق "تثبيت"، وسيقوم بتنزيل نفسه، وتثبيت نفسه، وتحديث نفسه في الخلفية لاحقًا؛ تشبه طريقة npm القديمة "تنزيل حزمة تثبيت والنقر يدويًا على التالي" - يمكنك تثبيته، لكن يجب عليك تحديثه بنفسك، ومن السهل أن تسوء الأمور بسبب الأذونات.

macOS / Linux / WSL

افتح المحطة الطرفية، والصق هذا السطر:

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

تلميح للشبكة في الصين: الوصول إلى claude.ai وخادم التنزيل downloads.claude.ai يتطلب في معظم الحالات تجاوز الحجب لضمان استقرار الاتصال. استخدم وكيل (proxy) أثناء التثبيت لتجنب أكثر من نصف أخطاء "التوقف / انتهاء المهلة".

Windows (أصلي، بدون WSL)

تأكد أولاً من المحطة الطرفية التي تتواجد فيها - هذه هي النقطة التي يتعثر فيها مستخدمو Windows غالبًا، أوامر PowerShell و CMD مختلفة:

PowerShell (موجه الأوامر يبدو هكذا PS C:\>):

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

CMD (موجه الأوامر هو C:\>، بدون PS في المقدمة):

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

كيف تفرق بينهما؟ انظر إلى ما إذا كان موجه الأوامر يبدأ بـ PS: إذا كان كذلك، فهو PowerShell، وإلا فهو CMD. تشغيل أمر CMD الذي يحتوي على && في PowerShell سيؤدي إلى الخطأ The token '&&' is not a valid statement separator، والعكس بالعكس، تشغيل irm في CMD سيؤدي إلى الخطأ 'irm' is not recognized - عند رؤية هذين الخطأين، فقط قم بتبديل الأمر المقابل.

بالإضافة إلى ذلك، في بيئة Windows الأصلية، نوصي بتثبيت Git for Windows بالمرة، فهو يوفر Git Bash لـ Claude Code؛ بدون تثبيته سيتحول إلى استخدام PowerShell لتشغيل الأوامر (يمكن استخدامه أيضًا، لكن بعض نصوص Bash ستكون محدودة). لا يحتاج WSL إلى ذلك.

هل تختار WSL أم الأصلي لنظام Windows؟

إذا كنت تقوم بتطوير سلسلة أدوات Linux، أو ترغب في استخدام ميزة صندوق الرمل (Sandbox)، فاختر WSL. جدول المقارنة الرسمي:

الخيار	ماذا يحتاج	يدعم صندوق الرمل	متى يُستخدم
Windows الأصلي	لا شيء (Git for Windows اختياري)	❌	المشاريع والأدوات الأصلية لنظام Windows
WSL 2	تمكين WSL 2	✅	سلسلة أدوات Linux أو إذا كنت تريد استخدام صندوق الرمل
WSL 1	تمكين WSL 1	❌	خط رجعة عندما لا يمكن استخدام WSL 2

إذا كنت ستسلك مسار WSL، فما عليك سوى تشغيل نص curl الخاص بـ macOS/Linux أعلاه في المحطة الطرفية لـ WSL - فهو يُثبَّت في WSL، وليس في PowerShell.

لا تريد لمس المحطة الطرفية؟ هناك طرق أخرى

إلى جانب النص البرمجي الرسمي، هناك عدة بدائل، إليك مقارنة لتختار ما يناسبك:

طريقة التثبيت	الأمر	التحديث التلقائي	نصيحتي
النص البرمجي الرسمي	curl ... | bash	✅ تلقائي في الخلفية	الخيار الأول، راحة البال
Homebrew (macOS)	brew install --cask claude-code	❌ يدوي	للأشخاص الذين يعتمدون بشدة على brew لإدارة البرامج
WinGet (Windows)	winget install Anthropic.ClaudeCode	❌ يدوي	للأشخاص المعتادين على استخدام WinGet
npm	npm install -g @anthropic-ai/claude-code	❌ يدوي	آخر شيء يجب التفكير فيه، يجب تثبيت Node.js 18+ أولاً

بعض المزالق التي يجب ذكرها مسبقًا:

• يحتوي Homebrew على حزمتي cask: claude-code هي النسخة المستقرة (تتأخر بأسبوع، وتتخطى الإصدارات التي تحتوي على تراجعات كبيرة)، و claude-code@latest هي أحدث نسخة، وتتم ترقيتهما باستخدام الأمرين brew upgrade claude-code / brew upgrade claude-code@latest على التوالي.
• لا يقوم WinGet بالتحديث التلقائي: تحتاج إلى تشغيل winget upgrade Anthropic.ClaudeCode يدويًا بشكل دوري.
• لا تقم أبدًا بإضافة sudo مع npm. يحذر المسؤولون بوضوح من أن sudo npm install -g سيتسبب في مشاكل بالأذونات ومخاطر أمنية - وهذا بالضبط هو الفخ الأكثر شيوعًا المذكور في البداية. إذا واجهت أخطاء في الأذونات، فالحل الصحيح هو التبديل إلى النص البرمجي الرسمي. عند ترقية npm، يجب عليك أيضًا استخدام npm install -g ...@latest، ولا تستخدم npm update -g.

💡 ملخص في جملة واحدة: اختر النص البرمجي الرسمي وأنت مغمض العينين، أمر curl (أو irm في Windows) يحل المشكلة، ويأتي مزودًا بالتحديث في الخلفية؛ npm هو أسوأ خيار، ولا تستخدم sudo أبدًا.

---

03 التحقق مما إذا كان التثبيت ناجحًا

بعد التثبيت، لا تتسرع في استخدامه، اقضِ عشر ثوانٍ للتأكد. افتح نافذة جديدة للمحطة الطرفية واكتب:

claude --version

المخرجات المتوقعة هي رقم الإصدار، مثل (الأرقام التي تراها سيتم تحديثها، وهذا طبيعي):

2.1.81 (Claude Code)

رؤية رقم الإصدار = التثبيت ناجح. إذا ظهر الخطأ command not found: claude أو 'claude' is not recognized في Windows، لا تستعجل بإعادة التثبيت - في 90% من الحالات، المشكلة هي عدم تكوين PATH بشكل صحيح (مجلد التثبيت لم يُضف إلى مسار بحث النظام)، ويوجد حل لذلك في القسم 06.

إذا كنت تريد المزيد من التفاصيل، يقدم المسؤولون أيضًا أمرًا للفحص الطبي:

claude doctor

سيقوم بإدراج حالة التثبيت والتكوين ونتائج آخر تحديث. بعد التثبيت على جهاز جديد أو مواجهة خلل، يجب أن يكون أول رد فعل هو تشغيل claude doctor - فهو أسرع بكثير من التخمين العشوائي.

💡 ملخص في جملة واحدة: ظهور رقم الإصدار مع claude --version يعني النجاح؛ إذا كان هناك أي شيء غير طبيعي، فإن claude doctor هو أداة التشخيص الأولى لك.

---

04 تسجيل الدخول: اجعله يتعرف عليك

لا يزال Claude Code المثبت عبارة عن صدفة فارغة "لا تعرفك"، يجب عليك تسجيل الدخول وربط الحساب ليتمكن من العمل. ابدأ تشغيله في مجلد المشروع الخاص بك:

claude

في المرة الأولى التي تقوم فيها بتشغيله، سيرشدك تلقائيًا لتسجيل الدخول، أو يمكنك تشغيله يدويًا بعد الدخول إلى الواجهة:

/login

بعد ذلك، ستظهر صفحة المتصفح للسماح لك بالتفويض، وبعد التفويض والعودة إلى المحطة الطرفية، سيتم تسجيل الدخول. يتم تخزين بيانات الاعتماد محليًا، ولن تضطر لتسجيل الدخول في المرة القادمة التي تقوم فيها بتشغيله. للتبديل بين الحسابات، قم بتشغيل /login مرة أخرى.

ماذا تفعل إذا توقف تسجيل الدخول

الأكثر شيوعًا: المتصفح لا ينبثق تلقائيًا، أو أنك تقوم بتسجيل الدخول في خادم عن بعد / WSL / SSH - قد يتم فتح المتصفح على جهاز آخر، ولا يمكن استرداد الاستدعاء (callback). الحل الرسمي بسيط جدًا:

في واجهة مطالبة تسجيل الدخول، اضغط على c، انسخ عنوان URL الخاص بـ OAuth (التفويض المفتوح)، وافتحه يدويًا في المتصفح. بعد تسجيل الدخول، سيتم عرض رمز (code)، قم بلصق الرمز مرة أخرى في المحطة الطرفية.

من السهل الوقوع في هذا الفخ عند تكوين Claude Code على خادم سحابي، حيث تنتظر طويلاً لظهور نافذة المتصفح دون جدوى - في البيئات البعيدة، يجب عليك اتباع مسار "نسخ URL وفتحه يدويًا". إذا لم ينجح حتى اللصق، فهناك أمر بديل أكثر استقرارًا:

claude auth login

إنه يقرأ الرمز الذي لصقته من الإدخال القياسي، وهو مخصص للمحطات الطرفية التي لا يمكن لصق المطالبات التفاعلية فيها.

فخ خفي كبير في تسجيل الدخول

بعد تسجيل الدخول، يظهر خطأ This organization has been disabled، على الرغم من أن الاشتراك سليم - الاحتمال الأكبر هو أن هناك ANTHROPIC_API_KEY قديم متبقي في تكوين الغلاف (shell)، مما أدى إلى تجاوز بيانات اعتماد اشتراكك.

عندما يكون هناك مفتاح API في متغيرات البيئة، سيعطي Claude Code الأولوية لاستخدام المفتاح بدلاً من الاشتراك. الحل هو مسحه:

unset ANTHROPIC_API_KEY
claude

لحل المشكلة بشكل دائم، ابحث في ~/.zshrc أو ~/.bashrc أو ~/.profile، واحذف سطر export ANTHROPIC_API_KEY=.... بعد الدخول إلى Claude Code، يمكنك استخدام /status للتأكد من طريقة تسجيل الدخول المستخدمة حاليًا.

💡 ملخص في جملة واحدة: سيوجه تشغيل claude تلقائيًا لتسجيل الدخول، في بيئة التحكم عن بعد/WSL تذكر "الضغط على c لنسخ URL وفتحه يدويًا"؛ إذا أبلغ تسجيل الدخول عن تعطيل المؤسسة، فتحقق أولاً مما إذا كان هناك مفتاح API قديم متبقي في متغيرات البيئة.

---

05 الترقية وإلغاء التثبيت

الترقية

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

claude update

لمعرفة ما إذا كان التحديث ناجحًا، استخدم نفس عبارة claude doctor. يمكن اختيار قناة التحديث (مكتوبة في settings.json، أو تعيينها باستخدام /config داخل Claude Code):

{
  "autoUpdatesChannel": "stable"
}

• "latest" (الافتراضي): ستحصل على الميزات الجديدة بمجرد إصدارها
• "stable": يستخدم إصدارًا منذ أسبوع تقريبًا، ويتخطى الإصدارات التي تحتوي على تراجعات كبيرة - اختر هذا إذا كنت تبحث عن الاستقرار

إذا كنت لا تريد التحديث التلقائي، يمكنك تعيين "DISABLE_AUTOUPDATER": "1" في قسم env بملف settings.json (سيوقف هذا فحص الخلفية فقط، وسيظل التحديث اليدوي claude update متاحًا). الإصدارات المثبتة عبر Homebrew / WinGet / apt لا تتحدث تلقائيًا افتراضيًا، ويجب تشغيل أمر الترقية المقابل يدويًا (كما هو مذكور في تلميحات المزالق السابقة).

إلغاء التثبيت

قم بإلغاء التثبيت بناءً على طريقة التثبيت الأصلية الخاصة بك. للتثبيت عبر النص البرمجي الرسمي:

macOS / Linux / WSL:

rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

Windows PowerShell:

Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force

الطرق الأخرى تقابلها أوامرها الخاصة: Homebrew يستخدم brew uninstall --cask claude-code، WinGet يستخدم winget uninstall Anthropic.ClaudeCode، و npm يستخدم npm uninstall -g @anthropic-ai/claude-code.

ملاحظة: تحذف الأوامر المذكورة أعلاه البرنامج نفسه فقط، بينما تظل الإعدادات والتفويضات وسجل المحادثات موجودة في ~/.claude/. إذا كان لا يزال بإمكان claude العمل بعد إلغاء التثبيت، فمن المحتمل أن يكون لديك تثبيت ثانٍ أو اسم مستعار (alias) في الغلاف تُرك من إصدار قديم (سيعلمك القسم 06 كيفية اكتشاف ذلك).

إذا كنت تريد التنظيف بالكامل (هذه الخطوة لا رجعة فيها، وستُفقد جميع الإعدادات / التفويضات / تكوينات MCP / سجلات المحادثة):

# الإعدادات العامة للمستخدم والحالة
rm -rf ~/.claude
rm ~/.claude.json

# الإعدادات المحلية للمشروع الحالي (تُنفذ في مجلد المشروع)
rm -rf .claude
rm -f .mcp.json

تذكير: تقوم إضافات VS Code ومكونات JetBrains وتطبيق سطح المكتب أيضًا بكتابة بيانات في ~/.claude/، وستتم إعادة إنشاء هذا المجلد طالما كانت مثبتة - يجب عليك إلغاء تثبيتها أولاً لحذفه تمامًا.

💡 ملخص في جملة واحدة: الإصدار المثبت بالنص البرمجي الرسمي يعتمد على التحديث التلقائي في الخلفية، ويُطلب التحديث اليدوي عبر claude update؛ اتبع طريقة التثبيت لإلغاء التثبيت، ويجب حذف ملفات التكوين بشكل منفصل، وبمجرد حذفها لا يمكن استعادتها.

---

06 مرجع سريع للأخطاء: المزالق التي يقع فيها 90% من المبتدئين

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

الخطأ الذي تراه	السبب الحقيقي	كيفية الإصلاح
command not found: claude	لم يُضف مجلد التثبيت إلى PATH	أضف ~/.local/bin إلى PATH (انظر أدناه)
syntax error near unexpected token '<'	نص التثبيت أعاد HTML وليس نصًا برمجيًا	في الغالب مشكلة بالشبكة/المنطقة، غيّر إلى Homebrew/WinGet أو أعد المحاولة لاحقًا
irm is not recognized	لقد قمت بتشغيل أمر PowerShell في CMD	بدّل إلى أمر تثبيت CMD، أو افتح PowerShell
'&&' is not valid	لقد قمت بتشغيل أمر CMD في PowerShell	بدّل إلى أمر irm الخاص بـ PowerShell
bash is not recognized	قمت بتشغيل أمر Mac/Linux على Windows	بدّل إلى أمر irm الخاص بـ PowerShell
أثناء تثبيت Linux Killed	الذاكرة غير كافية (القاتل OOM أنهى العملية)	أضف مساحة تبديل (Swap) (انظر أدناه)، يتطلب Claude Code 4GB+ من RAM
Error loading shared library	أخطأ المثبت في تحديد نوع مكتبة libc بالنظام، وسحب المتغير الخاطئ	راجع الاستكشاف الرسمي لمشكلة musl/glibc
بعد تسجيل الدخول 403 Forbidden	الاشتراك غير صالح / الحساب ليس لديه صلاحيات	تحقق من حالة الاشتراك، أو تأكد من أن حساب Console لديه الدور المناسب
App unavailable in region	المنطقة التي تتواجد فيها غير مدعومة	راجع البلدان/المناطق المدعومة

لنستعرض أكثر اثنتين تكرارًا.

الفخ الأول: command not found: claude (الأكثر شيوعًا)

تشغيل claude يفيد بأنه لا يمكن العثور على الأمر - هذا لا يعني أنه لم يتم التثبيت، بل إن مجلد التثبيت لم يُدرج في مسار بحث النظام (PATH).

للتشبيه: PATH هو قائمة العناوين الخاصة بالنظام. البرنامج المثبت يشبه بناء منزل، لكن النظام سيبحث فقط في العناوين المسجلة في "قائمة العناوين" واحدًا تلو الآخر. تم بناء منزل claude في ~/.local/bin/، وهذا العنوان غير مسجل في القائمة، لذلك لا يمكن العثور عليه بطبيعة الحال.

كيفية الإصلاح (الافتراضي في macOS هو Zsh):

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

الافتراضي في Linux غالبًا ما يكون Bash، فقط استبدل ~/.zshrc بـ ~/.bashrc. تحقق بعد التعديل:

claude --version

إذا ظهر رقم الإصدار، فقد تم الإصلاح. أما بالنسبة لمستخدمي Windows، فأضف %USERPROFILE%\.local\bin إلى متغير بيئة PATH الخاص بالمستخدم، ثم أعد تشغيل المحطة الطرفية.

الفخ الثاني: اكتشاف التثبيتات المتعددة "المتعارضة"

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

which -a claude

إذا تم إدراج أكثر من واحد، احتفظ فقط بذلك الخاص بالنص البرمجي الرسمي (~/.local/bin/claude)، واحذف الباقي:

# إزالة التثبيت العام لـ npm
npm uninstall -g @anthropic-ai/claude-code

# حذف التثبيت المحلي لـ npm للإصدارات القديمة
rm -rf ~/.claude/local

في كثير من الأحيان، عند تشغيل which -a claude، ستكتشف أنه تم تثبيت واحد عبر npm وآخر أصلي، وبحذف الخاص بـ npm وترتيب PATH، ستُحل المشكلة فورًا.

💡 ملخص في جملة واحدة: إذا واجهت خطأ، فابحث في الجدول لمعرفة السبب أولاً، ولا تقم بإعادة التثبيت كاستجابة شرطية؛ عدم العثور على الأمر سببه PATH في الغالب، والسلوك الغريب سببه التثبيتات المتعددة المتعارضة، وتشغيل which -a claude سيكشف الحقيقة.

---

07 التطبيق العملي: التشغيل لأول مرة من الصفر

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

الخطوة الأولى، قم بإنشاء مجلد اختبار وادخل إليه، ثم ابدأ تشغيل Claude Code:

mkdir claude-test && cd claude-test
claude

عند التشغيل لأول مرة سيرشدك لتسجيل الدخول (اتبع القسم 04 حتى النهاية)، وبعد تسجيل الدخول سترى واجهة الترحيب.

الخطوة الثانية، اكتب /help في مربع الإدخال لمعرفة الأوامر المتاحة:

/help

المتوقع: ستنبثق قائمة بالأوامر المتاحة ووصف للميزات. مجرد كتابة / ستؤدي أيضًا إلى ظهور الإكمال التلقائي لجميع الأوامر.

الخطوة الثالثة، اجعله يقوم بعمل حقيقي - أعط التعليمات بلغة بسيطة مباشرة (لا حاجة لحفظ تنسيق الأمر):

في ملف test.py، اكتب دالة تطبع hello world

السلوك المتوقع: سيقوم Claude Code أولاً بتقديم الكود المراد تغييره لك كفرق (diff) لتراه، وسينتظر تأكيدك (اختيار نعم) قبل كتابته فعليًا في الملف. سير العمل الأساسي هذا - تقديم اقتراح، انتظار موافقتك، ثم التنفيذ، يضمن عدم تعديل أشيائك خفية.

بعد التأكيد، ستجد ملف test.py جديدًا في المجلد. للخروج:

exit

عند هذه النقطة، تكون قد أكملت بنجاح سير العمل الكامل المتمثل في "التثبيت → تسجيل الدخول → إعطاء التعليمات → تعديله للملف → تأكيدك". في المرة الأولى التي تراه يكتب فيها الكود بنفسه ويتوقف في انتظار إيماءة منك، يعطيك ذلك إحساسًا حقيقيًا بأن "هذا الشيء يمكنه العمل حقًا" - في أول مرة تنجح فيها في تشغيله، ستشعر ببعض الحماس.

تجمع هذه الصورة الخطوات الأربع المذكورة أعلاه في مسار واحد: من بدء تشغيل claude، تسجيل الدخول، مشاهدة الأوامر بـ /help، إعطاء التعليمات بلغة بسيطة، إلى الحلقة الأكثر أهمية - حيث يعرض لك الـ diff أولاً وينتظر إيماءة منك (نعم) قبل كتابة الملف؛ وإذا قلت لا سيمتنع عن الكتابة، ويقوم بالتعديل لتجربة جولة أخرى، دون تعديل أشيائك سرًا طوال العملية.

💡 ملخص في جملة واحدة: يمكنك تشغيل سير العمل الكامل عن طريق إنشاء مجلد فارغ - تشغيل claude لتسجيل الدخول، /help لمشاهدة الأوامر، إعطاء تعليمات بلغة بسيطة، مشاهدة diff واختيار نعم، يمثل إيقاع "تقديم الحلول قبل العمل" هذا جوهر أدائه.

---

08 ملخص

لقد استعرض هذا المقال خطوة "التثبيت والتشغيل" بالكامل:

• تأكد من 3 أشياء قبل التثبيت: إصدار النظام كافٍ، الحساب فئة مدفوعة أو Console، طريقة الاستخدام اختر CLI.
• اعتمد على النص البرمجي الرسمي: استخدم curl لـ Mac/Linux/WSL، ولـ Windows ميز بين PowerShell (irm) و CMD؛ npm هو أسوأ خيار، ولا تستخدم sudo أبدًا.
• للتحقق استخدم claude --version، وللفحص الطبي استخدم claude doctor؛ إذا أبلغ تسجيل الدخول عن تعطيل المؤسسة فتحقق أولاً من أي ANTHROPIC_API_KEY متبقي.
• إذا واجهت خطأ ابحث في الجدول لمعرفة السبب أولاً: إذا لم تجد الأمر فتحقق من PATH، وإذا كان السلوك غريبًا فتحقق من التثبيتات المتعددة.

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

المقال التالي 03 · كيف يعمل Claude Code - سيكشف الغطاء للنظر في الداخل: كيف تحولت جملتك "اكتب دالة hello world" للتو من جملة واحدة إلى تعديل ملف دقيق؟ تكمن وراء ذلك آلية تسمى "حلقة الوكيل" (agent loop)، فبفهمها فقط يمكنك أن تقول إنك تعرف حقًا كيفية استخدام Claude Code، بدلاً من مجرد كتابة الأوامر.

سؤال للتفكير: عندما طلبت منه لتوه كتابة test.py، هل قام أولاً بالنظر إلى الملفات الموجودة في المجلد، أم قام بالكتابة مباشرة؟ هذا الاختلاف، هو بالضبط نقطة البداية للمقال التالي.

---

بمجرد تثبيته، فأنت تمتلك الأداة فقط، والقدرة الحقيقية تكمن في فهم "طريقة تفكيره" - نلتقي في المقال التالي.

---

قراءة موصى بها

• الإضافات (Plugins): حزم مجموعة من الإعدادات المتفرقة بنقرة واحدة
• دليل الإضافات المرجعي: قم بحزم إعداداتك الخاصة في حزمة جاهزة للإرسال
• تكوين التطوير: ضبط "بيئة العمل" التي يعمل فيها Claude