دليل تحسين التكلفة

أتقن تقنيات التحكم في تكلفة Claude Code لإنجاز المزيد باستخدام tokens أقل

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

آخر تحقق: 2026-11-12 · 📄 وفقًا للوثائق الرسمية لـ Anthropic وqcode.cc (تحققت هذه المراجعة من جدول أسعار النماذج ونماذج Fable الحالية؛ وتُعرض أسعار كل نموذج على qcode.cc/models)

دليل تحسين التكلفة¶

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

لست مستعدًا لخطة شهرية؟ تبدأ باقات الدفع حسب الاستخدام من $4 مقابل حصة لمرة واحدة تستخدمها خلال 7 أيام. عند نفاد الحصة تحصل على HTTP 402، ويُبقيك التجديد مستمرًا على المفتاح نفسه؛ القواعد موجودة في باقات الدفع حسب الاستخدام.

فهم فوترة token¶

قبل تحسين التكاليف، عليك فهم المنطق الكامن وراء الفوترة—أي token.

ما هو token؟¶

token هو أصغر وحدة نصية يعالجها نموذج ذكاء اصطناعي. يمكنك التفكير فيه بوصفه «كلمة» النموذج:

• الإنجليزية: 1 token ≈ 4 أحرف، أو 0.75 كلمة
• الصينية: حرف صيني واحد ≈ 1-2 token (بمتوسط ~1.5 token)
• الشيفرة: تستهلك أسماء المتغيرات والكلمات المفتاحية والرموز أعدادًا مختلفة من token

مرجع تقديري سريع:

token الإدخال مقابل token الإخراج¶

تتألف كل عملية تفاعل مع Claude من جزأين من حيث الفوترة:

Total Cost = Input tokens × Input rate + Output tokens × Output rate

نقطة أساسية: عادةً ما تكون token الإخراج أغلى بمقدار 5x من token الإدخال. باستخدام Sonnet 5.5 كمثال (يستخدم الجدول أسعار القائمة المنشورة من Anthropic لتوضيح كيفية هيكلة فوترة token، حتى 2026-11-12؛ وتحتسب QCode الفوترة لكل token، وتُدرج أسعار كل نموذج على qcode.cc/models، وهي الصفحة المعتمدة):

وهذا يعني أن جعل Claude يولّد محتوى مطوّلًا أكثر تكلفة من أن توفّر أنت سياقًا أكبر.

كم token تستهلكه محادثة نموذجية؟¶

باستخدام Sonnet 5.5 كمثال، فيما يلي تقديرات التكلفة لعدة سيناريوهات شائعة:

الأرقام أعلاه لأغراض مرجعية فقط. تعتمد التكاليف الفعلية على حجم الشيفرة لديك، وعدد أدوار المحادثة، وحجم السياق.

استراتيجية اختيار النموذج¶

اختيار النموذج المناسب هو الطريقة الأكثر مباشرة لتوفير المال. فرق السعر بين النماذج المختلفة كبير.

تصنيف النماذج الرئيسية¶

الأسعار أدناه هي أسعار القائمة المنشورة من Anthropic (بالدولار الأمريكي لكل مليون token، حتى 2026-11-12). تُستخدم فقط لمقارنة الفئات ببعضها؛ أما الأسعار الفعلية لـ QCode فهي على qcode.cc/models.

تسرد صفحة /models في QCode النموذج claude-fable-5-2، ولا يزال النموذج السابق claude-fable-5-1 معروضًا للبيع؛ مفتاح QCode واحد يستدعي كليهما، والأسعار الفعلية على qcode.cc/models.

مقارنة التكلفة: إنجاز المهمة نفسها متوسطة التعقيد (10K من token الإدخال، و3K من token الإخراج) بالأسعار أعلاه:

• Haiku 5.5: $0.0025
• Sonnet 5.5: $0.050
• Opus 5.5: $0.100

تبلغ تكلفة Sonnet 5.5 نحو 20 ضعف تكلفة Haiku 5.5، وOpus 5.5 نحو ضعفَي Sonnet 5.5.

مبادئ اختيار النموذج¶

Use Sonnet as your daily default (80% of tasks can be handled by it)

Only switch to Opus for:

  - Complex architecture design and technical decisions
  - Large-scale code refactoring
  - Cross-module modifications involving multiple systems
  - Difficult bugs requiring deep reasoning

Only switch to Haiku for:

  - Simple format conversions
  - Generating repetitive code (like CRUD endpoints)
  - Quick Q&A (questions answerable in one sentence)
  - Code comments and documentation generation

استخدم الأمر /model للتبديل في أي وقت:

/model sonnet    # Switch to Sonnet
/model opus      # Switch to Opus
/model haiku     # Switch to Haiku

نصائح لتوفير التكلفة في إدارة السياق¶

إدارة السياق أساسية لتحسين التكلفة. في كل دور من المحادثة، يعيد Claude إرسال كامل سجل المحادثة السابق، ما يعني أنه كلما طالت المحادثة، زاد عدد token الإدخال في كل دور.

/compact لضغط السجل¶

عندما تتجاوز المحادثة 10 أدوار، أو تشعر أن الاستجابة أصبحت أبطأ، استخدم /compact:

/compact

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

متى تستخدمه:

• تتجاوز المحادثة 10 أدوار
• إكمال مهمة فرعية والاستعداد لبدء التالية
• الشعور بأن استجابات Claude تتراجع (علامة على تحميل السياق الزائد)

/clear للبدء من جديد¶

عند الانتقال إلى موضوع مختلف تمامًا، استخدم /clear دون تردد:

/clear

متى تستخدمه:

• الانتقال من تطوير الميزة A إلى الميزة B
• اكتمال تصحيح الأخطاء، والبدء في كتابة شيفرة جديدة
• انحراف المحادثة عن الموضوع، والرغبة في البدء من جديد

تكلفة عدم استخدام /clear: إذا كان سجل محادثتك السابق يحتوي على 50K token، فإن كل دور في الموضوع الجديد يدفع مقابل تلك الـ 50K token بلا داعٍ. وبسعر الإدخال لدى Sonnet 5.5 ($2 لكل مليون token)، يمثل ذلك $0.10 إضافية في كل دور. 10 أدوار = $1 مهدرة.

الإحالة الدقيقة باستخدام @¶

فرق التكلفة بين ترك Claude يبحث عن الملفات بنفسه وبين إحالتك إلى الملفات مباشرة كبير:

# Expensive! Claude may search dozens of files to find relevant code
"Help me modify the email validation part of user registration logic"

# Cheap! Directly tell Claude where to look
"Modify the regex in the validateEmail method in @src/services/auth-service.ts"

عندما تعرف الملف الذي تريد تعديله، استخدم @ دائمًا للإحالة المباشرة. إن ترك Claude يبحث بنفسه ليس أكثر تكلفة فحسب، بل وأقل دقة أيضًا.

.claudeignore لاستبعاد الملفات الكبيرة¶

تأكد من أن الأنواع التالية من الملفات موجودة في .claudeignore:

# These files consume massive tokens if read by Claude
node_modules/          # Tens of thousands of files
dist/                  # Build output
*.min.js               # Minified JS
*.sql                  # Database dump
*.csv                  # Data files
package-lock.json      # Lock file (enormous content)
pnpm-lock.yaml         # Lock file
yarn.lock              # Lock file

حالة واقعية: اكتشف أحد المستخدمين تكاليف مرتفعة بشكل غير طبيعي، وتبين أن Claude قرأ ملف تفريغ SQL بحجم 50MB أثناء البحث في الشيفرة، مستهلكًا نحو 15M token دفعة واحدة (نحو $45 من تكاليف الإدخال).

الاستفادة من التخزين المؤقت¶

التخزين المؤقت للـ prompt ميزة مهمة جدًا لتوفير التكلفة في Claude API.

ما هو التخزين المؤقت للـ prompt¶

عندما تكون لديك محادثات متتالية متعددة الأدوار، يعيد كل دور إرسال كل المحتوى السابق. ومن دون التخزين المؤقت، تُحتسب التكلفة في كل مرة بسعر الإدخال الكامل. مع التخزين المؤقت:

• الإرسال الأول: تُحتسب التكلفة بسعر الإدخال العادي (كتابة التخزين المؤقت أعلى قليلًا)
• الإرسالات اللاحقة: يُصيب المحتوى نفسه التخزين المؤقت، وتُحتسب التكلفة بسعر قراءة التخزين المؤقت (1/10 من الإدخال العادي على معظم النماذج، و1/20 على Sonnet 5.5 وOpus 5.5)

باستخدام Sonnet 5.5 كمثال:

وهذا يعني أن إصابة التخزين المؤقت تكلّف جزءًا صغيرًا فقط من سعر الإدخال العادي (1/10 على معظم النماذج، و1/20 على Sonnet 5.5 وOpus 5.5).

كيف تعظّم فوائد التخزين المؤقت¶

التخزين المؤقت تلقائي، لكن يمكنك تحسين معدل إصابة التخزين المؤقت من خلال عادات الاستخدام:

حافظ على تماسك المحادثات:

# Good habit: Continue developing the same feature in one conversation
> "Create UserService basic structure"
> "Add getUserById method"        # Previous content hits cache
> "Add updateUser method"         # Previous content hits cache
> "Add unit tests"                # Previous content hits cache

# Bad habit: /clear after every sentence
> "Create UserService basic structure"
> /clear
> "Add getUserById method to UserService"    # Cannot leverage cache
> /clear
> "Add updateUser method to UserService"     # Cannot leverage cache

لا تُعدّل CLAUDE.md بشكل متكرر:

يُرسَل محتوى CLAUDE.md في كل دور من أدوار المحادثة. وإذا كان المحتوى مستقرًا، فسيصيب التخزين المؤقت على المدى الطويل. التعديلات المتكررة تسبب إبطال التخزين المؤقت.

توقيت معقول لـ /compact:

يستبدل /compact السجل، مما يسبب إبطال التخزين المؤقت. لذا لا تستخدمه بشكل مفرط، بل فقط عندما تكون المحادثة طويلة جدًا بالفعل.

ما مدى فائدة التخزين المؤقت¶

بافتراض محادثة من 10 أدوار، يحتوي كل دور على نحو 20K من tokens الإدخال (بما في ذلك السجل):

وفقًا لأسعار Anthropic المدرجة أعلاه، يوفّر التخزين المؤقت نحو 85% من تكلفة الإدخال في هذا المثال.

المراقبة وإعداد الميزانية¶

اجعل من عادتك مراقبة التكاليف لتجنب الإنفاق الزائد دون أن تدري.

/cost لعرض الجلسة الحالية¶

في أي وقت داخل Claude Code، أدخل:

/cost

سيُظهر عدد tokens المستهلكة والتكلفة التقديرية للجلسة الحالية. تحقق منه بعد إكمال كل مهمة.

لوحة التحكم في QCode.cc للسجل¶

سجّل الدخول إلى QCode.cc Console، وفي صفحة «إحصاءات الاستخدام» يمكنك رؤية:

• تفاصيل استدعاء النموذج: النموذج وعدد tokens والتكلفة لكل استدعاء
• ملخصات يومية/شهرية: مخططات اتجاه التكلفة
• تقدم استهلاك الخطة: النسبة المئوية لاستخدام حصة الخطة الحالية

اجعل من عادتك التحقق من لوحة التحكم يوميًا لاكتشاف الاستهلاك غير الطبيعي مبكرًا.

توصيات التحكم في التكاليف¶

مزالق التكلفة الشائعة¶

فيما يلي المواقف التي تهدر tokens بأكبر سهولة. تحقق مما إذا كان أي منها ينطبق عليك:

المزلق 1: لصق الملفات الكبيرة مباشرة¶

# Wrong approach: Pasting file content into the conversation
> "Here's my code, help me review it:
[pasted 500 lines of code]"

# Correct approach: Use @ reference
> "Review the createOrder method in @src/services/order-service.ts"

الفرق: لصق 500 سطر يبلغ نحو 1,500 من tokens الإدخال، وتُعاد إرسالها في كل دور من المحادثة. وعند استخدام @ للإشارة إلى الملف نفسه، لا يقرأه Claude إلا عند الحاجة، ويُخزَّن المحتوى المقروء في التخزين المؤقت.

المزلق 2: إعادة محاولة الأمر الفاشل نفسه مرارًا¶

# Wrong approach: Asking Claude to run the same failed command repeatedly
> "Run npm run build"
# Failed
> "Try again"
# Still failed
> "One more time"

# Correct approach: Analyze the failure reason and try a different approach
> "Run npm run build"
# Failed
> "Look at the error logs, analyze the failure reason, fix the issue, then build"

كل إعادة محاولة ترسل سجل المحادثة الكامل (بما في ذلك جميع المخرجات الفاشلة السابقة)، ويتراكم استهلاك tokens بسرعة.

المزلق 3: نسيان /clear مما يؤدي إلى تضخم السياق¶

هذا هو أخفى مزالق التكلفة:

# Morning: Fixed a bug (conversation accumulated 30K tokens of history)
# Afternoon: Started writing a new feature, but no /clear
# Every turn of the new conversation carries the morning's 30K tokens unnecessarily

# Fix: Develop the habit of /clear when switching tasks
/clear
> "Now starting development of the new feature..."

المزلق 4: استخدام Opus للمهام البسيطة¶

# Wasteful: Using Opus to generate a simple interface
/model opus
> "Help me define a User interface with id, name, email fields"

# Savings: Haiku is sufficient for simple tasks
/model haiku
> "Help me define a User interface with id, name, email fields"

مخرجات النموذجين شبه متطابقة لهذه المهمة، لكن تكلفة Opus تفوق تكلفة Haiku بنحو رتبة عشرية كاملة (نحو 40x بالأسعار أعلاه).

المزلق 5: ترك Claude يبحث في المشروع بأكمله¶

# Expensive: Claude may read dozens of files
> "Find the code that handles payments in the project"

# Cheap: Tell it roughly where to look
> "Find the service handling payments in @src/services/"

# Cheapest: Specify the file directly
> "Check @src/services/payment-service.ts"

قائمة التحقق لتحسين التكلفة¶

استخدم قائمة التحقق هذه في كل مرة تستخدم فيها Claude Code:

• [ ] اختيار النموذج المناسب (استخدم Sonnet لمعظم المهام)
• [ ] استخدام مراجع @ بدلًا من لصق محتوى الملفات
• [ ] تنفيذ /clear عند تغيير الموضوع
• [ ] النظر في استخدام /compact عندما تتجاوز المحادثة 10 أدوار
• [ ] تكوين .claudeignore لاستبعاد الملفات الكبيرة
• [ ] وصف المتطلبات واضح بما يكفي (تجنّب إعادة العمل بسبب سوء الفهم)
• [ ] التحقق من /cost لفهم الاستهلاك الحالي

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

التخزين المؤقت للـ prompt والتكلفة¶

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

البادئات الثابتة فقط تُخزّن مؤقتًا¶

يقوم التخزين المؤقت للـ prompt في Claude API بتخزين البادئة الثابتة من الـ prompt الخاص بك مؤقتًا—الافتتاحية غير المتغيّرة: الـ prompt النظامي، وCLAUDE.md، والمواد الخلفية الطويلة، إلخ. وبعد تخزينه مؤقتًا، تكلّف قراءات هذا الجزء نحو 10% كحد أقصى من الإدخال العادي (ونحو 5% على Sonnet 5.5 وOpus 5.5). والأهم أن التخزين المؤقت يعمل وفق البادئة: فبمجرد تغيّر أي شيء في الجزء الأول من البادئة، يُبطل كل التخزين المؤقت من نقطة التغيّر فصاعدًا.

لذا فإن مبدأ توفير التكلفة الجوهري هو: ضع المحتوى غير المتغيّر أولًا، وحاول ألا تعدّله.

جعل السياق ملائمًا للتخزين المؤقت¶

• CLAUDE.md موجز وثابت: محتوى عالي الدلالة، يُعدّل نادرًا. إن تغيير CLAUDE.md بشكل متكرر يُبطل التخزين المؤقت بأكمله بعده، مما يفرض إعادة حساب بالسعر الكامل في كل مرة.
• أعد استخدام الجلسات: واصل تنفيذ المهمة نفسها ضمن جلسة واحدة حتى تبقى البادئة كما هي ويستفيد كل دور لاحق من سعر قراءة التخزين المؤقت.
• الإشارة بالمسار بدلًا من اللصق: استخدم @path للإشارة إلى الملفات بدلًا من لصق المحتوى في المحادثة—فهذا يقلل عدد tokens ويمنع حشو محتوى متغيّر في البادئة وكسر التخزين المؤقت.
• استخدم /compact باعتدال: يعيد /compact كتابة ملخص السجل، ما يعني فعليًا إعادة كتابة البادئة وإبطال التخزين المؤقت الحالي—لا تستخدمه إلا عندما تكون المحادثة طويلة جدًا فعلًا.

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

توجيه النماذج حسب الدور¶

«استخدم Sonnet يوميًا» نقطة بداية جيدة، لكن ثمة مقاربة أكثر اقتصادًا هي اختيار النموذج حسب دور المهمة، وتشغيل كل نوع من العمل على النموذج الأكثر فعالية من حيث التكلفة بدلًا من استخدام نموذج واحد طوال الوقت.

التوجيه حسب الدور¶

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

التبديل أثناء الجلسة¶

استخدم /model للتبديل في أي وقت، دون إعادة تشغيل الجلسة:

/model haiku     # Drop to a lightweight model for simple steps
/model sonnet    # Switch back to the primary model to keep implementing
/model opus      # Temporarily upgrade when hitting an architecture decision

إيقاع فعّال لتوفير التكاليف: قُد معظم التطوير باستخدام Sonnet، وانتقل مؤقتًا إلى /model opus للتفكير في نقطة عالقة متعلقة بالبنية، ثم عُد إلى Sonnet بمجرد اتخاذ القرار؛ وسلّم الجزء الأكبر من أعمال التنظيف البسيطة إلى Haiku. للحصول على مقارنة أكثر تفصيلًا لقدرات كل نموذج ونصائح الاختيار، راجع دليل اختيار النموذج.

المؤسسات ←