DEV Community

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

Posted on Originally published at apidog.com

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

لاستخدام Claude Haiku 5.5 في Claude Code، حدّث 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 دولار فوق ذلك.

جرّب Apidog اليوم

يوضح هذا الدليل الإعداد، وفخ الاسم المستعار haiku، ومستويات الجهد، وملفات الوكلاء الفرعيين، وخطوة التسعير عند 100 ألف رمز، ومتى تستخدم Sonnet أو Opus كنموذج رئيسي. للتفاصيل عن النموذج نفسه، راجع ما هو Claude Haiku 5.5. وإذا كان مشروعك يستدعي واجهات API، فإن Apidog يحتفظ بسيناريوهات اختبار يمكن لوكيل Haiku فرعي تشغيلها.

Claude Haiku 5.5 في Claude Code

Claude Haiku 5.5 في Claude Code: ملخص سريع

الإعداد Haiku 5.5
الحد الأدنى للإصدار v2.1.293 عبر claude update
معرّف النموذج claude-haiku-5-5
الاسم المستعار haiku يشير إلى Haiku 5.5 على Anthropic API فقط
السياق مليون رمز (1M) أصلي في كل خطة، بلا لاحقة [1m]
الضغط التلقائي نحو 967 ألف رمز افتراضيًا
الجهد الافتراضي متوسط، من منخفض إلى أقصى
التفكير يعمل دائمًا ولا يمكن إيقافه في Claude Code
سعر API 0.10 / 0.50 دولار حتى 100 ألف رمز؛ 0.50 / 2.50 دولار فوقها
الخطط Pro وMax وTeam وEnterprise أو مفتاح API؛ ليست متاحة مجانًا

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

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

claude update
Enter fullscreen mode Exit fullscreen mode

تحقق من الإصدار بعد التحديث، ثم أعد تشغيل الطرفية أو جلسة Claude Code إذا لزم الأمر.

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

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

ابدأ جلسة جديدة باستخدام المعرّف الكامل للنموذج:

claude --model claude-haiku-5-5
Enter fullscreen mode Exit fullscreen mode

وللتبديل داخل جلسة قائمة:

/model claude-haiku-5-5
Enter fullscreen mode Exit fullscreen mode

إذا كان إعداد model المحفوظ لديك هو haiku، فإن الجلسة المحفوظة على Haiku 4.5 تستأنف على Haiku 5.5 عند استخدام Anthropic API.

الاسم المستعار haiku لا يعني Haiku 5.5 على كل موفر

الموفّر ما الذي يشير إليه haiku؟
Anthropic API Haiku 5.5
منصة Claude على AWS Haiku 4.5
Amazon Bedrock ومنصة وكيل Google Cloud Haiku 4.5
Microsoft Foundry Haiku 4.5

على أي موفر سحابي، قد يعطيك /model haiku أو model: haiku في ملف وكيل فرعي نموذج Haiku 4.5. لتجنب ذلك، استخدم المعرّف الصريح المناسب للموفر:

  • Google Cloud ومنصة Claude على AWS: claude-haiku-5-5
  • Microsoft Foundry: اسم النشر الخاص بك
  • Amazon Bedrock: معرّف ملف الاستدلال، مثل us.anthropic.claude-haiku-5-5

يمكنك أيضًا توجيه الاسم المستعار haiku عبر المتغير ANTHROPIC_DEFAULT_HAIKU_MODEL، كما في الخطوة 5.

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

Haiku 5.5 هو أول نموذج Haiku يتيح التحكم في مستوى الجهد:

  • منخفض
  • متوسط
  • مرتفع
  • مرتفع جدًا
  • أقصى

يبدأ Claude Code افتراضيًا عند متوسط. لبدء جلسة بجهد أعلى:

claude --model claude-haiku-5-5 --effort high
Enter fullscreen mode Exit fullscreen mode

ولتغيير الجهد داخل الجلسة:

/effort low
Enter fullscreen mode Exit fullscreen mode

استخدم المستويات عمليًا كالتالي:

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

يبقى التفكير مفعّلًا دائمًا في Claude Code. لا تؤثر الإعدادات التالية في Haiku 5.5:

alwaysThinkingEnabled: false
MAX_THINKING_TOKENS=0
Enter fullscreen mode Exit fullscreen mode

يمكن تعطيل التفكير في واجهة Messages API الخام عند مستوى مرتفع أو أقل، لكن ليس من Claude Code. إذا أردت تقليل رموز التفكير، خفّض مستوى الجهد.

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

تشير Anthropic إلى أن Haiku 5.5 يعمل جيدًا مع Opus 5.5 وSonnet 5.5 كوكيل فرعي في مهام البرمجة. الوكلاء الفرعيون عبارة عن ملفات Markdown ذات YAML front matter، وتوضع في أحد المسارين:

.claude/agents/      # خاص بالمشروع
~/.claude/agents/    # متاح في كل المشاريع
Enter fullscreen mode Exit fullscreen mode

الحقول الإلزامية هي name وdescription. وتقبل وثائق الوكلاء الفرعيين القيم sonnet وopus وhaiku وfable ومعرّف نموذج كامل أو inherit ضمن model. يشرح دليل الوكيل الفرعي النطاقات والأدوات بمزيد من التفصيل.

استبدال Explore بمستكشف منخفض التكلفة

وكيل Explore المدمج يعمل على نموذج المحادثة الرئيسي، وليس تلقائيًا على Haiku. إذا كنت تستخدم Opus 5.5 كنموذج رئيسي، فقد تعمل كل عملية بحث في Explore على Opus.

لتجاوز ذلك، أنشئ وكيلًا فرعيًا باسم Explore وحدد له Haiku:

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

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

احفظ الملف باسم:

.claude/agents/Explore.md
Enter fullscreen mode Exit fullscreen mode

أثناء التنفيذ، استخدم /tasks للتحقق من النموذج المستخدم. عند استخدام موفر سحابي، استبدل haiku بالمعرّف الكامل المناسب من الخطوة 2.

فرض تشغيل كل وكيل فرعي على Haiku

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

{
  "env": {
    "CLAUDE_CODE_SUBAGENT_MODEL": "haiku",
    "CLAUDE_CODE_SUBAGENT_MODEL_FORCE": "1"
  }
}
Enter fullscreen mode Exit fullscreen mode

استخدام CLAUDE_CODE_SUBAGENT_MODEL وحده يحدد نموذجًا افتراضيًا فقط. أي قيمة model داخل ملف الوكيل الفرعي تظل لها الأولوية، ولا يتغير Explore.

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

يحدد المتغير ANTHROPIC_DEFAULT_HAIKU_MODEL النموذج المستخدم للاسم المستعار haiku وللمهام الخلفية، مثل تلخيص الجلسات السابقة عند تنفيذ:

claude --resume
Enter fullscreen mode Exit fullscreen mode

وفق مرجع متغيرات البيئة، أصبح 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
Enter fullscreen mode Exit fullscreen mode

ضع التصدير في ملف إعداد shell المناسب، مثل ~/.zshrc أو ~/.bashrc، إذا أردته دائمًا.

انتبه إلى خطوة السعر عند 100 ألف رمز

يعتمد سعر Haiku 5.5 على طول الموجّه، ويرسل Claude Code المحادثة كجزء من الموجّه في كل دور. عند تجاوز سياق الجلسة 100 ألف رمز، تُحاسب الطلبات بسعر:

0.50 دولار / 2.50 دولار
Enter fullscreen mode Exit fullscreen mode

بدلًا من:

0.10 دولار / 0.50 دولار
Enter fullscreen mode Exit fullscreen mode

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

لن يحل الضغط التلقائي المشكلة وحده؛ إذ يضغط Haiku 5.5 السياق قرب 967 ألف رمز افتراضيًا. اتبع هاتين الممارستين:

  1. اضغط مبكرًا: اضبط حد الضغط التلقائي قريبًا من خطوة التسعير. 
   /autocompact 100k
Enter fullscreen mode Exit fullscreen mode
  1. انقل العمل المطول إلى وكلاء فرعيين: يملك كل وكيل فرعي سياقه الخاص، لذا لا تتراكم سجلات الاختبارات ونتائج البحث داخل المحادثة الرئيسية.

حتى بعد تجاوز 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.

الجهد Haiku 5.5 Sonnet 5.5
متوسط 20.3% بسعر 0.68 دولار 28.8% بسعر 0.68 دولار
مرتفع 24.8% بسعر 1.04 دولار 43% بسعر 1.46 دولار
أقصى 39.2% بسعر 2.64 دولار 70.6% بسعر 10.44 دولار

عند متوسط، تكون تكلفة المحاولة متقاربة، بينما يحقق 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 تشغيل سيناريوهات الاختبار المحفوظة من الطرفية، ثم يعيد الوكيل الفرعي تقريرًا قصيرًا دون تلويث سياق النموذج الرئيسي.

أنشئ الملف التالي:

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

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

إعداد 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
Enter fullscreen mode Exit fullscreen mode

توقع تغييرات كسرية إذا كان تطبيقك يستخدم أيًا من التالي:

  • تفكير يدوي عبر budget_tokens
  • قيمة غير افتراضية لـ temperature
  • قيمة غير افتراضية لـ top_p
  • أي استخدام لـ top_k
  • تعبئة مسبقة لرسالة المساعد

كل هذه الحالات تعيد خطأ 400 على Haiku 5.5. يوضح دليل Haiku 5.5 مقابل Haiku 4.5 الإصلاحات المطلوبة.

بعد الترحيل:

  1. احفظ الطلب القديم والجديد كزوج اختبار في Apidog.
  2. خزّن ANTHROPIC_API_KEY كمتغير بيئة.
  3. تحقق من stop_reason وusage.
  4. اجعل الاختبار يفشل عند ظهور 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، وأضف وكيل Explore الذي يعمل على Haiku، ثم احتفظ بنموذجك الرئيسي الحالي لمدة أسبوع وقارن النتائج. إذا كان مشروعك يحتوي على APIs، أضف بعدها وكيل تشغيل الاختبارات.

لاستدعاء النموذج من تطبيقك، ابدأ بـ دليل API لـ Haiku 5.5. Apidog مجاني للبدء، ويمنح وكيل الاختبار سيناريوهات حقيقية لتشغيلها.

Top comments (0)