«Request timed out» في Claude Code على Mac
يطبع Claude Code الرسالة Request timed out عندما لا يردّ API قبل انتهاء مهلة الاتصال. مهلة الطلب الافتراضية 10 دقائق.
يواجه 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 الرسالة
Request timed outبعد انتظار طويل. - يحدث على الشبكات البطيئة، أو عبر الوكلاء، أو مع الطلبات الكبيرة.
- تنجح بعض إعادة المحاولة.
الأسباب المحتملة
- شبكة أو وكيل بطيء. تذكر الوثائق أن الشبكة أو الوكيل البطيء قد يسبب ذلك.
- اتصال متوقف. قد يحتجز VPN أو جدار حماية الحزم، فلا يصل أي رد.
- طلب كبير. يحتفظ الطلب غير المتدفق بحد 300 ثانية في الجلسة المحلية.
- مهلة صفرية في إصدار قديم. في الإصدارات الأقدم من v2.1.305، قد يؤدي ضبط API_TIMEOUT_MS على 0 إلى فشل كل طلب.
كيفية التحقق
اختبر مضيف API من الصدفة نفسها.
curl -I https://api.anthropic.comتحقق من إصدارك.
claude --versionاعرض متغيرات الوكيل.
env | grep -i proxyشغّل فحوصات الإعداد داخل Claude Code.
/doctor
كيفية الإصلاح
أعد الطلب.
على شبكة أو وكيل بطيء، ارفع المهلة.
export API_TIMEOUT_MS=900000حدّث Claude Code إذا ضبطت المهلة على 0.
إذا تكررت انتهاءات المهلة، فاختبر شبكة أخرى وVPN.
باستخدام Kilobat
يختبر طبيب الاتصال في Kilobat مضيف API طبقة بعد طبقة. ويسمّي الطبقة التي تفشل أو تبطئ.
kilobat why https://api.anthropic.comفحوصات Kilobat هذه مجانية. يشغّلها وكلاء الذكاء الاصطناعي عبر MCP باستخدام
diagnose_connectionوdiagnose_network. راجع معرفة سبب تعذّر اتصال موقع أو API واحد.
الأسئلة
ما المهلة الافتراضية؟
تذكر وثائق Claude Code أن مهلة الطلب 10 دقائق.
هل يوقف API_TIMEOUT_MS=0 كل المهل؟
لا. تبقى مهلة أول بايت ومهلة خمول المحتوى قيد التشغيل.
المصادر
تم التحقق في 29 أكتوبر 2026.