One dial changes everything: effort
مفتاح واحد يغيّر كل شيء: الجهد
النموذج نفسه، والطلب نفسه — ونتائج مختلفة تماماً، والسبب سؤال واحد:
كم تريد للذكاء الاصطناعي أن يجتهد؟
يصعد بك هذا الفصل السُلّم كاملاً: من إجابات فورية عند low،
إلى Ultracode حيث يقود منسّقٌ واحد جيوشاً من الوكلاء المتوازين.
Same model, same prompt — wildly different results. This chapter climbs the whole ladder, from instant answers at low to Ultracode's armies of parallel agents.
Adaptive thinking: Claude decides when to think التفكير التكيّفي: كلود يقرّر متى يفكّر
قبل أن تُحسن استخدام مفتاح الجهد، ينبغي أن تعرف ما الذي تديره أصلاً.
Thinking on demand · تفكير عند الطلب
تستخدم نماذج كلود الحديثة الـadaptive thinking: فالنموذج نفسه يقرّر متى يستحقّ الطلب استدلالاً متأنّياً خطوة بخطوة، ومتى يمكنه الإجابة مباشرةً. اسأله كم يساوي 2 + 2 فيجيبك فوراً. واطلب منه أن يحلّ deadlock موزّعاً على ثلاث خدمات، فيتمهّل، ويفكّر في الاحتمالات، ويراجع منطقه قبل أن يردّ.
Why fixed budgets died · لماذا انقرضت الميزانيات الثابتة
كانت الأنظمة الأقدم تُجبرك على حجز «ميزانية تفكير» ثابتة من التوكنز لكل طلب. وهي صفقة خاسرة من الجهتين: فالأسئلة البسيطة كانت تبدّد الميزانية، والمشكلات الصعبة كانت تستنفدها في منتصف الفكرة. وقد استبدل الـadaptive thinking بالحصّة الثابتة حُكمَ النموذج، فصار ينفق الاستدلال حيث تحتاجه المشكلة فعلاً.
Thinking vs. the answer · التفكير شيء والإجابة شيء آخر
التفكير هو المسودّة الداخلية للنموذج: فرضيات تُطرح وتُرفض، وحالات حدّية تُفحص، وخطط تُعدَّل. أمّا الإجابة فهي الخلاصة المقطَّرة. وزيادة التفكير نادراً ما تعني ردّاً أطول، بل ردّاً أصحّ. فالجهد يتحكّم بعمق المسودّة لا بطول الردّ.
output_config.effort، وهو في Claude Code المفتاح نفسه من وراء الكواليس.The effort ladder سلّم الجهد
ستّ درجات، من الأرخص والأسرع إلى فريق كامل منسَّق من الوكلاء. تعلّم ماذا تشتري لك كل درجة، وكم تكلّفك.
| Level · المستوى | Reasoning depth · عمق الاستدلال | Tool calls & output · الأدوات والإخراج | Latency & cost · الزمن والتكلفة | Pick it when · اختاره لما |
|---|---|---|---|---|
| low | جولات سريعة فقط — يفكّر لحظةً عند الحاجة، ويجيب مباشرةً حين يستطيع | أقلّ عدد من tool calls وأكثرها دمجاً؛ إخراج مختصر ومباشر | الأسرع والأرخص لكل طلب | بحث سريع، أو إعادة تسمية، أو إعادة تنسيق، أو تلخيص، أو خطوط معالجة عالية الحجم. وعلى أحدث النماذج يقدّم low أكثر بكثير ممّا يوحي به اسمه. |
| medium | استدلال معتدل على الأجزاء التي تحتاجه | استخدام أدوات مدموج؛ إجابات موجزة لكنها كاملة | زمن استجابة منخفض، تكلفة منخفضة | العمل اليومي الروتيني: صياغة، وتعديلات صغيرة، وأسئلة مباشرة. وهو قويّ بشكل مفاجئ على النماذج الحالية. |
| high | استدلال كامل خطوة بخطوة على كل ما ليس بديهياً | مستعدّ للاستكشاف بـtool calls إضافية؛ إخراج وافٍ | أبطأ وأغلى من medium بشكل ملحوظ |
الافتراضي في الـAPI. تحليل متين، ومهامّ متعدّدة الخطوات، وكل ما تكلّفك فيه الإجابة الخاطئة وقتاً حقيقياً. |
| xhigh | استدلال عميق ومثابر — يخطّط، وينفّذ، ويعيد التحقّق | ميزانية أدوات سخيّة: يقرأ على اتّساع، ويتحقّق من تعديلاته بنفسه | أعلى أيضاً — لكنه غالباً أرخص من إجابة خاطئة | الافتراضي في Claude Code، والنقطة المثلى للبرمجة والعمل الوكيلي: ميزات حقيقية، وrefactors، وتعديلات متعدّدة الملفات. |
| max | استقصائي — يلاحق كل حالة حدّية وكل فرضية بديلة | لا يتردّد لحظةً في الاستكشاف الإضافي والتحقّق المزدوج | أقصى ما ينفقه وكيل واحد | حين تكون الصحّة أهمّ من التكلفة: أخطاء دقيقة، أو منطق حسّاس أمنياً، أو migrations. وتحذير: قد يبالغ في التفكير في المهامّ البسيطة. |
| ULTRACODE | أبعد من عقل واحد — منسّق مع وكلاء متخصّصين بالتوازي | سير عمل كامل من وكلاء فرعيّين يبحثون ويبنون ويتحقّقون من عمل بعضهم | أضعاف توكنز الجلسة العادية | تدقيقات، أو أخطاء عنيدة، أو بناء كبير، أو أي عمل من نوع «كن شاملاً». وهو مشروح بالتفصيل أدناه. |
max قد يبالغ في التفكير في طلب بسيط، فيحرق الوقت وهو يشكّك في إجابة كانت صحيحة من أوّل مرّة. والمهارة كلّها في مطابقة الدرجة مع المشكلة.Ultracode — beyond a single mind Ultracode — أبعد من عقل واحد
كل درجة حتى الآن جعلت وكيلاً واحداً يجتهد أكثر. أمّا Ultracode فيغيّر شكل العمل نفسه: يستبدل بالعقل الواحد فريقاً منسَّقاً كاملاً.
How you invoke it · كيف تستدعيه
اكتب ببساطة الكلمة المفتاحية ultracode في أي موضع من طلبك في Claude Code — "ultracode: audit this repo's auth flow for vulnerabilities". هذه الكلمة وحدها تُدخل الجلسة في وضع تنسيق الوكلاء المتعدّدين. دون flags، ودون ملفات إعداد، ودون منتج منفصل.
What happens next · ماذا يحدث بعدها
يأخذ وكيلٌ منسّق هدفك ويؤلّف سير عمل: يوزّع وكلاء فرعيّين بالتوازي — researchers يرسمون الخريطة، وbuilders ينفّذون العمل، وreviewers ينتقدونه، وadversarial verifiers يحاولون كسره فعلاً. ولا يصلك إلا ما ينجو من التحقّق.
Four patterns worth knowing by name أربعة أنماط تستحقّ أن تعرف أسماءها
سير عمل Ultracode ليس أسراباً عشوائية؛ فالمنسّق يركّبه من قوالب معروفة ومجرَّبة.
Parallel fan-out · التوزيع المتوازي
نمط الـparallel fan-out: قسّم العمل المستقلّ على وكلاء كثيرين دفعةً واحدة — وكيل لكل module، ولكل ملف، ولكل فرضية. فعشرة وكلاء يستكشفون عشر زوايا من الكود في اللحظة نفسها، ويغطّون في دقائق ما يطحنه وكيل واحد بالتسلسل.
Adversarial verification · التحقق العدائي
في نمط الـadversarial verification يُطلَق لكل نتيجة أو تعديل وكيلٌ متحقّق منفصل مهمّته دحضها: يعيد إنتاج الخطأ، وينفي الادّعاء، ويكسر الإصلاح. والنتائج التي لا تصمد أمام الهجوم لا تصل إلى تقريرك أصلاً. وهذا أكبر فارق جودة عن الجلسة الفردية.
Judge panels · لجان التحكيم
حين يوجد أكثر من حلٍّ مرشَّح — ثلاث استراتيجيات refactoring، أو نظريتان متنافستان عن السبب الجذري — تقيّمها لجنة judge panels من وكلاء تحكيم مستقلّين مقابل هدفك، ثم يدمج المنسّق أو يختار. واختلاف الحكّام فيما بينهم إشارة بحدّ ذاتها تستحقّ الإبراز.
Loop-until-dry discovery · التكرار حتى ينضب
للتدقيقات والمراجعات نمط الـloop-until-dry: تتكرّر موجات الاستكشاف — بحث، ثم تحقّق، ثم بحث من جديد — حتى تمرّ جولة كاملة دون أن تُخرج شيئاً جديداً. وبذلك تكفّ كلمة «شامل» عن كونها إحساساً، وتصبح شرط توقّف يمكنك الوثوق به فعلاً.
When it's worth it — and when it's waste متى يستحقّ — ومتى يكون هدراً
Reach for Ultracode · الجأ إليه
- تدقيقات أمنية أو تدقيقات صحّة، حيث يكلّف تفويت مشكلة واحدة كثيراً
- أخطاء عنيدة نجت أصلاً من جلسة أو جلستين عاديّتين من debugging
- مراجعات كود شاملة لـbranch كبير أو codebase لا تعرفه
- بناء كبير: مواقع متعدّدة الصفحات، وميزات متعدّدة الـmodules، وmigrations واسعة
- كل ما تصوغه طبيعياً بعبارة «كن استقصائياً» أو «جِد لي كل شيء»
Skip it for · استغنِ عنه في
- التعديلات البسيطة: إعادة تسمية، أو تعديل config، أو إصلاح في ملف واحد
- الأسئلة السريعة التي يجيبها وكيل واحد في ثوانٍ
- المهامّ ذات المسار التسلسلي الواحد الواضح، التي لا شيء فيها يقبل التوزيع
- طلبات «ماذا لو» الاستكشافية التي ستتخلّص منها غالباً
- كل موضع يأتي فيه
xhighأوmaxبالنتيجة الصحيحة أصلاً
How to set effort كيف تضبط الجهد
حقل واحد في الـAPI، وإعداد واحد في Claude Code، وكلمة واحدة لـUltracode.
In the API · عبر الـAPI
مرّر output_config.effort في أي طلب. وإن تركته فارغاً فالقيمة الافتراضية هي high.
// POST /v1/messages { "model": "claude-opus-5", "max_tokens": 16000, "output_config": { "effort": "high" // low | medium | high | xhigh | max }, "messages": [ { "role": "user", "content": "Review this diff for concurrency bugs…" } ] }
In Claude Code · في Claude Code
القيمة الافتراضية هي xhigh، وهي مضبوطة للبرمجة والعمل الوكيلي. غيّرها من الإعدادات عبر /config، وانتقل إلى الوكلاء المتعدّدين بكلمة واحدة.
> /config # → open settings; adjust the effort level # (default: xhigh — best for coding/agentic work) > ultracode: audit the payment module end to end, verify every finding, and report only what survives # the "ultracode" keyword opts this prompt into # multi-agent orchestration — no flags needed
max في بحث سريع، أو تصارع خطأً عويصاً على low. فقبل كل مهمّة جادّة، اسأل نفسك ثانيتين: كم تكلّفني الإجابة الخاطئة هنا؟ ثم اضبط المفتاح على قدر الإجابة.Choosing in practice الاختيار على أرض الواقع
أربعة مواقف حقيقية، وأربع درجات مختلفة. ولاحظ النمط: المفتاح يتبع كلفة الخطأ.
Quick rename · إعادة تسمية سريعة
غيّر اسم getUserData إلى fetchUserProfile في المشروع كلّه. مهمّة ميكانيكية، تتحقّق منها بنظرة، ولا شيء فيها يستدعي التفكير. يُنجزها low في أسرع وقت، وبأقلّ tool calls وأقصر تقرير.
Feature in familiar code · ميزة في كود تعرفه
أضِف زرّ تصدير إلى CSV في codebase تعرفه جيداً. مهمّة متعدّدة الخطوات لكن الطريق فيها ممهَّد: بضعة قرارات تصميم، وعدّة ملفات، واختبارات تحتاج تحديثاً. يمنحك high استدلالاً وافياً دون تأمّل بمستوى max عند كل سطر.
Gnarly race condition · حالة تسابُق عنيدة
دفعة تُنفَّذ مرّتين كل بضعة آلاف طلب، ومحاولتا إصلاح فشلتا من قبل. الصحّة هنا تعلو على أي كلفة توكنز؛ فـmax يلاحق كل تداخل ممكن، ويرفض إعلان النجاح دون إثبات.
Full security audit · تدقيق أمني شامل
«جِد لي كل ثغرة في هذه الخدمة قبل الإطلاق.» لا يستطيع وكيل واحد أن يَعِد بصدق بكلمة كل. أمّا Ultracode فيوزّع researchers على كل سطح هجوم، ويتحقّق عدائياً من كل نتيجة، ويكرّر حتى تمرّ جولة كاملة دون أن تجد جديداً.
Feel the dial for yourself · جرّب المفتاح بنفسك
اختر مهمّة حقيقية من مشروعك: شيئاً جادّاً لكنه محدود، مثل «أضِف تحقّقاً من المدخلات لهذا الـform handler». ونفّذها مرّتين في Claude Code: مرّة والجهد على low عبر /config، ثم في جلسة جديدة على xhigh. وقارِن النتيجتين: كم ملفاً قرأت كل جولة، وكم حالة حدّية غطّت، وكيف بدت الاختبارات، وكم استغرقت من وقت. هذا الفارق هو درس الفصل كلّه مكتوباً بكودك أنت — وبعد هذه التجربة لن تعود تختار مستوى الجهد بحكم العادة، بل على قدر المهمّة.