skill
واجهة برمجة تطبيقات Claude
مرجع ل Claude API / Anthropic SDK — معرفات النماذج، التسعير، المعاملات، البث، استخدام الأدوات، MCP، الوكلاء، التخزين المؤقت، عد الرموز، ترحيل النماذج. المحفز — اقرأ قبل فتح الملف الهدف؛ لا تتخطاه لأنه "يبدو سطرا واحدا" — كلما: يذكر الموجه Claude/Anthropic بأي شكل (Claude, Anthropic, Fable, Opus, Sonnet, Haiku, `anthropic`, `@anthropic-ai`, `claude-*`, `us.anthropic.*`, `[1m]`)؛ يسأل المستخدم عن LLM (التسعير/اختيار النموذج/الحدود/التخزين المؤقت) — لا تجب أبدا...
نبذة
# بناء تطبيقات مدعومة بنماذج اللغة الكبيرة (LLM) باستخدام Claude
تساعدك هذه المهارة في بناء تطبيقات مدعومة بنماذج اللغة الكبيرة (LLM) باستخدام Claude. اختر الواجهة المناسبة بناء على احتياجاتك، اكتشف لغة المشروع، ثم اقرأ الوثائق ذات الصلة الخاصة باللغة.
## قبل أن تبدأ
افحص الملف المستهدف (أو، إذا لم يكن هناك ملف مستهدف، فافحص الموجه والمشروع) بحثا عن علامات مزود غير Anthropic - `import openai`، `from openai`، `langchain_openai`، `OpenAI(`, `gpt-4`، `gpt-5`، أسماء ملفات مثل `agent-openai.py` أو `*-generic.py`، أو أي تعليمات صريحة للحفاظ على الكود محايدا للمزود. إذا وجدت أيا منها، توقف وأخبر المستخدم أن هذه المهارة تنتج كود Claude/Anthropic SDK؛ اسأل عما إذا كانوا يريدون تحويل الملف إلى Claude أو يريدون تطبيقا غير Claude. لا تقم بتعديل ملف غير Anthropic باستخدام استدعاءات Anthropic SDK. (استثناء: الأمر الفرعي `prompt-audit` غير تفاعلي ولا يتوقف هنا - يسجل علامات المزود غير Anthropic في افتراضات تقريره المعلنة ولا يقترح أبدا تحويل ملف غير Anthropic إلى Anthropic SDK.)
## متطلبات الإخراج
عندما يطلب منك المستخدم إضافة أو تعديل أو تنفيذ ميزة Claude، يجب أن يستدعي الكود الخاص بك Claude من خلال أحد الخيارات التالية:
1. **ال SDK الرسمي ل Anthropic** للغة المشروع (`anthropic`، `@anthropic-ai/sdk`، `com.anthropic.*`، إلخ). هذا هو الخيار الافتراضي كلما وجد SDK مدعوم للمشروع. 2. **HTTP الخام** (`curl`، `requests`، `fetch`، `httpx`، إلخ) - فقط عندما يطلب المستخدم صراحة cURL/REST/HTTP الخام، أو عندما يكون المشروع مشروع shell/cURL، أو عندما لا تحتوي اللغة على SDK رسمي.
لا تخلط بين الاثنين أبدا - لا تلجأ إلى `requests`/`fetch` في مشروع Python أو TypeScript لمجرد أنه يبدو أخف. لا تعتمد أبدا على شيمات متوافقة مع OpenAI.
**لا تخمن أبدا استخدام SDK.** يجب أن تأتي أسماء الدوال، أسماء الفئات، مساحات الأسماء، توقيعات الدوال، ومسارات الاستيراد من وثائق صريحة - إما ملفات `{lang}/` في هذه المهارة أو مستودعات SDK الرسمية أو روابط الوثائق المدرجة في `shared/live-sources.md`. إذا لم يكن الربط الذي تحتاجه موثقا بشكل صريح في ملفات المهارة، فاستخدم WebFetch لجلب مستودع SDK ذي الصلة من `shared/live-sources.md` قبل كتابة الكود. لا تستنتج واجهات برمجة تطبيقات Ruby/Java/Go/PHP/C# من أشكال cURL أو من SDK بلغة أخرى.
**إذا فشل WebFetch أو الوصول إلى المستودع** (الشبكة مقيدة، مهلات، حظر الاستنساخ): لا تستمر في إعادة المحاولة - اكتب الكود من الأنماط وجداول مساحات الأسماء/الحزم في ملف `{lang}/`، قم بتشغيل المترجم أو المفسر عليه، وكرر على مخرجات الخطأ. بالنسبة ل SDKs ذات الأنواع الثابتة (C#، Java، Go)، فإن حلقة إصلاح التجميع مقابل الأخطاء المحلية تصل إلى كود عامل بشكل أسرع من البحث الشبكي المحظور.
## الإعدادات الافتراضية
ما لم يطلب المستخدم خلاف ذلك:
بالنسبة لإصدار نموذج Claude، يرجى استخدام Claude Opus 5.5، والذي يمكنك الوصول إليه عبر سلسلة النموذج الدقيقة `claude-opus-5-5`. يرجى تعيين التفكير التكيفي (`thinking: {type: "adaptive"}`) كإعداد افتراضي لأي شيء معقد إلى حد ما. وأخيرا، يرجى تعيين البث كإعداد افتراضي لأي طلب قد يتضمن إدخالا طويلا، أو إخراجا طويلا، أو `max_tokens` عاليا - فهو يمنع الوصول إلى مهلات الطلب. استخدم المساعد `.get_final_message()` / `.finalMessage()` الخاص ب SDK للحصول على الاستجابة الكاملة إذا لم تكن بحاجة إلى التعامل مع أحداث البث الفردية. عندما يحدد طلب البث أدوات معرفة من قبل المستخدم (العميل)، قم بتعيين `eager_input_streaming: true` على كل من هذه الأدوات بحيث يتم بث مدخلات الأداة الكبيرة (محتويات الملفات، الكود، المستندات) أثناء إنشائها بدلا من وصولها دفعة واحدة بعد أن ينتهي الخادم من تخزينها مؤقتا؛ يمتلك العميل بعد ذلك التحقق من الصحة: يمكن لمحللات SDK المتسامحة إرجاع إدخال مقطوع بصمت بدلا من إثارة خطأ، لذا تحقق من صحة كل إدخال أداة محلل مقابل مخططها قبل تشغيله (يقوم بذلك مساعدو التشغيل المكتوبون مثل `betaZodTool` / `typed @beta_tool`؛ يجب أن تتحقق أدوات `betaTool()` JSON-Schema والحلقات اليدوية من صحتها)، تعامل مع الفشل ك JSON غير صالح (خطأ `INVALID_JSON` `tool_result` عندما تحتفظ بالكتلة، أعد الإصدار بخلاف ذلك)، تحقق من أسباب التوقف `max_tokens` / `refusal` قبل تشغيل الأدوات، والتقط فقط خطأ JSON الخاص ب SDK، وليس أخطاء API المكتوبة أبدا - النمط في `shared/tool-use-concepts.md` -> البث المسبق للمدخلات. اتركه معطلا للطلبات غير المتدفقة، ولأدوات الخادم، وعندما يمر الطلب عبر وكيل أو نشر نموذج Bedrock أقدم يرفض الحقل.
## تحذير: انحراف API - قد تكون أولويات تدريبك قديمة
تغيرت عدة أشكال شائعة ل Claude API في 2025-2026. إذا كنت تتذكر نمطا من التدريب، فتحقق منه مقابل ملفات `{lang}/` في هذه المهارة قبل الكتابة - الصفوف أدناه هي نقاط الانحراف الأكثر تكرارا:
| المنطقة | الأولوية القديمة | API الحالي | |---|---|---| | التفكير الموسع | `thinking: {type: "enabled", budget_tokens: N}` | على نماذج Claude 4.6+: `thinking: {type: "adaptive"}`. تم إهمال `budget_tokens` على Opus 4.6 / Sonnet 4.6 و**يتم رفضه بخطأ 400** على Fable 5/5.1 / Sonnet 5.5 / Sonnet 5 / Opus 5.5 / 5 / 4.8 / 4.7. لا تزال النماذج ما قبل 4.6 تستخدم `budget_tokens`. |
التثبيت
شغل هذا الأمر
npx skills add anthropics/skillsيعمل مع
خطوات التثبيت
ثبت باستخدام `npx skills add anthropics/skills`، أو استنسخ المستودع وانسخ مجلد `skills/claude-api` إلى دليل مهارات Claude الخاص بك.
أسئلة شائعة
ما هي مهارة واجهة برمجة تطبيقات Claude؟
مرجع ل Claude API / Anthropic SDK — معرفات النماذج، التسعير، المعاملات، البث، استخدام الأدوات، MCP، الوكلاء، التخزين المؤقت، عد الرموز، ترحيل النماذج. المحفز — اقرأ قبل فتح الملف الهدف؛ لا تتخطاه لأنه "يبدو سطرا واحدا" — كلما: يذكر الموجه Claude/Anthropic بأي شكل (Claude, Anthropic, Fable, Opus, Sonnet, Haiku, `anthropic`, `@anthropic-ai`, `claude-*`, `us.anthropic.*`, `[1m]`)؛ يسأل المستخدم عن LLM (التسعير/اختيار ا…
كيف أثبت واجهة برمجة تطبيقات Claude؟
شغل هذا الأمر في الطرفية:
npx skills add anthropics/skillsمع أي أدوات ذكاء اصطناعي تعمل واجهة برمجة تطبيقات Claude؟
تعمل مع claude_app، claude_code، claude_api، cursor، codex، windsurf، cline، zed.
من طور واجهة برمجة تطبيقات Claude؟
طورها anthropics، وتصدر بترخيص Complete terms in LICENSE.txt.
هل واجهة برمجة تطبيقات Claude مجانية؟
نعم، يمكنك استخدامها مجانا وفق ترخيص Complete terms in LICENSE.txt.
npx skills add microsoft/azure-skills
npx skills add prime-skills/runcomfy-agent-skills
npx skills add genmedia-labs/skills
npx skills add genmedia-labs/skills
git clone https://github.com/anthropics/knowledge-work-plugins && cp -r knowledge-work-plugins/finance/skills/variance-analysis ~/.claude/skills/
git clone https://github.com/microsoft/azure-skills && cp -r azure-skills/.github/plugins/aks-skills/skills/aks-troubleshooting ~/.claude/skills/
افحص قبل التثبيت
شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.
مختبر وكلاء الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
فحص أمني تلقائي للموقع
الأمان
اختبار جودة المحتوى العربي بالذكاء الاصطناعي
جودة المحتوى
كاشف منصة الموقع
الترحيل
محلل سرعة الصفحة
الأداء
تدقيق الظهور في محركات الذكاء الاصطناعي
الظهور في الذكاء الاصطناعي
مولد ملف llms.txt
الظهور في الذكاء الاصطناعي
منشئ البيانات المنظمة
الظهور في الذكاء الاصطناعي
مقياس سهولة القراءة بالعربية
جودة المحتوى
حاسبة تكاليف الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
محلل العناوين العربية
جودة المحتوى