ما هو Auto Compact في Claude Code

Claude Code هو مساعد ترميز قائم على الوكلاء من Anthropic يمكنه قراءة قواعد الشيفرة، وتحرير الملفات، وتشغيل الأوامر، والاندماج مع الأدوات عبر الطرفية وIDE وتطبيق سطح المكتب وسير عمل المتصفح. وبسبب عمله داخل نافذة سياق مشتركة، تمتلئ الجلسات الطويلة في النهاية بسجل الدردشة ومخرجات الملفات وضجيج الأدوات. يدير Claude Code هذا تلقائياً عبر ضغط سجل المحادثة عند الاقتراب من الحد، وقد تُفقد التعليمات المبكرة إذا كانت موجودة فقط في سجل الدردشة.

يصبح ذلك أكثر أهمية في 2026 لأن Anthropic تواصل دفع Claude Code نحو عمل أطول وأكثر استقلالية. في 25 مارس 2026، نشرت Anthropic “Claude Code auto mode: a safer way to skip permissions”، قائلة إن المستخدمين يوافقون على 93% من مطالبات الأذونات وواصفةً الوضع التلقائي بأنه حل وسط قائم على المصنف بين الموافقة اليدوية وتخطي الأذونات غير الآمن. في 5 فبراير 2026، أطلقت Anthropic أيضاً Claude Opus 4.6، مع إبراز ترميز أقوى وتصحيح أخطاء أفضل وجلسات أكثر وكلائية. هذه التحديثات ليست هي نفسها الضغط التلقائي، لكنها تُظهر اتجاه المنتج بوضوح: انقطاعات أقل، جلسات أطول، واستمرارية أكثر موثوقية.

يوفر CometAPI حالياً الوصول إلى Claude API بسعر أقل من الـ API الرسمي، على سبيل المثال Claude Sonnet 4.6، Claude Opus 4.6، وClaude 5.

ما الذي يعنيه Auto Compact فعلاً في Claude Code

Auto Compact هو آلية مدمجة لتحسين السياق في Claude Code (أداة CLI/سطح المكتب من Anthropic) وفي منظومة Claude API الأوسع. يتدخل تلقائياً عندما تقترب محادثتك من سقف نافذة السياق الخاصة بالنموذج — عادةً حوالي 200,000 رمز للنماذج الرائدة مثل Claude Opus 4 أو Sonnet 4. توثيق الخطافات واضح: PreCompact يُطلق قبل عملية الضغط، وauto كمطابِق يعني “الضغط التلقائي عندما تمتلئ نافذة السياق”. خطاف PostCompact المطابق يُطلق بعد اكتمال الضغط، ويتلقى compact_summary المُولّد.

هذا مهم لأن الضغط ليس هو نفسه “الذاكرة”. الذاكرة التلقائية هي نظام تدوين الملاحظات الخاص بـ Claude، بينما الضغط هو آلية لإدارة الجلسات تقوم بضغط حالة المحادثة الحية. توضح وثائق الذاكرة أن CLAUDE.md ثابت، والذاكرة التلقائية يكتبها Claude، والضغط هو اللحظة التي يُختزل فيها تاريخ المحادثة للجلسة حتى يتمكن النموذج من مواصلة العمل.

بدلاً من فرض بدء دردشة جديدة (وفقدان السجل) أو ترك النموذج “ينسى” التفاصيل الحرجة، يقوم Auto Compact بما يلي:

1. تحليل السجل الكامل — لتحديد العناصر الأساسية الجديرة بالإبقاء.
2. إنشاء ملخص موجز — للقرارات وهيكلية الشيفرة والأخطاء المُعالَجة وحالة الملفات والخطوات التالية.
3. استبدال الرسائل الأقدم — بهذا الملخص (كتلة “ضغط” في مصطلحات الـ API).
4. استئناف العمل بسلاسة — مع الحفاظ على السياق.

نقاط بيانات رئيسية (2026):

• عتبة التشغيل: افتراضياً عند ~95% من السعة (أو ~25% متبقية). أفاد بعض المستخدمين بوجود مخزن داخلي يحتفظ بـ 20–45k رمز (~22.5% من السياق) لعملية الضغط نفسها.
• تحسين الأداء: منذ Claude Code v2.0.64، أصبح الضغط “آنيّاً” بدلاً من أن يستغرق دقائق.
• مثال على توفير الرموز (من مقاييس Claude Agent SDK): انخفضت رموز الإدخال في سير عمل مكوّن من 5 تذاكر من 204k إلى 82k (انخفاض 58.6%) مع حدثي ضغط.

Auto Compact ليس هو نفسه /clear (الذي يمحو كل شيء) ولا مجرد اقتطاع بسيط. إنه يحافظ بذكاء على ما يهم — فروقات الشيفرة الأخيرة، الخيارات المعمارية، اصطلاحات التسمية — بينما يكثّف حلقات تصحيح الأخطاء المحلولة والتفرعات الاستكشافية.

لماذا تستخدم Auto Compact في Claude Code؟

الجلسات الطويلة هي القاعدة. قد يمتد تنفيذ ميزة واحدة إلى أكثر من 50 دورة: تخطيط، تصحيح أخطاء، إعادة هيكلة، اختبار. بدون ضغط، يزداد استخدام الرموز خطيًا، تتدهور جودة الاستجابة، وتقفز التكاليف.

بالنسبة للمطورين، المكسب هو تقليل إرهاق إعادة البدء. بدلاً من نسخ ملخص يدويًا إلى جلسة جديدة، دع Claude يضغط الجلسة وتابع العمل. يكون ذلك مفيداً بشكل خاص في إصلاح الأخطاء، وإعادة هيكلة متعددة الملفات، والتغييرات المدفوعة بالاختبارات، وسير العمل المعتمد على المراجعة حيث قد تصبح المحادثة طويلة جداً. تبدأ جلسات Claude Code بنافذة سياق جديدة، لذا فإن الضغط هو إحدى الآليات الأساسية التي تجعل العمل طويل الأمد عملياً.

الفوائد الأساسية

• طول جلسة غير محدود: متابعة إلى أجل غير مسمى دون البدء من جديد.
• كفاءة في التكلفة والأداء: يقلل رموز الإدخال بشكل كبير. تُظهر تقارير واقعية وفورات بنسبة 50–60% في سير العمل متعدد المراحل.
• تركيز واستقرار أفضل: يمنع “تحميل السياق الزائد” حيث يهلوس النموذج أو ينسى القيود السابقة.
• يحافظ على المعرفة المؤسسية: تبقى القرارات الرئيسية في السياق حتى بعد مئات الرسائل.
• سلس لسير العمل القائم على الوكلاء: حاسم عند استخدام الأدوات أو خوادم MCP أو إعدادات متعددة الوكلاء في Claude Code.

متى ينبغي الاعتماد على الضغط التلقائي؟

استخدم الضغط التلقائي عندما تكون المهمة بطبيعتها طويلة: إعادة هيكلة متعددة الملفات، جلسات تصحيح أخطاء تتأرجح بين السجلات ومصدر الشيفرة، تنفيذ ميزة مع تحقق متكرر، أو بحث يتطلب العديد من استدعاءات الأدوات. تشير وثائق Anthropic صراحةً إلى الجلسات الطويلة حيث تمتلئ نافذة السياق بمحادثات غير ذات صلة ومحتويات ملفات وأوامر، وتقول إن الضغط التلقائي يحافظ على الشيفرة والقرارات الرئيسية ويحرر مساحة.

وهو أقل ملاءمة عندما تكون المهمة قصيرة ومعزولة أو تتطلب تعليمات دقيقة ودائمة الاحتفاظ. قد تضيع التعليمات من بداية المحادثة بعد الضغط، ولهذا السبب ينبغي وضع قواعد المشروع في CLAUDE.md، وليس في موجه عابر قد يُضغط لاحقاً.

متى تُستخدم (أو تُفعَّل):

• يكون مفعلاً افتراضياً لمعظم المستخدمين — مثالي للترميز اليومي، وإعادة الهيكلة الكبيرة، أو المشاريع الاستكشافية.
• المهام طويلة الأمد — معالجة طوابير، أنابيب بيانات، أو قواعد شيفرة متعددة الملفات.
• بيئات الفرق/المؤسسات — حيث تهم استمرارية السياق عبر الجلسات.
• المشاريع عالية المخاطر — حيث قد يكلّف فقدان قرار معماري واحد ساعات.

متى تفكر في تعطيله (عبر /config):

• تريد كل رمز من السياق للتحكم فائق الدقة.
• تفضِّل إدارة يدوية بالكامل (مستخدمون متقدمون يحفظون/يستعيدون الخطط عبر ملفات).

أحدث الأخبار (2025–2026): في مارس 2025، حسَّنت Anthropic منطق الحفظ في Auto Compact، ما جعل الملخصات أذكى في الاحتفاظ بـ“المعلومات المهمة مع تقليل استخدام الرموز”. بحلول أواخر 2025، تم تحسين آلية التشغيل (أحياناً أبكر عند استخدام 64–75% لتجنب فشل الضغط). شهد أوائل 2026 أخطاء مؤقتة في واجهات الويب/سطح المكتب (وُسِمت بالمُعالَجة منتصف يناير مع تقارير متبقية)، بينما ظل CLI مستقراً. جعل الإصدار 2.0.64 (فبراير 2026) الضغط لحظياً — مكسباً كبيراً لتجربة المطور.

كيفية استخدام Auto Compact في Claude Code: دليل خطوة بخطوة

تم تصميم Claude Code بحيث تبدأ كل جلسة بنافذة سياق جديدة. هذا مفيد لأن كل مهمة جديدة تبدأ بنظافة، ويسهّل أيضاً ملاحظة متى تصبح الجلسة صاخبة. يوصى باستخدام /clear بين المهام غير المرتبطة حتى لا يستمر السياق القديم في استهلاك المساحة.

الخطوة 1: التحقق من حالة السياق الحالية

استخدم /context لتصوير حمل السياق الحالي. تقول قائمة الأوامر المدمجة في Claude Code إن /context يُظهر شبكة ملوّنة ويبرز انتفاخ الذاكرة واقتراحات التحسين وتحذيرات السعة. هذا يجعله أسرع طريقة لمعرفة ما إذا كنت تقترب من النقطة التي يُحتمل أن يبدأ فيها الضغط التلقائي.

في جلسة Claude Code الخاصة بك، اكتب:

/context

سيعرض “Context left until auto-compact: XX%” — شريط تقدمك في الزمن الحقيقي.

الخطوة 2: تهيئة الضغط التلقائي (اختياري)

عندما تمتلئ نافذة السياق، يقوم Claude Code بضغط المحادثة تلقائياً. يُسمّي مرجع الخطافات هذا الحدث بـauto، ويُطلق عندما تمتلئ نافذة السياق. عملياً، لا “تشغّل” الضغط التلقائي بقدر ما تسمح لـ Claude Code بالقيام به عند الحاجة.

/config

انتقل إلى “Auto-compact enabled” وبدّل true/false. الوضع الافتراضي مفعل. يمكنك أيضاً ضبط الإعدادات ذات الصلة مثل استخدام خوادم MCP لتحرير الرموز بشكل استباقي.

الخطوة 3: دع الضغط التلقائي يعمل تلقائياً

عندما تصل إلى ~95%:

• يعرض Claude “Compacting our conversation so we can keep chatting…” (أو ما شابه).
• يعمل في الخلفية ثم يستأنف.
• سترى الملخص الجديد أعلى السياق.

نصيحة مهمة: لا تنتظر 0%. قم بالضغط يدوياً مبكراً لنتائج أفضل (انظر أفضل الممارسات أدناه).

الخطوة 4: استخدم الخطافات إن أردت أتمتة ما يحدث حول الضغط

يوفر Claude Code خطافي PreCompact وPostCompact. يُظهر مرجع الخطافات أن PreCompact يمكنه اكتشاف ما إذا كان الضغط يدوياً أو تلقائياً، وأن PostCompact يتلقى compact_summary المُولّد. يجعل ذلك الخطافات ملائمة للتسجيل، ومسارات التدقيق، والملاحظات بعد الضغط، أو الأتمتة الخارجية.

نمط خطاف بسيط يبدو هكذا:

{  "hooks": {    "PostCompact": [      {        "matcher": "auto",        "hooks": [          {            "type": "command",            "command": "./scripts/save-compact-summary.sh"          }        ]      }    ]  }}

ويمكن لبرنامج الصدفة المطابق قراءة إدخال JSON من stdin، لأن خطافات أوامر Claude Code تتلقى JSON بهذه الطريقة:

#!/usr/bin/env bashset -euo pipefailjq -r '.compact_summary // empty' \  | sed 's/^/[compact] /' \  >> .claude/compact-log.txt

تؤكد الوثائق أن خطافات الأوامر تتلقى JSON عبر stdin، وأن PostCompact يتضمن compact_summary، لذا يتوافق هذا النمط مع نموذج الخطافات الحالي.

الخطوة 5: ضغط يدوي بدقة (موصى به)

استخدم /compact عندما تريد من المساعد ضغط السلسلة الآن. يمكنك تضمين تعليمات تُشكل الملخص الذي تريد الحفاظ عليه. تُدرج صفحة الأوامر المدمجة من Anthropic الأمر /compact [instructions] باعتباره “ضغط المحادثة مع تعليمات تركيز اختيارية”،

/compact keep the auth flow decisions, the current test plan, and the open TODOs

هذا النمط مفيد قبل التسليم، قبل تبديل الفرع، أو قبل أن تطلب من Claude بدء مرحلة جديدة من العمل.

أمثلة من الاستخدام الواقعي:

• بعد التصحيح: /compact keep the solution we found, remove debugging steps
• محطة مشروع: /compact focus on the new feature requirements

الضغط على مستوى الـ API (متقدم — Python SDK وMessages API)

بالنسبة للوكلاء المخصصين أو السكربتات، استخدم أدوات الضغط الرسمية.

مثال Claude Agent Python SDK (تلقائي لسير العمل الذي يستخدم أدوات):

from anthropic import Anthropic

client = Anthropic()

runner = client.beta.messages.tool_runner(
    model="claude-opus-4-6",
    max_tokens=4096,
    tools=your_tools,
    messages=messages,
    compaction_control={
        "enabled": True,
        "context_token_threshold": 100000,  # or lower for aggressive compaction
        "model": "claude-haiku-4-5",        # cheaper summarizer
        "summary_prompt": """Create a focused summary preserving:
1. COMPLETED TASKS and key outcomes
2. CURRENT STATE and open items
3. NEXT STEPS
Wrap in <summary></summary> tags."""
    }
)

اكتشف أحداث الضغط:

if curr_msg_count < prev_msg_count:
    print(f"Compaction occurred! Messages reduced from {prev_msg_count} to {curr_msg_count}")
```<grok-card data-id="f4afb5" data-type="citation_card" data-plain-type="render_inline_citation" ></grok-card>

**Full Messages API (beta, 2026)** – يتطلب الترويسة:
```bash
curl https://api.anthropic.com/v1/messages \
  --header "anthropic-beta: compact-2026-01-12" \
  --data '{
    "model": "claude-opus-4-6",
    "messages": [...],
    "context_management": {
      "edits": [{
        "type": "compact_20260112",
        "trigger": {"type": "input_tokens", "value": 150000},
        "pause_after_compaction": true
      }]
    }
  }'

يعيد الـ API كتلة ضغط يجب أن تمُرِّرها مرة أخرى في المكالمات المستقبلية. تمنحك التعليمات المخصصة والإيقاف المؤقت تحكماً كاملاً في الميزانية (مثلاً: فرض حد إجمالي 3M رمز عبر الجلسات).

إذا كنت تستخدم Claude API الخاص بـ CometAPI، فغيّر ترويسة الرسالة إلى "https://api.cometapi.com/v1/messages\\".

Auto-Compact مقابل الضغط اليدوي مقابل Clear: جدول مقارنة

أفضل الممارسات للضغط التلقائي في Claude Code (نصائح احترافية من المطورين)

اضغط بشكل استباقي

القاعدة الثالثة هي استخدام الضغط كإعادة تنظيم، لا كعكاز. إذا امتلأت السلسلة بنهايات مسدودة، اطلب من Claude الضغط مع تعليمات واضحة حول ما يهم: الهدف الحالي، النهج المختار، الاختبارات الفاشلة، والأسئلة غير المحسومة. عملياً، يجعل ذلك الملخص أكثر فائدة بكثير من ترك النظام يضغط عشوائياً والأمل بالأفضل.

اجعل تعليماتك الدائمة قصيرة.

تقول Anthropic إن الملفات التي تتجاوز 200 سطر قد تقلّل الالتزام، لذا فإن كتل السياسات الكبيرة عادة أسوأ من القواعد الموجزة محددة النطاق. استخدم .claude/rules/ لسلوك خاص بنوع الملف أو المسار، واستخدم واردات @path عندما تحتاج تفاصيل داعمة أغنى دون نفخ ملف التعليمات الرئيسي.
حرر الرموز أولاً — عطّل خوادم MCP غير المستخدمة عبر /mcp أو @server-name disable قبل الضغط.

اجمع ذلك مع CLAUDE.md

عامل CLAUDE.md كمصدر الحقيقة لأي شيء تريد أن يبقى عبر جلسة طويلةCLAUDE.md يُعاد قراءته بعد /compact، ما يجعله المكان المناسب لأوامر البناء، واتفاقيات الترميز، والقواعد الدائمة التي لا تريد فقدانها. الذاكرة التلقائية مفيدة أيضاً، لكنها نظام مختلف لغرض مختلف.

نصائح أخرى

راقب عبر /context — أبقِ الاستخدام تحت 70–80% قدر الإمكان.

لمستخدمي الـ API — اضبط عتبات أقل (مثلاً: 50k–100k) واستخدم نماذج تلخيص أرخص مثل Haiku.

لا تعطل إلا عند الحاجة — ينصح معظم المطورين الآن بإبقاء Auto-Compact مفعلاً بعد تحسينات 2025.

اختبر الضغط — أولاً في جلسات غير حرجة لترى كيف يُلخّص سير عملك المحدد.

الأثر الواقعي: أفاد المطورون بزيادة 2–3 مرات في طول الجلسات الإنتاجية وعدد أقل من لحظات “Claude نسي ما كنا نفعله”.

مشاكل شائعة واستكشاف الأخطاء وإصلاحها (إصدار 2026)

• عدم تشغيل الضغط التلقائي: تحقق من الويب/سطح المكتب مقابل CLI؛ تمت معالجة بعض أخطاء يناير 2026 لكن تحقق من الإصدار.
• فقدان السياق بعد الضغط: استخدم الضغط اليدوي /compact مع تعليمات صريحة في المرة القادمة.
• حلقات لا نهائية أو استخدام 102%: نادرة؛ أعد تشغيل الجلسة أو استخدم /clear كملاذ أخير.
• ضغط بطيء: مشكلة ما قبل v2.0.64 — حدّث Claude Code.
• أخطاء كتل الضغط في الـ API: دائماً ألحِق محتوى كتلة الضغط الكامل في المكالمات اللاحقة.

الخلاصة

الضغط التلقائي أحد أهم الآليات الخفية في Claude Code لأنه يبقي جلسات الترميز الطويلة قابلة للاستخدام دون إجبارك على إعادة البدء كلما امتلأت نافذة السياق. القاعدة العملية بسيطة: دع الضغط التلقائي يتعامل مع الفائض، استخدم /compact عندما تريد التحكم، خزّن الإرشاد الدائم في CLAUDE.md، واستخدم /clear أو /rewind عندما تتغير بنية الجلسة. يمنحك هذا المزيج أفضل توازن بين الاستمرارية والتحكم والسرعة في جلسات Claude Code الطويلة.

يمثل Auto Compact في Claude Code قفزة في التطوير العملي بمساعدة الذكاء الاصطناعي. من خلال إدارة نافذة السياق ذات 200k رمز بذكاء، يقضي على أكبر نقطة احتكاك في الترميز طويل الشكل: نفاد “الذاكرة”. مع أداء لحظي (2026)، وخيارات تهيئة غنية، وامتدادات API قوية، أصبح الآن ميزة ناضجة ومجرّبة يستخدمها آلاف المطورين يومياً.

خطوات عملية اليوم:

1. افتح Claude Code وشغّل /config — تأكد من تمكين Auto-Compact.
2. جرّب /compact يدويًا مع تعليمات حول مشروعك الحالي.
3. استكشف Python SDK أو Messages API للوكلاء المؤتمتين في CometAPI.