كيف تُحدِّث Claude Code (وكيف تُصلح تحديثًا لا يُطبَّق)
أمر claude update، والتحقق من الإصدار، والتحديث عبر مديري الحزم، وكل واجهة تُحدَّث على حدة — بلقطات من العرض الرسمي.
باختصار
- التثبيت الأصلي (سكربت curl أو PowerShell) يُحدِّث Claude Code تلقائيًا في الخلفية — كل ما عليك إعادة التشغيل لتطبيقه.
- تحتاجه الآن؟ شغّل claude update. وفي تثبيتات مديري الحزم استخدم brew upgrade claude-code أو winget upgrade Anthropic.ClaudeCode.
- تحقّق من إصدارك عبر claude --version؛ وأمر claude doctor يعرض نتيجة آخر محاولة تحديث.
- الميزات الجديدة تصل الطرفية أولًا، أما إضافات IDE وتطبيق سطح المكتب والويب فلكلٍّ منها إيقاع تحديث خاص.
Installing Claude Code (official walkthrough)
القناة: Claude — official YouTube channel3:02
Claude Code Plugins Explained In 7 Minutes
القناة: Software Engineer Meets AI7:21
Set up Claude Code — official docs (updates & channels)
الوثائق: code.claude.com/docs
اللقطات من العرض الرسمي ومن تسجيل شاشة نظيف؛ ونص الخطوات يتبع وثائق الإعداد الرسمية.
تبقى لقطات الشاشة ملكًا لأصحابها، ويرافق كل خطوة رابط يعيدك إلى اللحظة الدقيقة في الفيديو الأصلي.
تحديث Claude Code خطوة بخطوة
تحديث واجهة الأوامر
- 1
تأكد أنك على التثبيت الأصلي
سكربتا curl وPowerShell يثبّتان النسخة الأصلية التي تُحدِّث نفسها في الخلفية — الفحص عند بدء التشغيل وبين الحين والآخر أثناء العمل. إذا جاءت نسختك من Homebrew أو WinGet أو apt أو npm فالتحديث التلقائي معطّل، وتوجه إلى الخطوة 7.
ينتهي المُثبِّت الأصلي بعرض الإصدار ومسار التثبيت داخل الطرفية مباشرة.شاهد من 0:23 - 2
تحديث فوري: شغّل claude update
في أي طرفية، يجلب claude update أحدث نسخة في الحال. عند النجاح يُخبرك بالإصدار الذي غادرتَه والإصدار الذي وصلتَ إليه؛ وإن لم يوجد أحدث فسيقول ببساطة إنك على آخر إصدار.
- 3
تحقّق من الإصدار الذي تستخدمه
يعرض claude --version رقم البناء الدقيق، مثل 2.1.211. ويُظهر شريط بدء كل جلسة الإصدار نفسه بجانب الموديل، فنظرة واحدة تكفي غالبًا.
شريط الجلسة يذكر الإصدار الجاري — هنا v2.1.87 على Sonnet 4.6.شاهد من 5:31 - 4
فشل صامت؟ شخّصه بأمر claude doctor
إذا بدا التحديث التلقائي عالقًا، يطبع claude doctor تشخيصًا يشمل نتيجة آخر محاولة تحديث. وهو أيضًا أول ما تجريه عندما يكون مجلد npm العام غير قابل للكتابة — السبب الكلاسيكي لفشل التحديثات.
اختر قناة التحديث المناسبة
- 5
اعرف أي واجهة تصلها الميزات أولًا
تصل الميزات الجديدة إلى الطرفية أولًا، وتليها تكاملات IDE عن قرب، ثم سطح المكتب والويب. تلاحق ميزة أُعلنت هذا الأسبوع؟ حدّث واجهة الأوامر واعمل منها.
يقارن العرض الرسمي بين الطرفية وIDE وسطح المكتب والويب جنبًا إلى جنب.شاهد من 2:25 - 6
أبطئ الإيقاع مع قناة stable
ليست أحدث النسخ مناسبة للجميع. اضبط autoUpdatesChannel على stable عبر /config أو settings.json وستنتقل إلى نسخة تتأخر نحو أسبوع، متجاوزًا الإصدارات التي تحمل تراجعات جسيمة.
- 7
مديرو الحزم على جدولك أنت
تثبيتات Homebrew وWinGet وapt وdnf وnpm لا تُحدَّث ذاتيًا أبدًا. حدّثها يدويًا بـ brew upgrade claude-code أو winget upgrade Anthropic.ClaudeCode أو أمر apt upgrade أو npm install -g @anthropic-ai/claude-code@latest — وتجنب npm update -g التي تحذّر منها الوثائق صراحة.
أبقِ كل واجهة محدَّثة
- 8
حدّث إضافة VS Code
تُحدَّث الإضافة من لوحة الإضافات في VS Code كأي إضافة أخرى: ابحث عن Claude Code، ثبّت التحديث، ثم أعد تحميل النافذة. الإضافة تُشغّل ملف CLI التنفيذي نفسه، فأبقِ الاثنين محدَّثَين.
يظهر Claude Code for VS Code في قائمة الإضافات المثبتة بجوار لوحة Claude Code.شاهد من 1:07 - 9
حدّث إضافة JetBrains
في بيئات JetBrains افتح Settings ثم Plugins ثم Marketplace، وابحث عن Claude Code لتثبيته أو تحديثه. أعد تشغيل البيئة عند الطلب لتحميل نسخة الإضافة الجديدة.
في JetBrains Marketplace يحمل Claude Code علامة مثبَّت بجوار إضافات مجتمعية مشابهة.شاهد من 1:37 - 10
أبقِ تطبيق سطح المكتب محدَّثًا
يتحدّث تطبيق سطح المكتب عبر مُحدِّثه الداخلي، ومفتاح Code بداخله يفتح جلسات في مجلد محدد مع صلاحيات وبيئات سحابية اختيارية. لا تتجاهل تنبيهات تحديثه حتى لا يتخلف الـ CLI المدمج عن طرفيتك.
لواجهة سطح المكتب قسم خاص في العرض الرسمي.شاهد من 1:50 - 11
افهم تنبيه «أعد التشغيل للتطبيق»
التحديثات في الخلفية لا تستبدل أبدًا الملف التنفيذي تحت جلسة تعمل. يطبّق Claude Code النسخة المنزّلة عند بدء التشغيل التالي، لذا فتنبيه إعادة التشغيل سلوك طبيعي لا خطأ — أنجز مهمتك، اخرج، ثم ابدأ من جديد.
حين لا يُطبَّق التحديث
- 12
أصلح تحديثًا لا يُطبَّق
ابدأ بـ claude doctor — فهو يبرز مشاكل الصلاحيات والمحاولة الفاشلة والإصلاحات المقترحة. ما زال عالقًا؟ أعد تشغيل المُثبِّت الأصلي ليستبدل الملف التنفيذي في مكانه، أو راجع دليلنا لعلاج تعليق Claude Code وتجمّده للمزيد.
أوامر إصدارات Claude Code في لمحة
كل الأوامر التي تحتاجها لفحص إصدار Claude Code أو جلبه أو إصلاحه في قائمة واحدة. تعمل كلها من طرفيتك المعتادة.
- 1claude --version — يطبع رقم البناء الدقيق، مثل 2.1.211.
- 2claude update — يحدّث التثبيت الأصلي فورًا ويعرض الإصدار القديم والجديد.
- 3claude doctor — تشخيص التثبيت، بما في ذلك نتيجة آخر محاولة تحديث.
- 4brew upgrade claude-code — المسار اليدوي لتثبيتات Homebrew؛ شغّل brew cleanup بين حين وآخر لإزالة الإصدارات القديمة.
- 5winget upgrade Anthropic.ClaudeCode — المسار اليدوي لـ WinGet؛ قد يفشل أثناء تشغيل Claude Code لأن ويندوز يقفل الملف التنفيذي.
- 6القيمة DISABLE_AUTOUPDATER=1 في كتلة env من settings.json تعطّل فحوصات التحديث في الخلفية كليًا.
مِفتاحان آخران يستحقان المعرفة: autoUpdatesChannel على stable يُبقيك متأخرًا نحو أسبوع عن أحدث إصدار، وmanaged settings للمؤسسات يمكنها فرض حد أدنى أو أقصى للإصدار على كل الأجهزة.