«Unable to connect to API: SSL certificate verification failed» على Mac

يطبع Claude Code هذا عندما تأتي الشهادة من جهة لا يثق بها. تذكر الوثائق وكيل مؤسسة يفحص TLS أو بوابة بجهة تصديق خاصة.

أصلحها مع وكيلكينسخ طلبًا لـ Claude Code أو Codex أو أي وكيل يستطيع استخدام الطرفية.

يواجه 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 في Terminal على جميع إصدارات macOS الحالية.تاريخ التحقق: 29 أكتوبر 2026

الأعراض

  • يطبع 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.
  • ساعة خاطئة. التاريخ البعيد عن الصحيح يعطّل فحص الشهادات.

كيفية التحقق

  1. اقرأ الجهة المصدِرة.

    curl -v -o /dev/null https://api.anthropic.com 2>&1 | grep -i issuer
  2. اعرض المتغيّر.

    echo $NODE_EXTRA_CA_CERTS
  3. شغّل Claude Code مع سجل التصحيح، ثم اقرأ أسطر جهة التصديق في السجل.

    claude --debug
  4. تحقق من التاريخ.

    date

كيفية الإصلاح

  1. احصل على حزمة جهات التصديق من المسؤول بتنسيق PEM.

  2. وجّه Claude Code إليها قبل التشغيل.

    export NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pem
  3. أو أضف جهة التصديق إلى مخزن شهادات النظام في macOS، كما تذكر الوثائق.

  4. لا تضبط NODE_TLS_REJECT_UNAUTHORIZED=0. فهو يوقف التحقق.

باستخدام Kilobat

  1. يختبر طبيب الاتصال في Kilobat مضيف API طبقة بعد طبقة. وتُظهر طبقة TLS من وقّع الشهادة.

    kilobat why https://api.anthropic.com
  2. فحوصات Kilobat هذه مجانية. يشغّلها وكلاء الذكاء الاصطناعي عبر MCP باستخدام diagnose_connection وdiagnose_network. راجع معرفة سبب تعذّر اتصال موقع أو API واحد.

الأسئلة

هل يستخدم Claude Code مخزن شهادات macOS؟

افتراضيًا يثق بجهات تصديق Mozilla المضمّنة وبمخزن نظام التشغيل. وتقرأ عمليات التثبيت الأصلية مخزن النظام دائمًا.

هل يمكنني إيقاف التحقق؟

تقول الوثائق ألا تضبط NODE_TLS_REJECT_UNAUTHORIZED=0.

المصادر

تم التحقق في 29 أكتوبر 2026.