DEV Community

Cover image for توجيه كلود أوبوس 5: توقف عن مطالبته بإعادة التحقق
Yusuf Khalidd
Yusuf Khalidd

Posted on • Originally published at apidog.com

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

تخبرك معظم أدلة الترحيل بما يتعطل في التعليمات البرمجية الخاصة بك. هذا الدليل يدور حول ما يتعطل في الأوامر (Prompts) الخاصة بك.

جرّب Apidog اليوم

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

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

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

إذا كنت لا تزال تعمل على التغييرات على مستوى التعليمات البرمجية، فإن دليل ترحيل Opus 4.8 إلى Opus 5 يغطي هذه التغييرات بشكل منفصل. وإذا كنت ترغب في مشاهدة هذه السلوكيات تتغير في حمولات الطلبات والاستجابات الحقيقية، فإن Apidog طريقة مباشرة لإرسال الأمر نفسه بإعدادات مختلفة ومقارنة النتائج.

الملخص في سطر واحد

يتحقق Opus 5 أكثر، ويكتب أكثر، ويفوض أكثر، ويوضح نفسه أكثر مما فعله Opus 4.8. تم ضبط أمر Opus 4.8 الخاص بك لدفع النموذج نحو هذه السلوكيات؛ والآن يدفعها إلى ما بعدها.

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

1. احذف تعليمات التحقق الخاصة بك

هذه هي النقطة الأهم، وهي سبب العنوان.

تذكر Anthropic أن Opus 5 يتحقق من عمله الخاص دون طلب. يعيد قراءة ما كتبه، ويتحقق من حساباته، ويعيد تشغيل اختبار، ويبحث عن الحالات الهامشية التي لم تذكرها. كان هذا هو السلوك الدقيق الذي أدخله الجميع يدويًا في Opus 4.8 باستخدام أسطر مثل: “تحقق جيدًا من عملك قبل الرد” أو “تحقق من كل خطوة”.

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

ابحث في أوامر النظام الخاصة بك عن هذه الأنماط وأزلها:

Double-check your work before responding.
Verify each step before moving to the next one.
Review your answer for errors, then revise it.
Check your reasoning carefully.
Make sure the output is correct before returning it.
Enter fullscreen mode Exit fullscreen mode

إذا كانت لديك خطوة عالية المخاطر فعلًا وتريد عملية تحقق صريحة، فقيدها بهذه الخطوة بدلًا من جعلها قاعدة عامة:

Do not add general verification passes; you already verify by default.
The only exception: after writing the migration SQL, run it against the
schema dump once and report any mismatch. Do not re-verify anything else.
Enter fullscreen mode Exit fullscreen mode

هذا الشكل مهم: تعليمات “تحقق من كل شيء” العامة في Opus 5 هي مضاعف للتكلفة. أما الاستثناء الواحد محدد النطاق فهو تحكم.

إذا كنت تتبع إنفاق API عبر هذا الترحيل، فإن أدوات التخزين المؤقت والدفعات في توزيع أسعار Opus 5 تتراكم مع هذه الأداة، ويغطي دليل خفض فاتورة Claude API الأدوات العامة.

2. اطلب الإيجاز صراحة، لأن الجهد لن يفي بالغرض

تكون الاستجابات الافتراضية لـ Opus 5 أطول من استجابات Opus 4.8. وينطبق ذلك أيضًا على المخرجات المكتوبة: التقارير، والملخصات، ووثائق التصميم، وملفات README.

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

إذا افترضت أن الجهد مؤشر للإسهاب، فلن تتحرك فاتورتك كما توقعت. يشرح دليل معلمة الجهد في Opus 5 ما الذي يغيره كل مستوى فعليًا.

الطول مشكلة توجيه، لذا حلها في الأمر. كن محددًا بشأن الحد الأقصى بدلًا من قول “كن موجزًا”:

Response format: at most 150 words unless I ask for more.
No preamble, no restatement of my question, no summary at the end.
Lead with the answer, then the reasoning if it is needed.
Enter fullscreen mode Exit fullscreen mode

للمخرجات المكتوبة، ضع حدًا للناتج وسمِّ ما يجب حذفه:

Write the migration doc at 800 words maximum.
Include: the breaking changes, the fix for each, and a rollback step.
Exclude: background on the old system, a glossary, and a conclusion section.
If a section would exceed its share, cut examples before cutting steps.
Enter fullscreen mode Exit fullscreen mode

للعمل الذي يتضمن الكثير من التعليمات البرمجية، اجعل القيد متعلقًا بالتعليقات، لا بالكود:

Return the diff and nothing else.
No explanation of what you changed unless the change is non-obvious,
in which case one sentence above the hunk.
Enter fullscreen mode Exit fullscreen mode

3. حدد تفويض الوكلاء الفرعيين

يفوض Opus 5 إلى الوكلاء الفرعيين بسهولة أكبر مما فعله Opus 4.8. عند وجود مهمة متعددة الأجزاء ونظام يدعم الاستنساخ، سيتوسع النموذج.

غالبًا ما يكون هذا الخيار صحيحًا، لكنه أيضًا قرار تكلفة يتخذه النموذج نيابة عنك. يحمل كل وكيل فرعي سياقه الخاص وفاتورة الرموز الخاصة به. لأحمال العمل الحساسة للتكلفة أو زمن الاستجابة، ضع حدًا صريحًا:

Do not spawn subagents for this task. Handle it in this conversation.
Enter fullscreen mode Exit fullscreen mode

أو اسمح بالتوسع ضمن حدود واضحة:

You may delegate to at most 2 subagents, and only for independent
file-level work that can run in parallel.
Do research, planning, and final synthesis yourself in this thread.
Enter fullscreen mode Exit fullscreen mode

تجنب التفويض لمجرد التفويض: لا تستدعِ وكيلًا فرعيًا لقراءة ملف واحد أو لاتخاذ قرار تملك السلسلة الرئيسية سياقه بالفعل.

إذا كنت تبني باستخدام وكلاء فرعيين عن قصد، فإن دليل إنشاء وكلاء فرعيين لـ Claude Code يغطي التحكم في تحديد نطاقهم.

4. قيد النطاق صراحة في المهام الضيقة

يوسع Opus 5 نطاق المهمة. اطلب منه إصلاح اختبار فاشل، وقد يعيد هيكلة المساعد الذي يستدعيه الاختبار، ويحدث توقيع النوع، ويضيف حالات اختبار إضافية. اطلب منه إعادة تسمية متغير، وقد يرتب الدالة المحيطة.

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

حدد الحدود بوضوح، وسمِّ ما هو خارج النطاق:

Scope: change only the retry-count constant in src/client/http.ts.
Do not refactor surrounding code, do not rename anything, do not add
tests, do not update docs. If you believe another change is required,
stop and tell me instead of making it.
Enter fullscreen mode Exit fullscreen mode

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

5. توقع المزيد من سرد التصحيح، وأوقفه إذا لم تكن بحاجة إليه

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

للعمل التفاعلي، قد يكون هذا مفيدًا. أما في خط أنابيب يغذي الاستجابة إلى محلل (parser) أو واجهة مستخدم أو نموذج آخر، فهذا السرد ضجيج يقع في حقل من المفترض أن يحمل إجابة.

استخدم تعليمات قصيرة:

Do not narrate corrections or changes of approach.
Return only the final answer. If you revised your thinking, that
revision belongs in your reasoning, not in the response.
Enter fullscreen mode Exit fullscreen mode

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

أنماط الفشل عند تعطيل التفكير

كل ما سبق مشكلة ضبط. هذا الجزء مشكلة صحة.

توثق Anthropic عيبين يظهران أحيانًا في Opus 5 عندما يتم تعطيل التفكير عبر thinking: {type: "disabled"}. كلاهما يستحق المعرفة قبل نشر وكيل.

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

علامات XML داخلية في الإخراج المرئي. قد تظهر علامات مثل <thinking> في الاستجابة التي يراها المستخدم. هذا سيئ شكليًا، وأسوأ إذا كنت تعرض الاستجابات كـ HTML أو تحللها للحصول على بنية.

الجزء غير البديهي: تسمية العلامات في أمرك تجعل التسرب أسوأ، لا أفضل. تعليمات مثل “لا تخرج علامات <thinking> أبدًا” تضع تسلسل الرموز في السياق وتزيد احتمال ظهوره. لا تكتب هذه التعليمات.

التخفيف الموصى به من Anthropic ليس أمرًا إضافيًا، بل إبقاء التفكير ممكّنًا والتحكم في التكلفة بمستوى جهد أقل:

{
  "model": "claude-opus-5",
  "max_tokens": 4096,
  "output_config": { "effort": "low" },
  "messages": [
    { "role": "user", "content": "..." }
  ]
}
Enter fullscreen mode Exit fullscreen mode

هذا يمنحك الطرف الأقل تكلفة من النطاق دون عيوب التفكير المعطل. كما يتجنب فخًا ذا صلة: في Opus 5، يؤدي الجمع بين thinking: {type: "disabled"} والجهد xhigh أو max إلى خطأ 400، لأن تعطيل التفكير محدد بجهد high.

لاحظ أيضًا أن التفكير أصبح ممكّنًا افتراضيًا الآن. الطلب الذي يحذف حقل thinking يعمل بالتفكير التكيفي بدلًا من العمل بدونه، كما كان سيحدث في Opus 4.8.

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

اختبر التغييرات بدلًا من التخمين

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

لقطة شاشة لاختبار طلبات API

يمكن إعداد ذلك بسهولة في Apidog، وهي منصة متكاملة لتطوير واختبار واجهات برمجة التطبيقات:

  1. ابنِ طلبًا واحدًا إلى نقطة نهاية Anthropic Messages باستخدام "model": "claude-opus-5"، وخزن مفتاح API كمتغير بيئة بدلًا من لصقه في نص الطلب.
  2. احفظ أمر نظام Opus 4.8 القديم وإصدار Opus 5 المقلص كطلبين محفوظين مقابل المدخلات نفسها.
  3. قارن كتلة usage في كل استجابة. تخبرك رموز الإخراج ما إذا كان قيد الإيجاز قد تحقق، وتخبرك رموز الإدخال وحقول التخزين المؤقت ما إذا كانت تعديلات الأمر قد كسرت بادئة التخزين المؤقت.
  4. كرر الطلب عبر مستويات الجهد لترى أن رموز التفكير تنخفض بينما يبقى الطول المرئي ثابتًا تقريبًا.
  5. افحص الاستجابة المتدفقة لتتأكد من وصول استدعاءات الأدوات ككتل tool_use منظمة، لا كنص.

الخطوة الخامسة هي التي تلتقط فشل استدعاء الأداة كنص عادي قبل وصوله إلى الإنتاج. نزّل Apidog إذا كنت ترغب في تشغيل هذه الجوانب جنبًا إلى جنب، واطلع على دليل API الخاص بـ Opus 5 لمعرفة شكل الطلب الكامل.

السقف الحقيقي

تجدر الإشارة بوضوح إلى أن Opus 5 ليس قمة مكدس Claude. يحتفظ Fable 5 بتصنيف “الأكثر قدرة والأكثر انتشارًا”، ولا يزال Opus 5 يتخلف عن Mythos 5 في استغلال الأمن السيبراني وأبحاث البيولوجيا الذاتية. تقول Anthropic الأمرين في منشور إطلاقها.

الإطار الدقيق هو: قدرة من فئة الحدود القصوى بنصف سعر الحدود القصوى، مع سقف مسمى فوقها.

ادعاءات معايير الإطلاق، مثل Frontier-Bench وARC-AGI 3 وOSWorld 2.0 وCursorBench، هي جميعها أرقام Anthropic الخاصة ولم يتم التحقق منها بشكل مستقل حتى 25 يوليو 2026. تعامل معها كأرقام مقدمة من البائع، ونفذ تقييماتك الخاصة على الأوامر التي تستخدمها فعلًا.

تجميعها معًا

قد يبدو أمر نظام Opus 5 المقلص لمهمة وكيل حساسة للتكلفة هكذا:

Do not add verification passes; you verify by default.
Responses: 150 words maximum, no preamble, no closing summary.
Do not spawn subagents. Handle this in one thread.
Stay strictly within the task I state. If another change seems
required, stop and tell me rather than making it.
Do not narrate corrections or changes of approach.
Enter fullscreen mode Exit fullscreen mode

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

ابدأ من هناك، ثم نفذ مسحًا للجهد على تقييماتك الخاصة بدلًا من نقل إعدادات 4.8، لأن المستويات أعيدت معايرتها. لميكانيكا المعلمات، راجع دليل معلمة الجهد. ولسير عمل جانب المحرر، راجع استخدام Opus 5 في Claude Code. ولصورة النموذج الكاملة، ابدأ من ما هو Claude Opus 5. يحتوي عرض نماذج Anthropic على جدول المواصفات الحالي.

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

هل يجب علي حقًا حذف “راجع عملك مرتين” من أوامري؟

نعم. يقول دليل أوامر Anthropic إن Opus 5 يتحقق دون طلب، وتؤدي تعليمات التحقق المنقولة إلى تحقق مفرط. احذف القاعدة العامة. إذا كانت هناك خطوة محددة تتطلب فحصًا صريحًا، فحدد التعليمات لتلك الخطوة فقط.

لماذا Opus 5 مطوّل جدًا حتى عند الجهد المنخفض؟

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

كيف أمنع Opus 5 من إنشاء وكلاء فرعيين؟

قل ذلك مباشرة:

Do not spawn subagents. Handle this in this conversation.
Enter fullscreen mode Exit fullscreen mode

إذا كان بعض التوسع مفيدًا، فامنح حدًا رقميًا وقصره على العمل المستقل المتوازي.

لماذا أرى علامات <thinking> في مخرجاتي؟

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

ماذا يحدث إذا عاد استدعاء أداة كنص عادي؟

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

Top comments (0)