تم إطلاق واجهة برمجة تطبيقات Claude Opus 4.8 مع إطلاق النموذج في 28 مايو 2026. معرف النموذج هو claude-opus-4-8، وهو يعمل على نفس واجهة برمجة تطبيقات الرسائل (Messages API) التي تعرفها بالفعل. يرشدك هذا الدليل خلال الإعداد الكامل: الحصول على مفتاح، أول مكالمة لك، المعلمة الجديدة effort، التفكير التكيفي، البث، استخدام الأدوات، واختبار كل شيء في Apidog.
إذا كنت قد أجريت أي مكالمة مع أي نموذج Claude من قبل، فإن السلسلة الوحيدة التي تتغير هي اسم النموذج. المفهوم الجديد الوحيد هو التحكم في الجهد (effort control)، وهو يستحق عشر دقائق للفهم لأنه يحل محل نمط "ميزانية التفكير" القديم. هل أنت جديد على واجهة برمجة تطبيقات Claude؟ يمكنك إجراء مكالمات Opus 4.8 عاملة في حوالي عشر دقائق. للحصول على معلومات أساسية حول النموذج نفسه، راجع ما هو Claude Opus 4.8.
ما تحصل عليه مع واجهة برمجة تطبيقات Opus 4.8
الأرقام التي تشكل تكاملك:
claude-opus-4-8: سياق إدخال 1 مليون توكن، إخراج 128 ألف توكن- نفس نقطة نهاية الرسائل: استبدال مباشر للمشاريع التي تستدعي Opus 4.7 بالفعل
- تحكم
effort: خمسة مستويات منlowإلىmax، يتم تعيينها لكل طلب - التفكير التكيفي: النموذج يقرر مدى عمق التفكير
- تسعير قياسي: 5 دولارات لكل مليون توكن إدخال، 25 دولارًا لكل مليون توكن إخراج
لحساب التكلفة الكاملة وأسعار الوضع السريع، راجع دليل تسعير Opus 4.8. إذا لم يكن لديك خطة مدفوعة بعد، يغطي دليل الوصول المجاني خياراتك.
الخطوة 1: الحصول على مفتاح API الخاص بك لـ Claude
- اذهب إلى console.anthropic.com
- سجل الدخول أو أنشئ حسابًا
- افتح Settings (الإعدادات)، ثم API Keys (مفاتيح API)
- انقر على Create Key (إنشاء مفتاح)، سمه، وانسخه
خزّن المفتاح في متغير بيئة بحيث لا يظهر أبدًا في التعليمات البرمجية الخاصة بك:
export ANTHROPIC_API_KEY="sk-ant-..."
تحصل الحسابات الجديدة على أرصدة تجريبية للاختبار قبل إضافة معلومات الفواتير. يعمل المفتاح مع claude-opus-4-8 فورًا.
الخطوة 2: تثبيت حزمة SDK
توفر Anthropic حزم SDK رسمية لـ Python و TypeScript و Go و Java و C# و Ruby و PHP. اختر لغتك:
# Python
pip install anthropic
# Node.js / TypeScript
npm install @anthropic-ai/sdk
يمكنك تخطي حزمة SDK بالكامل واستدعاء نقطة نهاية REST باستخدام curl، كما هو موضح أدناه. مصدر Python SDK هو المرجع إذا كنت بحاجة إلى أنواع دقيقة.
الخطوة 3: إجراء أول مكالمة لك لـ Opus 4.8
بايثون
import anthropic
client = anthropic.Anthropic() # reads ANTHROPIC_API_KEY
message = client.messages.create(
model="claude-opus-4-8",
max_tokens=4096,
messages=[
{"role": "user", "content": "Explain the OAuth 2.0 PKCE flow in 3 short paragraphs."}
],
)
print(message.content[0].text)
نود.جي إس
import Anthropic from "@anthropic-ai/sdk";
const client = new Anthropic();
const message = await client.messages.create({
model: "claude-opus-4-8",
max_tokens: 4096,
messages: [
{ role: "user", content: "Explain the OAuth 2.0 PKCE flow in 3 short paragraphs." },
],
});
console.log(message.content[0].text);
كيرل
curl https://api.anthropic.com/v1/messages \
--header "x-api-key: $ANTHROPIC_API_KEY" \
--header "anthropic-version: 2023-06-01" \
--header "content-type: application/json" \
--data '{
"model": "claude-opus-4-8",
"max_tokens": 4096,
"messages": [
{"role": "user", "content": "Explain the OAuth 2.0 PKCE flow in 3 short paragraphs."}
]
}'
هذا هو المسار السعيد. من هنا تقوم بإضافة الميزات التي تحتاجها.
التحكم في الجهد: المعلمة الجديدة الوحيدة
تتحكم معلمة effort في عدد الرموز (tokens) التي ينفقها Opus 4.8 عبر الاستجابة بأكملها: النص، واستدعاءات الأدوات، والتفكير. وهي موجودة داخل output_config وتقبل القيم low، medium، high، xhigh، و max. القيمة الافتراضية هي high، لذا فإن حذفها يعطيك سلوك high.
message = client.messages.create(
model="claude-opus-4-8",
max_tokens=8192,
messages=[{"role": "user", "content": "Refactor this 600-line module for testability."}],
output_config={"effort": "xhigh"},
)
نود:
const message = await client.messages.create({
model: "claude-opus-4-8",
max_tokens: 8192,
messages: [{ role: "user", content: "Refactor this 600-line module for testability." }],
output_config: { effort: "xhigh" },
});
كيفية الاختيار، وفقًا لـ وثائق الجهد من Anthropic:
| المستوى | استخدمه لـ |
|---|---|
low (منخفض) |
التصنيف، عمليات البحث السريعة، المهام عالية الحجم، الوكلاء الفرعيون |
medium (متوسط) |
العمل الوكيلي المتوازن حيث التكلفة مهمة |
high (مرتفع) |
افتراضي. التفكير المعقد حيث الجودة تتفوق على السرعة |
xhigh (مرتفع جداً) |
الترميز ومهام الوكلاء طويلة المدى؛ نقطة البداية الموصى بها |
max (أقصى) |
المشكلات المتطورة حقًا حيث قمت بقياس مساحة العمل |
قاعدتان عمليتان. ابدأ من xhigh للبرمجة والحلقات الوكيلية. عند تشغيل xhigh أو max، قم بتعيين قيمة كبيرة لـ max_tokens (64K هي نقطة بداية معقولة) حتى يكون لدى النموذج مساحة للتفكير والتصرف.
التفكير التكيفي
يستخدم Opus 4.8 التفكير التكيفي. قم بتعيين thinking: {type: "adaptive"} وسيقرر النموذج متى وكم يفكر. بدون ذلك، يتم تشغيل الطلبات بدون تفكير.
message = client.messages.create(
model="claude-opus-4-8",
max_tokens=16000,
thinking={"type": "adaptive"},
output_config={"effort": "xhigh"},
messages=[{"role": "user", "content": "Find the race condition in this scheduler."}],
)
for block in message.content:
if block.type == "thinking":
print("[thinking]", block.thinking[:200])
elif block.type == "text":
print(block.text)
فخ ترحيل واحد: التفكير الموسع اليدوي باستخدام budget_tokens غير مدعوم في Opus 4.8 ويعيد خطأ 400. إذا كنت قد نقلت ذلك من Opus 4.5 أو ما قبله، احذف حقل budget_tokens واستخدم التفكير التكيفي مع الجهد بدلاً من ذلك.
استجابات البث
البث يجعل Opus 4.8 يبدو سريعًا في واجهة المستخدم. توفر لك حزمة SDK مساعدًا:
with client.messages.stream(
model="claude-opus-4-8",
max_tokens=4096,
messages=[{"role": "user", "content": "Write a 5-step guide to writing a REST client in Go."}],
) as stream:
for text in stream.text_stream:
print(text, end="", flush=True)
نود:
const stream = client.messages.stream({
model: "claude-opus-4-8",
max_tokens: 4096,
messages: [{ role: "user", content: "Write a 5-step guide to writing a REST client in Go." }],
});
for await (const event of stream) {
if (event.type === "content_block_delta" && event.delta.type === "text_delta") {
process.stdout.write(event.delta.text);
}
}
بالنسبة لـ REST الخام، أضف "stream": true إلى جسم الطلب واقرأ الأحداث المرسلة من الخادم.
استخدام الأدوات واستدعاء الدوال
يستدعي Opus 4.8 الأدوات بكفاءة أكبر من 4.7، ويحدد مستوى effort عدد الاستدعاءات التي يقوم بها. قم بتعريف أداة باستخدام input_schema:
tools = [
{
"name": "get_weather",
"description": "Get the current weather for a city.",
"input_schema": {
"type": "object",
"properties": {
"city": {"type": "string", "description": "City name"},
"unit": {"type": "string", "enum": ["celsius", "fahrenheit"]},
},
"required": ["city"],
},
}
]
message = client.messages.create(
model="claude-opus-4-8",
max_tokens=1024,
tools=tools,
messages=[{"role": "user", "content": "What's the weather in Singapore right now?"}],
)
for block in message.content:
if block.type == "tool_use":
print(f"Call: {block.name}")
print(f"Args: {block.input}")
تقوم بتشغيل الأداة محليًا، وتلحق كتلة tool_result، وتستدعي مرة أخرى للمتابعة. الجهد المنخفض يجعل كلود يقوم بتجميع العمليات في عدد أقل من الاستدعاءات؛ الجهد العالي يجعله يشرح خطته أولاً. إذا كنت تقوم ببناء أنظمة متعددة الوكلاء، فإن دليلنا الوكلاء المدارون بواسطة كلود مقابل Agent SDK يغطي خيارات البنية.
رسائل النظام في منتصف المحادثة
يأتي Opus 4.8 مع تغيير في Messages API: يمكنك الآن وضع إدخال نظام في منتصف مصفوفة messages، وليس فقط في البداية. يتيح لك ذلك حقن تعليمات أو أذونات جديدة في منتصف المهمة، وهو الأساس لـ Claude Code’s Dynamic Workflows. إذا كنت تقوم بتنسيق وكلاء فرعيين عبر واجهة برمجة التطبيقات، اقرأ التفاصيل العميقة لـ Dynamic Workflows للحصول على النمط الكامل.
اختبار تكامل Opus 4.8 الخاص بك باستخدام Apidog
الاستدعاء الناجح لـ SDK هو الخطوة الأولى. يجب أن تتعامل عمليات التكامل الإنتاجية مع الأجزاء المعقدة: الأجزاء المتدفقة، التحقق من صحة استدعاء الأدوات، شكل output_config الجديد، وكتل التفكير التكيفي في الاستجابة. هنا يأتي دور إعداد اختبار حقيقي.
يتعامل Apidog مع واجهة برمجة تطبيقات Messages بأكملها في مساحة عمل واحدة:
- احفظ نقطة النهاية كطلب: الصق
https://api.anthropic.com/v1/messages، أرفق رؤوسx-api-keyوanthropic-version، ثم اضغط على إرسال - إعادة التشغيل عبر إصدارات النماذج: استبدل
claude-opus-4-7بـclaude-opus-4-8على نفس الطلب وقارن المخرجات - بث الاستجابات مباشرة: يعرض Apidog الأجزاء المتدفقة فور وصولها، مع توقيتات لكل جزء
- التحقق من شكل الاستجابة: أضف تأكيدات تكتشف الانحراف عند تغيير مستويات
effortأو تبديل التفكير - محاكاة نقطة النهاية: قم بإنشاء استجابة رسائل وهمية حتى تتمكن من اختبار التعليمات البرمجية اللاحقة دون إنفاق أرصدة
- بناء سيناريوهات حلقة الوكيل: قم بربط المكالمات مع التحقق من صحة استدعاء الأدوات بين الخطوات
للبدء، قم بتنزيل Apidog، أنشئ طلبًا يشير إلى نقطة نهاية Messages، واستورد مقتطف curl من قبل. يستغرق الإعداد حوالي دقيقتين. يعمل نفس التدفق مع واجهة برمجة تطبيقات Gemini 3.5 و واجهة برمجة تطبيقات Qwen 3.7 إذا كنت تدير أكثر من مزود واحد.
معالجة الأخطاء وحدود المعدل
نموذج أخطاء Claude ثابت. الرموز المهمة هي:
- 400
invalid_request_error: نص طلب غير صحيح، غالبًاbudget_tokensعلى Opus 4.8 أو قيمةeffortخاطئة - 401
authentication_error: مفتاح API غير صحيح أو مفقود - 403
permission_error: مفتاحك لا يمكنه الوصول إلى النموذج - 429
rate_limit_error: تراجع وأعد المحاولة - 500
api_error: خطأ من جانب الخادم، أعد المحاولة مع التراجع الأسي - 529
overloaded_error: واجهة برمجة التطبيقات محملة بشكل زائد مؤقتًا، أعد المحاولة مع التراجع الأسي
لف الاستدعاءات بحلقة إعادة محاولة وتراجع أسي:
import time
import anthropic
client = anthropic.Anthropic()
def call_with_retry(prompt, max_retries=4):
for attempt in range(max_retries):
try:
return client.messages.create(
model="claude-opus-4-8",
max_tokens=4096,
messages=[{"role": "user", "content": prompt}],
)
except anthropic.RateLimitError:
if attempt == max_retries - 1:
raise
time.sleep(2 ** attempt)
تتغير حدود المعدل مع مستوى استخدامك. بالنسبة للوظائف الدفعية عالية الإنتاجية التي لا تحتاج إلى زمن استجابة في الوقت الفعلي، تتيح Batch API أيضًا ما يصل إلى 300 ألف توكن إخراج مع رأس بيتا.
الترحيل من Opus 4.7 إلى 4.8
معظم المشاريع تقوم بتغيير سلسلة واحدة بالضبط:
# قبل
model="claude-opus-4-7"
# بعد
model="claude-opus-4-8"
ما يجب التحقق منه بعد التبديل:
- مستويات الجهد (Effort levels): السلوك هو نفس النطاق في 4.7، ولكن أعد تشغيل تقييماتك على المستوى الذي تستخدمه.
- تكوين التفكير (Thinking config): إذا قمت بتعيين
budget_tokensفي أي وقت، قم بإزالته؛ يرفضه Opus 4.8 بخطأ 400. - مخططات الأدوات (Tool schemas): تنتقل إلى الأمام، ولكن أعد تشغيل تقييم استخدام الأدوات الخاص بك.
- التكلفة (Cost): أسعار التوكن الواحدة مطابقة لـ 4.7، لذا لا توجد مفاجأة في الفواتير.
الأسئلة الشائعة
ما هو معرف نموذج واجهة برمجة تطبيقات Claude Opus 4.8؟ claude-opus-4-8 على واجهة برمجة تطبيقات Claude و Vertex AI، و anthropic.claude-opus-4-8 على AWS Bedrock.
هل يوجد مستوى مجاني لواجهة برمجة تطبيقات Opus 4.8؟ لا يوجد مستوى مجاني دائم لواجهة برمجة التطبيقات، لكن الحسابات الجديدة تحصل على أرصدة تجريبية. راجع دليل الوصول المجاني للحصول على مسارات أخرى منخفضة التكلفة.
كيف أحدد مستوى الجهد؟ مرر output_config: {"effort": "xhigh"} (أو low، medium، high، max) في الطلب. القيمة الافتراضية هي high.
لماذا يعيد طلبي خطأ 400 بخصوص budget_tokens؟ لا يدعم Opus 4.8 التفكير الموسع اليدوي. قم بإزالة budget_tokens واستخدم thinking: {type: "adaptive"} مع معلمة الجهد.
هل يعمل Opus 4.8 مع حزمة SDK المتوافقة مع OpenAI؟ توفر Anthropic طبقة توافق لحزمة SDK الخاصة بـ OpenAI. وجه عنوان URL الأساسي إلى نقطة نهاية Anthropic واستخدم مفتاح Anthropic الخاص بك؛ احتفظ بسلسلة النموذج claude-opus-4-8.
ما هي قيمة max_tokens التي يجب أن أحددها للعمل الوكيلي؟ ابدأ بـ 64K عند تشغيل جهد xhigh أو max حتى يكون لدى النموذج مساحة للتفكير وربط استدعاءات الأدوات. اضبطها للأسفل بمجرد رؤية الاستخدام الفعلي.
كيف يمكنني اختبار استجابات البث في Apidog؟ افتح الطلب، وقم بتمكين البث في النص، وسيقوم Apidog بعرض أجزاء الأحداث المرسلة من الخادم فور وصولها، مما يجعل من السهل اكتشاف الاستجابات غير المكتملة.