«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 واحد.

الأسئلة

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

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

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

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

المصادر

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