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. قارن النتيجتين: كم ملف قرأت كل جولة، كم حالة حدّية غطّت، شو شكل الاختبارات، وقديش أخدت وقت. هالفرق هو درس الفصل كله، مكتوب بكودك إنت — وعمرك ما رح تختار مستوى جهد بالعادة بعد هلق.