التفكير التكيفي في Claude مقابل budget_tokens

التفكير التكيفي مقابل budget_tokens على Claude 4.6 / 4.7 / 4.8: اضبط التفكير على adaptive، واضبط الجهد، ولماذا يعيد Opus 4.8 خطأ 400 بسبب budget_tokens.

تحتاج مفتاح API؟ أنشئ حسابًا ←·نقاط النهاية وعناوين Base URL ←

آخر تحقق: 2026-11-13 · 📄 وفق الوثائق الرسمية وqcode.cc/models (تحققت هذه المراجعة صفًا صفًا مما إذا كان كل نموذج في مصفوفة الدعم أدناه معروضًا للبيع على QCode؛ وآخر تحقق للجزء المتبقي من جدول المعاملات في 2026-10-15)

التفكير التكيفي هو وضع الاستدلال الذي صدر مع Claude 4.6: يقرر النموذج بنفسه متى يستثمر في الاستدلال وكم token ينفق، دون ميزانية ثابتة يحددها المطوّر مسبقًا. يوفّر المعامل effort تحكمًا خشنًا في عمق الاستدلال. يغطي هذا الدليل استخدام API المرتبط، ومصفوفة دعم النماذج، والمقايضات بين الجودة والتكلفة.

من أين تأتي المعاملات: تتبع الصفوف أدناه الوثائق الرسمية من Anthropic حتى 2026-10-15. سبق اختبار نماذج 4.x التي لا تزال معروضة للبيع كقابلة للاستدعاء على QCode؛ أما نماذج الجيل 4.5 وما قبله فلم تعد مُدرجة في قائمة ما يعرضه QCode للبيع، ولم يُتحقق من نماذج السلسلة 5 بندًا بندًا على QCode بعد. لاختيار نماذج السلسلة 5 راجع اختيار النموذج.

الفروق الرئيسية مقابل التفكير الممتد القديم¶

قاعدة مختصرة: استخدم adaptive لنماذج 4.6 وما بعدها؛ واستخدم budget_tokens فقط مع 4.5 وما قبله (تلك النماذج الأقدم تعيد 400 لـ type: "adaptive").

مصفوفة دعم النماذج¶

سبق اختبار نماذج 4.x أعلاه التي لا تزال معروضة للبيع كقابلة للاستدعاء على QCode. أما صفّا 4.5 فلم يعد QCode يقدمهما ويُحتفظ بهما للرجوع إلى المعاملات فقط؛ والنماذج المعروضة للبيع مُدرجة على qcode.cc/models. وفيما يخص عائلة 5 فيتبع سلوك المعاملات الوثائق الرسمية، وتوجد أسعار كل نموذج وتوفره على qcode.cc/models.

معامل effort: ضابط تقريبي لعمق الاستدلال¶

يتحكم effort في الشدة الإجمالية للتفكير التكيفي (ويشمل tokens الخاصة بالتفكير، وعدد استدعاءات الأدوات، وشمولية الإجابة). يُكتب في الطلب بالصيغة output_config.effort.

قاعدة عامة: يُضبط Opus 5.5 وHaiku 5.5 افتراضيًا على medium، ويأتي Sonnet 5.5 افتراضيًا على high في API؛ وتنصح Anthropic بإعادة تشغيل تقييماتك الخاصة بعد تبديل النماذج بدلًا من نقل الإعدادات. يقدم xhigh أفضل نسبة سعر إلى أداء لحلقات الوكيل الطويلة (مثل مراجعة الشيفرة متعددة الخطوات، والبحث المعمق)؛ ولا يستحق max إلا عندما تكون الصحة أهم بكثير من التكلفة. عند رفع المستوى، ارفع max_tokens أيضًا، لأن tokens الخاصة بالتفكير تُحتسب ضمن حد الإخراج.

تغيير effort يبطل التخزين المؤقت للـ prompt: للحفاظ على إصابة التخزين المؤقت، أبقِ إعداد التفكير وeffort ثابتين داخل المحادثة. لتغييره أثناء المحادثة، استخدم تغيير effort الرسمي لكل رسالة (بيتا، يتطلب ترويسة beta mid-conversation-output-config-2026-07-01؛ مدعوم على Opus 5.5 وSonnet 5.5 وHaiku 5.5 وغيرها).

أمثلة استخدام API¶

Python (anthropic SDK)¶

import anthropic

client = anthropic.Anthropic(
    base_url="https://api.qcode.cc/api",
    api_key="cr_xxxxxxxx",
)

response = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=16000,
    thinking={"type": "adaptive"},
    output_config={"effort": "high"},
    messages=[{"role": "user", "content": "Refactor the authentication logic of the user service module..."}],
)

for block in response.content:
    if block.type == "thinking":
        print(f"[Thinking] {block.thinking}")
    elif block.type == "text":
        print(f"[Answer] {block.text}")

TypeScript (@anthropic-ai/sdk)¶

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({
  baseURL: "https://api.qcode.cc/api",
  apiKey: "cr_xxxxxxxx",
});

const response = await client.messages.create({
  model: "claude-opus-5-5",
  max_tokens: 16000,
  thinking: { type: "adaptive" },
  output_config: { effort: "high" },
  messages: [{ role: "user", content: "Refactor user service..." }],
});

Claude Code CLI¶

في Claude Code، اضبط effort باستخدام /effort: من دون وسيط يفتح شريط تمرير، ويضبط /effort high المستوى مباشرة، ويمسح /effort auto المستوى المحفوظ. يمكنك أيضًا تمرير --effort عند التشغيل أو تعيين متغير البيئة CLAUDE_CODE_EFFORT_LEVEL. يظهر المستوى الحالي في ترويسة الجلسة بجوار اسم النموذج. المستويات القابلة للاختيار: low وmedium وhigh وxhigh وmax على Opus 5.5 / Sonnet 5.5 / Haiku 5.5 / Opus 5 / Sonnet 5 / Opus 4.8 / Opus 4.7؛ وlow وmedium وhigh وmax على Opus 4.6 وSonnet 4.6.

الإعدادات الافتراضية في Claude Code (الوثائق الرسمية، حتى 2026-10-15): medium على Opus 5.5 وSonnet 5.5 وHaiku 5.5، وxhigh على Opus 4.7، وhigh على النماذج الأخرى التي تدعم effort. في Claude Code، لا يمكن إيقاف التفكير على نماذج 5.5 الثلاثة هذه؛ وللحصول على تفكير أقل، اخفض effort.

عرض محتوى التفكير¶

لا تعرض نماذج سلسلة 5 (بما فيها Opus 5.5 وSonnet 5.5 وHaiku 5.5) نص التفكير افتراضيًا (حيث يكون display افتراضيًا "omitted")؛ فالاستدلال داخلي فقط، ولا تزال tokens التفكير تُحتسب كالمعتاد. لإظهار أثر التفكير في واجهة المستخدم:

thinking={"type": "adaptive", "display": "summarized"}

يطلب display: "summarized" من النموذج إصدار ملخص للتفكير (كتل تفكير مرئية)؛ أما omitted فيحسب tokens التفكير فقط دون إنتاج نص مرئي.

ميزانيات المهام (تجريبية)¶

إذا كنت تشغّل حلقة وكيل وتريد حدًا أعلى شاملًا للدور بأكمله (يشمل التفكير + الأدوات + الإخراج النهائي)، فاستخدم task_budget. تسرد الوثائق الرسمية Opus 5.5 وSonnet 5.5 وHaiku 5.5 وOpus 5 وOpus 4.8 وOpus 4.7 وغيرها بوصفها مدعومة تجريبيًا؛ أما Sonnet 5 فغير مدعوم:

response = client.beta.messages.create(
    betas=["task-budgets-2026-03-13"],
    model="claude-opus-5-5",
    max_tokens=64000,
    thinking={"type": "adaptive"},
    output_config={
        "effort": "high",
        "task_budget": {"type": "tokens", "total": 128000},
    },
    messages=[...],
)

يرى النموذج عدًا تنازليًا للميزانية المتبقية وينظّم نفسه لتجنّب التجاوز. الحد الأدنى لـ total هو 20,000؛ والقيم الأصغر تُرجع 400.

نصائح مراقبة التكلفة¶

بمجرد تفعيل التفكير التكيفي، تتجه tokens الإدخال وtokens الإخراج معًا إلى الارتفاع؛ راقب الأمر تبعًا لذلك:

print(response.usage)
# Watch: input_tokens, output_tokens, cache_read_input_tokens
# Adaptive thinking does not bill thinking tokens separately — they are billed as output tokens and roll into output_tokens

تحاسب QCode لكل token؛ وتوجد أسعار كل نموذج على qcode.cc/models. ويتم الإبلاغ عن الطلبات إلى probe.qcode.cc، حيث يمكنك رؤية نسبة الإدخال / الإخراج / التفكير لكل طلب.

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

كيف أحوّل من budget_tokens إلى التفكير التكيفي؟¶

لا يوجد تحويل خطي. لا يقابل budget_tokens=8000 مستوى جهد محددًا. ابدأ بـ effort: "medium" واضبط بناءً على جودة الإجابة واستهلاك tokens. إذا كان لا بد من فرض حد أعلى صارم، فاستخدم task_budget (انظر أعلاه).

يعيد طلبي الموجّه إلى Opus 4.7 / 4.8 / أحد نماذج سلسلة 5 الرمز 400 مع رسالة تفيد بأن budget_tokens غير مسموح به¶

استبدل كل thinking={"type": "enabled", "budget_tokens": N} بـ thinking={"type": "adaptive"}. لم يعد Opus 4.7 وما بعده يدعم budget_tokens (أي قيمة تُرجع 400).

هل يجب أن أستمر في استخدام budget_tokens مع Sonnet 4.6؟¶

لا يُوصى بذلك. استخدم التفكير التكيفي لكل الشيفرة الجديدة. لا يزال budget_tokens يعمل على 4.6 لكنه على مسار مهجور.

أريد إيقاف التفكير ويعيد Opus 5.5 الرمز 400. ماذا الآن؟¶

لا يمكن إيقاف التفكير على Opus 5.5. لجعله يفكر أقل، اخفض مستوى الجهد (مثلًا low). استخدم thinking: {"type": "between_tools"} على Sonnet 5.5 وthinking: {"type": "disabled"} على Haiku 5.5؛ وكلاهما يعمل فقط عند الجهد العالي أو أقل منه.

كيف أغيّر مستوى الجهد في Claude Code CLI؟¶

استخدم /effort (انظر أعلاه) أو أضف --effort عند التشغيل؛ يوجد الافتراضي المحفوظ ضمن effortLevel أو modelSettings الخاص بكل نموذج في ~/.claude/settings.json.

الخطوات التالية¶

• دليل اختيار النموذج — مقارنة الأسعار والقدرات بين النماذج
• أفضل الممارسات — تقنيات صياغة prompt للسياقات الكبيرة وسير عمل الوكلاء
• نقاط النهاية ومسارات API — مرجع كامل لنطاقات الدخول الخاصة بـ QCode.cc
• الدرس التعليمي لـ Claude Code — مرجع كامل لميزات CLI

المؤسسات ←