«Unable to connect to API» في Claude Code على Mac

يطبع Claude Code الرسالة Unable to connect to API عندما لا يصل الطلب إلى api.anthropic.com. تذكر وثائق Claude Code من الأسباب الشائعة غياب الوصول إلى الإنترنت، وVPN يحظر المضيف، ووكيل مؤسسة لم يُضبط.

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

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

الأعراض

  • يطبع 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 أن الوكيل رفض النفق. افحص بيانات اعتماده وأنه يسمح بهذا المضيف.

كيفية التحقق

  1. اختبر مضيف API من الصدفة نفسها.

    curl -I https://api.anthropic.com
  2. اعرض متغيرات الوكيل.

    env | grep -i proxy
  3. شغّل الفحوصات داخل Claude Code.

    /doctor
  4. اختبر اسم المضيف عبر macOS.

    dscacheutil -q host -a name api.anthropic.com

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

  1. إذا فشل DNS، فأصلحه. راجع تعذر حل DNS على Mac.

  2. خلف وكيل مؤسسة، اضبطه قبل التشغيل.

    export HTTPS_PROXY=http://proxy.example.com:8080
  3. إذا كنت تستخدم بوابة، فاضبط ANTHROPIC_BASE_URL على عنوانها.

  4. أوقف VPN لاختبار قصير. ثم شغّله من جديد.

باستخدام Kilobat

  1. يختبر طبيب الاتصال في Kilobat مضيف API طبقة بعد طبقة: الشبكة والوكيل وDNS والقواعد وIPv4 وIPv6 وTLS والخادم.

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

الأسئلة

هل الرمز بين القوسين مهم؟

نعم. يشير ENOTFOUND إلى DNS، وEHOSTUNREACH إلى المسار، وECONNRESET إلى إعادة ضبط الاتصال، وERR_PROXY_TUNNEL إلى الوكيل.

هل أعيد تشغيل Claude Code بعد ضبط متغيّر؟

نعم. تذكر صفحة إعداد الشبكة أن الجلسة الجارية لا تلتقط تغييرات الصدفة اللاحقة.

المصادر

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