شرح التكلفة · حتى 2026-11-20

تكلفة التخزين المؤقت لمطالبات Claude Code: 5 دقائق أم ساعة واحدة تعتمد على طريقة الدفع

حتى 20 نوفمبر 2026، تعتمد الإجابة على طريقة محاسبتك: اشتراك Claude داخل استهلاك الخطة يطلب التخزين المؤقت لمدة ساعة واحدة، بينما مفاتيح API وأرصدة الاستخدام ومزوّدو السحابة يعطون 5 دقائق افتراضيًا. على مسار مفتاح API يمكنك نقل المحادثة الرئيسية إلى ساعة واحدة بتعيين promptCacheTtl إلى 1h (Claude Code v2.1.242 أو أحدث)، ولا تزال مضاعفات Anthropic الرسمية سارية: كتابة تخزين مؤقت لمدة 5 دقائق تكلّف 1.25x سعر الإدخال، وكتابة ساعة واحدة 2x، وقراءة التخزين المؤقت 0.1x في معظم الطُرز.

آخر تحديث 2026-11-20

الأسعار تتغيّر: على QCode، تُحتسب فاتورة Claude وGPT وDeepSeek وQwen حسب token — والأسعار المباشرة على /models.

#5 دقائق مقابل ساعة واحدة#قراءة التخزين المؤقت 0.1x#كتابة التخزين المؤقت 1.25x / 2x#promptCacheTtl=1h

أربعة أرقام يجدر تذكّرها

5 دقائق

عمر التخزين المؤقت الافتراضي على مسار مفتاح API

مفاتيح API وأرصدة الاستخدام ومزوّدو السحابة يحصلون على 5 دقائق لكل طلب؛ والاشتراك يحصل على ساعة واحدة فقط داخل استهلاك الخطة، وتعود المحادثة الرئيسية إلى 5 دقائق بمجرد تجاوزك إلى أرصدة الاستخدام.

1.25x

كتابة تخزين مؤقت لمدة 5 دقائق: 1.25x سعر الإدخال

كتابة إلى التخزين المؤقت تكلّف أكثر من إرسال الرموز نفسها كإدخال عادي، لكن الإصابات اللاحقة تُحاسب بسعر قراءة التخزين المؤقت؛ وتُدرج صفحة أسعار Anthropic الكتابات لمدة 5 دقائق عند 1.25x من سعر الإدخال الأساسي، مع صلاحية الإدخال لمدة 5 دقائق.

2x

كتابة تخزين مؤقت لمدة ساعة واحدة: 2x سعر الإدخال

كتابة لمدة ساعة واحدة تُحاسب عند 2x من الإدخال الأساسي وتُبقي الإدخال دافئًا لمدة ساعة. تناسب الجلسات التي تبتعد فيها لدقائق إلى ساعة، أما في الفترات القصيرة التي لا تتجاوز 5 دقائق دون خمول فإن الزيادة لا تُستخدم.

0.025x

قراءات التخزين المؤقت في Fable 5.2 تكلّف 0.025x فقط

Fable 5.2 وMythos 5.2 وFable 5.1 وMythos 5.1 تُحاسب الإصابات عند 0.025x من سعر الإدخال، ما يضع Fable 5.2 عند $0.20 لكل مليون رمز؛ وOpus 5.5 وSonnet 5.5 عند 0.05x، وكل طراز آخر عند 0.1x.

أي الطلبات تحصل على 5 دقائق وأيها على ساعة واحدة

حتى 20 نوفمبر 2026، تصنّف الوثائق كل طلب في فئتين: المحادثة الرئيسية (الجولات التفاعلية، وتشغيلات -p غير التفاعلية، وجولات Agent SDK، إضافة إلى الطلبات المساعدة التي يشغّلها Claude Code داخليًا) وكل ما عدا ذلك (الوكلاء الفرعيون، وworkflows، وteammates داخل العملية، وfork، والضغط، وعناوين الجلسات). يختار Claude Code مدة TTL لكل طلب: ما لم تختر مدة بنفسك، فإن اشتراك Claude ضمن استهلاك الخطة هو وحده ما يطلب ساعة واحدة، بينما تحصل مفاتيح API وأرصدة الاستخدام ومزوّدو السحابة على 5 دقائق للمحادثة الرئيسية.

على الاشتراك يبقى الباقي عند 5 دقائق، باستثناء مجموعة صغيرة من الطلبات المساعدة التي تتحكم بها Anthropic من جهة الخادم، وتحصل على ساعة واحدة؛ أما على مفاتيح API أو أرصدة الاستخدام أو مزوّدي السحابة فالفئتان كلتاهما 5 دقائق. الجملة الرسمية تقول: Unless you choose a TTL yourself, Claude Code requests the one-hour TTL only on a Claude subscription within your plan's included usage.

وهنا تحديدًا يقع اللبس الشائع في المجتمع، وقد كتب أحد المطوّرين في منتدى: I still don't understand if cache lasts for 5 minutes or one hour.

ما الذي تغيّر: عناصر التحكم في TTL، ولوحة للتخزين المؤقت، ومضاعفات الكتابة نفسها

ثلاثة أمور في الوثائق حتى 20 نوفمبر 2026 تتصل مباشرة بهذه الفاتورة.

  1. 1يمكنك اختيار TTL بنفسك: promptCacheTtl أو CLAUDE_CODE_PROMPT_CACHE_TTL يغطي المحادثة الرئيسية، وsubagentPromptCacheTtl أو CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL يغطي كل ما عدا ذلك، وعناصر التحكم الأربعة كلها تتطلب Claude Code v2.1.242 أو أحدث؛ وFORCE_PROMPT_CACHING_5M=1 يتقدّم عليها جميعًا، ثم متغيّر بيئة الفئة، ثم إعداد الفئة.
  2. 2حالة التخزين المؤقت مرئية: منذ v2.1.251 يضيف بلوك Session في /usage سطر Prompt cache (main) يعرض نسبة الإصابة وعدد الإخفاقات وما إذا كان التخزين المؤقت دافئًا ومدة TTL السارية؛ ومنذ v2.1.260 يذكر أيضًا سببًا محتملًا لآخر إخفاق، مثل تغيّر تعريفات الأدوات.
  3. 3المضاعفات لم تتغيّر: 1.25x لكتابة 5 دقائق، و2x لكتابة ساعة واحدة، ومن 0.025x إلى 0.1x للقراءات حسب الطراز. في خيوط المجتمع المؤرخة 2026-11-15 و2026-11-17، خلص أحد المستخدمين إلى أن تخزينًا مؤقتًا معطّلًا جعل سير عمل أكثر تكلفة، بينما كان آخر لا يزال يسأل عما إذا كان التخزين المؤقت يدوم 5 دقائق أم ساعة واحدة. للمقارنة، يقسّم جدول OpenAI الرسمي لـ gpt-6.2-sol كتابات التخزين المؤقت إلى 30m write و12h write ($2.00 إدخال، $10.00 إخراج، $0.10 إدخال مخزّن مؤقتًا، $2.50 لكتابة 30m، $5.00 لكتابة 12h)، وهي أسماء فئات لا تطابق 5 دقائق وساعة واحدة في Claude.

ثلاثة تواريخ: خيطان في المجتمع ومراجعة رسمية واحدة

2026-11-15

ينشر مستخدم تحليلًا: تخزين مؤقت معطّل جعل جزءًا من سير عمل Claude Code أكثر تكلفة. يشير الخيط إلى تبديل الطُرز في منتصف الجلسة، وتعديل تعريفات الأدوات، وأول رسالة بعد انقطاع أطول من عمر التخزين المؤقت (تقارير مجتمعية، وليست استنتاجًا رسميًا؛ والمبلغ غير مذكور هنا).

2026-11-17

في خيط آخر يكتب مطوّر أنه ما زال لا يستطيع تحديد ما إذا كان التخزين المؤقت يدوم 5 دقائق أم ساعة واحدة. تجيب الوثائق الرسمية بجدول من صفّين: الاشتراك داخل استهلاك الخطة يحصل على ساعة واحدة للمحادثة الرئيسية، بينما تحصل مفاتيح API وأرصدة الاستخدام ومزوّدو السحابة على 5 دقائق.

2026-11-20

القواعد الرسمية حتى 20 نوفمبر 2026: الاشتراكات داخل استهلاك الخطة تحصل افتراضيًا على ساعة واحدة، ومفاتيح API ومزوّدو السحابة على 5 دقائق، وتغيير TTL يتطلب v2.1.242 أو أحدث، وتبقى المضاعفات 1.25x لكتابة 5 دقائق، و2x لكتابة ساعة واحدة، و0.025x وما فوق للقراءة.

قواعد المحاسبة المؤكدة مقابل قراءات المجتمع الخاطئة

مؤكد (وثيقة التخزين المؤقت في Claude Code وصفحة أسعار Anthropic)

قابلة للتحقق حتى 20 نوفمبر 2026

  1. 1القيم الافتراضية: الاشتراك ضمن استهلاك الخطة يحصل على ساعة واحدة للمحادثة الرئيسية و5 دقائق لكل ما عداها، باستثناء الطلبات المساعدة التي يتحكم بها الخادم، وتحصل على ساعة واحدة؛ ومفاتيح API أو أرصدة الاستخدام أو مزوّدو السحابة تحصل على 5 دقائق للفئتين.
  2. 2المعاملات: الكتابة لمدة 5 دقائق تساوي 1.25x من سعر الإدخال الأساسي، والكتابة لمدة ساعة 2x، والقراءة 0.1x في معظم الموديلات.
  3. 3أسعار إصابة الذاكرة المؤقتة لكل موديل: Fable 5.2 وMythos 5.2 عند 0.025x ($0.20 لكل مليون token)، وFable 5.1 وMythos 5.1 عند 0.025x ($0.25)، وOpus 5.5 عند 0.05x ($0.20)، وSonnet 5.5 عند 0.05x ($0.10)، وكل الموديلات الأخرى عند 0.1x.
  4. 4الأسعار في الصف نفسه: Fable 5.2 بسعر $8 للإدخال و$40 للإخراج مع كتابة لمدة ساعة بـ $16؛ وOpus 5.5 بـ $4 و$20 مع كتابة لمدة ساعة بـ $8؛ وSonnet 5.5 بـ $2 و$10 مع كتابة لمدة ساعة بـ $4.
  5. 5التحقق: شغّل claude -p "hello" --output-format json، حيث يعني ephemeral_1h_input_tokens كتابة لمدة ساعة ويعني ephemeral_5m_input_tokens كتابة لمدة 5 دقائق.
  6. 6التوقيت والحدود الدنيا: كل إصابة تجدّد المدخل دون تكلفة إضافية، ومدّة الصلاحية تبدأ من وقت الطلب، وأقصر prompt قابل للتخزين المؤقت هو 512 token في Fable 5.2 وMythos 5.2 وFable 5.1 وMythos 5.1 وOpus 5.5 وSonnet 5.5 وHaiku 5.5.

قراءات المجتمع الخاطئة وما لم يُنشر بعد

  1. 1«مفتاح API يمكنه الحصول على ساعة واحدة دون دفع». ليس افتراضيًا: لا يحدث ذلك إلا بتعيين promptCacheTtl إلى 1h، والطلبات خارج المحادثة الرئيسية تبقى عند 5 دقائق حتى تعيّن TTL الخاص بها أيضًا.
  2. 2«ساعة واحدة أرخص دائمًا». تصف الوثائق العكس في الفترات القصيرة التي لا تتجاوز 5 دقائق دون خمول، حيث يُطبّق معدل الكتابة الأعلى ولا يُستخدم العمر الأطول.
  3. 3«إصابة التخزين المؤقت لا تكلّف شيئًا». تُحاسب الإصابات عند 0.025x إلى 0.1x حسب الطراز، أي أقل من سعر الإدخال القياسي لكن ليس صفرًا.
  4. 4«تغيير الجهد يعيد بناء التخزين المؤقت دائمًا». في Fable 5.1 وما بعده، وOpus 5.5 وSonnet 5.5 وHaiku 5.5 يبقى التخزين المؤقت سليمًا افتراضيًا مع مفتاح API أو اشتراك؛ وفي معظم الطُرز الأخرى لكل مستوى جهد تخزينه المؤقت الخاص.
  5. 5«الوكيل الفرعي يقرأ التخزين المؤقت للأب». طلبه الأول لا يقرأه، لأن البادئات تختلف؛ أما التفرّع فيقرأه لأنه يرث الأب بالكامل.
  6. 6لا إجابة رسمية واحدة: مدى توافر ساعة واحدة على كل منصة سحابية وبوابة يعتمد على وثائق تلك المنصة، ووثيقة Anthropic نفسها تقول فقط إنه يختلف حسب الطراز على Amazon Bedrock.

الإبقاء على 5 دقائق الافتراضية مقابل تعيين ساعة واحدة للمحادثة الرئيسية

الافتراضي 5 دقائق: عمل متواصل بفواصل أقل من 5 دقائق

يتجدد التخزين المؤقت لمدة 5 دقائق دون تكلفة إضافية في كل مرة يُستخدم، فما دامت طلباتك تفصلها أقل من 5 دقائق يبقى الإدخال دافئًا وتنطبق كتابة 1.25x على المحتوى الجديد فقط. يناسب ذلك جلسة تحرير طويلة أو استدعاءات أدوات متتابعة؛ وإذا ابتعدت أكثر من 5 دقائق فإن أول رسالة عند العودة تعيد معالجة السياق كله.

promptCacheTtl مضبوط على 1h: ابتعد قليلًا ثم عُد

عند ضبط المحادثة الرئيسية على ساعة واحدة، تُحتسب الكتابات بسعر مضاعف وتشتري ساعة من التسامح مع فجوات الخمول. جملة المقايضة في الوثيقة نفسها: It costs more on short bursts of work that never idle past five minutes, where the higher write rate applies and the longer cache lifetime goes unused. وبعبارة أخرى، إذا كنت تغادر كثيرًا ثم تعود، فهذه الزيادة هي ما يشتري لك تخطي إعادة معالجة السياق الكامل.

خمس خطوات: اقرأ مدة TTL الفعلية، ثم قرر إن كنت ستغيّرها

  1. 1اقرأ مدة TTL الحقيقية أولًا: شغّل claude -p "hello" --output-format json وافحص usage.cache_creation، حيث يشير ephemeral_1h_input_tokens إلى كتابة لمدة ساعة ويشير ephemeral_5m_input_tokens إلى كتابة لمدة 5 دقائق. وداخل الجلسة، يعرض /usage سطر Prompt cache (main) مع نسبة الإصابة وعدد الإخفاقات ومدة TTL الفعلية أثناء دفء التخزين المؤقت.
  2. 2للحصول على ساعة، ضع "promptCacheTtl": "1h" في settings.json، أو اضبط CLAUDE_CODE_PROMPT_CACHE_TTL=1h (الإصدار v2.1.242 أو أحدث)؛ ولمنح كلتا المجموعتين ساعة، اضبط ENABLE_PROMPT_CACHING_1H=1. وعندما تصل إلى أي بوابة عبر ANTHROPIC_BASE_URL، فالملاحظة الرسمية أن جزءًا من طلب الساعة ينتقل في ترويسة anthropic-beta، لذا يجب أن تمرّره البوابة دون تغيير؛ وبعد ضبطه، استخدم الخطوة ① للتأكد من ظهور ephemeral_1h_input_tokens.
  3. 3عند التنقيح، أعِد المجموعتين قسرًا إلى 5 دقائق عبر FORCE_PROMPT_CACHING_5M=1 ثم قارن، لأنه يتقدم على كل ضابط آخر.
  4. 4توقف عن إعادة بناء التخزين المؤقت: لا تبدّل النماذج ولا تعدّل تعريفات الأدوات ولا تغيّر دليل العمل في منتصف الجلسة، لأن التخزين المؤقت مرتبط فعليًا بجهاز واحد ودليل واحد؛ امنح الوكلاء الفرعيين مدة TTL أطول عبر subagentPromptCacheTtl، ولاحظ أن تغييرات الجهد تحتفظ بالتخزين المؤقت افتراضيًا على Fable 5.1 وأحدث، و Opus 5.5، و Sonnet 5.5، و Haiku 5.5.
  5. 5مع QCode، اضبط ANTHROPIC_BASE_URL على https://api.qcode.cc/api و ANTHROPIC_AUTH_TOKEN على مفتاح cr_ الخاص بك، ثم كرر الخطوة ① للتأكد من TTL.

شغّل Claude Code بفوترة لكل token: أسعار التخزين المؤقت على /models

QCode يحاسب لكل token. في Claude Code اضبط ANTHROPIC_BASE_URL على https://api.qcode.cc/api وANTHROPIC_AUTH_TOKEN على مفتاح cr_ الخاص بك. الجانب المتعلق بإعدادات TTL في Claude Code مشروح أعلاه؛ وخلف ANTHROPIC_BASE_URL مخصص توجد الذاكرة المؤقتة حيث تُوجَّه طلباتك، لذلك يعتمد عمل التخزين المؤقت على الخدمة التي تتصل بها — وبعد إعداده شغّل claude -p "hello" --output-format json وتحقق بنفسك من ephemeral_5m_input_tokens وephemeral_1h_input_tokens.

أسعار كتابة الذاكرة المؤقتة وقراءتها لكل موديل مدرجة موديلًا بموديل على qcode.cc/models، وتلك الصفحة هي المرجع. لم تجهّز نفسك لخطة شهرية؟ تبدأ باقات الدفع حسب الاستخدام من $4 لحصة تُستخدم مرة واحدة خلال 7 أيام؛ وإذا كانت لديك خطة شخصية بالفعل، أضف باقة التعزيز عندما تحتاج إلى حصة أكبر.

الأسئلة المتكررة

لماذا يُخزَّن النموذج نفسه 5 دقائق فقط مع مفتاح API؟

لأن Claude Code يختار مدة TTL لكل طلب ولكل نوع محاسبة. في الجدول الرسمي يحصل الاشتراك ضمن استهلاك الخطة على ساعة واحدة للمحادثة الرئيسية، بينما تحصل مفاتيح API أو أرصدة الاستخدام أو مزوّدو السحابة على 5 دقائق هناك. وخارج المحادثة الرئيسية يحصل الاشتراك أيضًا على 5 دقائق، باستثناء مجموعة صغيرة من الطلبات المساعدة التي تتحكم بها Anthropic من جهة الخادم، وتحصل على ساعة واحدة؛ وعلى مفاتيح API أو أرصدة الاستخدام أو مزوّدي السحابة تحصل تلك الطلبات على 5 دقائق كذلك. وللاحتفاظ بساعة على مفتاح API، اضبط promptCacheTtl على 1h بنفسك في v2.1.242 أو أحدث، وهذا ما تنص عليه الوثائق.

هل يستحق التخزين المؤقت لمدة ساعة؟

يعتمد الأمر على الفجوة بين الطلبات. إذا كنت تستخدم بادئة ما بمعدل أكثر من مرة كل 5 دقائق، فأبقِ على التخزين المؤقت لـ 5 دقائق، لأنه يستمر في التجديد دون رسوم إضافية؛ أما التخزين المؤقت لمدة ساعة فيناسب المطالبات المستخدمة أقل من كل 5 دقائق ولكن أكثر من كل ساعة، مثل وكيل جانبي يعمل أكثر من 5 دقائق أو محادثة طويلة تنتظر المستخدم. والثمن هو أن الكتابات تُحتسب بضعف سعر الإدخال.

لماذا تكلّف قراءة التخزين المؤقت شيئًا؟

لأن الخادم يقرأ تلك البادئة مرة أخرى فعلًا، لكن بسعر أرخص بكثير من الإدخال العادي: 0.1x على معظم النماذج، و0.05x على Opus 5.5 و Sonnet 5.5، و0.025x على Fable 5.2 و Mythos 5.2 و Fable 5.1 و Mythos 5.1. وتقدّم صفحة أسعار Anthropic الحساب: مع كتابة 1.25x لمدة 5 دقائق، يبدأ التخزين المؤقت في تعويض كلفته بعد قراءة واحدة من التخزين المؤقت.

كم تكلّف قراءة التخزين المؤقت في Fable 5.2 فعليًا؟

إنها $0.20 لكل مليون token: يسرد Fable 5.2 سعر $8 لكل MTok من الإدخال الأساسي وتُحتسب الإصابات بـ 0.025x، إذن $8 × 0.025 = $0.20. وفي الصف نفسه، كتابة الساعة هي $16 لكل MTok، وكتابة 5 دقائق تُحسب $8 × 1.25 = $10 لكل MTok (مثال حسابي، بأسعار قائمة Anthropic فقط، دون أسعار QCode).

هل يتسبب تغيير مستوى الجهد في إهدار التخزين المؤقت؟

ليس افتراضيًا على Fable 5.1 وأحدث، و Opus 5.5، و Sonnet 5.5، و Haiku 5.5: تقول الوثائق إن التخزين المؤقت يبقى سليمًا هناك مع مفتاح API أو اشتراك. أما على معظم النماذج الأخرى فلكل مستوى جهد تخزينه المؤقت الخاص، لذا فإن تغيير الجهد في منتصف الجلسة يعيد حساب الطلب بأكمله. وتقترح الوثائق اختيار النموذج والجهد في بداية الجلسة وحفظ /compact للفواصل الطبيعية بين المهام.

هل تحصل الوكلاء الفرعيون على تخزين مؤقت؟

نعم، لكنه منفصل. يبدأ الوكيل الفرعي محادثته الخاصة بنظام مطالبه ومجموعة أدواته، لذا لا يمكن لطلبه الأول قراءة التخزين المؤقت للأب، وهو يدفئ تخزينًا مؤقتًا خاصًا به عبر أدواره. وإنه خارج نطاق TTL الخاص بالمحادثة الرئيسية، لذا يحصل على 5 دقائق حتى مع اشتراك إلى أن تختار subagentPromptCacheTtl أطول. ولا يتأثر تخزين الأب المؤقت؛ والتفريع استثناء ويقرأ تخزين الأب المؤقت في طلبه الأول.

المصادر

وثائق prompt caching الرسمية لـ Claude Code، code.claude.com/docs/en/prompt-caching، وصفحة التكاليف، code.claude.com/docs/en/costs (تم التحقق في 2026-11-20)؛ وصفحة الأسعار الرسمية من Anthropic، platform.claude.com/docs/en/about-claude/pricing، ودليل prompt caching، platform.claude.com/docs/en/build-with-claude/prompt-caching (تم التحقق في 2026-11-20)؛ وصفحة الأسعار الرسمية من OpenAI، developers.openai.com/api/docs/pricing (2026-11-20، استُخدمت فقط لمقارنة أسماء فئات الذاكرة المؤقتة)؛ وqcode.cc/models (2026-11-20، المرجع لأسعار كتابة الذاكرة المؤقتة وقراءتها)؛ والمواد المجتمعية تأتي فقط من خيوط نقاش عامة وهي موسومة في النص بأنها تقارير مستخدمين. كل ما سبق تم التحقق منه في 2026-11-20.

اضبط TTL بشكل صحيح أولًا، ثم انتقل إلى مفتاح فوترة لكل token

أنشئ حساب QCode للحصول على مفتاح cr_، واضبط ANTHROPIC_BASE_URL=https://api.qcode.cc/api في Claude Code، واستدعِ نماذج متعددة بفوترة لكل token؛ أسعار التخزين المؤقت على /models.

قراءات ذات صلة

دليل الدفع بالعملات المشفرة

تسع عملات، و56 شبكة، وبدون رسوم منصة لرصيد API للبرمجة بالذكاء الاصطناعي.

تم التحقق من صفحتي أسعار Anthropic و OpenAI إضافة إلى وثائق التخزين المؤقت والتكاليف في Claude Code في 2026-11-20 وهي المرجع على code.claude.com و platform.claude.com و developers.openai.com؛ أما أسعار جهة QCode فتتبع qcode.cc/models. و QCode.cc خدمة وصول مستقلة إلى API وليست تابعة لـ Anthropic أو OpenAI أو غيرهما من المزوّدين ولا تحظى بتأييدها. وكل رقم بالدولار أعلاه هو سعر قائمة رسمي لمزوّد، والأمثلة الحسابية تكتفي بتوضيح معاملات الفوترة.

لست متأكدًا من أين تبدأ؟

جرّبه لمدة أسبوع

الباقة الصغيرة: $4 مقابل $30 من الحصة، مدة الصلاحية: 7 يوم

استخدمها كل يوم

Starter: $9.00 شهريًا مع $5 من الحصة كل يوم — $0.060 فقط لكل $1 من الحصة، مقارنةً بنحو $0.113 لـ الباقة المتوسطة