# دليل إعداد التفكير التكيفي

> **آخر تحقق**: 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 راجع [اختيار النموذج](/docs/usage/model-selection).

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

| البُعد | التفكير الممتد القديم (4.5 وما قبله) | التفكير التكيفي (4.6 وما بعده) |
|-----------|--------------------------------------------|-------------------------------|
| معامل التفعيل | `thinking={"type": "enabled", "budget_tokens": N}` | `thinking={"type": "adaptive"}` |
| التحكم في الميزانية | حد أقصى ثابت لـ token (`budget_tokens` يجب أن يكون < `max_tokens`) | ينظّم النموذج نفسه، مع إمكان الضبط اختياريًا عبر `effort` |
| السلوك عبر استدعاءات الأدوات | غير متداخل افتراضيًا (يتطلب ترويسة بيتا `interleaved-thinking-2025-05-14`) | متداخل تلقائيًا (لا حاجة إلى ترويسة بيتا) |
| Opus 4.7 وما بعده (بما في ذلك 4.8 وعائلة 5) | ❌ **خطأ 400** (`budget_tokens` لم يعد مدعومًا) | ✅ الوضع الوحيد المدعوم |
| Sonnet 4.6 / Opus 4.6 | ⚠️ مهمل (لا يزال يعمل لكن لا يُنصح به) | ✅ موصى به |

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

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

| النموذج | التفكير التكيفي | budget_tokens | معامل effort |
|-------|-------------------|---------------|------------------|
| `claude-opus-5-5` | ✅ مفعّل افتراضيًا ولا يمكن إيقافه (`thinking: {"type": "disabled"}` يعيد 400) | ❌ خطأ 400 | ✅ low / medium / high / xhigh / max، الافتراضي `medium` |
| `claude-sonnet-5-5` | ✅ مفعّل افتراضيًا؛ `thinking: {"type": "between_tools"}` يوقف التفكير المسبق (low / medium / high فقط) | ❌ خطأ 400 | ✅ low / medium / high / xhigh / max، الافتراضي في API هو `high` |
| `claude-haiku-5-5` | ✅ مفعّل افتراضيًا؛ `thinking: {"type": "disabled"}` يوقفه (عند جهد مرتفع أو أقل فقط) | ❌ خطأ 400 | ✅ low / medium / high / xhigh / max، الافتراضي `medium` |
| `claude-opus-5` | ✅ مفعّل افتراضيًا؛ يعمل `disabled` عند جهد مرتفع أو أقل | ❌ خطأ 400 | ✅ low / medium / high / xhigh / max، الافتراضي `high` |
| `claude-sonnet-5` | ✅ مفعّل افتراضيًا؛ يعمل `disabled` | ❌ خطأ 400 | ✅ low / medium / high / xhigh / max، الافتراضي `high` |
| `claude-opus-4-8` | ✅ الطريقة الوحيدة للتفعيل (عدم وجود حقل `thinking` يعني عدم وجود تفكير) | ❌ خطأ 400 | ✅ low / medium / high / xhigh / max |
| `claude-opus-4-7` | ✅ الطريقة الوحيدة للتفعيل | ❌ خطأ 400 | ✅ low / medium / high / xhigh / max |
| `claude-sonnet-4-6` | ✅ موصى به | ⚠️ لا يزال يعمل لكنه مهمل | ✅ low / medium / high / max |
| `claude-haiku-4-5-20251001` (لم يعد معروضًا على QCode) | ❌ `type: "adaptive"` يعيد 400 | ✅ استخدم هذا | ❌ معامل effort سيعطي خطأ |
| `claude-sonnet-4-5` وما قبله (لم يعد معروضًا على QCode) | ❌ غير مدعوم | ✅ استخدم هذا | ❌ |

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

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

| effort | الأنسب لـ | ملاحظات |
|--------|----------|-------|
| `low` | أسئلة وأجوبة بسيطة، الوكلاء الفرعيون، المسارات الحساسة لزمن الاستجابة | الأقل استهلاكًا من tokens؛ قد تتخطى المهام البسيطة التفكير كليًا |
| `medium` | البرمجة الروتينية، البحث في الوثائق (معظم المهام اليومية) | الافتراضي لدى Opus 5.5 وHaiku 5.5 |
| `high` | الاستدلال المعقد، إعادة هيكلة ملفات متعددة | الافتراضي لمعظم النماذج |
| `xhigh` | سير عمل الوكيل الطويل الأمد (متاح بدءًا من Opus 4.7 وSonnet 5 وHaiku 5.5) | يفكر بسهولة أكبر وبعمق أكبر من `high` |
| `max` | أقصى جودة، والتكلفة ثانوية | لا قيد على طول التفكير |

**قاعدة عامة**: يُضبط 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)

```python
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)

```ts
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 التفكير تُحتسب كالمعتاد. لإظهار أثر التفكير في واجهة المستخدم:

```python
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 فغير مدعوم:

```python
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 الإخراج معًا إلى الارتفاع؛ راقب الأمر تبعًا لذلك:

```python
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](https://qcode.cc/models). ويتم الإبلاغ عن الطلبات إلى [probe.qcode.cc](https://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`.

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

- [دليل اختيار النموذج](/docs/usage/model-selection) — مقارنة الأسعار والقدرات بين النماذج
- [أفضل الممارسات](/docs/usage/best-practices) — تقنيات صياغة prompt للسياقات الكبيرة وسير عمل الوكلاء
- [نقاط النهاية ومسارات API](/docs/getting-started/endpoints-and-api-paths) — مرجع كامل لنطاقات الدخول الخاصة بـ QCode.cc
- [الدرس التعليمي لـ Claude Code](/docs/getting-started/claude-code-tutorial) — مرجع كامل لميزات CLI