كيفية استخدام Claude Haiku 5.5 في Claude Code (وكنموذج وكيل فرعي)

لاستخدام Claude Haiku 5.5 في Claude Code، قم بالتحديث إلى الإصدار v2.1.293 أو أحدث باستخدام claude update، ثم ابدأ جلسة باستخدام claude --model claude-haiku-5-5 أو قم بتشغيل /model claude-haiku-5-5 داخل إحداها. الفائدة الأكبر لمعظم الأشخاص هي تشغيله كوكيل فرعي: ضع model: haiku في ملف وكيل فرعي ودع Sonnet 5.5 أو Opus 5.5 يسلمه عمليات البحث وتشغيل الاختبارات والملخصات. باستخدام مفتاح API، تبلغ التكلفة 0.10 دولار / 0.50 دولار لكل مليون رمز إدخال/إخراج للموجهات التي تصل إلى 100 ألف رمز، و 0.50 دولار / 2.50 دولار فوق ذلك.

أدناه: الإعداد، فخ الاسم المستعار haiku، الجهد، ملفات الوكيل الفرعي، خطوة السعر 100 ألف، ومتى يجب أن يقود Sonnet أو Opus. للنموذج نفسه، اقرأ ما هو Claude Haiku 5.5. إذا كانت التعليمات البرمجية الخاصة بك تستدعي واجهات برمجة التطبيقات (APIs)، فإن Apidog يحتفظ بسيناريوهات الاختبار التي يمكن لوكيل فرعي من Haiku تشغيلها لك.

Claude Haiku 5.5 في Claude Code: نظرة سريعة

الخطوة 1: تحديث Claude Code

يتطلب Haiku 5.5 الإصدار v2.1.293 أو أحدث من Claude Code. يُشير إدخال سجل التغييرات إليه بأنه "الآن نموذج Haiku الافتراضي على Anthropic API."

claude update

Claude Code غير متاح في الخطة المجانية. يمكن للمستخدمين المجانيين تحديد Haiku 5.5 في تطبيقات Claude.ai، لكن Claude Code يتطلب خطة Pro أو Max أو Team أو Enterprise أو مفتاح Anthropic API. وفقًا لـ claude.com/pricing، تبلغ تكلفة Pro 17 دولارًا شهريًا عند الفوترة السنوية أو 20 دولارًا شهريًا، وتبدأ Max من 100 دولار.

الخطوة 2: تحديد Haiku 5.5 كنموذج رئيسي لك

claude --model claude-haiku-5-5

داخل جلسة قيد التشغيل، يقوم /model claude-haiku-5-5 بنفس الشيء. إذا كان إعداد model المحفوظ هو haiku، فإن الجلسة المحفوظة على Haiku 4.5 تستأنف على Haiku 5.5.

الاسم المستعار haiku يعني Haiku 5.5 فقط على Anthropic API

على أي موفر سحابي، يمنحك /model haiku و model: haiku في ملف وكيل فرعي Haiku 4.5. بدلاً من ذلك، ثبت المعرف الكامل هناك: claude-haiku-5-5 على Google Cloud ومنصة Claude على AWS، واسم النشر الخاص بك على Foundry، ومعرف ملف تعريف الاستدلال مثل us.anthropic.claude-haiku-5-5 على Amazon Bedrock. أو وجه الاسم المستعار إليه باستخدام ANTHROPIC_DEFAULT_HAIKU_MODEL (الخطوة 5).

الخطوة 3: اختيار مستوى الجهد

Haiku 5.5 هو أول نموذج Haiku يتحكم في مستوى الجهد: منخفض، متوسط، مرتفع، مرتفع جدًا، و أقصى، ويبدأ من متوسط في Claude Code.

claude --model claude-haiku-5-5 --effort high

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

يبقى التفكير قيد التشغيل. لا يمكنك إيقاف تشغيله في Haiku 5.5 في Claude Code؛ alwaysThinkingEnabled: false و MAX_THINKING_TOKENS=0 ليس لهما أي تأثير. (يمكن لواجهة برمجة تطبيقات الرسائل الخام تعطيله عند مرتفع أو أقل.) قلل الجهد عندما تريد عددًا أقل من رموز التفكير.

الخطوة 4: تشغيل Haiku 5.5 كوكيل فرعي

تقول Anthropic إن Haiku 5.5 "يتوافق جيدًا مع Opus 5.5 و Sonnet 5.5 كوكيل فرعي في أعمال البرمجة." الوكلاء الفرعيون هم ملفات Markdown تحتوي على بيانات YAML أولية في .claude/agents/ (للمشروع) أو ~/.claude/agents/ (لجميع المشاريع). name و description فقط مطلوبان، ووثائق الوكيل الفرعي تقبل sonnet، opus، haiku، fable، معرف نموذج كامل، أو inherit لـ model. يغطي دليل الوكيل الفرعي الخاص بنا النطاقات والأدوات.

استبدال Explore بمستكشف رخيص

يعمل الوكيل الفرعي Explore المدمج على نموذج المحادثة الرئيسي، وليس Haiku. في جلسة Opus 5.5، يتم تشغيل كل عملية بحث في Explore على Opus. يقوم وكيل فرعي للمستخدم أو المشروع باسم Explore بتجاوز الوكيل المدمج ويحتفظ بنموذجه الخاص:

---
name: Explore
description: بحث سريع للقاعدة البرمجية للقراءة فقط. استخدمه للعثور على الملفات والرموز ومواقع الاستدعاء دون تعديل أي شيء.
tools: Read, Grep, Glob
model: haiku
effort: low
---

أنت تبحث في قاعدة التعليمات البرمجية وتقدم تقريرًا عما تجده. أعد مسارات الملفات مع أرقام الأسطر وملخصًا قصيرًا لكل تطابق. لا تقم أبدًا بتعديل الملفات.

احفظه باسم .claude/agents/Explore.md. شغل /tasks أثناء عمله لتأكيد النموذج. على موفر سحابي، استبدل haiku بالمعرف الكامل من الخطوة 2.

فرض كل وكيل فرعي على Haiku

لتشغيل كل وكيل فرعي على Haiku، بما في ذلك Explore، قم بتعيين كلا المتغيرين في كتلة env لملف الإعدادات:

{
  "env": {
    "CLAUDE_CODE_SUBAGENT_MODEL": "haiku",
    "CLAUDE_CODE_SUBAGENT_MODEL_FORCE": "1"
  }
}

CLAUDE_CODE_SUBAGENT_MODEL وحده هو الافتراضي: لا يزال حقل model الخاص بالوكيل الفرعي هو الفائز، ولا يتحرك Explore.

الخطوة 5: توجيه العمل في الخلفية إلى Haiku 5.5

ANTHROPIC_DEFAULT_HAIKU_MODEL يحدد "النموذج الذي سيتم استخدامه لـ haiku، أو وظائف الخلفية،" مثل تلخيص الجلسات السابقة لـ claude --resume. تم إهمال ANTHROPIC_SMALL_FAST_MODEL الأقدم، وفقًا لـ مرجع متغيرات البيئة؛ استبدله إذا كان ملف تعريف shell الخاص بك لا يزال يقوم بتعيينه.

على Anthropic API، لا تحتاج إلى تعيين أي شيء. على Google Cloud، تكون مهام الخلفية افتراضيًا على Sonnet؛ على Foundry، على النموذج الأساسي؛ على Bedrock، على Sonnet أو النموذج الأساسي. بمجرد تمكين Haiku 5.5 في حسابك، قم بتثبيته:

# منصة وكيل Google Cloud
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-5-5

# Amazon Bedrock (معرف ملف تعريف الاستدلال)
export ANTHROPIC_DEFAULT_HAIKU_MODEL=us.anthropic.claude-haiku-5-5

خطوة السعر 100 ألف في الجلسات الطويلة

يعتمد سعر Haiku 5.5 على طول الموجه، ويرسل Claude Code المحادثة كالموجه في كل دور. بمجرد أن يتجاوز سياق الجلسة 100 ألف رمز، يتم احتساب كل طلب بسعر 0.50 دولار / 2.50 دولار بدلاً من 0.10 دولار / 0.50 دولار، أي خمسة أضعاف سعر الموجه القصير. لا تذكر الوثائق ما إذا كانت الرموز المخزنة مؤقتًا تُحتسب ضمن هذا الحد، لذا ضع ميزانية كما لو كانت كذلك.

لن ينقذك الضغط التلقائي: يقوم Haiku 5.5 بالضغط عند حوالي 967 ألف رمز افتراضيًا، لذا يمكن أن تعمل الجلسة فوق خطوة السعر في البداية بكثير. تساعد عادتان عندما تدفع لكل رمز:

1. اضغط مبكرًا. يحدد /autocompact 100k أدنى نافذة يقبلها Claude Code، بحيث يتم ضغط الجلسة بالقرب من الحد بدلاً من قرب مليون (1M).
2. ادفع الأعمال الكبيرة إلى الوكلاء الفرعيين. لدى الوكيل الفرعي سياقه الخاص، لذلك تبقى سجلات الاختبار ونتائج البحث خارج المحادثة الرئيسية.

حتى فوق 100 ألف، يمثل 0.50 دولار / 2.50 دولار ربع سعر Sonnet 5.5 البالغ 2 دولار / 10 دولار. في الخطة المدفوعة، تعتمد الجلسات على حدود الاستخدام بدلاً من ذلك، ولم تنشر Anthropic كيف يتم احتساب Haiku 5.5 مقابلها. يشرح تفصيل أسعار Haiku 5.5 الخاص بنا الحسابات.

مشتركو Max و Team: لا تغطي أرصدة API الشهرية الجديدة (100 دولار على Max 5x، 200 دولار على Max 20x، وما يصل إلى 500 دولار مجمعة على Team) Claude Code التفاعلي، وفقًا لوثائق أرصدة API من Anthropic.

متى تبقي Sonnet 5.5 أو Opus 5.5 كنموذج رائد

تقول Anthropic إن Sonnet 5.5 و Opus 5.5 "يظلان خيارين أفضل لمهام البرمجة المعقدة التي تتطلب وكيلًا." في Terminal-Bench 4.0، الذي أجرته Anthropic في Claude Code بأقصى جهد، سجل Haiku 5.5 نسبة 39.2% مقابل 70.6% لـ Sonnet 5.5. تضيف الرسوم البيانية الإطلاق التكلفة لكل محاولة:

عند متوسط، تكلف كلاهما نفس الشيء تقريبًا لكل محاولة ويسجل Sonnet أعلى. سعر رمز Haiku لا ينتقل إلى عمل shell الطويل، لذا لا تجعله القائد لجلسات البرمجة الصعبة.

استخدام الكمبيوتر يحكي قصة مختلفة. في OSWorld 2.1، سجل Haiku 5.5 عند متوسط 53.3% بسعر 0.13 دولار لكل محاولة، بينما سجل Sonnet 5.5 عند منخفض 57.9% بسعر 0.68 دولار. يتضمن تفصيل مقاييس Haiku 5.5 كل صف، ويغطي دليل Claude Code لـ Sonnet 5.5 جانب النموذج الرائد.

تقسيم عملي: Sonnet 5.5 أو Opus 5.5 كنموذج رئيسي، Haiku 5.5 لـ Explore، ومشغلي الاختبار، وقارئي السجلات، وجالبي المستندات.

مثال: وكيل فرعي من Haiku يشغل اختبارات Apidog الخاصة بك

عمليات تشغيل الاختبار مفصلة ومتكررة، وهي مناسبة تمامًا لـ Haiku. يقوم Apidog CLI بتشغيل سيناريوهات اختبار Apidog المحفوظة من الطرفية، لذا يمكن لوكيل فرعي تشغيلها وإرجاع تقرير قصير بينما يظل سياق النموذج الرئيسي نظيفًا.

---
name: api-test-runner
description: يشغل سيناريوهات اختبار Apidog للمشروع باستخدام Apidog CLI بعد تغيير نقطة نهاية API، ثم يبلغ عن عدد حالات النجاح والفشل مع الطلبات الفاشلة.
tools: Bash, Read
model: haiku
effort: low
---

شغل أمر اختبار Apidog CLI الموثق في ملف README لهذا المستودع للسيناريو الذي يغطي نقطة النهاية المتغيرة. أبلغ عن عدد حالات النجاح والفشل. لكل فشل، قدم اسم الطلب، النتيجة المتوقعة، والنتيجة الفعلية. لا تعدل التعليمات البرمجية. لا تعيد محاولة تشغيل فاشل أكثر من مرة واحدة.

إعداد CLI، بما في ذلك المصادقة وأمر التشغيل، موجود في Apidog CLI في Claude Code. حمل Apidog لإنشاء السيناريوهات التي يشغلها الوكيل الفرعي.

ترحيل تطبيق من Haiku 4.5

إذا كان تطبيقك يستدعي Haiku 4.5 عبر API، فيمكن لـ Claude Code بدء الترحيل:

/claude-api migrate this project to claude-haiku-5-5

توقع تغييرات كسرية: التفكير اليدوي في budget_tokens، أو temperature أو top_p غير الافتراضيين، أو أي top_k، وتعبئة المساعد المسبقة، كلها ستعيد خطأ 400 على Haiku 5.5. يسرد دليل Haiku 5.5 مقابل Haiku 4.5 كل إصلاح. بعد التعديل، احفظ الطلب القديم والجديد كزوج في Apidog، وقم بتخزين ANTHROPIC_API_KEY كمتغير بيئة، وتحقق من stop_reason و usage، بحيث يؤدي توقف refusal جديد أو قفزة في الرموز إلى فشل الاختبار بدلاً من الوصول إلى الإنتاج.

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

هل Haiku 5.5 هو النموذج الافتراضي في Claude Code؟ لا. إنه نموذج Haiku الافتراضي على Anthropic API، مما يعني أن الاسم المستعار haiku يشير إليه. حدده كنموذجك الرئيسي باستخدام --model أو /model.

هل يمكنني استخدام Haiku 5.5 في Claude Code على الخطة المجانية؟ لا. يتطلب Claude Code خطة مدفوعة أو مفتاح API. يمكن للمستخدمين المجانيين اختيار Haiku 5.5 في تطبيقات Claude.ai؛ انظر كيفية استخدام Claude Haiku 5.5 مجانًا.

لماذا يمنحني model: haiku Haiku 4.5؟ أنت على Bedrock، Google Cloud، Foundry أو منصة Claude على AWS، أو على إصدار قبل v2.1.293. ثبت المعرف الكامل أو قم بتعيين ANTHROPIC_DEFAULT_HAIKU_MODEL.

هل يمكنني إيقاف التفكير لتوفير الرموز؟ ليس في Claude Code. قم بتقليل الجهد بدلاً من ذلك؛ منخفض هو الإعداد الأقل تكلفة.

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

شغل claude update، أضف تجاوز Haiku Explore، واحتفظ بنموذجك الرئيسي الحالي لمدة أسبوع. ثم أضف الوكيل الفرعي لمشغل الاختبار إذا كان مشروعك يحتوي على واجهات برمجة تطبيقات (APIs). لاستدعاء النموذج من التعليمات البرمجية الخاصة بك، ابدأ بـ دليل API لـ Haiku 5.5. Apidog مجاني للبدء ويمنح هذا الوكيل الفرعي اختبارات حقيقية لتشغيلها.