كيفية تحديث Claude Code إلى أحدث إصدار في 2026

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

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

تجد معلومات عن استخدام Ailoot في الوثائق.

كيف تحدّث Claude Code بسرعة إلى أحدث إصدار؟#

سأشرح كل حالة بالتفصيل أدناه، لكن إن كان وقتك ضيقًا، فإليك ثلاثة أوامر تغطي معظم الحالات تقريبًا.

claude --version   # الإصدار المثبّت حاليًا
claude update      # التحديث فورًا (التثبيت الأصلي)
claude doctor      # فحص التثبيت والتحديثات

يعرض الأول إصدارك، ويحدّثه الثاني، ويشخّص الثالث المشكلات إذا حدث خطأ ما. سأشرح أدناه متى تستخدم كل أمر ولماذا لا يعمل claude update لدى بعض الأشخاص.

كيف تتحقق من إصدار Claude Code المثبّت حاليًا؟#

من المفيد أن تعرف الإصدار الذي ستحدّث منه قبل البدء. الأمر بسيط:

claude --version

ستحصل على سطر مثل 2.1.211 (Claude Code). وهذا هو إصدارك الحالي. قارن أول رقمين بأحدث رقم في سجل التغييرات؛ فإذا كان رقمك أقل بكثير، فقد حان وقت التحديث.

إذا أردت صورة أشمل، شغّل claude doctor. فهو يفحص فقط ولا يغيّر أي شيء: لا يبدأ جلسة، لكنه يعرض حالة التثبيت والأخطاء في ملف الإعدادات والتحذيرات المصحوبة باقتراحات جاهزة لما ينبغي إصلاحه. كما يعرض نتيجة آخر محاولة تحديث تلقائي، وهو أمر مفيد عندما تشتبه في أن تحديث الخلفية أخفق في التثبيت بصمت.

هل يحدّث Claude Code نفسه تلقائيًا؟#

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

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

يمكنك التحقق من نتيجة آخر محاولة في الخلفية باستخدام أمر claude doctor نفسه. وسيُظهر لك ما إذا كان التحديث قد أخفق في التثبيت لسبب ما.

لكن إذا ثبّتَّ Claude Code عبر مدير حزم — Homebrew على MacBook أو WinGet على Windows أو apt أو dnf على Linux — فلن يحدث تحديث في الخلفية. تُحدَّث تلك التثبيتات بأمر الترقية المعتاد؛ وهناك قسم منفصل عنها أدناه.

يُعد إصدار Claude Code الحديث أساسًا مهمًا، لكنه لن ينجز العمل وحده. فالنتائج المتسقة لا تأتي من إصدار الأداة، بل من طريقة عملك بها.

كيف تحدّث Claude Code يدويًا بأمر واحد؟#

لا حاجة إلى انتظار فحص الخلفية كي يكتشف إصدارًا جديدًا. هناك أمر يحدّثه الآن:

claude update

هناك نتيجتان محتملتان. إذا عُثر على تحديث وتثبيته، فسيعرض Claude Code سطرًا مثل Successfully updated from <old version> to version <new version>. وإذا كنت تستخدم أحدث إصدار بالفعل، فستحصل على Claude Code is up to date (<version>)، ما يعني أنه لا يوجد ما يحتاج إلى تحديث.

هناك أمر يستحق الانتباه إليه عند استخدام مديري الحزم. فإذا ثُبّت Claude Code عبر Homebrew أو WinGet أو apk، فسيعرض claude update ردًا أقصر — Claude is up to date! — ولا يجلب الإصدار الجديد بنفسه دائمًا. في هذه التثبيتات، يكون استخدام أمر الترقية الخاص بمدير الحزم أكثر موثوقية، كما هو موضح أدناه.

كيف تحدّث Claude Code المثبّت عبر Homebrew أو WinGet؟#

إذا ثبّتَّ Claude Code عبر مدير حزم بدلًا من نص موقع الويب، فأنت مسؤول عن تحديثه. إليك الأوامر الخاصة بكل نظام.

على macOS باستخدام Homebrew:

brew upgrade claude-code

يوفر Homebrew خيارين. إذ يُثبَّت Claude Code بنسختين. تتبع نسخة claude-code القناة المستقرة؛ وهي إصدار أقدم بنحو أسبوع ويتجاوز الإصدارات التي تحتوي على مشكلات كبيرة. أما نسخة claude-code@latest فتحصل على أحدث إصدار فور صدوره. حدّث النسخة التي ثبّتَّها: إذا كانت لديك claude-code@latest، فسيكون الأمر brew upgrade claude-code@latest.

على Windows باستخدام WinGet:

winget upgrade Anthropic.ClaudeCode

قد تفشل الترقية باستخدام WinGet أحيانًا أثناء تشغيل Claude Code لأن Windows يكون يستخدم الملف التنفيذي. سيعرض Claude Code الأمر اليدوي فحسب؛ أغلقه وشغّل الترقية مرة أخرى.

على Linux باستخدام apt أو dnf أو apk، لا يوجد أمر منفصل عليك تعلّمه؛ إذ يصل أحدث إصدار مع تحديث النظام المعتاد لأن Claude Code ينشر مستودعات موقّعة.

إذا لم ترغب في تذكّر ذلك، يمكنك استخدام متغير البيئة CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE. اضبطه على 1، وسيشغّل Claude Code الترقية في الخلفية باستخدام Homebrew وWinGet، ثم يقترح إعادة التشغيل بعد نجاح التحديث. تتضمن الوثائق تنبيهًا: قد يخبرك Claude Code أحيانًا بوجود إصدار جديد قبل أن يظهر فعليًا في مدير الحزم. إذا لم يعثر التحديث على إصدار، فانتظر قليلًا ثم حاول مرة أخرى.

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

لماذا لا يُحدَّث Claude Code، وماذا ينبغي أن تفعل؟#

أحيانًا تكرّر التحديث، لكن claude --version يظل يعرض الرقم القديم بعناد. سأستعرض الأسباب الرئيسية بدءًا بالأكثر شيوعًا.

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

which -a claude

قد يوجد Claude Code في ثلاثة مواضع: ~/.local/bin/claude هو المثبّت الأصلي، و~/.claude/local/ هو التثبيت المحلي القديم عبر npm من الإصدارات الأولى، أما حزمة npm العامة فتظهر باستخدام الأمر npm -g ls @anthropic-ai/claude-code. إذا وجدت أكثر من نسخة، فأبقِ واحدة فقط، ويفضّل أن تكون التثبيت الأصلي. أزل النسخ الإضافية هكذا:

npm uninstall -g @anthropic-ai/claude-code
rm -rf ~/.claude/local

السبب الشائع الثاني هو أن مجلد npm العام غير قابل للكتابة. إذا ثبّتَّ Claude Code عالميًا عبر npm ولم يكن لديه إذن الكتابة في مجلده، فلن يُثبَّت تحديث الخلفية. يعرض Claude Code إشعارًا لمرة واحدة عند بدء التشغيل، ويسرد claude doctor ما ينبغي إصلاحه بالضبط. وهذا سبب آخر لتفضيل التثبيت الأصلي: فهو يكتب في مجلدك الرئيسي ولا يتطلب تلك الأذونات.

الحالة الثالثة هي أنك استبدلت مشغّل ~/.local/bin/claude بنص أو رابط رمزي خاص بك. بدءًا من 2.1.207، تترك التحديثات التلقائية هذا المشغّل دون تغيير؛ وتثبت الإصدارات الجديدة في ~/.local/share/claude/versions/ بينما يختار نصك ما يُشغّل. لا تحذف مشغّلك الوحيد ثم تستدعِ claude update بالاسم. احفظ أولًا المشغّل المخصص وهدفه إن كان رابطًا رمزيًا في موضع نسخ احتياطي مستقل غير مستخدم. لا تنقله من مساره الأصلي إلا بعد التحقق من النسخة. استعد المشغّل الأصلي باستخدام المثبت الرسمي الذي لا يعتمد على أمر claude قائم:

# macOS أو Linux أو WSL: المثبت الأصلي الرسمي
curl -fsSL https://claude.ai/install.sh | bash

بعد انتهاء المثبت، افتح طرفية جديدة وتحقق من النتيجة:

claude --version
claude doctor

يجب أن يطبع الأمر الأول رقم إصدار. افحص إخراج doctor لتحذيرات المشغّل أو PATH قبل المتابعة؛ ولا تزل المشغّل المحفوظ حتى يعمل البديل.

ومن الأعراض الأخرى أن يتوقف claude update أو claude doctor فورًا بعد سطر Checking for updates. كان هذا يحدث أحيانًا في الإصدارات القديمة (قبل 2.1.214) عندما يكون أحد ملفات إعدادات الصدفة، مثل ~/.zshrc، مجلدًا بدلًا من ملف. أما الإصدارات الحديثة فتتجاوز هذه الحالة الآن، لذا فإن التحديث إلى أحدث إصدار يصلح هذا الخلل أيضًا.

كيف تختار قناة التحديث: latest أم stable؟#

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

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

أسهل طريقة للتبديل بين القنوات هي استخدام الأمر /config داخل Claude Code، ضمن خيار Auto-update channel. أو يمكنك إدخال الإعداد يدويًا في ملف الإعدادات settings.json:

{
  "autoUpdatesChannel": "stable"
}

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

كيف تثبّت إصدارًا محددًا أو تحدد الحد الأدنى للإصدار؟#

قد تحتاج أحيانًا إلى إصدار محدد بدلًا من الأحدث، مثلًا للعودة إلى إصدار تعرف أن سير عملك كان يعمل عليه بالتأكيد. يدعم المثبّت الأصلي ذلك؛ إذ يقبل اسم قناة ورقم إصدار محددًا. ثبّت إصدارًا بعينه كما يلي:

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

على Windows، يبدو الأمر المكافئ في PowerShell مختلفًا قليلًا:

& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 2.1.89

يمكنك تثبيت قناة stable بالطريقة نفسها؛ اكتب stable بدلًا من رقم. تصبح القناة التي تختارها أثناء التثبيت هي القناة الافتراضية للتحديثات التلقائية المستقبلية.

إذا أردت الحماية من الرجوع إلى إصدار أقدم، فحدّد حدًا أدنى للإصدار في settings.json:

{
  "autoUpdatesChannel": "stable",
  "minimumVersion": "2.1.100"
}

هذا هو الحد الأدنى. لن يثبّت تحديث الخلفية ولا claude update إصدارًا أدنى من الإصدار المحدد. ويفيد هذا عند التبديل إلى stable إذا لم ترغب في الرجوع من إصدار أحدث تستخدمه بالفعل.

كيف تعطل التحديثات التلقائية إذا كانت تعيقك؟#

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

{
  "env": {
    "DISABLE_AUTOUPDATER": "1"
  }
}

هناك تفصيل مهم: لا يوقف DISABLE_AUTOUPDATER إلا الفحص في الخلفية. وسيظل أمر claude update يعمل، لذا يمكنك التحديث يدويًا. وإذا احتجت إلى حظر جميع مسارات التحديث دفعة واحدة، بما فيها التحديث اليدوي، فهناك المتغير الأكثر صرامة DISABLE_UPDATES. يُستخدم عند توزيع Claude Code عبر قناتك الخاصة، عندما تريد أن يلتزم المستخدمون بالإصدار الذي وفّرته لهم تمامًا.

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

من أين تبدأ؟#

إليك خطة مختصرة.

1. تحقّق من إصدارك الحالي: claude --version. قارنه بأحدث رقم في سجل التغييرات.
2. حدّث البرنامج. التثبيت الأصلي — claude update. Homebrew — brew upgrade claude-code. WinGet — winget upgrade Anthropic.ClaudeCode.
3. أعد تشغيل جلسة Claude Code لتفعيل الإصدار الجديد.
4. إذا لم يتغير الإصدار، فشغّل claude doctor وwhich -a claude. من المحتمل أن لديك عدة تثبيتات أو أن مجلد npm غير قابل للكتابة.
5. اختر القناة المناسبة لك: latest إن أردت الميزات الجديدة فور صدورها، أو stable إن كانت قابلية التنبؤ أهم. غيّر القناة عبر /config.

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

تعرّف على Ailoot.