كيف توفّر الـ Tokens في Claude Code
دليل عملي مرتّب حسب التأثير، يستند إلى وثائق Claude Code الرسمية وأسعار Anthropic حتى نوفمبر 2026.
في كل مرة ترسل فيها رسالة، يعيد Claude Code إرسال المحادثة بالكامل من الصفر: أوامرك (prompts)، وإجابات Claude، ومخرجات كل أداة (tool results). لا يقرأ Claude Code من سجل محفوظ، بل يعيد معالجة السجل الكامل مع كل خطوة. لذلك يُحسب استهلاكك بناءً على كل ما قيل أو قُرئ في الجلسة، بما في ذلك ما كتبته. مع التخزين المؤقت للأوامر (Prompt caching)، تُحتسب قراءة السجل المتكرّر بسعر أقل، لكنه يظلّ محسوباً ضمن استهلاكك مع كل رسالة.
الخلاصة: ارتفاع التكلفة سببه تضخّم السياق (bloated context) لا سوء صياغة الأوامر. تركّز معظم الأساليب أدناه على إبقاء السياق مختصراً ومقتصراً على ما يتعلّق بالمهمة.
استخدم النموذج (Model) المناسب للمهمة
اختيار النموذج هو العامل الأكبر في تحديد التكلفة. النموذج الافتراضي حالياً في Claude Code في الخطط المدفوعة وعبر API هو Opus 5.5. بحسب أسعار API الرسمية لكل مليون token (الإدخال ثم الإخراج)، تبلغ تكلفة Opus 5.5 $4/$20، وتبلغ تكلفة Sonnet 5.5 $2/$10، أي إن تكلفة Opus تقارب ضعف تكلفة Sonnet. وتبلغ تكلفة Haiku 5.5 $0.10/$0.50 للأوامر التي لا تتجاوز 100,000 token، أي نحو جزء من 20 من تكلفة Sonnet. يمكنك التبديل في منتصف الجلسة عبر /model مع الاحتفاظ بالسياق. عند استخدام /model مع اسم النموذج، يُحفظ النموذج الذي اخترته أيضاً بوصفه النموذج الافتراضي للجلسات الجديدة. للتبديل في الجلسة الحالية فقط، افتح قائمة /model واضغط s عند تحديد صفّ النموذج المطلوب.
/model # عرض النماذج المتاحة
/model sonnet # أفضل خيار يومي، وأرخص من Opus الافتراضي
/model opus # للمشاكل المعقدة
/model haiku # للمهام الروتينية
/model opusplan # هجين: Opus يخطّط و Sonnet ينفّذ
/effort low # تفكير أقل للمهام البسيطةللمهام الروتينية: إعادة تسمية المتغيّرات، كتابة الهياكل الأساسية (boilerplate)، تنسيق البيانات، الأسئلة السريعة عن قواعد كتابة الكود. هو الأسرع والأقل تكلفة، لكنه لا يناسب المهام التي تتطلّب منطقاً معقّداً.
خيارك الافتراضي: ينجز معظم مهام البرمجة بكفاءة وتكلفته أقل من Opus.
للقرارات الهندسية المعقّدة: إعادة هيكلة الكود (refactoring) على نطاق واسع وتتبّع الأخطاء الخفية. استخدمه عندما تصل إلى طريق مسدود.
للعمل الهجين: يضع Opus التصميم المعماري في وضع التخطيط (Plan mode)، ثم يتولّى Sonnet التنفيذ تلقائياً. ممتاز لتخطيط الميزات وإعادة الهيكلة.
تُحسب الـ tokens للتفكير الممتدّ ضمن تكلفة الإخراج. للمهام البسيطة، خفّض مستوى التفكير باستخدام /effort low. المستوى الافتراضي في نماذج 5.5 هو medium.
ملاحظة: في خطط الاشتراك، تشترك جميع النماذج في حدود الجلسة والحدود الأسبوعية، لذا لا يمكنك استئناف الاستخدام بعد بلوغ هذه الحدود بالتبديل عبر /model. يمكنك المتابعة بنموذج آخر فقط إذا ظهرت رسالة تفيد ببلوغ حدّ خاص بنموذج معيّن، مثل حدّ Opus.
أحكِم إعداد ملف CLAUDE.md وأبقِه مختصراً
يحتوي ملف CLAUDE.md على التعليمات الدائمة لمشروعك. شغّل /init لإنشائه في المجلّد الرئيسي للمشروع، فيقرؤه Claude تلقائياً في بداية كل جلسة، ويوفّر عليك إعادة كتابة قواعد المشروع كل مرة.
الخطأ الشائع: يبقى الملف في نافذة السياق طوال الجلسة، وتُحتسب تكلفته مع كل رسالة. يشغل الملف الكبير جزءاً من نافذة السياق طوال الجلسة.
توصي الوثائق الرسمية بأن يقلّ طول كل ملف CLAUDE.md عن 200 سطر، وأن يتضمّن:
- ملخّص المشروع والميزات النشطة حالياً.
- حزمة التقنيات المستخدمة (Tech stack).
- أسلوب كتابة الكود (Code style) وقواعد التسمية.
- الأخطاء المعروفة (Bugs) والمهام المقبلة (TODOs).
انقل تعليمات سير العمل الخاصة بمهام محدّدة، مثل مراجعة طلبات الدمج (PR) أو ترحيل قواعد البيانات، إلى المهارات (Skills) أو إلى ملفات قواعد في .claude/rules/ تُحمّل عند الحاجة فقط. استيراد ملف باستخدام @path داخل CLAUDE.md لا يقلّل الاستهلاك، لأن الملف المستورد يُحمّل معه في بداية الجلسة.
امسح السياق أو لخّصه عند الحاجة (Clear & Compact)
كلما زاد حجم السياق، عانى النموذج من «تشتّت السياق» (Context rot): يقلّ تركيزه، وتضيع المعلومات القديمة، ويبدأ بتكرار حلول سابقة أو نسيان القيود الأولية. بدلاً من توسيع نافذة السياق، حدّد متى تحتاج إلى تقليص السياق.
/clear
يمسح الجلسة الحالية ويبدأ من جديد. استخدمه عند الانتقال إلى مهمة مختلفة تماماً، حتى لا تستمر سجلات البحث القديمة في استهلاك الـ tokens. لا يترتّب على تشغيله أي تكلفة.
/compact
يلخّص المحادثة ويستبدل السجل الكامل بالملخّص. تستمر الجلسة بسياق العمل، مع انخفاض كبير في الاستهلاك. استخدمه عند نهاية مرحلة من العمل. يقرأ أمر /compact المحادثة كاملة لتلخيصها، ولذلك يستهلك الأمر نفسه عدداً كبيراً من الـ tokens.
نصيحتان مهمتان للتلخيص:
- لخّص مبكراً: يبدأ التلخيص التلقائي عند الاقتراب من حدّ نافذة السياق، أي عند نحو 967K token في النماذج التي تبلغ سعة نافذة السياق فيها 1M token. لخّص يدوياً عند نهاية مرحلة من العمل، أو قدّم موعد التلخيص التلقائي باستخدام
/autocompact 200k. - وجّه عملية التلخيص: ضع القالب أدناه تحت عنوان
# Compact instructionsفي ملفCLAUDE.mdليُطبّق في كل مرة، أو حدّد بإيجاز ما تريد التركيز عليه بعد الأمر، مثلاً/compact Focus on code changes and failing tests.
# Compact instructions
When compacting, preserve:
- current task goal
- files changed
- commands already run
- failing tests and exact errors
- decisions made
- next action list
Drop:
- old exploration paths
- repeated logs
- irrelevant discussionتحكّم في حجم مخرجات الأدوات (Tool Output)
مخرجات الأدوات (مثل Terminal) من أكبر مستهلكي الـ tokens، لأنها تملأ السياق ويُعاد إرسالها مع كل دورة.
- قلّل حجم مخرجات Bash: يعرض Claude Code افتراضياً نحو 30,000 حرف من المخرجات مباشرةً، ويحفظ المخرجات التي تتجاوز هذا الحدّ في ملف. لخفض الحدّ، اضبط
"bashOutputMaxChars"فيsettings.jsonعلى قيمة بين 4000 و128000، كما في المثال أدناه. - رشّح السجلات قبل تمريرها إلى Claude: استخرج الأسطر المهمّة فقط قبل تمرير السجلات.
{
"bashOutputMaxChars": 10000
}pnpm test 2>&1 | grep -A 5 -E "FAIL|ERROR|Error|failed" | head -120بهذه الطريقة، يتلقّى Claude أسطر الأخطاء مع قدر قليل من السياق بدلاً من آلاف الأسطر الناتجة عن الاختبارات الناجحة.
كن دقيقاً لتتجنّب عمليات البحث العشوائية
تدفع الأوامر المبهمة Claude إلى البحث في الكود وقراءة عدّة ملفات لفهم السياق، وكل قراءة تُضاف إلى نافذة السياق. الدقّة توفّر الـ tokens والوقت.
اذكر مسارات الملفات مباشرةً
إذا كنت تعرف مسار الملف، فاذكره لتجنّب عمليات البحث المكلفة في الكود.
صف السلوك المتوقّع والفعلي
عند الإبلاغ عن خطأ، صف السلوك المتوقّع والسلوك الفعلي بدقة وتجنّب الأوصاف العامّة.
خطّط مسبقاً: تحديد مسارات الملفات وتقسيم المهام يغني Claude عن قراءة الكود كاملاً لمعرفة موضع التعديل.
استخدم الوكلاء الفرعيين (Subagents) بحكمة
الوكلاء الفرعيون نُسخ معزولة من Claude بنوافذ سياق مستقلّة. تُسنِد الجلسة الرئيسية مهمةً إلى الوكيل الفرعي، فيتولّى العمليات التي تتطلّب معالجة مكثّفة (بحث، قراءة سجلات، تحليل متعدّد الخطوات) ضمن سياقه المستقلّ، ويُعيد الملخّص فقط للمحادثة الرئيسية.
يساعد الوكلاء الفرعيون على تقليص حجم السياق الرئيسي، ولكل وكيل طلباته الخاصة التي تُحسب ضمن استهلاكك. للمهام البسيطة، اضبط model: haiku في إعدادات الوكيل الفرعي.
متى تستخدم الوكلاء الفرعيين؟
- المهام التي تنتج مخرجات طويلة جداً لا تحتاج إلى الاحتفاظ بها.
- استكشاف الكود بالتفصيل عندما يُحتمل أن يتضخّم سياق الجلسة الرئيسية.
- مهام البحث المتوازية، أو المهام التي تتطلّب تقييد استخدام أدوات محدّدة.
كيف تصوغ أمراً واضحاً للوكيل الفرعي؟ اطلب مخرجات مهيكلة ومحدّدة:
# Bad: vague, returns too much
"Look at the codebase"
# Good: specific, bounded output
"Find all React components that handle user input forms.
For each, report: 1. File path 2. What data it collects
3. How it validates input. Return as a bullet list.
Skip components unrelated to user data."راقب استهلاكك (Monitor Your Usage)
- احتفظ برابط لوحة متابعة الاستهلاك
claude.ai/settings/usage، أو افتح Settings > Usage على claude.ai. - شغّل
/usageداخل الجلسة لعرض تكلفتها وحدود خطتك وتفاصيل ما يستهلك رصيدك، مع توصيات لتقليل الاستهلاك. يمكنك استخدام/costلتنفيذ الأمر نفسه. - استخدم
/contextداخل الجلسة لعرض شبكة ملوّنة توضّح كيفية توزيع السياق، مع اقتراحات لتحسينه. - تعمل نماذج Opus 5.5 وSonnet 5.5 وHaiku 5.5 افتراضياً بنافذة سياق تتّسع لـ 1M token. النافذة الأكبر لا تعني أن عليك ملأها، فتشتّت السياق يخفض جودة الإجابات قبل بلوغ الحدّ، وتُحسب تكلفة السياق الكامل مع كل رسالة.
قائمة مرجعية سريعة
/effort low للمهام البسيطة./init واجعل طوله أقل من 200 سطر..claude/rules/ تُحمّل عند الحاجة فقط./clear عند الانتقال إلى مهمة مختلفة كلياً./compact بعد إنهاء جزء من المهمة، وحدّد بدقّة ما ينبغي الاحتفاظ به وما ينبغي حذفه.bashOutputMaxChars، ورشّح السجلات بـ grep/head قبل تمريرها./usage و/context.المصادر: وثائق Claude Code الرسمية (code.claude.com/docs: Manage costs، Model configuration، Commands، Memory، Tools reference) وصفحة أسعار Anthropic (platform.claude.com/docs/en/about-claude/pricing). تمّت المراجعة في نوفمبر 2026. الأسعار والنماذج تتغيّر، فراجع /model و/usage دائماً.
هل ترغبون في تطبيق ما تعلّمتموه مع فريقكم؟
أنا عبدالعزيز الشامسي، مدرب معتمد ومستشار في الذكاء الاصطناعي في أبوظبي. أدرّب فرق الجهات الحكومية والشركات على استخدام الذكاء الاصطناعي في عملها اليومي. راسلوني لنناقش جلسة تدريبية لفريقكم.