---
title: "«Unable to connect to API» في Claude Code على Mac · أدلة Kilobat"
url: "https://kilobat.app/ar/guides/claude-code-unable-to-connect-to-api"
description: "يطبع Claude Code على Mac الرسالة Unable to connect to API. افحص اتصالك، وVPN يحظر مضيف API، ووكيلًا يجب ضبطه."
---

# «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](https://kilobat.app/ar/guides/dns-server-not-found).
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 واحد](https://kilobat.app/ar/guides/recipes/why-cant-it-connect).

## الأسئلة

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

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

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

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

## المصادر

- [Claude Code: مرجع الأخطاء](https://code.claude.com/docs/en/errors.md)
- [Claude Code: إعداد شبكة المؤسسات](https://code.claude.com/docs/en/network-config.md)

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

## أدلة ذات صلة

- [«Request timed out» في Claude Code على Mac](https://kilobat.app/ar/guides/claude-code-request-timed-out): يطبع Claude Code الرسالة Request timed out عندما لا يردّ API قبل انتهاء مهلة الاتصال.
- [«Unable to connect to API: SSL certificate verification failed» على Mac](https://kilobat.app/ar/guides/claude-code-ssl-certificate-verification-failed): يطبع Claude Code هذا عندما تأتي الشهادة من جهة لا يثق بها.
- [«curl: (6) Could not resolve host» على Mac](https://kilobat.app/ar/guides/curl-could-not-resolve-host): يعني رمز خروج curl رقم 6 أن curl لم يتمكن من الحصول على عنوان لاسم المضيف.
- [إعدادات الوكيل تمنع التطبيقات من الاتصال على Mac](https://kilobat.app/ar/guides/proxy-settings-breaking-apps): يرسل إعداد الوكيل حركة البيانات عبر خادم آخر.
