إدارة السياق

فهم نافذة سياق Claude Code وإدارتها، واستخدام أوامر مثل /compact و/clear بفعالية

تحتاج مفتاح API؟ أنشئ حسابًا ←·نقاط النهاية وعناوين Base URL ←

آخر تحقق: 2026-11-12 · 📄 وفق الوثائق الرسمية (وثائق نافذة السياق وإعدادات النماذج في Claude Code، ونظرة عامة على نماذج Anthropic؛ جرى التحقق هذه المرة من جزأي نافذة السياق وقائمة النماذج)

تعمل كل جلسة في Claude Code ضمن نافذة سياق. ويساعدك فهم كيفية عمل السياق على استخدام Claude بفعالية أكبر وتجنب الأخطاء الناتجة عن تجاوز السياق.

فهم نافذة السياق¶

حتى 2026-11-12، وفقًا لوثائق Claude Code ونظرة عامة على نماذج Anthropic: تعمل Fable 5.2 (صدر في 9 نوفمبر 2026)، وFable 5.1، وFable 5، وSonnet 5 وما بعدها، وHaiku 5.5، وOpus 4.7 وما بعدها، افتراضيًا بنافذة سياق تبلغ 1,000,000 token (1M)، من دون الحاجة إلى لاحقة [1m]. لا تصل Opus 4.6 وSonnet 4.6 إلى 1M إلا عبر نسختهما [1m]؛ وإلا فإنهما تعملان عند 200K. على QCode، ينتمي كل من claude-fable-5-2 وclaude-fable-5-1 الذي ما زال متاحًا، إلى جانب النماذج الشائعة الاستخدام claude-opus-5-5 وclaude-sonnet-5-5 وclaude-haiku-5-5، إلى المجموعة الأولى. للإبقاء على الجلسات عند نافذة 200K، عيّن متغير البيئة CLAUDE_CODE_DISABLE_1M_CONTEXT=1.

يتضمن السياق:

• كل سجل المحادثة (رسائلك + ردود Claude)
• محتويات الملفات المشار إليها باستخدام @
• مدخلات استدعاءات الأدوات ومخرجاتها
• prompts النظام ومحتوى CLAUDE.md

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

ضغط السياق: /compact¶

يضغط أمر /compact سجل المحادثة الحالي في ملخص موجز، مما يحرر مساحة السياق مع الاحتفاظ بالمعلومات المهمة.

/compact

يمكنك أيضًا إضافة تعليمات مخصصة للتحكم في ما يركز عليه الضغط:

/compact Keep all code examples and the completed task list

الضغط التلقائي: ما لم تضبط نافذتك الخاصة، يضغط Claude Code تلقائيًا مع اقتراب المحادثة من حد سياق النموذج؛ بالنسبة إلى النماذج ذات نافذة 1M الأصلية، يكون الإعداد الافتراضي نحو 967K tokens (وفق الوثائق الرسمية). للضغط مبكرًا، شغّل أمرًا مثل /autocompact 500k لضبط النافذة (يعيد auto الإعداد الافتراضي؛ يتطلب Claude Code v2.1.221 أو أحدث). يمكنك أيضًا تشغيل /compact استباقيًا عندما يصل السياق إلى 70–80% لتجنب الانتظار حتى اللحظة الأخيرة.

مسح السجل: /clear¶

يقوم الأمر /clear بمسح كل سجل المحادثة وبدء جلسة جديدة:

/clear

ملاحظة: يزيل /clear كل السياق، بما في ذلك معلومات المشروع التي تعلّمها Claude بالفعل. استخدمه عند الانتقال إلى مهمة جديدة غير مرتبطة تمامًا.

التحقق من حالة السياق: /context¶

استخدم الأمر /context لعرض استخدام السياق الحالي:

/context

مراجع الملفات باستخدام @¶

استخدم الرمز @ لإضافة محتويات الملف إلى السياق:

@src/main.ts Explain what this file does
@package.json Check dependency versions
@README.md

أفضل الممارسات:

• أشِر فقط إلى الملفات ذات الصلة بالمهمة الحالية لتجنب إضافة سياق غير ضروري
• تستهلك الملفات الكبيرة مساحة السياق بسرعة — أعطِ الأولوية للإشارة إلى الملفات الأساسية
• استخدم CLAUDE.md لتوفير خلفية المشروع بدلًا من لصقها بشكل متكرر في كل محادثة

الإدخال عبر الأنابيب¶

مرّر إخراج الأمر أو محتويات الملف إلى Claude عبر الأنابيب:

# Pipe file contents in
cat error.log | claude "Analyze this error"

# Pipe command output in
git diff | claude "Generate a commit message"

# Multi-line input
echo "Please analyze the following code:
$(cat src/utils.ts)" | claude

منع تجاوز الجلسة الطويلة¶

العَرَض: E015 خطأ الخادم الداخلي¶

عندما يقترب سياق المحادثة من حد سعة النموذج (~95%)، يعيد Anthropic API خطأ 500. يغلّف QCode.cc هذا كاستجابة 429:

429 {"error":{"code":"E015","message":"Internal server error"},"status":500}

هذا سلوك معروف في Anthropic API (وليس خاصًا بـ QCode.cc). يغلّف QCode.cc أخطاء 5xx هذه كاستجابات 429 للاستفادة من آلية إعادة المحاولة المدمجة في Claude Code.

خطوات الحل¶

1. جرّب /compact:

2. إذا نجح، يمكن للمحادثة أن تستمر بشكل طبيعي

3. إذا أخطأ /compact نفسه (إذ يتطلب طلب الضغط إرسال السياق الكامل أيضًا)، فانتقل إلى الخطوة التالية

4. اخرج وأعد تشغيل Claude Code: bash # Press Ctrl+C or type /exit # Then restart claude

نصائح الوقاية¶

• الضغط بانتظام: شغّل /compact بشكل استباقي عندما يصل السياق إلى 70–80% بدلًا من انتظار التجاوز
• قسّم المهام: قسّم المهام الكبيرة إلى مهام أصغر، مع استخدام جلسة منفصلة لكل منها
• استخدم CLAUDE.md بدلًا من اللصق المتكرر: اكتب خلفية المشروع في CLAUDE.md — يقرأها Claude تلقائيًا عند بدء التشغيل، لذا لا تحتاج إلى تكرارها في كل محادثة
• تجنّب استيراد الملفات الكبيرة: تستهلك الإشارة إلى ملف كبير قدرًا كبيرًا من السياق — فضّل الإشارة إلى الأقسام الأساسية فقط
• راقب باستخدام /cost: يعرض الأمر /cost استخدام token للجلسة الحالية

مرجع الأوامر السريع¶

هرمية هندسة السياق¶

يعني «هندسة السياق» تنظيم ما يقرأه Claude في كل طلب تنظيماً مقصوداً، وذلك بوضع المعلومات عالية القيمة والمستقرة في المقدمة وإبعاد الضجيج. يتبع سياق Claude Code هرمية أسبقية واضحة (من الأعلى إلى الأدنى):

1. سياسة المؤسسات / السياسة المُدارة — قواعد تفرضها مؤسستك من الأعلى. أعلى أسبقية؛ ولا يمكن للأفراد تجاوزها.
2. ذاكرة المشروع CLAUDE.md / AGENTS.md — تعليمات المشروع في جذر المستودع، تصف اصطلاحات الشيفرة وأوامر البناء وخلفية المشروع.
3. قواعد محدَّدة النطاق بالمسار — ملفات CLAUDE.md المتداخلة أو .claude/rules في المجلدات الفرعية، وتُطبَّق فقط على العمل ضمن ذلك المسار.
4. سجل المحادثة الحيّ — التبادل في الجلسة الحالية. أدنى أسبقية، وهو الجزء الأكثر عرضة للتضخم.

يساعدك فهم هذه الهرمية على وضع التعليمات في المكان الصحيح: الاصطلاحات العامة تُوضع في CLAUDE.md على مستوى المشروع، والقواعد الخاصة بمجلد معيّن تُوضع في قواعد محدَّدة النطاق بالمسار — بدلاً من إعادة ذكرها في كل محادثة.

نصائح عملية¶

• أبقِ التعليمات موجزة وعالية الدلالة: كلما كان CLAUDE.md أكثر إيجازاً كان اتباع Claude له أسهل؛ فالمحتوى الطويل والخارج عن الموضوع يخفف التعليمات الأساسية.
• استخدم /compact عند نقاط التوقف المنطقية: اضغط السجل بعد إنهاء مرحلة — فالمحادثات الطويلة غير المركّزة تُضعف الدقة.
• استخدم /clear بين المهام غير المترابطة: امسح السجل عند الانتقال إلى مهمة غير مترابطة تماماً حتى لا يتداخل السياق القديم.
• أشِر إلى الملف بالمسار بدلاً من اللصق: استخدم @<file path> لتدع Claude يقرأ الملفات عند الحاجة بدلاً من حشو كتل كبيرة في المحادثة — فهذا يوفّر السياق ويحسّن الدقة.
• ضع المحتوى المستقر أولاً: المحتوى الذي لا يتغير مثل prompts النظام وCLAUDE.md وكتل الخلفية الكبيرة ينبغي أن يأتي أولاً ويبقى دون تعديل، حتى يستفيد من التخزين المؤقت للـ prompt (تكلّف قراءات التخزين المؤقت نحو 10% من الإدخال العادي). ولهذا السبب تحديداً يوفّر CLAUDE.md موجز ومستقر مع إعادة استخدام الجلسات المال.

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

تفاصيل أوامر السياق الشائعة¶

حتى 2026-10-15، وفقًا لمرجع أوامر Claude Code:

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

ملاحظات عند استخدام QCode¶

• نماذج Claude ليس لديها فئة منفصلة للسياق الطويل وتُحاسَب على tokens الفعلية. أما نماذج GPT، فعندما يتجاوز إدخال طلب واحد (بما في ذلك tokens المطابقة من التخزين المؤقت) 272K، يُحاسَب الطلب كله بسعر السياق الطويل؛ القاعدة موجودة في الفوترة. الضغط قبل أن تقترب جلسة طويلة من 272K أقل تكلفة.
• تُعيد كل جولة إرسال السياق الحالي بالكامل إلى النموذج، لذا كلما طالت الجلسة زاد عدد tokens التي تستهلكها كل جولة. يمكن تقديم بادئة مستقرة (CLAUDE.md، prompt النظام) من التخزين المؤقت، بينما يؤدي تغيير المحتوى المبكر غالبًا إلى إبطال ذلك.
• استخدم /usage (الاسم البديل /cost) لاستخدام الجلسة الحالية. تُحاسِب QCode لكل token؛ أسعار كل نموذج مدرجة في qcode.cc/models.

الأخطاء الشائعة وكيفية استكشافها وإصلاحها¶

الأسئلة الشائعة¶

هل أستخدم /compact أم /clear؟¶

استخدم /compact عندما تستمر في العمل على الشيء نفسه، لأنه يحتفظ بملخص. واستخدم /clear فقط عند الانتقال إلى مهمة غير ذات صلة تمامًا، لأنه يبدأ من فراغ.

هل يؤدي الضغط إلى فقدان CLAUDE.md؟¶

لا. تُعاد قراءة CLAUDE.md الموجود في جذر المشروع بعد الضغط؛ وتُحمَّل ملفات CLAUDE.md المتداخلة في الأدلّة الفرعية والقواعد المرتبطة بالمسارات مرة أخرى عند الطلب.

كيف أجعل الضغط التلقائي يبدأ أبكر؟¶

اضبط النافذة بأمر مثل /autocompact 500k؛ وتعيدها auto إلى الوضع الافتراضي المُهيّأ لنموذجك. يتطلب الأمر Claude Code v2.1.221 أو أحدث. يمكنك أيضًا تشغيل /compact بنفسك عندما يصل الاستخدام إلى ما بين 70% و80% (قاعدة تقريبية مقترحة، وليست رقمًا رسميًا).

ضغطت وفقدت شيئًا. هل يمكنني الرجوع؟¶

نعم. استخدم /rewind واختر نقطة سابقة لاستعادة المحادثة أو الشيفرة أو كليهما. يعتمد ذلك على نقاط التحقق الخاصة بالجلسة؛ راجع نصائح سير العمل.

المؤسسات ←