«Unable to connect to API: SSL certificate verification failed» على Mac
يطبع Claude Code هذا عندما تأتي الشهادة من جهة لا يثق بها. تذكر الوثائق وكيل مؤسسة يفحص TLS أو بوابة بجهة تصديق خاصة.
يواجه Mac لديّ هذه المشكلة: «Unable to connect to API: SSL certificate verification failed» على Mac. اقرأ https://kilobat.app/ar/guides/claude-code-ssl-certificate-verification-failed.md وتابعه معي. ثبّت Kilobat CLI إن لم يكن مثبتًا: brew install seifip/kilobat/kilobat. شغّل بنفسك فحوصات Terminal وkilobat الواردة في الدليل وأخبرني بما تجده. اذكر الخطوات التي لا يستطيع تنفيذها غيري. اسألني قبل أن تغيّر أي إعداد.
الأعراض
- يطبع Claude Code الرسالة
Unable to connect to API: SSL certificate verification failed. - يظهر الرمز UNABLE_TO_GET_ISSUER_CERT_LOCALLY، أو يذكر النص self-signed certificate.
- يبدأ ذلك على شبكة عمل.
الأسباب المحتملة
- وكيل يفحص TLS. يعترض وكيل أو جهاز أمان حركة TLS بشهادته الخاصة.
- بوابة بجهة تصديق خاصة. قد تستخدم بوابة LLM شهادة من جهة خاصة.
- ملف جهة تصديق لا يُحمَّل. يحذّر Claude Code عندما لا يستطيع قراءة ملف NODE_EXTRA_CA_CERTS.
- ساعة خاطئة. التاريخ البعيد عن الصحيح يعطّل فحص الشهادات.
كيفية التحقق
اقرأ الجهة المصدِرة.
curl -v -o /dev/null https://api.anthropic.com 2>&1 | grep -i issuerاعرض المتغيّر.
echo $NODE_EXTRA_CA_CERTSشغّل Claude Code مع سجل التصحيح، ثم اقرأ أسطر جهة التصديق في السجل.
claude --debugتحقق من التاريخ.
date
كيفية الإصلاح
احصل على حزمة جهات التصديق من المسؤول بتنسيق PEM.
وجّه Claude Code إليها قبل التشغيل.
export NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pemأو أضف جهة التصديق إلى مخزن شهادات النظام في macOS، كما تذكر الوثائق.
لا تضبط
NODE_TLS_REJECT_UNAUTHORIZED=0. فهو يوقف التحقق.
باستخدام Kilobat
يختبر طبيب الاتصال في Kilobat مضيف API طبقة بعد طبقة. وتُظهر طبقة TLS من وقّع الشهادة.
kilobat why https://api.anthropic.comفحوصات Kilobat هذه مجانية. يشغّلها وكلاء الذكاء الاصطناعي عبر MCP باستخدام
diagnose_connectionوdiagnose_network. راجع معرفة سبب تعذّر اتصال موقع أو API واحد.
الأسئلة
هل يستخدم Claude Code مخزن شهادات macOS؟
افتراضيًا يثق بجهات تصديق Mozilla المضمّنة وبمخزن نظام التشغيل. وتقرأ عمليات التثبيت الأصلية مخزن النظام دائمًا.
هل يمكنني إيقاف التحقق؟
تقول الوثائق ألا تضبط NODE_TLS_REJECT_UNAUTHORIZED=0.
المصادر
تم التحقق في 29 أكتوبر 2026.