دليل كتابة الموجّهات لـ Claude Opus 5.5: مستوى الجهد والوكلاء والرفض والقوالب

لتكتب موجّهات جيدة لـ Claude Opus 5.5، احتفظ بالموجّهات التي كنت تستخدمها مع Claude Opus 5، واضبط مستوى الجهد (effort) قبل أن تغيّر الصياغة، ثم أضف إلى موجّه النظام سطرًا محدد الهدف لكل سلوك تريد تغييره. يقول دليل Anthropic إن موجّهات Claude Opus 5 الحالية «يُفترض أن تعمل جيدًا دون تغييرات»، وإن الجهد هو «أول إعداد يجب ضبطه عند الموازنة بين الذكاء وزمن الاستجابة والتكلفة». معظم النصائح الجديدة تخص الوكلاء: إبقاء التشغيل الذي يجري دون إشراف مستمرًا، والحصول على تحديثات التقدّم خلال الأدوار الطويلة، وضبط إيقاع فريق من الوكلاء. كل ما يلي مأخوذ من دليل Anthropic بعنوان «Prompting Claude Opus 5.5» ومن مرجع API الخاص بالنموذج، وقد تحقّقنا منه في 3 أكتوبر 2026.

قواعد الطلب المشتركة مع Claude Fable 5.1، مثل عدم الملء المسبق لرد المساعد وعدم تحديد قيمة مخصّصة لـ temperature، مشروحة في دليل كتابة الموجّهات لـ Claude Fable 5.1. يتناول هذا المقال ما يخص Claude Opus 5.5 وحده.

هل تعمل موجّهات Claude Opus 5 على Claude Opus 5.5؟

نعم. تقول Anthropic إنها «يُفترض أن تعمل جيدًا دون تغييرات»، وإن أنماط كتابة الموجّهات لـ Claude Opus 5 «تبقى نقطة انطلاق معقولة». ما يتغيّر هو طريقة توزيع النموذج لجهده. يولّد Claude Opus 5.5 رموز الإخراج (tokens) أسرع من Claude Opus 5 بأكثر من 30 بالمئة، ويميل إلى إنجاز المهمة نفسها بعدد أقل من الرموز.

تذكر Anthropic أربعة مجالات تحسّن فيها النموذج، وهي التي تحدّد أي أجزاء هذا الدليل تهمك:

• البرمجة الوكيلية ومراجعة الشيفرة. العمل متعدد الخطوات في مستودع حقيقي، والتشغيل الذاتي الطويل مع وكلاء فرعيين، ومراجعات شيفرة تكتشف أخطاء أكثر مع إنذارات كاذبة أقل.
• العمل المعرفي. أصبح أقل احتمالًا بكثير لأن يذكر رقمًا خاطئًا أو يستشهد بمصدر خاطئ، ويلاحظ التناقضات الصغيرة في المدخلات الكبيرة، مثل تاريخ يقع في يوم الأسبوع الخطأ.
• التواصل. تحديثات التقدّم والتقارير النهائية تقول بوضوح ما الذي فعله، وما الذي وجده، وما الذي يحتاجه منك.
• المخططات والرسوم التوضيحية ولقطات الشاشة واستخدام الحاسوب. يقرأ المواد المرئية بدقة أعلى من Claude Opus 5، حتى عند أدنى مستوى جهد.

إذا كانت موجّهاتك للمحادثة في الغالب، فاقرأ قسمي الجهد والمحادثة. وإذا كنت تشغّل وكلاء، فالنصائح الجديدة في أقسام الوكلاء.

أي مستوى جهد أستخدم مع Claude Opus 5.5؟

ابدأ بـ medium، وهو القيمة الافتراضية في Claude Opus 5.5 (القيمة الافتراضية في Claude Opus 5 هي high). حدّده صراحةً وجرّب عدة مستويات على مهامك أنت بدلًا من نقل القيمة التي استخدمتها مع Claude Opus 5. أسماء مستويات الجهد لا تعني القدر نفسه من التفكير في كل النماذج: في اختبارات Anthropic، «يضاهي Claude Opus 5.5 عند medium أو يتفوّق على Claude Opus 5 عند high في تقييمات البرمجة والعمل المعرفي»، وفي عدة تقييمات برمجية يقترب low من ذلك بتكلفة أقل بكثير.

تحديد medium صراحةً يعطي السلوك نفسه تمامًا كحذف effort.

عند المستوى نفسه، يميل Claude Opus 5.5 إلى التفكير في كل دور أكثر من Claude Opus 5، خاصة عند xhigh وmax. تذكّر ثلاثة أمور:

• اترك مساحة في max_tokens. يُحتسب التفكير ضمن max_tokens حتى عندما لا تراه، لذلك قد يقطع حدٌّ مضبوط لـ Claude Opus 5 مع إيقاف التفكير الردودَ قبل اكتمالها. بالنسبة إلى الأدوار الطويلة في البرمجة الوكيلية، وجدت Anthropic أن قيمة max_tokens تبلغ 128,000، وهي الحد الأقصى للنموذج، تعمل جيدًا.
• اخفض الجهد قبل أن تكتب «فكّر أقل». خفض الجهد يقلّل التفكير والتكلفة وزمن الاستجابة بشكل أوثق من التعليمات في الموجّه.
• ثبّت الجهد إن كنت تعتمد على التخزين المؤقت للموجّهات. تغيير قيمة الجهد في المستوى الأعلى بين الطلبات يُبطل ذاكرة التخزين المؤقت للموجّهات.

يُضبط الجهد في output_config:

{
  "model": "claude-opus-5-5",
  "max_tokens": 128000,
  "output_config": {"effort": "medium"},
  "messages": [{"role": "user", "content": "Review this pull request for bugs and explain each one."}]
}

هل يمكن إيقاف التفكير في Claude Opus 5.5؟

لا. كان Claude Opus 5 يقبل "thinking": {"type": "disabled"} عند مستوى الجهد high أو أدنى؛ أما Claude Opus 5.5 فلا يقبله، ويعيد هذا الطلب خطأ 400. التفكير تكيّفي ومفعّل دائمًا. إذا كان تكاملك يعمل مع إيقاف التفكير، توصي Anthropic بأربعة تغييرات:

1. ابدأ بمستوى الجهد low وقِس النتائج. عند low يبقي النموذج تفكيره قصيرًا. إذا ظلّ زمن الوصول إلى أول رمز مهمًا، فإن سطرًا في موجّه النظام مثل «Answer directly without deliberating.» قد يقلّل التفكير أكثر، لكن تحقّق من الجودة بعد إضافته.
2. احذف التعليمات التي كانت بديلًا عن التفكير. إذا كان موجّهك يطلب من النموذج كتابة استدلاله في الرد، فاحذف هذا السطر واقرأ الاستدلال من ملخّص التفكير بدلًا من ذلك. أصبح الموجّه الذي يدفع النموذج إلى إعادة إنتاج استدلاله في الرد معرّضًا للرفض الآن (انظر قسم الرفض أدناه).
3. أعد اختبار الحلول الالتفافية القديمة. القواعد التي أضفتها لتجنّب مشكلات التشغيل دون تفكير قد لا تكون لازمة بعد الآن. احذف أي قاعدة تطلب من النموذج ألا يفكر.
4. اقرأ الاستجابة بحسب نوع الكتلة. قد تبدأ الاستجابة بكتلة thinking وقد لا تبدأ، لذا تحقّق من نوع كل كتلة بدلًا من افتراض أن الأولى نص.

لرؤية الاستدلال، اطلب ملخّص التفكير:

{
  "model": "claude-opus-5-5",
  "max_tokens": 16000,
  "thinking": {"type": "adaptive", "display": "summarized"},
  "output_config": {"effort": "low"},
  "messages": [{"role": "user", "content": "Which of these three invoices has a total that does not match its line items?"}]
}

كيف أمنع وكيل Claude Opus 5.5 الذي يعمل دون إشراف من التوقف مبكرًا؟

في المهام الطويلة، يُبقي Claude Opus 5.5 المستخدم على اطلاع أثناء العمل، وبعض هذه التحديثات تُنهي الدور بنص بدلًا من استدعاء أداة (stop_reason: "end_turn"). حلقة الوكيل التي تعدّ كل دور من هذا النوع «مهمة منتهية» تتوقف في منتصف الطريق. حل Anthropic له جزء في إطار التشغيل (harness) وجزء في الموجّه.

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

Your task list still has open items: migrate the remaining two endpoints and update their tests. Continue with them. If one is blocked, say what is blocking it.

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

في موجّه النظام، سمِّ أنواع التوقف المبكر التي لا تريدها. مثال Anthropic مكتوب للوكلاء الذين يعملون دون أي إشراف، ويوضع في نهاية موجّه النظام منذ الطلب الأول في الجلسة. إضافته في المنتصف تغيّر موجّه النظام وتُبطل كتل التفكير السابقة في المحادثة.

A standing instruction from the user, the person you are working for. It is about how your turns end. A message with no tool call in it ends your turn, and the work stops there until you are asked to continue. The user has seen you end turns in four ways while work they asked for was still owed, and does not want any of them. One: a long summary of what was done that closes by announcing the next step and has no tool call, so the next thing never starts. Two: an offer to carry on with something unless the user would prefer otherwise, which stops to wait for an answer the user was not going to give. Three: a list of decisions for the user when, by your own account, none of them blocks the rest of the work. Four: deciding that this is a good place to report, because the turn has been long or a milestone is done. Status notes are welcome, and so are your recommendations on open decisions, but put them in the same message as your next tool call and carry on with whatever does not depend on the user's answer. If you notice yourself inviting the user to redirect you or offering to wait, delete it and do the next thing. The stops the user does want are the ones where nothing can move without them, or where the thing blocking you is deliberately protected from you. This does not override the need for confirmation on risky or destructive actions.

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

كيف أحصل على تحديثات التقدّم من وكيل Claude Opus 5.5 في التشغيل الطويل؟

بين استدعاءات الأدوات، يكتب Claude Opus 5.5 ملاحظات تقدّم قصيرة: ما الذي وجده للتو وما الذي سيفعله بعد ذلك. في هذا النموذج تعود هذه الملاحظات ككتل thinking لا ككتل text، ويكون نصها فارغًا افتراضيًا، لذلك قد يبدو العميل الذي يعرض كتل text فقط صامتًا طوال دور طويل. توثّق Anthropic وضع عرض تجريبيًا (beta) يعيد ملخّصًا لكل ملاحظة؛ وتجد قيم thinking.display الموثّقة لنقطة النهاية في مرجع API لـ Claude Opus 5.5.

هناك ثلاث أدوات على مستوى الموجّه وإطار التشغيل تعمل دون أي إعداد خاص:

• أعطِ النموذج أداة لتسليم المحتوى حرفيًا. إذا احتاج إلى تسليم المستخدم شيئًا دقيقًا في منتصف الدور، مثل مقتطف شيفرة، فأعطه أداة بسيطة «أرسل رسالة إلى المستخدم» وأخبره أن يخصّصها لذلك. صرّح بالأداة منذ الطلب الأول؛ إضافتها لاحقًا تُبطل كتل التفكير السابقة.
• اطلب تحديثات في نقاط ثابتة. مثل جملة توضّح النية قبل أول استدعاء أداة وملخّص قصير في النهاية. يتبع النموذج هذا النوع من التعليمات بدقة، وهو مفيد أكثر عندما يتابع أحد العمل.
• نبّه الدور الصامت من إطار التشغيل. عُدّ خطوات استدعاء الأدوات المتتالية التي لا تقدّم للمستخدم شيئًا يقرؤه. بعد عدة خطوات، خمس مثلًا، ألحق تذكيرًا بعد أحدث نتائج الأدوات، وتوقّف بعد تذكيرين أو ثلاثة. صياغة Anthropic:

The user hasn't heard from you in a while — say in a few words what you're doing, then continue.

في اختبارات Anthropic على مهام البرمجة الوكيلية، خفّض هذا التذكير نسبة المهام التي فيها فترة صمت طويلة إلى النصف تقريبًا، دون تغيير ملموس في التكلفة.

كيف أجعل وكيل Claude Opus 5.5 يتحقق من السياق قبل أن يتصرّف؟

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

Before taking any action, explore broadly with tool calls: list and open the emails, documents, spreadsheet tabs and records across the available apps that could be relevant to this task, including ones the task does not explicitly mention, and use what you find.

في اختبارات Anthropic على مهام تشمل عدة تطبيقات، أنجز النموذج عددًا أكبر بوضوح منها بشكل صحيح مع هذا السطر، عند مستوى الجهد medium وmax على حد سواء، مقابل استدعاءات أدوات أكثر بقليل. ولأن السطر يطلب من النموذج التصرّف بناءً على ما يجده، أبعِد المحتوى غير الموثوق عن السجلات التي يبحث فيها.

كيف أجعل فريقًا من وكلاء Claude Opus 5.5 ينهي العمل أسرع؟

يهتم Claude Opus 5.5 كثيرًا بالوقت المنقضي. في بنية يوزّع فيها وكيل رئيسي العمل على وكلاء فرعيين، أعطه ميزانية زمنية: اجعل إطار التشغيل يضيف سطرًا قصيرًا في نهاية كل رسالة يعيدها إلى النموذج، مثل elapsed 340s / 1200s. يضبط النموذج إيقاعه لينتهي ضمن الميزانية، وعادةً ينتهي قبلها بكثير، لذا اجعل الميزانية أعلى قليلًا من الوقت الذي تريد إنفاقه فعلًا. إذا لم تستطع تقدير ميزانية، فاعرض الوقت المنقضي وحده وأضف هذه الجملة إلى موجّه النظام:

Time matters here: do not spend time that can be avoided, and the earlier a correct result is obtained, the better.

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

هل يجب أن يطلب موجّه نظام المحادثة من Claude Opus 5.5 أن يفكّر بعناية؟

لا. تقترح Anthropic حذف أسطر مثل «think carefully before answering» (فكّر بعناية قبل الإجابة) من موجّهات نظام المحادثة: النموذج يقرّر بنفسه مقدار التفكير، وأداة التحكم في ذلك هي الجهد. في اختبارات Anthropic على منتج محادثة، جعل حذف سطر كهذا الردود تبدأ أسرع دون تراجع واضح في الجودة.

هناك سطران آخران للمحادثة يستحقان المعرفة. أحدهما يجعل النموذج يعدّ الإجابات السابقة محسومة، فتبدأ الأدوار اللاحقة أسرع. والآخر يميّز النص الذي ألصقه المستخدم، حتى لا ينفّذ النموذج تعليمات مخبّأة في رسالة بريد أو صفحة ويب. السطران موجودان بنصّهما الحرفي في قسم Claude Opus 5.5 من دليل Fable 5.1. لا تستخدم سطر «الإجابات المحسومة» في التحليلات الطويلة أو المهام الوكيلية، حيث قد تكشف خطوة لاحقة خطأً في خطوة سابقة.

كيف أحصل على إجابات أفضل عن المخططات والرسوم التوضيحية ولقطات الشاشة؟

أعد الاختبار أولًا. من دون أدوات إضافية، يقرأ Claude Opus 5.5 المخططات الكثيفة والمخططات الانسيابية ولقطات شاشة التقويم بدقة أعلى بكثير من Claude Opus 5؛ في اختبارات Anthropic، قرأ القيم من المخططات الكثيفة حتى عند أدنى مستوى جهد بدقة تفوق Claude Opus 5 عند أعلى مستوى. الأدوات المساعدة التي بنيتها للنماذج الأقدم قد لا تكون لازمة بعد الآن.

مع المدخلات الأكثف، ما زال أمران يساعدان:

• صور بدقة أعلى، خاصة للرسومات الهندسية.
• أدوات معالجة الصور. شغّل النموذج كوكيل مع حاوية تضم الصور الأصلية وفيها PIL أو OpenCV، ليتمكن من القصّ والتكبير والقياس. إن كان ذلك ثقيلًا، فأداة قصّ وحدها تساعد أيضًا. يستخدم النموذج هذه الأدوات بشكل أفضل عند مستويات جهد أعلى.

من دون أدوات، يحسّن رفع مستوى الجهد قراءة الرسومات الهندسية لكنه لا يفيد كثيرًا مع المخططات. توضع الصور في دور المستخدم ككتل image بمصدر URL؛ ويعرض مرجع API الصيغة.

كيف أمنع مخرجات الواجهة الأمامية من Claude Opus 5.5 من أن تبدو نمطية؟

سمِّ الأنماط التي لا تريدها. من دون توجيه تصميمي، يعود Claude Opus 5.5 إلى عدد قليل من الأنماط الافتراضية، وغالبًا ما تستبدل تعليمة عامة مثل «تجنّب المظهر العام المصنوع بالذكاء الاصطناعي» نمطًا افتراضيًا بآخر. يسرد مثال Anthropic أشياء محددة يجب تجنّبها:

Output a vanilla HTML/CSS personal website with placeholder data. Do not use a cream or off-white background, italic accent words in headlines, numbered "01/02/03" section labels, monospace labels, or pill-shaped buttons.

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

لماذا يعيد Claude Opus 5.5 القيمة stop_reason "refusal"؟

لأن مصنِّف أمان رفض الطلب. يشغّل Claude Opus 5.5 مصنِّفات للأحياء والأمن السيبراني واستخراج الاستدلال، ويصل الرفض كاستجابة عادية تحتوي stop_reason: "refusal" وكائن stop_details يذكر الفئة.

عن رفض الطلبات غير الضارة عمومًا، انظر لماذا يرفض Claude طلبًا غير ضار في دليل Fable 5.1.

الأسئلة الشائعة

هل يوجد دليل رسمي لكتابة موجّهات Claude Opus 5.5؟

نعم. تنشر Anthropic دليل «Prompting Claude Opus 5.5» في توثيق المطوّرين، إلى جانب صفحة عامة لأفضل الممارسات تنطبق على كل نماذج Claude الحالية. يلخّص هذا المقال دليل Opus 5.5 كما هو في 3 أكتوبر 2026، ويقتبس القوالب بنصّها الحرفي.

ما مستوى الجهد الافتراضي في Claude Opus 5.5؟

medium. القيمة الافتراضية في Claude Opus 5 هي high. المستويات هي low وmedium وhigh وxhigh وmax، وتُضبط في output_config.effort.

كم رمز إخراج يمكن أن يكتب Claude Opus 5.5؟

حتى 128,000 رمز لكل طلب، ويشمل هذا الحد التفكير. نافذة السياق 1M رمز.

هل يمكنني الملء المسبق لرد Claude Opus 5.5 أو ضبط temperature؟

لا. الملء المسبق لرد المساعد وأي قيمة لـ temperature غير القيمة الافتراضية يعيدان خطأ 400، كما أن فرض أداة محددة غير مدعوم. صِف بدلًا من ذلك التنسيق الذي تريده في الموجّه. يشرح دليل كتابة الموجّهات لـ Claude Fable 5.1 ما الذي تستخدمه بدلًا من كل منهما.

أيهما أفضل للوكلاء: Claude Opus 5.5 أم Claude Fable 5.1؟

يعتمد ذلك على المهمة والميزانية؛ تشرح مقارنة نماذج Claude أيهما تختار. تختلف نصائح كتابة الموجّهات أساسًا في القيم الافتراضية: يبدأ Claude Opus 5.5 بمستوى الجهد medium، ويبدأ Claude Fable 5.1 بـ high.

جرّب الموجّهات

شغّل هذه القوالب على Claude Opus 5.5 بمفتاح SeedRouter، عبر Anthropic SDK أو صيغتي Chat Completions و Responses من OpenAI. يسرد مرجع API لـ Claude Opus 5.5 كل المعاملات، وتعرض صفحة النموذج الأسعار الحالية لكل رمز. يعمل SeedRouter بالدفع حسب الاستخدام: تشحن رصيدك مرة واحدة، ولا تنتهي صلاحية الرصيد أبدًا، ولا تُحتسب الطلبات الفاشلة.