المحتويات
يعني Prompt is too long في Claude Code أن الإدخال المرسل يتجاوز حد السياق. وقد تعرض الواجهة التفاعلية الحالية Context limit reached. ميّز أولًا بين سجل طويل يمكن ضغطه وإدخال أول كبير أصلًا. فيما يلي أمثلة للرسائل؛ الأرقام للتوضيح.
Prompt is too long
# مثال لرسالة خطأ API:
prompt is too long: 233153 tokens > 200000 maximumلا يقتصر الإدخال على ما كتبته للتو، بل قد يشمل سجل المحادثة والملفات المقروءة ونتائج الأدوات والتعليمات. في 233153 tokens > 200000 maximum، يتجاوز الإدخال البالغ 233,153 توكن الحد المسموح وهو 200,000. تشمل نافذة السياق نفسها الإدخال والمخرجات المولدة لهذه الإجابة؛ ويشير الخطأ إلى أن الإدخال وحده تجاوز الحد بالفعل. تختلف معالجته عن usage limit الناتج عن نفاد حصة الخطة خلال فترة معينة.
استخدم /compact للسجل الطويل، وقلّل الإدخال إذا كانت الرسالة الأولى كبيرة، وعالج أولًا أي سبب مذكور لفشل الضغط. هذه مسارات التعافي الأساسية. الضغط التلقائي مفعّل افتراضيًا، لكنه لا يضمن منع كل تجاوز. يستند المقال إلى شرح أخطاء Claude Code الرسمي ومواصفات API التي جرى التحقق منها في 21 سبتمبر 2026، ليوضح الأسباب والخطوات وشروط 200K و1M. ويعالج استدعاء API مباشرةً على حدة.
قد يتطلب الخطأ نفسه تقليل أشياء مختلفة
لخّص السجل السابق. إذا امتلأت النافذة فورًا بعد الضغط، قسّم عمليات القراءة الكبيرة.
لا توجد محادثة سابقة لتلخيصها. ابدأ بلصق ومرفقات وتعليمات وأعباء أدوات أصغر.
عالج السبب المصاحب أولًا، مثل فشل المصادقة أو عدم توفر النموذج. التكرار وحده لا يصلحه.
استخدم /context لتفصيل النافذة، و/usage للاستهلاك خلال الفترة أو حصة الخطة. كلاهما يتعلق بالتوكنات، لكنهما يقيسان أمرين مختلفين.
1. معنى هذا الخطأ
نافذة السياق هي الحد الأقصى للمعلومات التي يستطيع النموذج الرجوع إليها وتوليدها في إجابة واحدة. تُقاس بالتوكنات لا بالحروف، وتشمل الإدخال والمخرجات الحالية وتوكنات التفكير. الإدخال المقروء من ذاكرة API المؤقتة يشغل النافذة أيضًا. التخزين المؤقت يغير التسعير أو المعالجة، ولا يجعل المساحة صفرًا. المرجع هو مواصفات نافذة السياق من Anthropic.
يحدث Prompt is too long عندما لا يتسع الإدخال المرسل وحده داخل النافذة. حتى السؤال القصير قد يكون جزءًا من طلب كبير إذا أُرفقت به ملفات أو محادثات سابقة. لذلك قد لا يفيد تقصير السؤال الأخير وحده. للأساسيات، راجع ما نافذة السياق؟
قرب الحد، ينظّف Claude Code مخرجات الأدوات القديمة ويلخّص المحادثة عند الحاجة. لكن لصقًا ضخمًا أو تعطيل الضغط التلقائي أو خطأ مصادقة أثناء الضغط قد يوقفه. وإعادة قراءة الملف الضخم نفسه بعد التلخيص قد تملأ النافذة مجددًا. لا تحدد السبب اعتمادًا فقط على كون الضغط التلقائي مفعّلًا. اقرأ رسالة الخطأ كاملة وافحص ما حُمّل قبلها مباشرة.
2. ما الذي يملأ نافذة السياق؟
يتبع التفصيل التالي شرح طريقة عمل Claude Code. سجل المحادثة المحفوظ ليس مطابقًا لما يُرسل الآن إلى النموذج. إزالة نتائج أدوات قديمة أو التلخيص يغيران محتوى النافذة النشطة.
| العنصر | ما يدخل النافذة | ما ينبغي مراجعته |
|---|---|---|
| سجل المحادثة | التبادلات المرسلة في الطلب الحالي؛ يستبدل الضغط بعض الأجزاء بملخص | /compact للمهمة نفسها، و/clear لمهمة تالية غير مرتبطة |
| الملفات ونتائج الأدوات | المحتوى المقروء ونتائج البحث ومخرجات الأوامر وغيرها | ضيّق البحث، واقرأ الأسطر المطلوبة، أو فوّض التحقيق المفصل لوكيل فرعي |
| MCP | أسماء الأدوات وتعليمات الخادم؛ تحمّل Tool Search التعريفات المفصلة عند الحاجة افتراضيًا | افحص العبء الفعلي عبر /context وعطّل الخوادم غير المستخدمة من /mcp |
| CLAUDE.md والذاكرة | التعليمات المطبقة والذاكرة المحمّلة؛ لا تدخل كل ملفات الذاكرة التلقائية دائمًا | اختصر القواعد الدائمة وافصل الشروح الخاصة بمهام معينة |
| المهارات | عادةً الوصف عند البداية والمحتوى عند الاستخدام؛ قد تؤجل الإعدادات الأوصاف أيضًا | راجع المرشحين غير الضروريين للاستدعاء التلقائي والمحتوى الطويل جدًا |
| تعليمات النظام | تعليمات التشغيل التي يضيفها Claude Code أو بيئة الاتصال | ابدأ بالتعليمات والمرفقات والأدوات التي تتحكم بها |
القول إن وصل MCP يحمّل جميع تعريفات الأدوات المفصلة منذ البداية لا يصف الإعداد الافتراضي الحالي. قد تُحمّل مسبقًا عند تعطيل Tool Search أو ضبط التحميل المسبق أو عدم دعم جهة الاتصال. راجع شروط اتصالك في جدول إعدادات Tool Search الرسمي. فحص /context أدق من تقدير العبء بعدد الخوادم وحده.
يحقق الوكيل الفرعي في نافذة مستقلة ويمكنه إرجاع النتائج دون نقل كل مخرجات الأدوات الوسيطة إلى المحادثة الأصلية. لكن الملخص أو الاستنتاجات العائدة تشغل نافذة الوكيل الرئيسي. طلب نسخ التحقيق كاملًا يقلل الفائدة. حدّد الناتج المطلوب، مثل «أعد الملفات والأسطر المعنية والاستنتاجات والنقاط غير المتحققة فقط». مبادئ التصميم في هندسة السياق.
يعرض /context إشغال النافذة الحالية، ويعرض /usage التوكنات المستهلكة واستخدام الخطة. تكلفة الأخير تقديرية وليست فاتورة نهائية. في البيئات المدعومة، يفحص /skill-doctor عبء المهارات أيضًا، لكن توفره مشروط. إن لم تجده، ابدأ بـ/context. راجع ما الذي يستهلك سياقك؟ لخطوات القياس، وقائمة الأوامر الرسمية لشروط التوفر.
3. حجم النافذة: 200K و1M
تعني 200K مئتي ألف توكن، و1M مليونًا. لكن افحص سعة النموذج، والسعة التي يستخدمها Claude Code لهذا الاتصال، وعتبة الضغط التلقائي، وشروط التسعير كلًّا على حدة. يعرض /status النموذج والحساب الحاليين، ويعرض /model الخيارات المتاحة.
افصل السعة عن شروط الاستخدام
نماذج مثل Sonnet 4.5. قد يعامل Claude Code نموذجًا يدعم 1M على أنه 200K بسبب جهة الاتصال أو إعداد يعطّل 1M.
من الأمثلة على Anthropic API عائلة Fable وSonnet 5 وOpus 4.7 وما بعده. يكون 1M افتراضيًا أحيانًا، فلا يلزم دائمًا إلحاق [1m].
المصدر: إعدادات النماذج والسياق الموسع من Anthropic. تختلف نقطة بدء الضغط التلقائي بحسب الإعدادات والنموذج.
في الاشتراكات، يتضمن Max وTeam وEnterprise سياق Opus 1M، بينما يتطلب Opus 1M على Pro وSonnet 4.6 1M في الاشتراكات أرصدة استخدام. يختلف Sonnet 5 المتصل مباشرةً بـAnthropic API: سياق 1M افتراضي لجميع الخطط، دون أرصدة استخدام إضافية أو اختيار [1m]. للبوابات وإعدادات تعطيل 1M استثناءات، فلا تحكم من اسم النموذج وحده.
تعني «الأسعار القياسية» لـ1M عدم إضافة علاوة للسياق الطويل لكل توكن عند تجاوز 200K. لا تعني زيادة الإدخال بلا حدود مقابل المبلغ الإجمالي نفسه. معالجة توكنات أكثر تزيد الاستخدام. وشمول 1M في الخطة أو احتسابه من الأرصدة مسألة أخرى.
تختلف نسبة الحروف إلى التوكنات بحسب النموذج والمحتوى أيضًا. لا تفترض زيادة ثابتة مع كل نموذج أحدث؛ استخدم عدّ التوكنات للنموذج المستهدف عند التعامل مع API. تحتاج بعض المهام نافذة أكبر، لكن إزالة السجلات غير المرتبطة والتعليمات المكررة أولًا تساعد على تقدير السعة اللازمة.
4. استئناف العمل الآن
اختر الخطوة بحسب ما حدث: سجل متنامٍ أم ملف ضخم أُضيف. الخيارات التالية مرتبة حسب الأولوية.
خطوات إفراغ مساحة في النافذة
/compact ركّز على خطأ المصادقة. يقل العبء مع الحفاظ على السياق./context ثم عطّل خوادم MCP غير الضرورية واختصر CLAUDE.md. افصل الإجراءات المفصلة لتُقرأ عند الحاجة./model لاختيار نموذج بسياق 1M. نفّذ التنظيف في الخطوات 1–4 أولًا. لا تعطّل الضغط التلقائي؛ اتركه مفعّلًا افتراضيًا.استخدم 1 للسجل الطويل و2 للمهمة التالية غير المرتبطة. للإدخال الأول الضخم استخدم 3 و4. إذا ظهر سبب جذري لفشل الضغط، أصلحه أولًا.
إذا فشل /compact برسالة Error during compaction: Conversation too long، فالتفسير الرسمي أن المساحة لا تكفي للملخص الناتج. أفرغ مربع الإدخال واضغط Esc مرتين، ثم اختر من القائمة دورًا يسبق الإدخال الكبير لإرجاع المحادثة. الضغط مرتين وحده لا يرجع عدة أدوار تلقائيًا. إذا اخترت عملية تعيد الشيفرة أيضًا، فافحص نطاقها. جرّب الضغط مجددًا؛ وإن لم تكفِ المساحة، استخدم /clear وابدأ بإدخال أصغر. الشروط في عناصر التحكم الرسمية بلوحة المفاتيح.
إذا تلت automatic compaction failed رسالة فشل مصادقة أو عدم توفر نموذج، فأصلح ذلك قبل إفراغ النافذة. تعني Not enough messages to compact. أن المحادثة السابقة لا تكفي للتلخيص؛ قلّل المرفقات أو النص الملصق بدل تكرار الضغط. إن امتلأت النافذة فورًا بعده، احصر الملفات أو السجلات الكبيرة الأخيرة في الأجزاء اللازمة.
عند استدعاء API مباشرةً
/compact و/clear عمليتان في Claude Code وليستا أمرَي تحكم يُرسلان إلى Messages API. افحص messages وsystem وtools والمرفقات المرسلة، وقدّر الإدخال عبر API عدّ التوكنات للنموذج المستهدف. صغّر الطلب نفسه بتلخيص السجل القديم أو تضييق المستندات أو حذف التعريفات غير اللازمة. لا تقطع الطلب بما يفسد الترابط بين استدعاء الأداة ونتيجتها. توجد آلية compaction في API للمحادثات الطويلة أيضًا، لكن نماذجها وإعداداتها منفصلة عن أوامر Claude Code.
بعد التعافي، تأكد من وصول إجابة لطلب صغير ثم أعد المعلومات اللازمة تدريجيًا. إعادة إرسال الإدخال الضخم نفسه والانتظار لا تزيد السعة. للتنظيم المعتاد، راجع توفير التوكنات في Claude Code.
5. التمييز بين الأخطاء المتشابهة
الإدخال الزائد وحد المخرجات المضبوط وبلوغ النافذة أثناء التوليد واستهلاك الفترة مشكلات مختلفة. اقرأ نص الخطأ أو stop_reason في API بدل الحكم من مظهر إجابة مبتورة فقط.
| العَرَض | المعنى | الإجراء الأساسي |
|---|---|---|
| Prompt is too long / N tokens > M maximum | موضوع المقال: الإدخال تجاوز نافذة السياق | /compact أو /clear أو تفويض القراءات الكبيرة لوكيل فرعي أو نموذج 1M |
| تتوقف الإجابة مبكرًا (stop_reason: max_tokens) | بلغت المخرجات قيمة max_tokens المحددة في الطلب | افحص إعداد المخرجات وحد النموذج في API أو اطلب المتابعة |
| stop_reason: model_context_window_exceeded | بلغ الإدخال مع المخرجات حد النافذة أثناء التوليد | قلّل الإدخال لترك مساحة للمخرجات |
| usage limit reached | نفدت حصة استخدام الخطة، وهو مستقل عن نافذة التوكنات | انتظر إعادة الضبط؛ معالجة حدود الاستخدام |
| Usage credits required for 1M context | مشكلة إتاحة: سياق 1M المختار غير مشمول بالخطة، وليس تجاوز إدخال أو نفاد حصة | فعّل الأرصدة وأعد التشغيل، أو استخدم /model للعودة إلى النافذة القياسية |
بحسب مواصفات Anthropic API، يقبل Claude 4.5 وما بعده الطلب إذا اتسع الإدخال نفسه، ولو تجاوز مجموع الإدخال وmax_tokens المطلوب النافذة. عند بلوغ الحد أثناء التوليد، يتوقف بسبب model_context_window_exceeded، لذا قِصر الإجابة وحده لا يثبت أن السبب max_tokens. للمشكلات الأخرى، راجع أخطاء Claude Code الشائعة.
6. قائمة منع تكرار المشكلة
قبل العمل: افحص المحتوى المحمّل عبر /context. ضيّق المستندات الكبيرة بالبحث أو نطاق الأسطر بدل لصقها كاملة. عند تقسيم التحقيق، حدّد أيضًا نطاق الاستنتاجات التي يعيدها الوكيل الفرعي.
أثناء العمل: اترك الضغط التلقائي مفعّلًا عادةً. إن كنت قد عطّلته، افحص /config والإعدادات المطبقة. راقب أيضًا إعادة قراءة المادة نفسها بعد كل ضغط. الضغط اليدوي الأكثر تكرارًا ليس أفضل تلقائيًا؛ المهم توقيت /compact وتحديد القرارات الواجب الاحتفاظ بها.
بين المهام: قبل مهمة غير مرتبطة، احفظ المعلومات اللازمة في ملفات وابدأ محادثة جديدة عبر /clear. تُحفظ المحادثة السابقة، لكن استئناف السجل الضخم نفسه للتعافي قد يعيد السبب. احتفظ في CLAUDE.md بالقواعد اللازمة كل مرة فقط.
اتصالات مخصصة: مع بوابة أو معرّف نموذج مخصص، تأكد من تطابق النافذة التي يفترضها Claude Code مع السعة الحقيقية لجهة الاتصال. رفع رقم في الإعدادات لا يوسّع نافذة النموذج الفعلية. راجع إعدادات النماذج المخصصة الرسمية مع المسؤول.
الخلاصة
يعني Prompt is too long أن كامل الإدخال، بما فيه السجل والمرفقات، لا يتسع، وليس الجملة الأخيرة فقط. اختر بحسب الحالة: /compact للسجل الطويل، أو تقليل الإدخال الأول الكبير، أو إصلاح السبب الجذري لخطأ الضغط.
تُحمّل تعريفات MCP المفصلة عند الحاجة افتراضيًا. افحص المحتوى الحالي عبر /context بدل الحكم من عدد الخوادم وحده. مع 1M افحص النموذج والاتصال والخطة وافصل السعة عن السعر وعتبة الضغط التلقائي. عند استخدام API مباشرةً، افحص الطلب وسبب التوقف بدل الاعتماد على أوامر Claude Code.
FAQ
س. هل “Prompt is too long” و“usage limit reached” متماثلان؟
ج. لا. الأول تجاوز حد السياق لطلب واحد، والثاني حصة استخدام الخطة. قلّل المحتوى المرسل للإدخال الزائد. لا يعيد /clear حصة الخطة.
س. لماذا يحدث مع تفعيل الضغط التلقائي؟
ج. قد يكون السبب إدخالًا ضخمًا أو غياب محادثة سابقة للتلخيص أو فشل الضغط أو امتلاء النافذة فورًا بعده. لا تحصر التشخيص في احتمالين؛ اقرأ الخطأ كاملًا وافحص القراءات الأخيرة. عالج أولًا السبب المصاحب كفشل المصادقة.
س. يفشل /compact أيضًا برسالة “Conversation too long”.
ج. التفسير الرسمي هو نقص مساحة الملخص. أفرغ الإدخال واضغط Esc مرتين واختر دورًا أقدم من القائمة لإرجاع المحادثة ثم أعد المحاولة. إن لم تكفِ المساحة، سجّل المهم وابدأ أصغر بعد /clear. افحص النطاق قبل اختيار إجراء يعيد الشيفرة.
س. هل الانتقال إلى نموذج 1M يحل المشكلة؟
ج. قد يساعد إن اتسع الإدخال المطلوب، لكن الشروط تختلف بحسب النموذج والاتصال والخطة. السعر القياسي لكل توكن لا يعني المبلغ الإجمالي نفسه مع معالجة أكثر. تقليل السجل غير الضروري والمخرجات الكبيرة أولًا يساعد على اختيار السعة.
س. كيف أعرف ما يشغل النافذة؟
ج. استخدم /context في Claude Code. يختلف ذلك عن الاستهلاك التراكمي أو حصة الخطة في /usage. بعض تعريفات MCP تُحمّل عند الحاجة، فلا تعتمد على عدد الاتصالات وحده. مع API قدّر الطلب باستخدام API عدّ التوكنات للنموذج المستهدف.
