Claude Code Auto Compact: /autocompact والعتبة والحلول
ماذا يفعل auto compact حين تمتلئ نافذة سياقك، وكيف تعمل نافذة /autocompact (تُحفظ الآن لكل نموذج على حدة)، ومتى تضغط ومتى تمسح، وماذا تفعل حين تصبح رسالة «Compacting conversation…» بطيئة.
الخلاصة السريعة
- يلخّص auto compact التاريخ الأقدم عندما تقترب المحادثة من حد السياق. ومنذ v2.1.288، يضغط وضع auto المحادثات الطويلة بدلًا من إفشال كل استدعاء أداة.
- /autocompact 500k يضبط نافذة التفعيل (من 100K إلى 1M توكن) — ومنذ v2.1.288 يُحفظ لكل نموذج على حدة. و/autocompact auto يعود إلى النافذة المضبوطة لنموذجك.
- يُظهر /context ما يستهلك المساحة ومخزن Autocompact المحجوز. اضغط إذا كنت تتابع الميزة نفسها؛ و/clear إذا بدأت شيئًا جديدًا.
- الضغط يقرأ المحادثة كاملة، فالجلسات الطويلة تأخذ وقتها. إن تعطلت، حدِّث Claude Code أولًا — الإصدار 2.1.288 أصلح المحادثات التي كانت تفشل بخطأ «Prompt is too long» بدل الضغط.
Context Management in Claude Code
القناة: Anthropic · Claude3:31
Claude Code release notes — v2.1.288
ملاحظات الإصدار: github.com/anthropics/claude-code
Set the auto-compact window — official documentation
التوثيق: code.claude.com/docs
تمت مطابقة وقائع هذه الصفحة مع توثيق Claude Code الرسمي وسجل تغييرات الإصدار v2.1.288؛ ولقطات الشاشة مأخوذة من الفيديو أعلاه. السلوك الموصوف مطابق لـ Claude Code v2.1.288 (سبتمبر 2026).
لقطات الشاشة إطارات من فيديو Anthropic «Context Management in Claude Code»، استُخدمت مع نسبة المصدر، وكل خطوة مرتبطة بثانية الصوت الأصلي.
auto compact خطوة بخطوة
اعرف ما يملأ سياقك
- 1
اسرد ما هو محمَّل في السياق
شغّل /context وانتقل عبر التفصيل. أدوات MCP تُحمَّل عند الطلب، لكن تعريفاتها والوكلاء المخصصون والمهارات (skills) يحجز كل منها توكنات قبل أن ترسل أول طلب. إيقاف خوادم MCP التي لا يحتاجها مشروعك هو أرخص مساحة ستفرغها على الإطلاق.
يعرض تفصيل /context أدوات MCP والوكلاء المخصصين والمهارات بتكلفة كل منها بالتوكنات قبل بدء أي عمل.شاهد عند 0:10 - 2
اقرأ المساحة الحرة ومخزن autocompact المؤقت
يعرض أعلى /context نافذة النموذج ومقدار استهلاكك — claude-opus-4-6 عند 21k/200k توكن (11%) في هذا العرض التوضيحي. أما الصف الأخير، Autocompact buffer، فهو الهامش الذي يحجزه Claude Code ليعمل الضغط التلقائي قبل أن تمتلئ النافذة فعليًا.
صف Autocompact buffer في /context هو المساحة المحجوزة للضغط — هنا 33k توكن (16.5%).شاهد عند 2:38 - 3
تعرّف على جلسة تمتلئ
الجلسات الطويلة تنمو بنتائج الأدوات: كل قراءة ملف، وكل ملاحظة من مراجعة الكود، وكل إصلاح تضيف رسائل إلى النافذة. جلسة العرض التوضيحي شغّلت مراجعة كود، وسردت ملاحظات مثل غياب التحقق من المدخلات وسر JWT مكتوبًا في الكود، ثم طلبت إصلاحها — وهو بالضبط نوع العمل الذي يصطدم بالحد.
مراجعة كود بملاحظات وإصلاحات هي عمل نمطي للجلسات الطويلة يدفع نافذة السياق نحو حدّها.شاهد عند 0:24 - 4
دع الملخص يُظهر ما ينجو
حين يطول الحوار، يُظهر ملخص Claude Code الذاتي — ترتيب الأولويات وكل رسائل المستخدم والمهام المعلّقة — ما يجب أن يحفظه الملخص. auto compact يعمل بالمنطق نفسه: طلباتك ومقاطع الكود الرئيسية تنجو؛ والنتائج القديمة للأدوات هي أول ما يُطرح.
ترتيب الأولويات ورسائل المستخدم والمهام المعلقة: الحالة التي يجب أن يحملها الملخص المضغوط معه.شاهد عند 0:50
اضغط المحادثة بقصد
- 5
اختر /compact من قائمة الأوامر
اكتب / واقرأ الأوصاف: /clear «Clear conversation history and free up context» و /compact «Clear conversation history but keep a summary in context». هذا السطر الواحد هو كل الفرق — compact يقايض ملخصًا مقابل الاستمرارية، وclear يشتري أقصى مساحة. ويقبل /compact أيضًا تعليمة تركيز مثل /compact Focus on the API changes.
قائمة الأوامر تقولها بلا غموض: /compact يُبقي ملخصًا في السياق، و/clear يفرّغ كل شيء.شاهد عند 0:09 - 6
افهم مؤشر Compacting conversation
عند تشغيل /compact تظهر رسالة «Compacting conversation…» بينما يقرأ النموذج ويلخص كل ما مضى. أما auto compact فيشغّل الروتين نفسه تلقائيًا قرب الحد — وجعل الإصدار v2.1.288 وضع auto يضغط المحادثات الطويلة بدلًا من إفشال كل استدعاء أداة، فلن تتعطل في منتصف المهمة بعد اليوم.
رسالة Compacting conversation… هي المؤشر الذي تراه سواء كان الضغط يدويًا أو تلقائيًا.شاهد عند 0:46 - 7
اقرأ ملخص الضغط
يبدأ الناتج بعبارة «This session is being continued from a previous conversation that ran out of context»، ثم ينقل Primary Request and Intent وKey Technical Concepts وFiles and Code Sections إلى النافذة الجديدة. تتابع العمل والملخص مقام التاريخ الكامل.
يفتح الملخص المضغوط باعتراف أن الجلسة نفد سياقها، ثم يسرد ما حُفظ.شاهد عند 0:48 - 8
استعد التفاصيل من النص الكامل
إن أسقط الملخص شيئًا تحتاجه، فملاحظات الضغط تخبرك أين تنظر: «read the full transcript at» يليها مسار .jsonl، إضافة إلى قسمَي Current Work وOptional Next Step. وتحذير التوثيق صالح في كل الأحوال — التعليمات التفصيلية من بداية المحادثة قد تضيع، فاجعل القواعد الدائمة في CLAUDE.md.
Current Work وOptional Next Step ومسار النص الكامل هي نقاط الاسترداد الثلاث بعد الضغط.شاهد عند 0:52
امسح، فوّض، استعد
- 9
استخدم /clear عند انتهاء المهمة
تبدأ ميزة جديدة؟ /clear يمحو المحادثة تمامًا — والتوثيق ينبّه إلى أنه بلا تكلفة، بينما ضغط سياق كبير هو بحد ذاته طلب كبير. نفّذ /rename أولًا لتبقى الجلسة المنتهية قابلة للعثور عبر /resume، وضع في CLAUDE.md ما تحتاج الجلسات المستقبلية معرفته.
/clear يبدأ من الصفر دون ملخص — أعِد تسمية الجلسة أولًا ليجدها /resume لاحقًا.شاهد عند 3:14 - 10
فوّض القراءات الثقيلة إلى وكيل فرعي
الوكلاء الفرعيون (subagents) يعملون في نافذة سياق مستقلة ويعيدون إلى الجلسة الرئيسية ملخصًا فقط. وإطلاق وكيل code-reviewer الفرعي كما في العرض يجعل مخرجات المراجعة خارج نافذتك كليًا — وهو جواب التوثيق لأسئلة «أين X؟» التي تحتاج الجواب لا الرحلة.
إطلاق وكيل code-reviewer فرعي: العمل يجري خارج نافذة السياق الرئيسية.شاهد عند 2:50 - 11
دع الوكيل الفرعي يعمل واحتفظ بالجواب
بينما يلخص الوكيل الفرعي عمليات إعادة الهيكلة ويحدّث المهام، لا تستقبل نافذتك الرئيسية إلا النتيجة. مخرجات أدوات أقل في المسار الرئيسي تعني أن auto compact يتفعّل لاحقًا — أو لا يتفعّل أبدًا. هذه أرخص طريقة تمنع مشروعًا طويلًا من بلوغ المخزون الاحتياطي.
يعيد الوكيل الفرعي تقريرًا ملخصًا فقط — الجلسة الرئيسية لم تخزّن المخرجات الوسيطة أبدًا.شاهد عند 2:53
auto compact مقابل /compact و /clear و /rewind
أربعة أوامر تسكن الزاوية نفسها من Claude Code — جميعها يعيد ضبط المحادثة أو يعيد تشكيلها — لكنها تجيب عن أسئلة مختلفة. إليك متى يكون كل منها هو الجواب الصحيح.
- 1auto compact (تلقائي) يتفعّل حين تبلغ المحادثة حد السياق — أو نافذة /autocompact التي ضبطتها. ويلخّص التاريخ الأقدم لتواصل الجلسة مسيرها؛ ومنذ v2.1.288 حتى وضع auto يضغط بدلًا من إفشال استدعاءات الأدوات في المحادثات الطويلة جدًا.
- 2/compact (يدوي مع الاحتفاظ بملخص) ينفّذ التلخيص نفسه عند الطلب — «Clear conversation history but keep a summary in context» كما تقول القائمة. استخدمه حين تجاوزت النافذة لكنك تتابع الميزة نفسها؛ وأضف تركيزًا مثل /compact Focus on the test output.
- 3/clear (بداية من الصفر) يمحو كل شيء دون ملخص وبلا تكلفة — ضغط سياق كبير هو بحد ذاته طلب كبير. استخدمه حين تنتهي الخطة ولا علاقة للعمل التالي بالسابق. نفّذ /rename أولًا ليستطيع /resume إعادة الجلسة القديمة.
- 4/rewind (تراجع) طبيعته مختلفة: نقرة Esc مزدوجة تفتح قائمة التراجع لاستعادة الكود والمحادثة من نقطة تحقق سابقة. استخدمه حين تريد التراجع عن تغييرات حديثة، لا حين تريد مواصلة العمل بعد حد السياق.
- 5القاعدة العملية من جولة Anthropic الرسمية: اضغط إذا تجاوزت النافذة لكنك تحتاج الاستمرارية في الميزة نفسها؛ وامسح إذا كنت تبدأ شيئًا جديدًا؛ وما يجب أن تتذكره الجلسات المستقبلية ضعه في CLAUDE.md — فهو ينجو من الاثنين.
وهناك تمييز آخر يستحق المعرفة: الضغط فاقد للتفاصيل بطبيعته. تُحفظ طلباتك ومقاطع الكود الرئيسية، لكن التعليمات التفصيلية من بداية المحادثة قد تضيع — هذا هو ثمن المساحة المحرَّرة، ولهذا تسكن القواعد الدائمة في CLAUDE.md لا في سجل المحادثة.
رسالة Compacting conversation بطيئة أو عالقة؟ الإسعافات الأولى
الضغط يقرأ المحادثة كاملة، لذا فالجلسة الكبيرة تستغرق وقتًا ظاهرًا في التلخيص — وهذا وحده ليس خللًا. هذه هي الحالات التي يكون هناك خلل حقيقي فيها، وما يجب فعله.
- 1خطأ «Prompt is too long» بدل الضغط — حدِّث Claude Code أولًا. أصلح الإصدار v2.1.288 حالة المحادثات الطويلة التي كانت تفشل بهذا الخطأ بدل الضغط التلقائي عندما يُبلِّغ آخر رد عن استهلاك صفير. الإصدارات الأقدم تتعطل عند هذه النقطة بالذات.
- 2ينتهي الضغط ويمتلئ السياق فورًا (thrashing). قراءة ملف ضخم واحدة أو ناتج أداة واحد قد يعيد ملء النافذة بعد كل ملخص مباشرة؛ وعندها يتوقف Claude Code عن الضغط التلقائي بعد محاولات قليلة ويعرض خطأ بدل الدوران في حلقة. نفّذ /clear أو قسّم المهمة أو فوّض القراءة الثقيلة لوكيل فرعي.
- 3بوابة أو وسيط يرفض الطلبات الكبيرة. إذا كان نقطة النهاية لديك ترفض أي شيء فوق 200K توكن، فاضبط CLAUDE_CODE_AUTO_COMPACT_WINDOW=200000 ليُفعَّل الضغط مبكرًا، بدلًا من ترك الجلسات تنمو بما يتجاوز ما تقبله البوابة.
- 4/autocompact يقول إن القيمة حُفظت لكنه لا يطبّقها. نطاق أعلى أولوية — الإعدادات المُدارة مثلًا — يتجاوزها؛ والأمر نفسه ينبّهك حين يحدث ذلك. أما متغير البيئة CLAUDE_CODE_AUTO_COMPACT_WINDOW فيتغلب على الكل، بما في ذلك /autocompact.
- 5بل هو بطيء فعلًا. تلخيص نافذة شبه ممتلئة طلب كبير؛ امنحه دقيقة قبل إعادة تشغيل /compact، وإن لم تكن بحاجة إلى الملخص أصلًا فـ /clear فوري ومجاني. وإبقاء خوادم MCP غير ذات الصلة مطفأة يقصّر كل ضغط قادم أيضًا.
إذا ظل الضغط يفشل في الجلسة نفسها، فمخرج النجدة يدوي: /rename للجلسة ثم /clear ثم /resume لاحقًا — أو تابع من الملخص المضغوط الذي أنتجه التشغيل الأخير. لا شيء على القرص يضيع؛ الضغط يعيد تشكيل ذاكرة المحادثة فقط.