---
title: "«Request timed out» في Claude Code على Mac · أدلة Kilobat"
url: "https://kilobat.app/ar/guides/claude-code-request-timed-out"
description: "يطبع Claude Code على Mac الرسالة Request timed out. لم يردّ API قبل انتهاء المهلة. افحص الشبكة والوكيل وإعداد المهلة."
---

# «Request timed out» في Claude Code على Mac

يطبع Claude Code الرسالة Request timed out عندما لا يردّ API قبل انتهاء مهلة الاتصال. مهلة الطلب الافتراضية 10 دقائق.

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

يواجه Mac لديّ هذه المشكلة: «Request timed out» في Claude Code على Mac. اقرأ https://kilobat.app/ar/guides/claude-code-request-timed-out.md وتابعه معي. ثبّت Kilobat CLI إن لم يكن مثبتًا: brew install seifip/kilobat/kilobat. شغّل بنفسك فحوصات Terminal وkilobat الواردة في الدليل وأخبرني بما تجده. اذكر الخطوات التي لا يستطيع تنفيذها غيري. اسألني قبل أن تغيّر أي إعداد.

ينطبق على: Claude Code في Terminal على جميع إصدارات macOS الحالية. · تاريخ التحقق: 29 أكتوبر 2026

## الأعراض

- يطبع Claude Code الرسالة `Request timed out` بعد انتظار طويل.
- يحدث على الشبكات البطيئة، أو عبر الوكلاء، أو مع الطلبات الكبيرة.
- تنجح بعض إعادة المحاولة.

## الأسباب المحتملة

- **شبكة أو وكيل بطيء.** تذكر الوثائق أن الشبكة أو الوكيل البطيء قد يسبب ذلك.
- **اتصال متوقف.** قد يحتجز VPN أو جدار حماية الحزم، فلا يصل أي رد.
- **طلب كبير.** يحتفظ الطلب غير المتدفق بحد 300 ثانية في الجلسة المحلية.
- **مهلة صفرية في إصدار قديم.** في الإصدارات الأقدم من v2.1.305، قد يؤدي ضبط API_TIMEOUT_MS على 0 إلى فشل كل طلب.

## كيفية التحقق

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

   ```
   curl -I https://api.anthropic.com
   ```
2. تحقق من إصدارك.

   ```
   claude --version
   ```
3. اعرض متغيرات الوكيل.

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

   ```
   /doctor
   ```

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

1. أعد الطلب.
2. على شبكة أو وكيل بطيء، ارفع المهلة.

   ```
   export API_TIMEOUT_MS=900000
   ```
3. حدّث Claude Code إذا ضبطت المهلة على 0.
4. إذا تكررت انتهاءات المهلة، فاختبر شبكة أخرى وVPN.

## باستخدام Kilobat

1. يختبر طبيب الاتصال في Kilobat مضيف API طبقة بعد طبقة. ويسمّي الطبقة التي تفشل أو تبطئ.

   ```
   kilobat why https://api.anthropic.com
   ```
2. فحوصات Kilobat هذه مجانية. يشغّلها وكلاء الذكاء الاصطناعي عبر MCP باستخدام `diagnose_connection` و`diagnose_network`. راجع [معرفة سبب تعذّر اتصال موقع أو API واحد](https://kilobat.app/ar/guides/recipes/why-cant-it-connect).

## الأسئلة

**ما المهلة الافتراضية؟**

تذكر وثائق Claude Code أن مهلة الطلب 10 دقائق.

**هل يوقف API_TIMEOUT_MS=0 كل المهل؟**

لا. تبقى مهلة أول بايت ومهلة خمول المحتوى قيد التشغيل.

## المصادر

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

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

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

- [«Unable to connect to API» في Claude Code على Mac](https://kilobat.app/ar/guides/claude-code-unable-to-connect-to-api): يطبع Claude Code الرسالة Unable to connect to API عندما لا يصل الطلب إلى api.anthropic.com.
- [ERR_CONNECTION_TIMED_OUT في Chrome على Mac](https://kilobat.app/ar/guides/err-connection-timed-out): يصف Chromium هذا الخطأ بأنه «انتهت مهلة محاولة الاتصال». وجد Chrome العنوان، لكن الخادم لم يرد في الوقت المحدد.
- [امتلاء المخزن المؤقت: تتأخر المكالمات عند انشغال الشبكة](https://kilobat.app/ar/guides/bufferbloat-mac): امتلاء المخزن المؤقت هو زمن استجابة تضيفه أجهزة الشبكة عندما تحتفظ ببيانات أكثر من اللازم في مخازنها المؤقتة.
- [اختبر فقدان الحزم على Mac باستخدام ping](https://kilobat.app/ar/guides/packet-loss-mac): يتسبب فقدان الحزم في تقطع المكالمات وتوقف الصفحات.
