ملاحظة الكاتب: استنادًا إلى ملاحظات تحديث Claude Code v2.1.318، يستعرض هذا المقال أسباب 7 أنواع من المشكلات وخطوات تشخيصها، بما فيها اختفاء إعدادات Claude Code وظهور رسالة “Not logged in” وانتهاء صلاحية تسجيل الدخول عند استخدام مجلد home مشترك عبر الشبكة.
في بيئات مثل معامل الجامعات وعناقيد HPC وخوادم القفز في الشركات، يُركّب مجلد home للمستخدم عادةً على NFS أو نظام ملفات شبكي آخر، بحيث تشترك عدة أجهزة في مجلد ~ واحد. وعند استخدام Claude Code في هذه البيئة، قد تواجه مشكلات مثل اختفاء إعدادات خادم MCP في اليوم التالي، أو تسجيل الدخول تلقائيًا بعد تسجيل الخروج، أو ظهور رسالة Not logged in فجأة في المهام الخلفية، أو تفريغ ملف ~/.claude.json. يشرح هذا المقال كيفية تشخيص مشكلات إعدادات Claude Code وتسجيل الدخول في مجلد home مشترك عبر الشبكة، لمساعدتك على تحديد ما إذا كان الخلل في الإصدار أو نظام الملفات أو بيانات الاعتماد نفسها.
هذه ليست قائمة تخمينات مبنية على الخبرة الشخصية. فقد عالج تحديث Claude Code v2.1.318، الصادر في 4 نوفمبر 2026، مجموعة من المشكلات المرتبطة بمجلدات home المشتركة عبر الشبكة. وتستند خطوات التشخيص في هذا المقال إلى ملاحظات ذلك التحديث.
الفائدة الأساسية: بعد قراءة المقال، ستتمكن من تحديد سبب خلل الإعدادات أو تسجيل الدخول في Claude Code وفقًا للأعراض، ومعرفة ما إذا كنت بحاجة إلى الترقية أو استعادة نسخة احتياطية أو استخدام طريقة مصادقة أخرى.
أهم النقاط حول إعدادات Claude Code وتسجيل الدخول في دليل home مشترك عبر الشبكة
لنبدأ بالصورة العامة. يحتفظ Claude Code في دليل home بثلاثة أنواع رئيسية من البيانات: ملف الإعدادات العام ~/.claude.json، الذي يتضمن خوادم MCP والأدلة الموثوقة وغيرها، وملف الإعدادات، وبيانات اعتماد تسجيل الدخول المحفوظة. في دليل home المشترك عبر الشبكة، تقرأ عمليات وأجهزة متعددة هذه الملفات وتكتب فيها في الوقت نفسه، كما يختلف سلوك الأقفال والتخزين المؤقت والحصص في نظام الملفات الشبكي عنه في القرص المحلي. يوضح الجدول التالي التغييرات المرتبطة بذلك مباشرة في الإصدار v2.1.318:
| النقطة | التوضيح | الفائدة لك |
|---|---|---|
| فشل الكتابة لم يعد يُبلّغ عنه خطأً بوصفه نجاحًا | إذا تعذّر تحديث الإعدادات في دليل home مشترك، فلن تبلغ الأوامر /logout وclaude auth logout وclaude mcp remove عن النجاح |
تجنّب الاعتقاد بأنك سجّلت الخروج بينما لم يحدث ذلك فعليًا |
| إعادة تسجيل الدخول من جهاز آخر لا توقف المهام | عند إعادة تسجيل الدخول إلى الحساب والمؤسسة نفسيهما من طرفية أو جهاز آخر يستخدم دليل home نفسه، لن تتوقف المهام الجارية بسبب الخطأ Not logged in | استقرار أكبر عند تشغيل المهام بالتوازي على أجهزة متعددة |
| قفل عند كتابة إعدادات MCP | ينتظر الأمران claude mcp add/remove حتى يتاح قفل الإعدادات، وينتهيان برمز الخروج 1 إذا تعذّر الحصول عليه |
تقليل تلف الإعدادات الناتج عن الكتابة المتزامنة |
| إظهار موعد انتهاء تسجيل الدخول | أضيف الحقل loginExpiresAt إلى claude auth status، والحقل credential_expires_at إلى نتيجة JSON للأمر claude -p |
اكتشاف اقتراب انتهاء صلاحية تسجيل الدخول مسبقًا |
| مقاومة أكبر لتلف ملفات الإعدادات | عند حفظ ~/.claude.json وملفات الإعدادات وبيانات اعتماد تسجيل الدخول في دليل home مشترك، تقل احتمالات حذفها أو إفراغها مؤقتًا أو استبدالها بنسخة قديمة |
تقليل احتمال «اختفاء» الإعدادات دون سبب واضح |
لماذا تتعرض إعدادات Claude Code للمشكلات في مجلد home مشترك؟
على القرص المحلي، يمكن اعتبار حفظ إعدادات Claude Code عملية ذرّية في الأساس. أما على نظام ملفات شبكي، فقد تؤدي ذاكرة التخزين المؤقت لدى العميل إلى نتائج مضللة عند عمليات مثل «كتابة ملف مؤقت ثم استبدال الملف الأصلي» أو «التحقق من وجود ملف». فقد يُبلَّغ مثلًا عن عدم وجود ملف رغم أنه موجود بالفعل. في هذه الحالة، قد تفترض الإصدارات القديمة أن الإعدادات غير موجودة، وعند التشغيل التالي تختفي خوادم MCP والأدلة الموثوقة. أما في v2.1.318، فيُعاد التحقق عندما يُبلَّغ خطأً عن فقدان ملف الإعدادات، ما يقلل حالات التشغيل بإعدادات فارغة.
هناك خطر آخر يتعلق بحصة مساحة القرص. تذكر ملاحظات التحديث حالة لا تتبقى فيها مساحة لكتابة البيانات في مجلد home الشبكي، مع استمرار السماح بإنشاء ملفات جديدة. عندئذٍ، قد تؤدي محاولة حفظ بيانات اعتماد تسجيل الدخول إلى استبدال ملفها بملف فارغ، فيُسجَّل خروج المستخدم فورًا. أصلح الإصدار الجديد هذه المشكلة. ومع ذلك، إذا كانت مجموعتك تفرض حصصًا صارمة على مساحة home، فمن الأفضل التحقق من المساحة المتبقية دوريًا باستخدام df أو أمر quota المتاح في المجموعة.
مشكلات تزامن تسجيل الدخول إلى Claude Code عند مشاركة مجلد home
حالة تسجيل الدخول من المواضع التي تكثر فيها المشكلات أيضًا. فعندما تشترك عدة أجهزة في مجلد home واحد، كان تنفيذ claude auth login لإعادة تسجيل الدخول على الجهاز A قد يؤدي إلى إنهاء مهمة دفعية تعمل باستخدام claude -p على الجهاز B، مع ظهور رسالة Not logged in. أصلح الإصدار v2.1.318 هذه المشكلة، بشرط استخدام الحساب نفسه والمؤسسة نفسها. كذلك، كانت أوامر claude plugin قد تنتهي قبل اكتمال حفظ تحديث بطيء للرمز المميز، فتجد نفسك مسجّل الخروج عند التشغيل التالي. وقد أُصلحت هذه المشكلة أيضًا.
وهناك مشكلة أقل وضوحًا: قد تحفظ جلسة تسجيل دخول أخرى على الجهاز نفسه قائمة allowedProviders، فتُرفض جلستك عند بدء تشغيلها بسبب هذه القائمة. تظهر هذه الحالة بسهولة عندما يتشارك عدة أشخاص جهازًا وسيطًا واحدًا، أو عندما يسجّل المستخدم نفسه الدخول إلى مؤسسات مختلفة. ولم يعد هذا الرفض الخاطئ يحدث في الإصدار الجديد.
دليل سريع لاستكشاف مشكلات Claude Code في دليل home مشترك
وفقًا لأسلوب هذا المقال، لا نستخدم كتل شفرة أدناه، بل نعرض الأوامر والحقول ضمن النص. يمكن تقسيم عملية استكشاف المشكلات إلى أربع خطوات، ويُنصح بتنفيذها بالترتيب.
الخطوة الأولى: التحقق من إصدار Claude Code وحالة تسجيل الدخول
نفّذ أولًا claude --version للتحقق من رقم الإصدار. إذا كان أقدم من v2.1.318، فمن الأفضل الترقية باستخدام claude update أو بالطريقة التي استخدمتها للتثبيت؛ فكثير من المشكلات المذكورة في هذا المقال لا يمكن حلها نهائيًا في الإصدارات القديمة، وإنما يمكن الالتفاف عليها فقط. بعد الترقية، نفّذ claude auth status للتحقق من الحساب الحالي والمؤسسة وحقل loginExpiresAt الجديد.
إذا كنت تستخدم claude -p أساسًا في السكربتات، فيمكنك ضبطه لإخراج النتائج بتنسيق JSON، ثم قراءة حقل credential_expires_at في خط أنابيب العمل لإصدار تنبيه قبل انتهاء الصلاحية. أما في وضع الإخراج النصي، فيطبع الإصدار الجديد سطر تحذير إلى stderr بدءًا من 10 أيام قبل انتهاء صلاحية تسجيل الدخول المحفوظ إلى claude.ai؛ لذا راقب السجلات.
| الأمر/الحقل | الغرض | ما الذي يجب الانتباه إليه؟ |
|---|---|---|
claude --version |
عرض الإصدار الحالي | هل الإصدار ≥ v2.1.318؟ |
claude auth status |
عرض حالة تسجيل الدخول | هل يقترب موعد loginExpiresAt؟ |
claude -p (إخراج JSON) |
الاستدعاء دون تدخل يدوي | حقل credential_expires_at |
claude auth login |
إعادة تسجيل الدخول إلى حساب claude.ai | نفّذه حسب التعليمات بعد انتهاء صلاحية تسجيل الدخول |
claude setup-token |
توليد رمز للاستخدام دون تدخل يدوي | مناسب للتكامل المستمر (CI) والمعالجة الدفعية |
claude mcp add / claude mcp remove |
إدارة خوادم MCP | رمز الخروج 1 يعني تعذّر الحصول على قفل الإعدادات |
الخطوة الثانية: التحقق من سلامة ~/.claude.json
يُعد تلف ~/.claude.json السبب الأكثر شيوعًا لفقدان الإعدادات بالكامل عند مشاركة دليل home. غيّر الإصدار v2.1.318 عدة جوانب من طريقة التعامل مع هذا الملف: إذا اكتشف عند بدء التشغيل غير التفاعلي أن الملف ليس بتنسيق JSON صالح، فلن يستبدله بالقيم الافتراضية. بدلًا من ذلك، يفشل بدء التشغيل وتظهر إرشادات لاستعادته، مع ترك الملف الأصلي دون تغيير (المشكلة #87551). أما إذا كان الملف فارغًا ولا توجد نسخة احتياطية، فسيبدأ الإصدار الجديد بصورة طبيعية كما لو أن الملف غير موجود، دون الإبلاغ عن تلفه.
أصبحت أوامر الاستعادة التي يعرضها الإصدار الجديد أكثر موثوقية أيضًا. ففي السابق، كان أمر الاستعادة قد يشير إلى نسخة احتياطية فارغة أو مبتورة، كما كان يفشل عند التعامل مع ملف للقراءة فقط. وقد أُصلحت هذه المشكلات. كذلك، في أدلة home التي لا يُشغّل فيها سوى claude -p، كان تنظيف النسخ وفق مدة الاحتفاظ قد يحذف آخر نسخة احتياطية من ~/.claude.json. أما الآن، فيُنشئ البرنامج نسخة احتياطية جديدة قبل حذف النسخة القديمة.
الخطوة الثالثة: معالجة فشل تسجيل الدخول وانتهاء صلاحية بيانات الاعتماد
إذا كان الخطأ متعلقًا بفشل تسجيل الدخول، فتحقق أولًا مما إذا كانت الرسالة تنص على أن «تسجيل الدخول المحفوظ إلى claude.ai انتهت صلاحيته». يوضح الإصدار الجديد ذلك مباشرة، ويعرض عند استخدام claude -p خيارين: claude auth login وclaude setup-token. اختر الأول للاستخدام التفاعلي؛ أما المهام طويلة التشغيل في الخلفية، فعادةً ما يناسبها الخيار الثاني.
على الأجهزة التي فُعّل فيها forceLoginOrgUUID لفرض تسجيل الدخول إلى مؤسسة محددة، كانت الإصدارات القديمة ترفض أحيانًا بدء التشغيل باستخدام رمز أنشأه setup-token، رغم أن الرمز ينتمي إلى مؤسسة مسموح بها. أُصلحت هذه المشكلة في v2.1.318، لذا إذا واجهتها في بيئة مؤسسية، فعادةً ما تحلها الترقية.
الخطوة الرابعة: تقليل مخاطر الكتابة المتزامنة
يُعد تعديل عدة مضيفين لإعدادات MCP في الوقت نفسه خطرًا ملازمًا لمشاركة دليل المنزل. ينتظر الإصدار الجديد من claude mcp add وclaude mcp remove الحصول على قفل الإعدادات، وإذا تعذّر ذلك ينتهي التنفيذ برمز خروج 1 بدلًا من الكتابة دون قفل. لكن ملاحظات التحديث توضح أيضًا أن مهمة أخرى قد تستبدل إدخال الخادم الذي حفظته للتو عند حفظ إعداداتها. لذلك، عند تعديل إعدادات MCP على نطاق واسع، يُفضّل تنفيذ التغييرات بالتتابع على مضيف واحد.
كذلك، عند التشغيل دون تدخل بشري باستخدام claude -p أو تطبيقات SDK، لن يُعاد كتابة ملف ~/.claude.json في كل مرة إذا لم تتغير الإعدادات. وهذا يقلل بوضوح ضغط الكتابة على ملف الإعدادات عند تشغيل عدد كبير من المهام بالتوازي. إذا كانت مجموعتك لا تزال تستخدم إصدارًا قديمًا لتشغيل مهام واسعة النطاق، فهذه نقطة أخرى تستحق الترقية من أجلها.
🚀 ابدأ بسرعة: إذا كان فريقك يستخدم Claude Code لتشغيل مهام مجمّعة على مجموعة حوسبة، ولا يريد أن يتأثر بانتهاء صلاحية تسجيل الدخول إلى حساب claude.ai، فيمكنه الاتصال عبر API بدلًا من ذلك. تتيح APIYI على apiyi.com استدعاء نماذج Claude عبر API، مع دعم تنسيقي واجهتَي OpenAI وAnthropic. للاطلاع على طريقة الاتصال، راجع مركز الوثائق على docs.apiyi.com.
المشكلات الشائعة في Claude Code عند مشاركة دليل home
يجمع الجدول التالي الأعراض الشائعة وأسبابها المحتملة والحلول المقترحة. يمكنك البحث فيه حسب العَرَض عند استكشاف المشكلة.
| العَرَض | السبب المحتمل | الحل المقترح |
|---|---|---|
يعرض تنفيذ /logout رسالة نجاح، لكن تظل حالة تسجيل الدخول قائمة عند التشغيل التالي |
الإصدار القديم يبلغ عن النجاح حتى عند فشل كتابة الإعدادات في دليل home مشترك | حدّث إلى v2.1.318، ثم نفّذ claude auth logout وتحقق من النتيجة |
| تُظهر مهمة تعمل في الخلفية فجأة رسالة Not logged in | أعاد طرف آخر أو جهاز آخر تسجيل الدخول باستخدام دليل home نفسه | حدّث الإصدار؛ فقد أُصلحت المشكلة عند استخدام الحساب والمؤسسة نفسيهما |
| تختفي جميع خوادم MCP والأدلة الموثوقة بعد بدء التشغيل | يُبلغ نظام ملفات الشبكة خطأً بأن ملف الإعدادات غير موجود | حدّث الإصدار لتفعيل منطق إعادة التحقق، واستعد الملف من النسخة الاحتياطية عند الحاجة |
| يصبح ملف بيانات اعتماد تسجيل الدخول فارغًا | امتلأت مساحة home، لكن لا يزال إنشاء ملفات جديدة ممكنًا | أفرغ مساحة ضمن الحصة المخصصة، ثم سجّل الدخول مجددًا وحدّث الإصدار |
| يفشل التشغيل غير التفاعلي مباشرةً وتظهر مطالبة بالاستعادة | ملف ~/.claude.json ليس ملف JSON صالحًا |
اتبع أمر الاستعادة المقترح، ولا تستبدل الملف يدويًا |
| يُرفض بدء التشغيل بسبب allowedProviders | تتداخل قائمة حفظتها جلسة تسجيل دخول أخرى على الجهاز نفسه | حدّث الإصدار وأعد المحاولة |
| تفشل جميع اتصالات الشبكة | يشير NODE_EXTRA_CA_CERTS إلى ملف فارغ أو ملف ليس بتنسيق PEM | يستخدم الإصدار الجديد الشهادات القابلة للقراءة ويعرض تحذيرًا على stderr؛ صحّح ملف الشهادة أيضًا |
هناك حالة تتعلق بتعدد المستخدمين تستحق توضيحًا منفصلًا. إذا استخدم شخص sudo claude وترك عملية قيد التشغيل تخص مستخدمًا آخر، فقد يعتبرها الإصدار القديم متوقفة عن طريق الخطأ أثناء تنظيف الإصدارات، ثم يحذف الملف التنفيذي الذي تستخدمه. وبالمثل، إذا حُذف الملف التنفيذي لعملية لا تزال تعمل أثناء التحديث أو تنظيف الإصدارات، فقد تظهر رسالة spawn ENOENT عند بدء جلسة جديدة على مضيف remote-control أو عملية خلفية أو runner مستضاف ذاتيًا. أُصلحت المشكلتان في v2.1.318، لكن يُنصح مع ذلك بتجنب تشغيل Claude Code باستخدام sudo في البيئات المشتركة.
مقارنة Claude Code قبل الإصدار v2.1.318 وبعده: سيناريو home المشترك
| السيناريو | قبل v2.1.318 | بدءًا من v2.1.318 |
|---|---|---|
| فشل كتابة إعدادات home المشترك | يُبلّغ عن نجاح تسجيل الخروج وإزالة MCP رغم فشلهما، وتُفقد تغييرات إعدادات الثقة وMCP بصمت | لم يعد يُبلّغ عن النجاح خطأً |
ملف ~/.claude.json يحتوي على JSON غير صالح |
يُستبدل بالقيم الافتراضية عند التشغيل غير التفاعلي | يفشل بدء التشغيل، مع إرشادات للاستعادة والاحتفاظ بالملف الأصلي |
ملف ~/.claude.json فارغ ولا توجد نسخة احتياطية |
يُبلّغ عن تلف الملف | يبدأ التشغيل بصورة طبيعية كما لو أن الملف غير موجود |
| انتهاء صلاحية تسجيل الدخول | تظهر رسالة عامة عن فشل تسجيل الدخول فقط | يظهر تنبيه واضح بانتهاء الصلاحية، مع عرض الأمرين claude auth login وclaude setup-token |
| التحذير المسبق من انتهاء الصلاحية | لا يوجد | يظهر تحذير على stderr قبل 10 أيام، ويمكن عرض موعد انتهاء الصلاحية عبر أمر الحالة |
| التشغيل دون مراقبة | يُعاد كتابة ~/.claude.json في كل تشغيل |
لا يُعاد كتابة الملف إذا لم يتغير محتواه |
يوضح الجدول نهج الإصلاح في v2.1.318: الإبلاغ عن حالات الفشل كما هي، ومحاولة الحفاظ على بيانات المستخدم عند تلف الإعدادات. وبالنسبة لفرق التشغيل، سيقل ظهور الحالات التي «تبدو طبيعية رغم وجود خطأ»، وستنكشف المشكلات مبكرًا، مما يسهّل تشخيصها.
إذا كنت تشغّل مهام دفعية واسعة النطاق على عنقود مشترك، فمن الأفضل الاستمرار في استخدام تسجيل الدخول بالحساب للتطوير التفاعلي، واستخدام رمز مولّد عبر setup-token للمهام الدفعية، أو المصادقة مباشرة عبر API، حتى لا تتداخل بيانات اعتماد الطريقتين.
استخدام API مع Claude Code لتجاوز مشكلات تسجيل الدخول في مجلد home مشترك
تعود معظم مشكلات تسجيل الدخول عند مشاركة مجلد home إلى استخدام بيانات اعتماد claude.ai نفسها في عدة مواضع. عند تحويل مهام المعالجة الدفعية إلى المصادقة باستخدام مفتاح API، تُمرَّر بيانات الاعتماد عبر متغيرات البيئة، بدلًا من الاعتماد على ملف تسجيل الدخول المحفوظ في مجلد home. وبذلك تتجنب إلى حد كبير مشكلات إلغاء تسجيل الدخول بين الأجهزة وانتهاء صلاحية الجلسة المذكورة سابقًا. يدعم Claude Code تحديد نقطة نهاية API والمفتاح باستخدام متغيرات بيئة مثل ANTHROPIC_BASE_URL وANTHROPIC_AUTH_TOKEN. راجع الوثائق الرسمية للتأكد من أسماء المتغيرات والإصدارات التي تدعمها.
🎯 نصيحة تقنية: تتيح APIYI على apiyi.com استدعاء نماذج Claude عبر API، مع دعم تنسيقي Anthropic الأصلي وOpenAI. وهذا يجعلها خيارًا مناسبًا لإعداد نقطة نهاية موحدة لـ Claude Code والأدوات الأخرى. راجع مركز توثيق APIYI على docs.apiyi.com لمعرفة Base URL وطريقة الحصول على المفتاح وأمثلة إعداد كل أداة.
| وجه المقارنة | تسجيل الدخول بحساب claude.ai | الاتصال باستخدام مفتاح API، مثل APIYI |
|---|---|---|
| تخزين بيانات الاعتماد | بيانات تسجيل الدخول المحفوظة في مجلد home | متغيرات البيئة أو نظام إدارة المفاتيح |
| أثر مشاركة مجلد home | تستخدم أجهزة متعددة البيانات نفسها، مما قد يسبب مشكلات التزامن وانتهاء الصلاحية | تُمرَّر بيانات الاعتماد لكل مهمة بشكل مستقل، دون تداخل |
| إدارة انتهاء الصلاحية | تجب متابعة loginExpiresAt | تحددها صلاحية المفتاح والحصة المتاحة له |
| تنسيق الواجهة | مدمج في Claude Code | متوافق مع تنسيقي Anthropic وOpenAI |
| الفوترة | وفق اشتراك الحساب وقواعد الاستخدام | وفق البيانات الفعلية في صفحة أسعار APIYI على docs.apiyi.com/models |
💰 ملاحظة عن التكلفة: للحصول على تفاصيل الفوترة، بما فيها أسعار النماذج وأسعار المدخلات والمخرجات والتخزين المؤقت، راجع البيانات الحالية في صفحة أسعار APIYI على docs.apiyi.com/models. لا يورد هذا المقال أرقامًا محددة لتجنب تقديم معلومات مضللة عند تغير الأسعار.
الأسئلة الشائعة FAQ
س1: ما هو «دليل home المشترك عبر الشبكة»، ولماذا يكون Claude Code أكثر عرضة للمشكلات عند استخدامه؟
هو الدليل الرئيسي للمستخدم، ويُثبَّت عبر نظام ملفات شبكي مثل NFS وتتشاركه عدة أجهزة. يخزّن Claude Code إعداداته العامة وتكويناته وبيانات اعتماد تسجيل الدخول داخل هذا الدليل. وقد تؤدي الكتابة المتزامنة من عمليات متعددة، أو التقارير غير الصحيحة من ذاكرة التخزين المؤقت لنظام الملفات، أو سلوك الكتابة غير المتوقع عند امتلاء الحصة التخزينية، إلى فقدان الإعدادات أو انتهاء صلاحية تسجيل الدخول.
س2: ما الفرق في عمل Claude Code ضمن دليل home مشترك قبل الإصدار v2.1.318 وبعده؟
كانت الإصدارات القديمة قد تبلغ عن نجاح الكتابة دون تنبيه رغم فشلها، أو تستبدل الإعدادات التالفة بالقيم الافتراضية. أما الإصدار v2.1.318 فيبلّغ عن الخطأ بوضوح، ويحافظ على الملف الأصلي، ويقدم إرشادات للاستعادة. كما حسّن استقرار حفظ ملفات الإعدادات في دليل home المشترك، وأضاف حقلاً لتاريخ انتهاء صلاحية تسجيل الدخول.
س3: متى صدرت هذه الإصلاحات؟
تضمن الإصدار Claude Code v2.1.318 هذه الإصلاحات، ويشير إصدار GitHub إلى أن تاريخ نشره هو 4 نوفمبر. يمكنك التحقق من الإصدار المثبت باستخدام `claude –version`، ويُنصح بالترقية أولاً قبل استكشاف المشكلة إذا كان الإصدار أقدم.
س4: ماذا أفعل إذا كانت المهام في الخلفية تعرض باستمرار الخطأ Not logged in؟
تحقق أولاً مما إذا كان أحدهم قد أعاد تسجيل الدخول إلى الحساب نفسه من طرفية أو جهاز آخر يستخدم دليل home نفسه. بعد الترقية إلى v2.1.318، تكون هذه المشكلة قد أُصلحت عند استخدام الحساب والمؤسسة نفسيهما. أما عند تسجيل الدخول إلى مؤسسات مختلفة، أو انتهاء صلاحية بيانات الاعتماد، فيُنصح باستخدام رمز يُنشأ عبر `claude setup-token` للمهام طويلة التشغيل، أو استخدام المصادقة بمفتاح API.
س5: كيف أجعل Claude Code يستدعي النموذج عبر API دون تسجيل الدخول إلى الحساب؟
يمكنك تحديد نقطة نهاية API والمفتاح لـ Claude Code باستخدام متغيرات البيئة. توفر APIYI، عبر apiyi.com، إمكانية استدعاء نماذج Claude من خلال API، مع دعم تنسيقي واجهات Anthropic وOpenAI، ويمكن استخدامها كنقطة نهاية موحدة. راجع وثائق docs.apiyi.com لخطوات الإعداد، وصفحة الأسعار docs.apiyi.com/models لمعرفة تفاصيل الفوترة.
س6: هل يمكنني حذف ~/.claude.json وإعادة إنشائه مباشرةً إذا تعرض للتلف؟
لا يُنصح بحذفه مباشرةً. إذا واجه الإصدار الجديد ملف JSON غير صالح، فسيتوقف عن البدء ويعرض أمر الاستعادة؛ لذا يُفضّل اتباع الإرشادات لاستعادته من نسخة احتياطية. أما إذا كان الملف فارغًا ولا توجد نسخة احتياطية، فسيبدأ الإصدار الجديد بشكل طبيعي كما لو أن الملف غير موجود، لكن ستحتاج إلى إعادة إضافة خوادم MCP والأدلة الموثوقة التي أعددتها سابقًا.
س7: ما القيود المعروفة المتبقية عند استخدام دليل home مشترك بعد الترقية إلى v2.1.318؟
توضح ملاحظات التحديث أن أمري `claude mcp add/remove` أصبحا يستخدمان آلية قفل، لكن حفظ مهمة أخرى للإعدادات قد يظل قادرًا على الكتابة فوق إدخال الخادم الذي حفظته للتو. كما أن مشكلات مثل ضيق الحصة المخصصة والتخزين المؤقت المفرط لنظام الملفات لم تُعالج إلا جزئيًا. لذلك، في حالات التزامن العالي، يُنصح بإدارة الإعدادات بشكل تسلسلي، أو فصل بيانات اعتماد المهام الدفعية عن بيانات الاستخدام التفاعلي.
أهم النقاط لاستكشاف مشكلات Claude Code في دليل home مشترك
- تحقق من الإصدار أولًا: قبل استكشاف المشكلة، تأكد من أن إصدار Claude Code لا يقل عن v2.1.318؛ فالتحديث يحل معظم مشكلات دليل home المشترك
- راقب صلاحية تسجيل الدخول: استخدم الحقل loginExpiresAt في
claude auth statusلاكتشاف قرب انتهاء صلاحية تسجيل الدخول مسبقًا - لا تحذف الإعدادات مباشرةً: إذا حدث خلل في
~/.claude.json، فاتبع أمر الاستعادة الذي يقدمه الإصدار الأحدث للحفاظ على إعداداتك - نفّذ التغييرات بالتسلسل: اجعل تغييرات إعدادات MCP على جهاز واحد لتجنب الكتابة فوقها من أجهزة أخرى
- راقب الحصة المتاحة: قد يؤدي امتلاء مساحة home إلى مسح بيانات الاعتماد، لذا تحقق منها دوريًا
- افصل بيانات اعتماد المهام الدفعية: استخدم للمهام طويلة التشغيل رمزًا مولّدًا باستخدام setup-token أو مفتاح API، منفصلًا عن تسجيل الدخول التفاعلي
- الاتصال عبر API خيار متاح: تتوافق APIYI مع صيغتَي Anthropic وOpenAI، وتُحدد رسوم الاستخدام وفقًا لما هو موضح في docs.apiyi.com/models
الخلاصة
أبرز النقاط لتشخيص مشكلات إعداد Claude Code وتسجيل الدخول عند استخدام مجلد home مشترك عبر الشبكة:
- ابدأ بالترقية: أصلح الإصدار v2.1.318 مجموعة من المشكلات، منها ظهور رسالة نجاح زائفة عند تسجيل الخروج، وتسبب تسجيل الدخول من جهاز آخر في قطع المهام، والكتابة فوق الإعدادات أو مسحها.
- حدد السبب حسب العَرَض: عند فقدان الإعدادات، افحص
~/.claude.jsonونسخه الاحتياطية أولًا؛ وعند تعطل تسجيل الدخول، افحص وقت انتهاء الصلاحية وملف بيانات الاعتماد؛ وعند انقطاع المهام، افحص عمليات الكتابة المتزامنة وحصة مساحة القرص. - افصل بين وسائل المصادقة: استخدم تسجيل الدخول بالحساب للتطوير التفاعلي، والرموز أو مفاتيح API للمعالجة الدفعية، لتقليل التعارضات الناتجة عن مشاركة مجلد home من الأساس.
عندما تستخدم الفرق Claude Code على نطاق واسع في عنقود حوسبة مشترك، فمن المفيد التخطيط لوسائل المصادقة بوضوح. وإذا احتجت إلى نقطة اتصال API موحدة، يمكنك مراجعة وثائق APIYI على apiyi.com عبر docs.apiyi.com لتقييم الخدمة، مع الرجوع إلى البيانات الفعلية في صفحة الأسعار docs.apiyi.com/models لمعرفة تفاصيل الفوترة.
📚 المراجع
- ملاحظات إصدار Claude Code v2.1.318: المصدر الأساسي لجميع الإصلاحات المذكورة في المقال
- الرابط:
github.com/anthropics/claude-code/releases/tag/v2.1.318 -
التفاصيل: تتضمن ملاحظات التحديث الكاملة حول مجلد home المشترك عبر الشبكة، وانتهاء صلاحية تسجيل الدخول، واستعادة
~/.claude.json -
مركز وثائق APIYI: إرشادات الاتصال بواجهة API وإعداد الأدوات
- الرابط:
docs.apiyi.com -
التفاصيل: عنوان URL الأساسي، والحصول على المفتاح، وطرق الاتصال بصيغتي Anthropic وOpenAI
-
صفحة أسعار نماذج APIYI: المصدر المرجعي لبيانات فوترة النماذج
- الرابط:
docs.apiyi.com/models - التفاصيل: يُرجع إلى البيانات المحدثة في هذه الصفحة لمعرفة أسعار وحدات الإدخال والإخراج، وأسعار التخزين المؤقت، وغيرها من تفاصيل الفوترة
المؤلف: فريق APIYI التقني
التواصل التقني: إذا واجهت مشكلات عند نشر Claude Code في بيئة مشتركة، يمكنك التواصل معنا عبر الصفحة الرئيسية لـ APIYI على apiyi.com. ولمزيد من مواد الاتصال، تفضل بزيارة مركز الوثائق على docs.apiyi.com.
