إنتقل إلى المحتوى الرئيسي

ضبط الجهد: خمسة مستويات، وافتراضات كل نموذج، وفخ التخزين المؤقت

متوسط

في 22 يوليو 2026 أدخلت Anthropic المعامل effort في إعدادات النموذج داخل Claude Managed Agents، لتُكمل حلقة في عنصر تحكّم نما بهدوء في Messages API إلى خمسة مستويات. إن كنت ما زلت تنسخ effort="high" في المستوى الأعلى من messages.create عن تدوينة من أوائل 2026، فطلبك يبدو سليمًا لكن Claude قد لا يلتزم بالحقل الذي تظنه — فالمعامل يوجد الآن داخل output_config، ولا تفرض الواجهة إلا المستويات الموثّقة في بطاقة النموذج.

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

What you'll learn
  • ضع حقل effort في مكانه الصحيح — داخل output_config في Messages API، وفي كائن model في Managed Agents، وعبر /effort أو CLAUDE_CODE_EFFORT_LEVEL في Claude Code
  • اختر مستوى البداية لكل نموذج — high هو الافتراضي في الواجهة لمعظم النماذج لكن ليس في Opus 5.5 وHaiku 5.5 اللذين يفترضان medium، ويختلف الجهد الموصى به للبداية فوق ذلك أيضًا (Sonnet 5.5 بمستوى medium للبرمجة الوكيلية، وSonnet 4.6 بمستوى medium، وOpus 4.7/4.8 بمستوى xhigh، وFable 5.1 بمستوى high)
  • افهم أن الجهد يؤثر في كل الرموز — النص واستدعاءات الأدوات و(عند تفعيله) التفكير — فخفض الجهد يقلّل عدد استدعاءات الأدوات لا الإسهاب وحده
  • تجنّب فخ التخزين المؤقت — تغيير الجهد داخل المحادثة الواحدة يُبطل التخزين المؤقت للمطالبات وقد يضاعف فاتورتك بصمت
  • تعرّف على واجهة الجهد في Claude Code — /effort وultrathink (لدور واحد) وultracode (xhigh + إذن دائم للعمل متعدد الوكلاء) ومتغير البيئة CLAUDE_CODE_EFFORT_LEVEL

المستويات الخمسة (وأين يقع "ultracode")​

مقياس الجهد حتى 22 يوليو 2026 له خمس قيم تقبلها الواجهة:

المستوىماذا يفعلمتى تلجأ إليه
lowالأكثر كفاءة. توفير كبير في الرموز مع انخفاض في القدرة. استدعاءات أدوات أقل، وتأكيدات موجزة، وبلا تمهيد.التصنيف البسيط، والأحمال كثيفة الحجم، والدردشة، وتجارب الاستخدام الحساسة للزمن، والوكلاء الفرعيون ذوو المهام المحدّدة
mediumمتوازن. توفير معتدل في الرموز مقارنةً بـ high.المهام الوكيلية التي تحتاج توازنًا بين السرعة والتكلفة والجودة؛ خفض واعٍ للتكلفة من high
highقدرة عالية. يعادل حذف المعامل — في كل نموذج عدا Opus 5.5 وHaiku 5.5 اللذين يفترضان medium.الاستدلال المعقّد، والبرمجة الصعبة، والمهام الوكيلية التي تهمّ فيها الجودة أكثر من السرعة
xhighقدرة موسّعة للأعمال طويلة الأمد. توقّع استهلاكًا للرموز أعلى بكثير من high.المهام الوكيلية والبرمجية الطويلة (30+ دقيقة)، وميزانيات رموز بالملايين، وإعادة الهيكلة العميقة متعددة الملفات
maxأقصى قدرة مطلقة بلا قيد على إنفاق الرموز.المشكلات الحدودية الحقيقية فقط. قد يفرط في التفكير في مهام المخرجات المنظَّمة.

لا max ولا xhigh متاحان في كل مكان — تحقق من المستوى مقابل النموذج قبل الإطلاق. يُدعم xhigh في Fable 5.1 وMythos 5.1 وFable 5 وMythos 5 وOpus 5.5 وOpus 5 وOpus 4.8 وOpus 4.7 وSonnet 5.5 وSonnet 5 وHaiku 5.5. ويشمل max هذه كلها إضافةً إلى Mythos Preview وOpus 4.6 وSonnet 4.6. أما Opus 4.5 فيدعم effort لكن لا يدعم أيًّا من المستويين الأعلى. وبحسب تعبير Anthropic: "Not every model that supports max supports xhigh."

Pro tip
  • ضبط الجهد على الافتراضي الخاص بالنموذج يعطي السلوك نفسه تمامًا كحذف المعامل — وهو 'high' في معظم النماذج، لكنه 'medium' في Opus 5.5 وHaiku 5.5. لا تضبطه 'للتوضيح فقط' في محادثة مخزَّنة مؤقتًا، لأن كتابة الحقل في بعض الطلبات دون غيرها تُبطل التخزين المؤقت.
  • 'ultracode' ليس مستوى سادسًا. إنه xhigh + إذن دائم لـ Claude Code بتشغيل سير عمل متعدد الوكلاء، يُمنح عبر رسائل نظام في منتصف المحادثة. والواجهة تقبل خمس قيم.

بنية الحقل التي تخطئ فيها معظم التدوينات​

تعرض كتابات أوائل 2026 عن معامل الجهد حقلًا في المستوى الأعلى:

# WRONG on current models — silently ignored or 400
client.messages.create(
    model="claude-opus-4-8",
    effort="medium",
    ...
)

تضع الواجهة الحالية effort داخل كائن output_config، وتمرّره شقيقًا لـ messages/model:

الموضع الصحيح لـ effort — Messages API

import anthropic

client = anthropic.Anthropic()

response = client.messages.create(
  model="claude-opus-4-8",
  max_tokens=4096,
  output_config={"effort": "medium"},
  messages=[{
      "role": "user",
      "content": "Analyse the trade-offs between microservices and monoliths."
  }],
)

print(response.content[0].text)

في Claude Managed Agents (تغيير 22 يوليو 2026)، يدخل effort داخل كائن model الخاص بالوكيل عند إنشائه. فالجلسة لا تحدّده — بل إصدار الوكيل.

الموضع الصحيح لـ effort — Managed Agents (POST /v1/agents)

# Effort travels with the versioned agent config,
# not the per-run session. Every session pinned to
# this agent version runs at xhigh.

POST https://api.anthropic.com/v1/agents
{
"name": "code-reviewer",
"model": {
  "id": "claude-opus-4-8",
  "effort": "xhigh"
},
"system_prompt": "You review pull requests for security issues.",
"tools": [...],
"mcp_servers": [...]
}

الجهد ليس أداة للتحكم في التفكير​

هذا هو سوء الفهم الكبير الثاني. يعمل الجهد سواء كان التفكير مفعّلًا أم لا، ويغيّر الرموز التي ينفقها Claude في أجزاء من الرد ليست تفكيرًا:

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

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

يجيب المعامل thinking والمعامل effort عن سؤالين مختلفين. يقرر thinking ما إذا كان Claude سينتج كتل تفكير أصلًا. ويقرر effort مقدار العمل المبذول في الرد كله — بما في ذلك مدى تكرار تفكير Claude وعمقه حين يكون التفكير التكيّفي مفعّلًا. تمرير effort="adaptive" خطأ شائع؛ فـ adaptive وضع تفكير وليس مستوى جهد.

Pro tip

في Opus 4.5 — النموذج الوحيد المقتصر على التفكير الموسَّع الذي يدعم effort — تضبط الجهد و budget_tokens معًا. اختر مستوى الجهد الذي تناسب مهمتك، ثم حدّد ميزانية رموز التفكير بحسب عمق الاستدلال المطلوب. أما كل النماذج الأخرى الداعمة لـ effort فتستخدم التفكير التكيّفي ولا تأخذ budget_tokens.

نقاط بداية لكل نموذج تفاجئ الفرق​

الافتراضي في الواجهة هو high في معظم النماذج الداعمة لـ effort — لكن ليس في كلها. يفترض Opus 5.5 وHaiku 5.5 المستوى medium. وفوق ذلك، يختلف الجهد الموصى به للبداية لدى Anthropic من نموذج إلى آخر، وفي هذا التفاوت تُفرط الفرق في الإنفاق أو تُقصّر فيه.

Guided walkthrough1 of 9
  1. Opus 5.5 هو الوحيد بين نماذج Opus الذي يفترض medium، لذا فالطلب الذي يحذف effort يعمل بمستوى أدنى بدرجة واحدة مما كانت عليه الشِفرة نفسها في Opus 5. إن انتقلت وانخفضت الجودة، فهذا أول ما يجب فحصه. التفكير التكيّفي مفعّل دائمًا ولا يمكن تعطيله (thinking: {type: 'disabled'} يعيد 400 عند كل مستوى)، فالجهد هو وسيلتك الوحيدة للتحكم في مقدار استدلاله وتكلفة الطلب. أجرِ مسحًا جديدًا للجهد بدل نقل الإعدادات القديمة — فهو عند مستوى معيّن يفكّر في كل دور أكثر مما كان يفعل Opus 5.

فخ التخزين المؤقت — الذي يضاعف فاتورتك بصمت​

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

مخرج الطوارئ: الجهد لكل رسالة (بيتا)​

تتيح النماذج الأحدث تغيير الجهد دون خسارة الذاكرة المؤقتة. أضف رسالة role: "system" بـ content فارغ تحمل المستوى الجديد في output_config.effort، ويبقى كل ما قبلها مطابقًا بايتًا ببايت — فيظل المقطع المخزَّن مطابقًا.

تغيير effort في منتصف المحادثة دون فقدان الذاكرة المؤقتة

# Beta header required:
#   anthropic-beta: mid-conversation-output-config-2026-07-01

{
"model": "claude-fable-5-1",
"max_tokens": 4096,
"output_config": {"effort": "high"},
"messages": [
  {"role": "user", "content": "Plan a migration from SQLite to PostgreSQL."},
  {"role": "assistant", "content": "1. Export... 2. Create schema... 3. Import."},
  {"role": "system", "content": [], "output_config": {"effort": "low"}},
  {"role": "user", "content": "Summarize the plan in one sentence."}
]
}

التوفّر حتى 19 أكتوبر 2026: في Claude API وGoogle Cloud يعمل على Fable 5.1 وMythos 5.1 وOpus 5.5 وOpus 5 وSonnet 5.5 وHaiku 5.5؛ وفي Amazon Bedrock على Fable 5.1 وMythos 5.1 وOpus 5.5 فقط. ويتطلب ترويسة البيتا mid-conversation-output-config-2026-07-01 — وبدونها يعيد output_config لكل رسالة الخطأ 400 messages.N.output_config: Extra inputs are not permitted. ومع الترويسة لكن بنموذج غير مدعوم (ومنها Fable 5) تحصل على 400 output_config.effort requires a model that supports per-turn effort; this model does not.

نموذجان يرفضان تغيير الجهد لكل دور متى ثُبِّت التفكير: Sonnet 5.5 مع thinking: {"type": "between_tools"} وHaiku 5.5 مع thinking: {"type": "disabled"} يعيدان 400 إذا اختلف المستوى الموضوع في الرسالة عن المستوى الساري. استخدم التفكير التكيّفي لتغيير الجهد هناك.

أما في كل ما عدا ذلك، فالقاعدة القديمة ما زالت سارية — اختر مستوى وثبّته:

Pro tip
  • في النماذج التي لا تدعم الجهد لكل رسالة، غيّر الجهد بين أحمال العمل المختلفة لا داخل محادثة مخزَّنة مؤقتًا. اختر المستوى عند بداية المحادثة، وأبقه ثابتًا حتى تنفّذ /clear.
  • فضّل الجهد لكل رسالة على تغيير المستوى الأعلى حتى حين يعمل الاثنان: ففي Fable 5.1 يوجّه تبديل المستوى الأعلى النموذج بموثوقية أقل أيضًا، لأن ردوده السابقة كُتبت بالمستوى القديم وهو يميل إلى الاتساق معها.
  • في Claude Code، تغيير /effort في منتصف الجلسة يعادل تبديل النموذج — توقّع خسارة كبيرة في الذاكرة المؤقتة في الدور التالي.
  • إن أردت تعميق التفكير لدور واحد فقط، فاستخدم 'ultrathink' في Claude Code (دفعة تفكير أعمق لدور واحد) بدل /effort xhigh — فهو يتجنب تغيير إعدادات الجلسة.
  • وإن كان لا بد من التصعيد لبقية الجلسة، ففعله مبكرًا. تبديل في الدور 3 رخيص؛ أما تبديل في الدور 30 فيعيد قراءة 30 دورًا من السياق بالسعر الكامل.

والنتيجة الملازمة: ضبط effort="high" صراحةً في بعض الطلبات المخزَّنة مؤقتًا وحذفه في أخرى يُبطل الذاكرة المؤقتة بالطريقة نفسها — لأن الصيغتين متكافئتان سلوكيًا لكنهما مختلفتان نصيًا. اختر عُرفًا واحدًا (الضبط دائمًا أو الحذف دائمًا) والتزم به.

Claude Code — واجهة سطر الأوامر​

يتيح Claude Code الجهد كأمر تفاعلي وراية تشغيل ومتغير بيئة (الأعلى أولوية يفوز، بالترتيب العكسي لما يلي):

# In-session (interactive slider, or direct)
/effort
/effort xhigh
/effort auto           # reset to model default

# At launch
claude --effort low

# Environment (overrides everything else)
CLAUDE_CODE_EFFORT_LEVEL=high claude

هناك أمران متصلان يستحقان المعرفة لأنهما ليسا مستويي جهد لكنهما يتصرفان بما يقاربهما:

  • ultrathink — دفعة تفكير أعمق لدور واحد لا تغيّر جهد الجلسة. استخدمه حين تريد أن يفكّر الدور التالي أكثر دون إبطال الذاكرة المؤقتة لكل الأدوار اللاحقة.
  • ultracode — يضبط xhigh على مستوى الجلسة كلها ويمنح إذنًا دائمًا لـ Claude Code بتشغيل سير عمل متعدد الوكلاء (عبر رسائل نظام في منتصف المحادثة). ليس في الواجهة قيمة اسمها ultracode — إنه تسهيل في سطر الأوامر يجمع xhigh مع إذن تنسيق.

قواعد الاستمرارية التي يجب تذكّرها: تبقى المستويات low وmedium وhigh وxhigh عبر جلسات Claude Code بعد ضبطها. أما max فيسري على الجلسة الحالية فقط — وعليك إعادة تطبيقه في المرة القادمة.

جولة ضبط — مطالبة واحدة بثلاثة مستويات جهد​

لمعايرة الحدس، شغّل المطالبة نفسها عند ثلاثة مستويات وقارن شكل المخرجات:

مطالبة معايرة الضبط (شغّلها عند low وhigh وxhigh)

Task: Review this pull request for security issues.

<pr_diff>
[paste a real diff — 300+ lines, multi-file, at least one auth-touching change]
</pr_diff>

Report: severity-tagged findings + a one-line fix per finding.
Do not restate what the diff does.

توقّع تقريبًا ما يلي:

  • low — يلتقط المشكلات الواضحة عالية الخطورة (دمج نصوص SQL، ومدخلات مستخدم غير مفحوصة في ترويسة). ويفوّت أخطاء المنطق الدقيقة. استدعاء أو اثنان للأدوات إن توفرت. مخرجات قصيرة. سريع.
  • high — تحليل كامل. يلتقط معظم الثغرات بما فيها الدقيقة. استدعاءات أدوات موجّهة متعددة لقراءة الملفات ذات الصلة. نتائج منظَّمة. وعند هذا المستوى تتوقف معظم الفرق.
  • xhigh — شامل ومستفيض. ينظر في متجهات هجوم جديدة والدفاع المتعدد الطبقات. يقرأ ملفات مجاورة لم يلمسها low/high. استدعاءات أدوات أكثر بكثير. استهلاك رموز أعلى بكثير.

إن أظهرت تقييماتك أن high وxhigh ينتجان النتائج نفسها على قاعدة شِفرتك، فأطلق بـ high. تظهر قيمة xhigh تحديدًا حين تستفيد المهمة من تكرار استدعاءات الأدوات والاستكشاف المفصّل — وهو بالضبط ما توصي به Anthropic لأجله.

Sonnet 5 أزاح المعايرة — لا تنقل المستويات دون تدقيق​

إن كنت تشغّل Sonnet 4.6 عند high وانتقلت إلى Sonnet 5، فإبقاء المستوى نفسه يجعل Sonnet 5 ينفق أقرب إلى ما كان ينفقه Sonnet 4.6 عند max — فمقياس الجهد في Sonnet 5 مُزاح. وإرشاد Anthropic نفسها: Sonnet 5 medium ≈ Sonnet 4.6 high. وهذا تفاوت في تكلفة الطلب الواحد يستحق التحقق إن أعدت تشغيل حركة المرور دون تعديل الجهد. راجع الدليل الميداني لـ Sonnet 5 للاطلاع على قصة الانتقال كاملة.

ثبّت ما تعلمته​

اضغط Enter أو مفتاح المسافة لقلب البطاقة. استخدم مفتاحي السهمين الأيسر والأيمن للتنقل بين البطاقات.تم إظهار المصطلح.
1 / 9

اختبر نفسك

0/7
  1. أي من هذه ليست قيمة effort صالحة في Messages API؟
  2. تشغّل محادثة من 20 دورًا مخزَّنة مؤقتًا، فتقلب effort في المستوى الأعلى من high إلى xhigh في الدور 21. ماذا يحدث؟
  3. أنت على Opus 5.5 وتحذف معامل effort كليًا. أي مستوى يعمل؟
  4. أنت في Claude Code وتريد أن يستدل الدور التالي فقط بعمق أكبر دون المساس بإعداد الجهد في جلستك. أفضل خطوة؟
  5. في Opus 4.8 عند effort='xhigh'، تظل ردودك تُبتر مع stop_reason='max_tokens' بعد تفكير طويل. ما الحل الأرجح؟
  6. أين يوضع effort عند إنشاء وكيل في Claude Managed Agents (تحديث يوليو 2026)؟
  7. أي تغيير يجعل 'medium' في Sonnet 5 يتصرف أقرب ما يكون إلى Sonnet 4.6 عند 'high'؟

المصادر وقراءات إضافية​

التالي​