طرق التثبيت البديلة: npm وHomebrew وWinGet ونسخة WorkBuddy لسطح المكتب
أنهى الدرس السابق المسار الرئيسي للتثبيت الأصلي الموصى به رسميًا؛ وفي هذا الدرس الذي يستغرق 8 دقائق نُكمل سلسلة التثبيت: نشرح دفعة واحدة الطرق البديلة الثلاث عبر مديري الحزم npm وHomebrew وWinGet — الأوامر والمفاضلات وكيفية التحديث؛ ثم نقدم لمن لا يريدون مطلقًا التعامل مع سطر الأوامر مسارًا بديلًا: نسخة WorkBuddy لسطح المكتب، بالتنزيل والتثبيت وتسجيل الدخول بمسح رمز WeChat، ويمكن إتمام كل ذلك بالنقر بالفأرة.
لنثبّت أولًا حقيقة واحدة: حزمة npm تحتوي على نفس الملف الثنائي الذي يثبّته التثبيت الأصلي، وليست سكربتًا يعمل على Node؛ وبعد التثبيت بأي من الطرق تكون طريقة التحقق واحدة تمامًا. الاختلاف فقط في «كيفية التثبيت والتحديث» — فكّر أولًا في ما تريده، ثم اختر مسارًا. (وقت التحقق من الحقائق 2026-11-04؛ الأوامر والإصدارات قد تتغير، والمرجع هو الوثائق الرسمية.)
ماذا ستستطيع أن تفعل بعد إتمام الدرس
- إكمال تثبيت Claude Code عبر npm بأمر
npm install -gواحد، وترقيته بالأمر الصحيح (مع تجنّب فخnpm update -g) - تثبيت Claude Code باستخدام Homebrew / WinGet، والتمييز بين قناتي الإصدار
claude-codeوclaude-code@latest - شرح قواعد التحديث لكل من طرق التثبيت الأربع: أيها يتحدث تلقائيًا وأيها يتطلب
brew upgrade/winget upgradeيدويًا - إكمال تنزيل WorkBuddy وتثبيته (Windows / macOS) وتسجيل الدخول بمسح رمز WeChat، دون لمس سطر الأوامر إطلاقًا
- تحديد ما إذا كان عليك البقاء على المسار الرئيسي للتثبيت الأصلي من الدرس السابق، أم التحويل إلى إحدى الطرق البديلة
مأزقك الحالي
- فشل أمر التثبيت الأصلي من الدرس السابق، أو أنك لا تريد إضافة «سكربت تثبيت مجهول المصدر» إلى نظامك — وتريد إدارة البرامج بشكل موحد عبر مدير الحزم المألوف لديك
- لديك Node.js مثبّت بالفعل: اعتدت على
npm install -g، فهل يمكن تثبيت Claude Code بالطريقة نفسها؟ وكيف ترقيه بعد التثبيت؟ - لا تريد مطلقًا التعامل مع الطرفية: مجرد رؤية سطر الأوامر يصيبك بالصداع، وتريد فقط تنزيل برنامج سطح مكتب والنقر على «التالي» بضع مرات لتبدأ الاستخدام
متى تستخدم هذه الطريقة
عندما تحتاج إلى:
- تثبيت وإدارة Claude Code عبر مدير الحزم المألوف لديك (npm / Homebrew / WinGet)
- إعادة المحاولة عبر قناة بديلة تدعمها الجهة الرسمية أيضًا عند فشل التثبيت الأصلي
- مسار بديل بدون أي أوامر سطرية: برنامج سطح مكتب + مسح رمز WeChat، يُثبَّت ويُسجَّل الدخول خلال دقائق
ولا تريد:
- تجربة كل طريقة واحدة تلو الأخرى، فينتهي بك الأمر بعدة نسخ من Claude Code متعارضة تتراكب في نظامك
- إهمال التحديث بعد التثبيت والبقاء على نسخة قديمة بها مشكلات معروفة
- تعلم الطرفية وإعدادات shell لمدة نصف يوم فقط لتثبيت أداة برمجة بالذكاء الاصطناعي
🎒 الاستعدادات قبل البدء
- قراءة الدرس السابق تثبيت Claude Code: من ثبّتوا البرنامج بالفعل يمكنهم تخطي جزء Claude Code في هذا الدرس والانتقال مباشرة إلى نسخة WorkBuddy لسطح المكتب في الخطوة 5
- جزء Claude Code: متطلبات الحساب والنظام هي نفسها كما في الدرس السابق (اشتراك Claude أو حساب Console؛ macOS 13.0+ / Windows 10 1809+ / Ubuntu 20.04+، وبحد أدنى 4 GB من الذاكرة)
- لمن يسلك طريقة npm: تثبيت Node.js 22 أو أحدث (شغّل
node --versionفي الطرفية للتحقق؛ من كانت نتيجةnpm --versionلديهم تبدأ بـ12فعليهم مراجعة فحص الإصدار في الخطوة 1) - لمن يسلك طريقة Homebrew: أن يكون Homebrew مثبّتًا على الجهاز وأن يعمل أمر
brewفي الطرفية - لمن يسلك طريقة WinGet: أن يعمل أمر
wingetفي الطرفية على Windows - لمن يسلك نسخة WorkBuddy لسطح المكتب: Windows 10 أو أحدث (x64) أو macOS 12 أو أحدث؛ وأن يكون WeChat على الهاتف قادرًا على مسح الرموز
الفكرة الأساسية
الطرق البديلة الأربع في جدول واحد واضح، حدّد وضعك أولًا ثم ابدأ:
| طريقة التثبيت | أمر واحد | المنصة | كيفية التحديث بعد التثبيت | لمن تناسب |
|---|---|---|---|---|
| npm (الخيار الرئيسي في هذا الدرس) | npm install -g @anthropic-ai/claude-code | macOS / Linux / Windows (يتطلب Node.js 22+) | تحديث تلقائي (بشرط عدم استخدام sudo وقابلية الكتابة في الدليل العام)؛ الترقية اليدوية npm install -g @anthropic-ai/claude-code@latest | من لديهم سلسلة أدوات Node.js بالفعل |
| Homebrew | brew install --cask claude-code | macOS | لا يتحدث تلقائيًا؛ brew upgrade claude-code للترقية اليدوية | من اعتادوا إدارة البرامج عبر brew على Mac |
| WinGet | winget install Anthropic.ClaudeCode | Windows | لا يتحدث تلقائيًا؛winget upgrade Anthropic.ClaudeCode للترقية الدورية | من اعتاد على إدارة البرامج عبر WinGet على Windows |
| WorkBuddy نسخة سطح المكتب | حمّل حزمة التثبيت من الموقع الرسمي workbuddy.cn | Windows 10+ (x64) / macOS 12+ (توجد أيضًا متاجر UOS وKylin) | «التحقق من التحديثات» داخل العميل | لا تريد لمس سطر الأوامر إطلاقًا |
قبل البدء، تذكّر ثلاث نقاط أساسية:
- ما يثبّته npm هو أيضًا «ثنائي أصلي». تنص الوثائق الرسمية صراحةً: حزمة npm تُجلب عبر تبعيات اختيارية مرتبطة بالمنصة (مثل
@anthropic-ai/claude-code-darwin-arm64)، وهي نفس الثنائي الأصلي الذي يثبّته المثبّت المستقل؛ ووقت التشغيلclaudeالناتج لا يستدعي Node إطلاقًا. لا تقلق بشأن «هل نسخة npm نسخة منقوصة؟» — ليست كذلك. - قواعد التحديث هي محور هذا الدرس. التثبيت الأصلي يتحدّث تلقائيًا في الخلفية؛ وطريقة npm تدعم التحديث التلقائي أيضًا، لكن بشرط ألا تكون استخدمت
sudoعند التثبيت وأن يكون دليل npm العام قابلًا للكتابة؛ أما Homebrew وWinGet وapt/dnf/apk فتتطلب الترقية يدويًا افتراضيًا. التثبيت دون تحديث = تفويت ميزات جديدة وإصلاحات أمنية. - WorkBuddy ليس «واجهة» لـ Claude Code. بل هو منتج مستقل آخر من Tencent: منصة عمل ذكاء اصطناعي لسطح المكتب، تستطيع كتابة الأكواد وقراءة المشاريع وتطوير المواقع والتطبيقات؛ تسجيل الدخول بمسح رمز WeChat، ونظام الحسابات مختلف تمامًا عن Claude Code. هو يحل مشكلة «صفر سطر أوامر»، وليس مشكلة «استخدام Claude مجانًا» — أمران مختلفان، لا تخلط بينهما.
💡 هل تخلط بين WorkBuddy وClaude Code نسخة سطح المكتب؟
Claude Code لديه أيضًا تطبيق سطح مكتب رسمي (بواجهة رسومية، دون فتح الطرفية)، وتوفر الشركة الرسمية تنزيلات لـ macOS وWindows وLinux؛ أما WorkBuddy فهو منتج مستقل من Tencent. الخطوتان 5 و6 في هذا الدرس تتحدثان عن WorkBuddy؛ أما أشكال Claude Code المختلفة فتُفصَّل في استخدام Claude Code.
اتبع خطواتي
حدّد أولًا فئة أدواتك: لديك Node.js ← الخطوة 1؛ مستخدمو Mac ← الخطوة 2؛ مستخدمو Windows ← الخطوة 3؛ لا تريد لمس أي منها ← الخطوتان 5 و6. يُنصح الجميع بالاطلاع على الخطوة 4 (قواعد التحديث).
الخطوة 1: إتمام تثبيت Claude Code عبر npm باستخدام npm install -g
لماذا: npm هي القناة الاحتياطية الموصى بها في هذا الدرس: أمر واحد يكفي للتثبيت، وتنتج نفس الثنائي الذي ينتجه التثبيت الأصلي، وتدعم التحديث التلقائي — بشرط ألا تستخدم sudo.
تأكد أولًا من إصدار Node.js (تتطلب حزمة npm إصدار Node.js 22 أو أحدث):
node --versionيجب أن ترى: v22 أو رقم إصدار أحدث. عندما يكون إصدار Node قديمًا، يطبع npm تحذير EBADENGINE — سيكتمل التثبيت رغم ذلك وسيعمل claude كالمعتاد (لأن الحزمة تنزّل ثنائيًا أصليًا لا يعتمد على Node المثبت على جهازك)، لكن يُنصح مع ذلك بترقية Node إلى 22+ قبل التثبيت.
وتأكد أيضًا من إصدار npm نفسه:
npm --versionيجب أن ترى: رقم إصدار. إذا كان يبدأ بـ 12، فلا تثبّت بالقوة بعد — إصدار npm 12 يعاني من مشكلات تثبيت معروفة، فعالجها وفق الوثيقة الرسمية Fix an npm 12 install، أو راجع ماذا أفعل إذا فشل التثبيت للعثور على حالتك، ثم عد للتثبيت.
ثم ثبّت (دون إضافة sudo):
npm install -g @anthropic-ai/claude-codeيجب أن ترى: يكمل npm التثبيت بشكل طبيعي دون أخطاء. افتح نافذة طرفية جديدة وشغّل claude --version، فسيطبع رقم الإصدار + (Claude Code) — تمامًا كطريقة التحقق في الدرس السابق.
للترقية لاحقًا استخدم هذا (لا تستخدم npm update -g، والسبب في «تنبيهات المخاطر»):
npm install -g @anthropic-ai/claude-code@latestالمنصات التي تدعمها قناة npm: darwin-arm64، darwin-x64، linux-x64، linux-arm64، linux-x64-musl، linux-arm64-musl، win32-x64، win32-arm64؛ ويجب أن يسمح مدير الحزم لديك بـ«التبعيات الاختيارية». إذا لم تجد أمر claude بعد التثبيت، راجع ماذا أفعل إذا فشل التثبيت للعثور على حالتك.
- تحقق سريع:
claude --versionطبع رقم إصدار يتضمن(Claude Code)، ولم أستخدمsudoعند التثبيت
الخطوة 2: تثبيت Claude Code عبر Homebrew (لمستخدمي macOS)
لماذا: من اعتاد على brew لإدارة البرامج على Mac يمكنه إسناد Claude Code أيضًا إلى brew للإدارة الموحدة — لكن brew بعد التثبيتلا يتحدث تلقائيًا، بل يجب الترقية يدويًا.
يوفر Homebrew حزمتين (cask)، اختر واحدة أولًا:
| cask | القناة التابعة لها | الخصائص |
|---|---|---|
claude-code | stable الإصدار المستقر | يتأخر عادةً عن أحدث إصدار بنحو أسبوع، ويتخطى الإصدارات ذات مشكلات التراجع الكبرى |
claude-code@latest | latest أحدث إصدار | يواكب الإصدارات الجديدة فور صدورها |
يختار معظم الناس الإصدار المستقر:
brew install --cask claude-codeيجب أن ترى: يكمل brew عملية التثبيت. افتح طرفية جديدة وشغّل claude --version للتحقق.
للترقية لاحقًا (نفّذ upgrade للحزمة التي ثبّتها):
brew upgrade claude-code
# 装了 latest 通道的用:
brew upgrade claude-code@latest- تحقق سريع: أعرف أي حزمة (cask) ثبّتها، وأتذكّر أن brew لا يتحدث تلقائيًا
الخطوة 3: تثبيت Claude Code عبر WinGet (لمستخدمي Windows)
لماذا: من يستخدم WinGet لإدارة البرامج على Windows يثبّت أيضًا بأمر واحد — وبالمثل بعد التثبيتلا يتحدث تلقائيًا، بل يجب الترقية يدويًا بشكل دوري.
شغّل في PowerShell:
winget install Anthropic.ClaudeCodeيجب أن ترى: يكمل WinGet عملية التنزيل والتثبيت. افتح طرفية جديدة وشغّل claude --version للتحقق.
للترقية الدورية لاحقًا:
winget upgrade Anthropic.ClaudeCodeملاحظة: عندما يكون Claude Code قيد التشغيل، يقوم Windows بقفل ملفه التنفيذي، وقد تفشل الترقية حينها — اخرج من Claude Code أولًا ثم رقِّ.
- تحقق سريع:
claude --versionطبع رقم الإصدار؛ وتذكّرت أن أمر الترقية هوwinget upgrade
الخطوة 4: التحقق من التثبيت وفهم قواعد تحديث Claude Code
لماذا: طريقة التحقق من claude موحّدة مهما كانت طريقة التثبيت؛ لكنقواعد التحديث تختلف من طريقة لأخرى — أول شيء بعد التثبيت هو توضيح «من يدير تثبيتي وكيف أرقّيه».
التحقق (افتح طرفية جديدة):
claude --versionيجب أن ترى: رقم الإصدار + (Claude Code)، مثل 2.1.211 (Claude Code).
للاطلاع على حالة التثبيت الصحية، قم بتشغيل تشخيص للقراءة فقط مرة أخرى:
claude doctorيجب أن ترى: معلومات تشخيصية حول التثبيت والتكوين — بما في ذلك نتيجة آخر تحديث تلقائي، مع اقتراحات لإصلاح المشكلات إن وُجدت.
جدول مطابقة قواعد التحديث:
| طريقة التثبيت لديك | تحديث تلقائي؟ | أمر الترقية اليدوية |
|---|---|---|
| التثبيت الأصلي (الدرس السابق) | ✅ تحديث تلقائي في الخلفية | claude update (تطبيق التحديث فورًا) |
| npm | ✅ يمكنه التحديث تلقائيًا (بشرط: أن يكون الدليل العام قابلًا للكتابة، وألا تستخدم sudo) | npm install -g @anthropic-ai/claude-code@latest |
| Homebrew | ❌ لا يتم التحديث تلقائيًا افتراضيًا | brew upgrade claude-code (أو claude-code@latest) |
| WinGet | ❌ لا يتم التحديث تلقائيًا افتراضيًا | winget upgrade Anthropic.ClaudeCode |
نقطة قد تسبب الالتباس: بالنسبة للتثبيتات المُدارة عبر Homebrew / WinGet، فإن تشغيل claude update سيُظهر Claude is up to date! — لهذا النوع من التثبيتات، يجب أن تتم التحديثات عبر مدير الحزم، فاستخدم الأمر المقابل في الجدول أعلاه للترقية.
- فحص صغير: أستطيع أن أقول لطريقة التثبيت الخاصة بي «من يدير التحديثات»، وكذلك أمر الترقية اليدوية المقابل
الخطوة 5: WorkBuddy التنزيل والتثبيت — مسار بدون أي سطر أوامر
لماذا: لمن لا يريد التعامل مع الطرفية إطلاقًا، هذا المسار يتم بالنقر بالفأرة من البداية إلى النهاية: تنزيل حزمة التثبيت من الموقع الرسمي → تثبيت بالنقر المزدوج → تسجيل الدخول بمسح رمز WeChat. WorkBuddy هو منصة عمل ذكاء اصطناعي لسطح المكتب من إنتاج Tencent، وتغطي أيضًا سيناريوهات التطوير مثل كتابة الأكواد وقراءة المشاريع وتطوير المواقع والتطبيقات.
تحقق أولًا من متطلبات النظام:
| النظام | المتطلبات |
|---|---|
| Windows | Windows 10 وما فوق، x64؛ لا يدعم Windows 7/8/8.1 (حالة دعم أجهزة ARM64 تخضع لوصف الإصدار الحالي) |
| macOS | macOS 12 (Monterey) وما فوق |
| UOS الموحدة / Kylin المجرة | التثبيت عبر البحث في متجر التطبيقات / متجر البرامج الخاص بالنظام (يدعم UOS بنية x86_64 و ARM64؛ أما Kylin فالإصدار المكتبي V10) |
الأنظمة التي لا تستوفي المتطلبات لا يمكنها تشغيل WorkBuddy — قم بترقية النظام أولًا ثم التثبيت.
لمستخدمي Windows
- قم بزيارة موقع WorkBuddy الرسمي، وانقر على «تنزيل الآن»، واختر Windows، ثم نزّل حزمة التثبيت
- بعد اكتمال التنزيل، انقر نقرًا مزدوجًا على حزمة التثبيت لتشغيل برنامج التثبيت
- ضع علامة على «أوافق على هذا الاتفاق»، ثم انقر على التالي
- اختر مسار التثبيت (يمكن النقر مباشرة على التالي للمسار الافتراضي)
- أكّد مجلد قائمة ابدأ، ثم انقر على التالي
- يُنصح بوضع علامة على «إنشاء اختصار على سطح المكتب»، ثم انقر على التالي
- تأكد من صحة التكوين وانقر على تثبيت؛ وبعد الاكتمال انقر على «إنهاء» للخروج من معالج التثبيت
يجب أن ترى: ظهور اختصار WorkBuddy على سطح المكتب، وأنه يعمل بالنقر المزدوج.
لمستخدمي macOS
- قم بزيارة موقع WorkBuddy الرسمي، وانقر على «تنزيل الآن»، واختر إصدار Mac — لرقاقات سلسلة M اختر Mac ARM64، ولرقاقات Intel اختر Mac X64؛ إذا لم يتعرف الموقع الرسمي على جهازك، فإنه يوفر افتراضيًا إصدار X64 (يمكنه العمل على سلسلة M عبر Rosetta، وبالتالي توافق أوسع). إذا كنت لا تعرف رقاقتك، انقر على أيقونة التفاحة في أعلى يسار الشاشة → «حول هذا الـ Mac» للتحقق
- اسمح بالتنزيل في النافذة المنبثقة للمتصفح، وانتظر حتى اكتمال تنزيل حزمة التثبيت
- انقر نقرًا مزدوجًا على ملف
.dmgالذي تم تنزيله لفتح نافذة التثبيت - اسحب أيقونة WorkBuddy إلى مجلد Applications (التطبيقات) — لا يمكن تخطي هذه الخطوة، والسبب موضح في «تنبيهات المخاطر»
- انتظر حتى يكتمل النسخ، ثم أخرج صورة القرص WorkBuddy المُحمّلة؛ ويمكنك حذف حزمة تثبيت
.dmgإذا لم تعد بحاجة إليها
يجب أن ترى: إمكانية العثور على WorkBuddy في Launchpad (أو عبر بحث Command + 空格)، وأنه يعمل من مجلد «التطبيقات».
- فحص صغير: WorkBuddy يعمل من مجلد «التطبيقات» (أما على Windows فمن قائمة ابدأ / اختصار سطح المكتب)، وليس مباشرة من داخل حزمة التثبيت
الخطوة 6: تسجيل الدخول إلى WorkBuddy بمسح رمز WeChat، والتأكد من إمكانية التحديث
لماذا: التثبيت ليس سوى نصف الطريق — تسجيل الدخول والتأكد من عمل قناة التحديث بشكل سليم هو ما يجعله «قابلًا للاستخدام».
- شغّل WorkBuddy، وانقر على زر تسجيل الدخول
- يفتح المتصفح تلقائيًا صفحة تسجيل الدخول في الموقع الرسمي؛ ضع علامة على «اتفاقية خدمة المستخدم» و«سياسة الخصوصية» في النافذة المنبثقة
- أكمل تسجيل الدخول بمسح رمز WeChat؛ وتُدعم أيضًا طرق مثل رقم الهاتف والبريد الإلكتروني وSSO، وكل ذلك يتم في الصفحة الحالية دون الحاجة إلى الانتقال
- بعد أن تعرض الصفحة نجاح تسجيل الدخول، ارجع إلى العميل
يجب أن ترى: دخول العميل إلى الواجهة الرئيسية، وإمكانية «إنشاء مهمة» جديدة.
للتأكد من قناة التحديث: انقر على الصورة الرمزية في أسفل اليسار → «التحقق من التحديثات». إذا كانت لديك أحدث إصدار فلا حاجة لأي إجراء؛ وعند توفر إصدار جديد سيقوم النظام بتنزيله وإتمام الترقية تلقائيًا.
(على Mac، إذا ظهرت رسالة تفيد بعدم إمكانية التحديث التلقائي، فهذا يعني أن WorkBuddy يعمل مباشرة من صورة القرص .dmg — انقر على «نقل إلى التطبيقات» حسب الرسالة، أو اسحبه يدويًا إلى مجلد «التطبيقات»، ثم أعد تشغيله من هناك.)
التكلفة في سطر واحد: WorkBuddy يتوفر لديه إصدار تجريبي مجاني (500 نقطة/شهر)، ولمستويات الدفع وقواعد النقاط راجع مقارنة الأسعار و WorkBuddy طريقة الاستخدام.
- فحص صغير: نجاح تسجيل الدخول بمسح رمز WeChat، وقدرة العميل على الفتح بشكل طبيعي؛ و«التحقق من التحديثات» يستجيب بشكل سليم
نقاط التحقق ✅
- ثبّتُّ Claude Code بنجاح عبر إحدى الطرق npm / Homebrew / WinGet، و
claude --versionيطبع رقم الإصدار +(Claude Code) - طريقة npm: لم أستخدم
sudo npm install -g؛ والترقية تتم بـnpm install -g @anthropic-ai/claude-code@latest، وليس بـnpm update -g - طريقة Homebrew / WinGet: أعلم أنه لا يتم التحديث تلقائيًا بعد التثبيت، وقد حفظت أوامر الترقية
brew upgrade/winget upgrade - تم تثبيت WorkBuddy لسطح المكتب بنجاح مع نجاح تسجيل الدخول بمسح رمز WeChat؛ وعلى Mac يعمل من مجلد «التطبيقات»
- أستطيع أن أقول لطريقة التثبيت الحالية لدي «من يدير التحديثات»، وعند حدوث خطأ أعرف مراجعة ماذا أفعل إذا فشل التثبيت للفحص السريع
تنبيهات المخاطر
❌ استخدام sudo npm install -g لتثبيت
توثيق رسمي يحذر بوضوح: لا تستخدم sudo لتثبيت الحزم العامة — فهذا يجلب مشاكل صلاحيات ومخاطر أمنية؛ كما أن Claude Code عند تحديث نفسه** يشغّل npm بدون sudo**، لذا لا يمكن للتثبيت المثبّت بـ sudo أن يُحدَّث تلقائيًا.
الطريقة الصحيحة: احذف sudo وثبّت مباشرة. إذا واجهت خطأ صلاحيات (دليل npm العام غير قابل للكتابة)، راجع ماذا تفعل إذا فشل التثبيت وعالج الحالة المقابلة، ولا تلجأ إلى sudo بالقوة.
❌ ترقية Claude Code باستخدام npm update -g
npm update -g يتبع نطاق إصدارات semver كما كان عند التثبيت الأول، وقد لا يصل بك إلى أحدث إصدار.
الطريقة الصحيحة:
# ❌ 可能升不到最新
npm update -g
# ✅ 明确指定装最新版
npm install -g @anthropic-ai/claude-code@latest❌ الاعتقاد بأن Homebrew / WinGet سيحدّثان تلقائيًا بعد التثبيت
لا. كلتا الطريقتين تتطلبان الترقية يدويًا افتراضيًا (brew upgrade claude-code / winget upgrade Anthropic.ClaudeCode). تذكيران إضافيان:
- لا تقلق فورًا إذا فشلت الترقية: قد يخبرك Claude Code بوجود تحديث قبل أن يتوفر الإصدار الجديد في مدير الحزم — تسميه الوثائق الرسمية مشكلة معروفة، فما عليك سوى المحاولة لاحقًا. وعند الترقية عبر WinGet، إذا كان Claude Code قيد التشغيل، فإن قيام Windows بقفل الملف التنفيذي يسبب الفشل أيضًا، فاخرج منه أولًا ثم رقِّ.
- يترك brew الإصدارات القديمة تشغل مساحة القرص: بعد ترقية Homebrew تبقى الإصدارات القديمة على القرص، وتوصي الوثائق الرسمية بتشغيل
brew cleanupبانتظام لاستعادة المساحة.
❌ تشغيل WorkBuddy مباشرة بالنقر المزدوج على .dmg على Mac
عند التشغيل مباشرة من صورة القرص، يعمل WorkBuddy على صورة للقراءة فقط، ولا يمكنه التحديث تلقائيًا لاحقًا.
الطريقة الصحيحة: اسحب WorkBuddy إلى مجلد «التطبيقات» أولًا ثم شغّله. من وقع في هذا الخطأ لا يحتاج إلى إعادة التثبيت — انقر زر «النقل إلى التطبيقات» في إشعار التحديث، أو اسحبه يدويًا، ثم أعد التشغيل من «التطبيقات».
نصائح متقدمة (اختيارية)
دع Claude Code يشغّل أمر الترقية نيابةً عنك. يمكن لمستخدمي Homebrew / WinGet الضبط في settings.json:
{
"env": {
"CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE": "1"
}
}بعدها عندما يكتشف Claude Code إصدارًا جديدًا، ينفّذ أمر الترقية المقابل في الخلفية نيابةً عنك — يتعامل مع حزمة Claude Code وحدها فقط، دون التأثير على برامجك الأخرى المثبتة. أما على WinGet، إذا كان Claude Code قيد التشغيل وقت الترقية، فسيعرض بدلًا من ذلك أمرًا يدويًا لتنسخه وتنفّذه.
مستخدمو Linux: apt / dnf / apk. يمكن لمستخدمي Debian/Ubuntu وFedora/RHEL وAlpine تثبيت Claude Code من مستودعات Anthropic الموقّعة، وبنفس القناتين stable (متأخرة بحوالي أسبوع) وlatest، وتتم الترقية عبر مدير حزم النظام (مثل sudo apt update && sudo apt upgrade claude-code) — الأوامر الكاملة في الوثائق الرسمية Install with Linux package managers.
مستخدمو الأنظمة الصينية. يُوزَّع WorkBuddy عبر متجر النظام على UOS وKylin: على UOS افتح متجر التطبيقات المدمج في النظام، وعلى Kylin افتح متجر البرامج في شريط المهام، ثم ابحث عن WorkBuddy وانقر لتثبيته؛ وتتم التحديثات أيضًا داخل المتجر.
WorkBuddy لغة الواجهة. عند الحاجة إلى تغيير اللغة: الصورة الرمزية أسفل اليسار ← الإعدادات ← عام ← اللغة.
خلاصة هذا الدرس
✅ Claude Code تثبيت npm = npm install -g @anthropic-ai/claude-code (بدون sudo)، والترقية بـ npm install -g @anthropic-ai/claude-code@latest؛ حزمة npm تحتوي أيضًا على ملف ثنائي أصلي، والـ claude الناتج عنها لا يعتمد على Node عند التشغيل.
✅ اثنان من casks في Homebrew: claude-code (stable، متأخرة بحوالي أسبوع) / claude-code@latest (الأحدث)؛ وأمر واحد في WinGet: winget install Anthropic.ClaudeCode. كلاهما لا يُحدَّث تلقائيًا بعد التثبيت، ويجب الترقية يدويًا بـ brew upgrade / winget upgrade.
✅ قواعد التحديث على ثلاث درجات: التثبيت الأصلي يُحدَّث تلقائيًا في الخلفية؛ npm يمكنه التحديث تلقائيًا (بشرط: عدم استخدام sudo وأن يكون الدليل العام قابلًا للكتابة)؛ Homebrew / WinGet / apt / dnf / apk يدوي افتراضيًا. يمكنك استخدام claude doctor للاطلاع على حالة صحة التثبيت ونتيجة آخر تحديث.
✅ WorkBuddy نسخة سطح المكتب = مسار بلا سطر أوامر: نزّلها من الموقع الرسمي workbuddy.cn ← تثبيت بالنقر المزدوج على Windows / السحب إلى «التطبيقات» على Mac ← تسجيل الدخول بمسح رمز WeChat؛ التحديث في العميل عبر «الصورة الرمزية أسفل اليسار ← التحقق من التحديثات».
✅ الاختيار في سطر واحد: لديك أدوات Node ← npm؛ مستخدم Mac ← Homebrew؛ مستخدم Windows ← WinGet؛ لا تريد لمس سطر الأوامر ← WorkBuddy؛ لا تريد أي عناء ← عد إلى خط التثبيت الأصلي الرئيسي في الدرس السابق.
مراجعة الأوامر الأساسية:
| الأمر | الوظيفة | يناسب |
|---|---|---|
npm install -g @anthropic-ai/claude-code | تثبيت npm لـ Claude Code | Node.js 22+، جميع المنصات |
npm install -g @anthropic-ai/claude-code@latest | ترقية npm إلى أحدث إصدار | مستخدمو التثبيت عبر npm |
brew install --cask claude-code | تثبيت Homebrew (قناة stable) | macOS |
brew upgrade claude-code | ترقية يدوية عبر Homebrew | مستخدمو التثبيت عبر Homebrew |
winget install Anthropic.ClaudeCode | تثبيت WinGet | Windows |
winget upgrade Anthropic.ClaudeCode | ترقية يدوية عبر WinGet | مستخدمو التثبيت عبر WinGet |
claude --version / claude doctor | التحقق من التثبيت / تشخيص للقراءة فقط | جميع المنصات |
استعراض الدرس القادم
كلما تعددت طرق التثبيت، تعددت أشكال الأخطاء. في الدرس القادم ماذا تفعل إذا فشل التثبيت: استكشاف أخطاء البداية وإصلاحها في 60 ثانية.
ستتعلم:
- طريقة الإصلاح في 60 ثانية لـ
command not found/'claude' is not recognized(غالبًا ما يكون PATH غير مضبوط) - كيفية التعامل مع أخطاء صلاحيات npm ومشاكل التثبيت عبر npm 12
- ماذا تتحقق منه أولًا عند نجاح التثبيت لكن ظهور خطأ عند التشغيل أو تعثّر تسجيل الدخول
- الأخطاء التي تشير إلى وجوب إعادة المحاولة عبر قناة تثبيت أخرى