كيف تُحسب رموز Claude في Claude Code؟

ما المقصود بالرموز في Claude؟

الرمز هو وحدة النص التي يقرأها Claude ويكتبها، وقد يكون جزءاً من كلمة. يقدّر مسرد Anthropic الخاص الرمز بنحو 3.5 أحرف إنجليزية في النماذج السابقة لـ Claude Opus 4.7. أما في أداة الترميز الحالية، فهو أقرب إلى 2.5 حرف، لأن Anthropic تقدّر أن 1M رمز تعادل نحو 2.5M حرف فيها. في كلتا الحالتين، يتجاوز العدد رمزاً واحداً لكل كلمة بفارق كبير بعد احتساب المسافات وعلامات الترقيم. لذلك يتجاوز نص نثري مؤلف من ألف كلمة 1,300 رمز بسهولة. يستهلك الرمز البرمجي عدداً أكبر لكل سطر. فالأقواس والعمليات الحسابية والشرطات السفلية والمسافات البادئة تُقسّم النص إلى رموز أكثر لكل حرف مقارنةً بالإنجليزية. وعادةً ما يستهلك ملف مصدر مؤلف من بضع مئات من الأسطر عدة آلاف من الرموز. أما الملف المؤلف من 2,000 سطر الذي يقرر الوكيل قراءته، فقد يستهلك خمسة أرقام من الرموز قبل كتابة أي سطر جديد من التعليمات البرمجية.

هناك أمران يسببان الالتباس عند التعامل مع أدوات الترميز. أولاً، تختلف هذه الأدوات باختلاف النموذج. اعتباراً من October 2026، يستخدم Claude Opus 4.7 وكل نموذج لاحق، بما في ذلك Fable 5.1 وOpus 5.5 وSonnet 5.5 وHaiku 5.5 الحالية، أداة ترميز أحدث تنتج رموزاً أكثر بنحو 30% للنص نفسه مقارنةً بنماذج Claude الأقدم مثل Haiku 4.5. ويختلف مقدار الزيادة الدقيق حسب المحتوى. ويؤثر ذلك في أي تقدير للتكلفة تضعه بالرموز، رغم أن أسعار الرمز الواحد لم ترتفع بالتزامن مع هذه الزيادة. ثانياً، tiktoken، وهي المكتبة التي تستخدمها منشورات المدونات عادةً، هي أداة ترميز OpenAI وليست أداة Claude. لذلك لن تتطابق أعدادها مع العدد الذي تحتسب Anthropic تكلفته. العدد الوحيد الموثوق هو العدد الذي يعيده endpoint count_tokens، الموضح أدناه.

لماذا تكلف جلسة البرمجة لديك هذا المبلغ

تُحتسب كل فاتورة لـClaude، سواء كانت فاتورة API أو حداً لاشتراك، أساساً وفق مقياس واحد: الرموز الداخلة والرموز الخارجة. تضيف بعض أدوات API بنداً خاصاً بها؛ فالبحث على الويب، مثلاً، يكلف $10 لكل 1,000 عملية بحث اعتباراً من October 2026، إضافة إلى تكلفة الرموز التي تضيفها نتائجه. لكن مقياس الرموز هو الذي يتحرك أثناء جلسة البرمجة. تعرض صفحة الأسعار الأمر على أنه بسيط: مبلغ معين لكل مليون رمز إدخال، ومبلغ آخر لكل مليون رمز إخراج. لكنها لا توضح أن جانب الإدخال في مقياس جلسة البرمجة الوكيلة يعمل بمعدل أعلى بكثير مما يوحي به الحدس، لأن المحادثة كاملة تُرسل من جديد في كل دورة. لقد بعت بنية تحتية محسوبة وفق الاستخدام لمدة خمسة عشر عاماً، والرموز هي أول مقياس أراه لا يستطيع معظم العملاء فعلاً تحديد ما الذي يدفعه إلى الارتفاع. هذا هو درس قراءة المقياس: ما الذي يُحتسب إدخالاً وإخراجاً في الجلسة الوكيلة، ولماذا تكون حلقة إعادة الإرسال مكلفة جداً، وكيف تعيد prompt caching صياغة الحساب، وأي العوامل تؤثر فعلاً في الرقم.

كل شيء يُحتسب كإدخال: ما الذي يقيسه العداد فعلياً

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

• موجّه النظام. تعليمات البنية الخاصة بـClaude Code، بالإضافة إلى CLAUDE.md وملفات الذاكرة، التي تُحمَّل عند بدء الجلسة وتبقى موجودة في كل طلب لاحق.
• تعريفات الأدوات. مخطط كل أداة يمكن للوكيل استدعاؤها. يضيف كل خادم MCP تتصل به إلى هذا الحمل الثابت، مع أن Claude Code يؤجل الآن تعريفات أدوات MCP الكاملة افتراضياً، لذلك لا تبقى في السياق إلا أسماء الأدوات إلى أن تُستخدم أداة لأول مرة. هذا يخفف التكلفة، لكنه لا يلغيها.
• كل ملف يقرأه الوكيل. يضع Read لملف مصدر كامل محتوى الملف في السياق، ويبقى فيه.
• كل نتيجة لأداة. تعود عمليات الاختبار، ومخرجات grep، ومخرجات الطرفية، وسجلات البناء، كلها كرموز إدخال. ومجموعة اختبارات فاشلة تطبع 8,000 سطر تعادل كتاباً صغيراً. اعتباراً من October 2026، يمرر Claude Code نحو 30,000 حرف من مخرجات الأوامر مباشرةً افتراضياً، وأي مخرجات أطول تصل في صورة ملف محفوظ مع معاينة تصل إلى 2,000 حرف. لكن تُحتسب بالكامل كل مخرجات تقع تحت هذا الحد، وكذلك كل قراءة لاحقة للملف المحفوظ.
• المحادثة كاملةً حتى هذه اللحظة، ويُعاد إرسالها في كل دور. تستحق هذه النقطة قسماً مستقلاً.

إعادة الإرسال التي لا يحتسبها أحد

واجهة Claude API عديمة الحالة. لا تتذكر جلستك بين الطلبات، ولا يوجد أي مكوّن يتذكرها. لذلك، في الدور 2، يرسل العميل الدور 1 مع استجابته، إضافة إلى رسالتك الجديدة. وفي الدور 50، يعيد إرسال كل ما يزال موجوداً في السياق من الأدوار 1 إلى 49، وكل ملف تمت قراءته، ونتيجة أداة، وفرق لم تُزل عبر الضغط، إضافة إلى الدور 50. (يستبدل الضغط السجل القديم بملخص، وتبقى قراءات الملفات التي ينفذها الوكيل الفرعي في سياقه الخاص، ولا تعود إلا نتيجته.) يعيد النموذج قراءة كامل السجل المحتفظ به في كل مرة، وتُحتسب كل واحدة من رموز إعادة القراءة هذه كرموز إدخال مفوترة.

والنتيجة هي أن التكلفة لكل دور تزداد تقريباً خطياً مع طول الجلسة، بينما تزداد التكلفة الإجمالية للجلسة تقريباً تربيعياً. قد تكلف رسالة نصف سنت في الدور 3 عشرين ضعف ذلك في الدور 60، للسؤال نفسه المؤلف من سطر واحد، لأنها تحمل ستين دوراً من البيانات. هذه هي الحقيقة الأساسية التي تفسر معظم طلبات الدعم من نوع «لماذا كانت فاتورتي مرتفعة إلى هذا الحد؟». وليست هذه سمة خاصة بـClaude؛ فكل منتج LLM يبدو ذا حالة هو في الواقع واجهة API عديمة الحالة تعمل في الخلفية ضمن حلقة إعادة إرسال.

الناتج: ما تراه، إضافةً إلى التفكير الذي لا تراه

تُعد رموز الناتج أغلى من رموز الإدخال، بمعدل خمسة أضعاف عبر النماذج الحالية في المجموعة ($10/$50 على Fable 5.1، و$4/$20 على Opus 5.5، و$2/$10 على Sonnet 5.5، و$0.10/$0.50 على Haiku 5.5 للمطالبات التي تصل إلى 100,000 رمز، اعتباراً من October 2026). يشمل الناتج النص والشفرة اللذين ينشئهما Claude، إضافةً إلى رموز التفكير: الاستدلال الداخلي الذي يجريه النموذج قبل الإجابة. هناك حقيقتان مهمتان. يُحاسَب التفكير وفق أسعار الناتج ويُحتسب ضمن max_tokens، وقد تعني استجابة API التي تنتهي بـstop_reason: "max_tokens" وتحتوي غالباً على إجابة مبتورة أن التفكير استهلك الميزانية قبل أن تبدأ الإجابة. في النماذج الحالية، قد لا يُعرض ملخص الاستدلال إطلاقاً. إذ تحجبه API افتراضياً في Fable 5.1 وOpus 5.5 وSonnet 5.5 وHaiku 5.5، وكذلك في النماذج الأقدم حتى Opus 4.7، لكن التفكير يكون قد حدث ويظل خاضعاً للمحاسبة. عدم ظهوره لا يعني أنه مجاني.

يفعّل Claude Code التفكير الموسّع افتراضياً لأنه يحسّن العمل متعدد الخطوات بصورة قابلة للقياس، وقد تصل الميزانية الافتراضية إلى عشرات الآلاف من الرموز لكل طلب. في المهام الأبسط، يمكنك خفضه: خفّض مستوى الجهد باستخدام /effort أو في /model، أو عطّل التفكير في /config على النماذج التي تسمح بذلك. اعتباراً من October 2026، لا يستطيع Claude Code تعطيل التفكير على Opus 5.5 أو Sonnet 5.5 أو Haiku 5.5 أو نماذج Fable، ولذلك يكون مستوى الجهد هو الخيار المتاح هناك. تمنحك API مساحة أكبر مع اثنين منها. يقبل Haiku 5.5 الخيار thinking: {"type": "disabled"} عند مستوى جهد high أو أقل، وكذلك Opus 5 الأقدم، بينما يقبله Sonnet 5 الأقدم عند جميع مستويات الجهد، بما في ذلك xhigh وmax. يرفض Sonnet 5.5 الخيار "disabled" ويستخدم thinking: {"type": "between_tools"} بدلاً منه، ما يقلل التفكير الأولي عند مستويات الجهد low أو medium أو high. لذلك يحصل الطلب الذي لا يستخدم الأدوات على إجابته من دون تفكير أولي. وحدهما Opus 5.5 ونماذج Fable يواصلان التفكير مهما كان المحتوى الذي ترسله. هذا عامل حقيقي للتحكم في التكلفة، وليس اعتقاداً بلا أساس.

تعيد تخزين الـPrompt المؤقتة صياغة الحسابات

تُفسِّر تخزين الـPrompt المؤقتة سبب عدم إفلاس الجميع بسبب حلقة إعادة الإرسال. يمكن لـAPI تخزين بادئة ثابتة من الـprompt، وsystem prompt، وتعريفات الأدوات، وسجل المحادثة مؤقتاً، ثم تقديمها في الطلب التالي بجزء من السعر. اعتباراً من October 2026، تكون المعاملات كما يلي: تكلّف كتابة الـcache مقدار 1.25× من سعر الإدخال الأساسي (و2× في صيغة الساعة الواحدة)، بينما تكلّف قراءة الـcache مقدار 0.1× في معظم النماذج، و0.05× في Claude Opus 5.5 وClaude Sonnet 5.5، و0.025× في Claude Fable 5.1. الكتابات أعلى تكلفة؛ أما القراءات فتمنح خصماً قدره 90% في معظم النماذج، و95% في Opus 5.5 وSonnet 5.5، و97.5% في Fable 5.1. تكفي قراءة واحدة لاسترداد التكلفة الإضافية لكتابة الـcache لمدة 5 دقائق، بل تتجاوزها.

يدير Claude Code التخزين المؤقت نيابةً عنك، وفي الجلسة السليمة تُقدَّم كل تلك الإعادة الكبيرة تقريباً من الـcache. لكن تنتهي صلاحية الـcache بعد فترة من عدم النشاط. اعتباراً من October 2026، يوفّر Claude Code لمحادثتك الرئيسية cache لمدة ساعة واحدة عند استخدام اشتراك ضمن الاستخدام المشمول في خطتك، ولمدة 5 دقائق من آخر استخدام عند استخدام API key أو موفّر سحابي أو عند السحب من أرصدة الاستخدام (يمكن لإعداد promptCacheTtl طلب مدة الساعة هناك، مع كلفة كتابة تبلغ 2×). في cache مدته 5 دقائق، إذا ابتعدت لتناول القهوة وتأخرت، ثم عدت وأرسلت رسالة، فستكون صلاحية الـcache قد انتهت، وستُعاد كتابة البادئة المتراكمة بالكامل بتكلفة 1.25× بدلاً من قراءتها بسعر الـcache. في جلسة تضم 150K من الرموز، تكتب تلك الدورة الباردة 150K من الرموز كلها بسعر 1.25×، بينما كانت الدورة الدافئة ستقرأها بسعر 0.1×، أي فرق قدره 12.5 ضعفاً في البادئة (و25 ضعفاً في Opus 5.5 وSonnet 5.5، و50 ضعفاً في Fable 5.1). هذه هي النتيجة غير البديهية التي يجدر ترسيخها: قد تكون وتيرة التوقف ثم الاستئناف أعلى تكلفة من العمل المتواصل، لأن كل فترة خمول تتجاوز TTL تحوّل دورتك التالية من قراءة رخيصة إلى إعادة كتابة مكلفة. اعمل على دفعات؛ وعند استخدام cache مدته 5 دقائق، لا ترسل رسائل متفرقة إلى جلسة ضخمة مرة كل 10 دقائق.

إذا كنت تستدعي API من تطبيقك الخاص على VPS، فلن يحدث أي من ذلك تلقائياً: يجب تفعيل الخيار عبر cache_control، ومن الأخطاء الشائعة التي يسببها المستخدم بنفسه إدراج طابع زمني أو معرّف طلب في system prompt، ما يغيّر بايتات البادئة في كل طلب ويعطّل التخزين المؤقت بصمت. المؤشر هو بقاء usage.cache_read_input_tokens عند الصفر في الطلبات المتطابقة ظاهرياً.

المعادلة، مع مثال تطبيقي

تجاهل من يقول إن «تكلفة الجلسة هي $X» بشكل ثابت. تختلف الجلسات بمقدار يصل إلى رتبتين عشريتين. المعادلة التالية هي ما ينطبق فعلاً:

turn cost = (uncached input        x base input price)
          + (cache writes          x 1.25 x base input price)
          + (cache reads           x read multiplier x base input price)
          + (output incl. thinking x output price)

read multiplier = 0.10 on most models, 0.05 on Opus 5.5 and Sonnet 5.5, 0.025 on Fable 5.1
session cost = sum over all turns

مثال تطبيقي على Claude Opus 4.8، وهو نموذج قديم الآن لكنه لا يزال متاحاً، ولا يزال سعره، اعتباراً من October 2026، يبلغ $5 لكل مليون input tokens و$25 لكل مليون output tokens. في turn وسط الجلسة يحمل 80,000 token من السياق المتراكم: جرىت قراءة 75,000 من cache، وكتابة 3,000 حديثاً، وإدخال 2,000 uncached جديد، وإخراج 1,500 token يتضمن thinking.

• قراءات cache: 75,000 × $0.50/M = $0.0375
• كتابات cache: 3,000 × $6.25/M = $0.019
• الإدخال غير المخزّن مؤقتاً: 2,000 × $5/M = $0.010
• الإخراج: 1,500 × $25/M = $0.0375

تبلغ التكلفة نحو $0.10 لهذه turn؛ وتبلغ نحو $5 لخمسين turn مماثلة. والآن، بعد انتهاء صلاحية cache لهذه turn نفسها: تجب إعادة كتابة 78,000 token القابلة للتخزين مؤقتاً بسعر $6.25/M، ويضاف إليها 2,000 token غير مخزّنة مؤقتاً بسعر $5/M. تبلغ التكلفة نحو $0.50 قبل احتساب الإخراج، أي ما يقارب خمسة أضعاف تكلفة turn كاملة وهي دافئة، مع تنفيذ العمل نفسه. يلخّص هذا الفرق قصة caching كاملة في رقم واحد. في Claude Opus 5.5 الحالي ($4/$20، مع cache reads بمعامل 0.05×)، تبلغ تكلفة turn الدافئة نفسها نحو $0.07 (القراءات $0.015، والكتابات $0.015، والإدخال غير المخزّن مؤقتاً $0.008، والإخراج $0.030)، بينما تبلغ تكلفة النسخة الباردة $0.40 قبل احتساب الإخراج، أي ما يقارب ستة أضعاف تكلفة turn الدافئة. وهذه الأسطر الأربعة نفسها هي الطريقة الوحيدة النزيهة لمقارنة المورّدين، لأن الأسعار المعلنة تتجاهل cache reads وthinking بالكامل، كما أن تشغيلها على ثلاث مهام حقيقية يوضح أين تتجاوز فاتورة Claude فاتورة OpenAI أو تقل عنها.

إذا كنت تريد فهماً لوحدة الفوترة نفسها، لا لتكلفة turn واحدة، فتعرض ما تعنيه تكلفة مليون token من حيث الصفحات والملفات والدولارات الحساب نفسه على مستوى أعلى. وللمعايرة لا للتنبؤ: تشير الأرقام المنشورة من Anthropic بشأن عمليات نشر Claude Code للمؤسسات، اعتباراً من October 2026، إلى متوسط يبلغ نحو $13 لكل مطوّر في اليوم النشط، ومن $150 إلى $250 شهرياً، مع بقاء 90% من المستخدمين دون $30 يومياً. تعتمد تكلفتك الفعلية على اختيار النموذج، وانضباط إدارة الجلسات، وحجم قاعدة الشيفرة، ولهذا تحديداً تهمك العوامل الواردة أدناه.

عرض استخدامك

في Claude Code، الأمر هو /usage (ولا يزال /cost يعمل، فهو اسم مستعار). تعرض كتلة Session في الأعلى إحصاءات الرموز وتقديراً محلياً للتكلفة الخاصة بالجلسة الحالية. وفي خطط الاشتراك، تعرض الشاشة نفسها أشرطة حدود الخطة وتقسيماً ينسب الاستخدام الأخير إلى المهارات والوكلاء الفرعيين والإضافات وخوادم MCP الفردية. وفي الإصدارات الحديثة، تتضمن كتلة Session أيضاً السطر Prompt cache (main) الذي يوضح نسبة الإدخال المقدَّمة من ذاكرة التخزين المؤقت، وحالات عدم التطابق، وما إذا كانت الذاكرة دافئة حالياً. للحصول على بيانات الفوترة الموثوقة لحسابات API، تُعد صفحة الاستخدام في Claude Console هي المرجع المعتمد، أما الرقم المعروض في CLI فهو تقدير. يرسم /context شبكة ملوّنة توضّح ما الذي يشغل نافذة السياق، مثل مطالبة النظام والأدوات وتعريفات MCP والملفات والسجل، وهو أسرع طريقة لاكتشاف CLAUDE.md متضخم أو خادم MCP كثير الرسائل. في وضع ملء الشاشة، يخفي التقسيم حسب العناصر، بينما يؤدي تمرير all إلى توسيعه.

من API، توضح لك كل استجابة ما حدث بالضبط:

response = client.messages.create(model="claude-sonnet-5-5", max_tokens=2048,
                                  messages=messages)
u = response.usage
total_prompt = u.input_tokens + u.cache_creation_input_tokens + u.cache_read_input_tokens
print(f"uncached={u.input_tokens} written={u.cache_creation_input_tokens} "
      f"read={u.cache_read_input_tokens} output={u.output_tokens}")

لاحظ أن input_tokens يمثل فقط الباقي غير المخزّن مؤقتاً؛ إذ إن الحجم الحقيقي للمطالبة هو مجموع حقول الإدخال الثلاثة. لا يعني وكيل عمل لمدة ساعة مع عرض input_tokens: 4000 أنه منخفض التكلفة؛ فقد قُدِّمت الرموز الـ200,000 الأخرى من ذاكرة التخزين المؤقت. للتقدير قبل الإرسال، استخدم نقطة نهاية حساب الرموز. استدعاؤها مجاني، ولها حد معدل خاص بها، وتستخدم محلّل الرموز الخاص بالنموذج الذي تحدده. تعامل مع النتيجة على أنها تقدير قريب؛ فالفوترة تعتمد على الطلب الفعلي:

count = client.messages.count_tokens(model="claude-sonnet-5-5",
                                     messages=[{"role": "user", "content": big_file}])
print(count.input_tokens)

لا تستخدم tiktoken مطلقاً للسبب المذكور أعلاه.

الاشتراكات مقابل الدفع حسب الاستخدام

آلية العمل في هذا الدليل واحدة في كل الحالات؛ الاختلاف الوحيد هو طريقة الفوترة. عند استخدام مفتاح API، تفرض Anthropic رسوماً حسب الاستخدام ولكل token وفق الأسعار المنشورة، ولذلك فإن كل رقم ورد أعلاه يمثل تكلفة مالية فعلية. يبدأ احتساب التكلفة في وقت أبكر مما يتوقعه معظم المستخدمين، لأنه لا توجد فئة مجانية يمكن الاعتماد عليها، بل رصيد صغير عند التسجيل وعدد محدود من نقاط النهاية التي لا تُحتسب عليها رسوم. وهذا هو ما يحصل عليه حساب API الجديد فعلياً قبل إضافة بطاقة دفع. والاستثناء منذ October 7, 2026 هو اشتراك Max أو Team؛ إذ تتضمن هذه الخطط الآن أرصدة API شهرية لتطبيقاتك ووكلائك على Claude Platform: $100 شهرياً في Max 5x، و$200 في Max 20x، وفي Team مبلغ $20 لكل مقعد Standard و$100 لكل مقعد Premium، ضمن رصيد مشترك وبحد أقصى $500. تحصل على هذه الأرصدة بربط مؤسسة Console، وتنتهي صلاحية الأرصدة غير المستخدمة في نهاية كل دورة فوترة، ولا تغطي Claude Code التفاعلي.

عند استخدام اشتراك Claude (Pro وMax وTeam وخطط Enterprise القديمة المعتمدة على المقاعد)، يُخصم استخدام Claude Code من الحصة المضمنة في خطتك بدلاً من ذلك. واعتباراً من October 2026، تتكون هذه الحصة من نافذة جلسة متحركة مدتها خمس ساعات ونافذة أسبوعية، وتُشارك بين النماذج وبين Claude Code ومحادثات claude.ai. ويكون الرقم بالدولار /usage إرشادياً وليس فاتورة. يوجد استثناءان اعتباراً من October 2026: لا تتضمن مقاعد Enterprise الحالية المعتمدة على الاستخدام أي استخدام ضمن الخطة، ولذلك يُحتسب كل token وفق أسعار API القياسية؛ كما أن نماذج Fable غير مشمولة في الحصة ضمن Pro ومقاعد Team القياسية ومقاعد Enterprise القديمة القياسية، حيث تعمل وفق أرصدة الاستخدام بالدفع حسب الاستخدام.

عند استنفاد إحدى النافذتين، ستظهر لك الرسالة "لقد وصلت إلى حد الجلسة" أو "لقد وصلت إلى الحد الأسبوعي" مع وقت إعادة الضبط. ولن تؤدي عملية تبديل النماذج باستخدام /model إلى استعادة الوصول، لأن النافذتين مشتركتان بين النماذج. وترتبط هذه النوافذ بالحساب، لا بالعميل الذي تستخدمه، وهذا مهم إذا كنت لا تزال تحدد ما الذي يعمل أصلاً على Linux وأي خطة تغطي كل واجهة. وتحدد النافذة التي استنفدتها فعلياً مدة الانتظار وما يستحق فعله في أثناء ذلك، لذلك من المفيد معرفة خياراتك عند بلوغ حد أثناء تنفيذ مهمة. ويمكن للخطط تفعيل أرصدة الاستخدام اختيارياً، وإدارتها باستخدام /usage-credits، لشراء استخدام يتجاوز الحد. لن أذكر حصص الخطط عمداً؛ فهي أكثر الأرقام تقلباً في هذا الموضوع، لذا راجع claude.com/pricing وأشرطة /usage الخاصة بحسابك. تظل آلية احتساب token مهمة حتى مع الاشتراك، لأن الجلسة غير الفعالة تستهلك نافذتك بالطريقة نفسها التي كانت ستستهلك بها الدولارات. ولمعرفة جانب الاشتراكات، راجع خطة Claude المناسبة لاستخدامك.

الأدوات التي تحقق أثراً فعلياً

• حدّد نطاق ما يقرأه الوكيل. يقرأ "أصلح خطأ التحقق في auth.py" ملفاً واحداً، بينما يقرأ "حسّن قاعدة الشيفرة هذه" أربعين ملفاً. أبقِ CLAUDE.md موجزاً، لأنه يُحمَّل في كل جلسة. اقتصر فيه على الأساسيات، وانقل التعليمات الخاصة بسير العمل إلى skills تُحمَّل عند الطلب.
• اجعل السياق واضحاً وموجزاً. امسح /clear بين المهام غير المرتبطة، لأن السياق القديم يُعاد إرساله وتُحتسب تكلفته في كل رسالة لاحقة. وفي المهمة الطويلة الواحدة، يلخّص /compact Focus on the failing tests and the diff السجل السابق ويمنعك من الوصول إلى منحنى التكلفة التربيعية.
• اختر النموذج بالحجم المناسب. يتولى Sonnet معظم مهام البرمجة بسعر $2/$10 لكل مليون token اعتباراً من October 2026، وأصبح هذا السعر قياسياً وليس سعراً تمهيدياً: سعر Sonnet 5.5 هو $2/$10، وحافظ Sonnet 5 على سعر $2/$10 بعد إلغاء الزيادة المخطط لها في September 1 إلى $3/$15. بالمقارنة، يبلغ سعر Opus 5.5 ‏$4/$20، بينما يبلغ سعر Haiku 5.5 ‏$0.10/$0.50 (للمطالبات التي تصل إلى 100,000 token، و$0.50/$2.50 لما يتجاوز ذلك)، ولذلك فهو مناسب للأعمال الميكانيكية التي ينفذها subagent، مثل فرز السجلات. يقع Fable 5.1 في الطرف الآخر بسعر $10/$50، وهو السعر نفسه لـFable 5 ويعادل مرتين ونصف سعر Opus 5.5 على جانبي العداد. لذلك يجدر بك معرفة المهام التي تبرر هذا السعر فعلياً قبل تركه محدداً للأعمال الروتينية. يبدّل /model النموذج أثناء الجلسة.
• رشّح المخرجات المطوّلة مسبقاً. يحوّل hook يمرّر ناتج تشغيل الاختبارات عبر grep لعرض حالات الفشل فقط قبل أن يراه Claude، نتيجة أداة حجمها 20,000 token إلى 300 token. ويتكرر هذا التوفير عند كل إعادة إرسال لاحقة لذلك الدور.
• نفّذ الأعمال غير التفاعلية على دفعات. في مسارات API الخاصة بك، مثل التصنيف والمراجعة المجمعة والمهام الليلية، تنفّذ Batches API النماذج نفسها بخصم 50% مقابل التسليم غير المتزامن.
• راعِ مدة صلاحية ذاكرة التخزين المؤقت. اعمل في فترات متواصلة. لا تكلّف جلسة Claude Code المنفصلة داخل tmux على VPS شيئاً أثناء خمولها، ولا تُستهلك token إلا عند تشغيل دور. لكن تجاوز فترة الخمول لـcache TTL يؤدي إلى فقدان cache الدافئة، وتدفع تكلفة إعادة كتابة السياق في الدور التالي.

FAQ

كم عدد الرموز التي تستهلكها جلسة برمجة في Claude Code؟

لا يوجد عدد ثابت. غالباً ما تتضمن الجولة الواحدة في منتصف الجلسة عشرات الآلاف من رموز الطلب بعد تراكم الملفات والسجل. وقد تصل الجلسة العملية إلى ملايين الرموز، ويُخدَم معظمها من الذاكرة المؤقتة بتكلفة تعادل عُشر السعر الأساسي أو أقل، وفقاً للنموذج. ولأغراض المعايرة، يبلغ متوسط الأرقام المنشورة من Anthropic للمؤسسات، حتى أكتوبر 2026، نحو $13 لكل مطوّر في يوم النشاط، ويقل إنفاق 90% من المستخدمين عن $30. شغّل /usage في جلستك، فمراقبته لمدة خمس دقائق أدق من أي متوسط منشور.

هل تكلّف رموز التفكير مالاً حتى عندما لا أستطيع رؤيتها؟

نعم. تُحاسَب رموز التفكير بوصفها رموز إخراج وفق التعرفة الأعلى، وتُحتسب ضمن max_tokens. كما تحاسب النماذج الحالية عليها حتى عندما تحجب الواجهة ملخص الاستدلال عن العرض. إذا اقتُطعت الاستجابة عند stop_reason: "max_tokens" قبل اكتمال الإجابة الظاهرة، فمن المرجح أن التفكير استهلك الميزانية. في Claude Code، خفّض مستوى الجهد باستخدام /effort للمهام التي لا تحتاج إلى استدلال عميق.

لماذا تصبح جلسة Claude Code الطويلة أكثر تكلفة لكل رسالة؟

لأن API عديم الحالة: تُرسَل المحادثة التي ما زالت ضمن السياق من جديد في كل جولة، بما في ذلك كل ملف تمت قراءته، وكل نتيجة أداة، وكل تبادل سابق لم يُختصر، وتُحاسَب هذه البيانات بوصفها إدخالاً. لذلك تحمل الجولة 50 الجولات من 1 إلى 49. توفّر ذاكرة التخزين المؤقت للمطالبات البادئة المتكررة بسعر يعادل عُشر سعر الإدخال الأساسي في معظم النماذج، و5% في Opus 5.5 وSonnet 5.5 و2.5% في Fable 5.1. لكن البادئة نفسها تستمر في النمو، وأي فترة خمول تتجاوز TTL لذاكرة التخزين المؤقت تجعل الجولة التالية إعادة كتابة كاملة بالسعر المعتاد. يقلّص /compact السجل، بينما يعيد /clear ضبطه.

كيف أتحقق من استخدام Claude للرموز والتكلفة؟

في Claude Code، يعرض /usage إحصاءات رموز الجلسة، وتقديراً محلياً للتكلفة، وأشرطة حدود الخطة في الاشتراكات، و/cost اسم مستعار له. ويعرض /context العناصر التي تملأ نافذة السياق. للحصول على بيانات فوترة API المعتمدة، استخدم صفحة الاستخدام في Claude Console. وفي الشفرة الخاصة بك، اقرأ response.usage. ويعطي جمع input_tokens وcache_creation_input_tokens وcache_read_input_tokens الحجم الحقيقي للمطالبة. وقدّر الحجم مسبقاً باستخدام نقطة النهاية count_tokens، وليس باستخدام tiktoken مطلقاً.