«Unable to connect to API» في Claude Code على Mac
يطبع Claude Code الرسالة Unable to connect to API عندما لا يصل الطلب إلى api.anthropic.com. تذكر وثائق Claude Code من الأسباب الشائعة غياب الوصول إلى الإنترنت، وVPN يحظر المضيف، ووكيل مؤسسة لم يُضبط.
يواجه Mac لديّ هذه المشكلة: «Unable to connect to API» في Claude Code على Mac. اقرأ https://kilobat.app/ar/guides/claude-code-unable-to-connect-to-api.md وتابعه معي. ثبّت Kilobat CLI إن لم يكن مثبتًا: brew install seifip/kilobat/kilobat. شغّل بنفسك فحوصات Terminal وkilobat الواردة في الدليل وأخبرني بما تجده. اذكر الخطوات التي لا يستطيع تنفيذها غيري. اسألني قبل أن تغيّر أي إعداد.
الأعراض
- يطبع Claude Code الرسالة
Unable to connect to API. Check your internet connection. - قد تنتهي الرسالة برمز، مثل ENOTFOUND أو EHOSTUNREACH أو ECONNRESET.
- تفشل الطلبات، لكن قد تعمل تطبيقات أخرى.
الأسباب المحتملة
- لا وصول إلى الإنترنت. Mac غير متصل أو بلا DNS.
- VPN يحظر مضيف API. تذكر وثائق Claude Code هذا من الأسباب الشائعة.
- وكيل لم يُضبط. يحتاج وكيل المؤسسة المطلوب إلى
HTTPS_PROXYقبل التشغيل. - وكيل يرفض النفق. يعني ERR_PROXY_TUNNEL أن الوكيل رفض النفق. افحص بيانات اعتماده وأنه يسمح بهذا المضيف.
كيفية التحقق
اختبر مضيف API من الصدفة نفسها.
curl -I https://api.anthropic.comاعرض متغيرات الوكيل.
env | grep -i proxyشغّل الفحوصات داخل Claude Code.
/doctorاختبر اسم المضيف عبر macOS.
dscacheutil -q host -a name api.anthropic.com
كيفية الإصلاح
إذا فشل DNS، فأصلحه. راجع تعذر حل DNS على Mac.
خلف وكيل مؤسسة، اضبطه قبل التشغيل.
export HTTPS_PROXY=http://proxy.example.com:8080إذا كنت تستخدم بوابة، فاضبط
ANTHROPIC_BASE_URLعلى عنوانها.أوقف VPN لاختبار قصير. ثم شغّله من جديد.
باستخدام Kilobat
يختبر طبيب الاتصال في Kilobat مضيف API طبقة بعد طبقة: الشبكة والوكيل وDNS والقواعد وIPv4 وIPv6 وTLS والخادم.
kilobat why https://api.anthropic.comفحوصات Kilobat هذه مجانية. يشغّلها وكلاء الذكاء الاصطناعي عبر MCP باستخدام
diagnose_connectionوdiagnose_network. راجع معرفة سبب تعذّر اتصال موقع أو API واحد.
الأسئلة
هل الرمز بين القوسين مهم؟
نعم. يشير ENOTFOUND إلى DNS، وEHOSTUNREACH إلى المسار، وECONNRESET إلى إعادة ضبط الاتصال، وERR_PROXY_TUNNEL إلى الوكيل.
هل أعيد تشغيل Claude Code بعد ضبط متغيّر؟
نعم. تذكر صفحة إعداد الشبكة أن الجلسة الجارية لا تلتقط تغييرات الصدفة اللاحقة.
المصادر
تم التحقق في 29 أكتوبر 2026.