Claude API

# بناء تطبيقات مدعومة بنماذج اللغة الكبيرة مع Claude

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

## قبل البدء

امسح الملف المستهدف (أو إذا لم يكن هناك ملف مستهدف، الطلب والمشروع) بحثا عن علامات موفر غير Anthropic — `import openai` أو `from openai` أو `langchain_openai` أو `OpenAI(` أو `gpt-4` أو `gpt-5` أو أسماء ملفات مثل `agent-openai.py` أو `*-generic.py`، أو أي تعليمات صريحة للحفاظ على الكود محايدا من حيث الموفر. إذا وجدت أيا منها، توقف وأخبر المستخدم بأن هذه المهارة تنتج كود Claude/Anthropic SDK؛ اسأل ما إذا كانوا يريدون التبديل إلى Claude أو يريدون تطبيقا غير خاص بـ Claude. لا تعدل ملف غير Anthropic بأكواد SDK خاصة بـ Anthropic.

## متطلبات المخرجات

عندما يطلب منك المستخدم إضافة أو تعديل أو تطبيق ميزة 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 لغة أخرى.

## القيم الافتراضية

ما لم يطلب المستخدم خلاف ذلك:

بالنسبة لإصدار نموذج Claude، يرجى استخدام Claude Opus 4.8، والذي يمكنك الوصول إليه عبر سلسلة النموذج الدقيقة `claude-opus-4-8`. يرجى الافتراضي على استخدام التفكير التكيفي (`thinking: {type: "adaptive"}`) لأي شيء معقد نسبيا. وأخيرا، يرجى الافتراضي على البث لأي طلب قد ينطوي على إدخال طويل أو إخراج طويل أو `max_tokens` مرتفعة — فهذا يمنع الوصول إلى انتهاء انتظار الطلب. استخدم مساعد `.get_final_message()` / `.finalMessage()` الخاص بـ SDK للحصول على الاستجابة الكاملة إذا لم تكن بحاجة إلى التعامل مع أحداث البث الفردية.

---

## أوامر فرعية

إذا كان طلب المستخدم في الأسفل عبارة عن سلسلة أمر فرعي مجردة (بدون نصوص)، ابحث في كل جدول **أوامر فرعية** في هذا المستند — بما في ذلك أي جداول في أقسام مرفقة أدناه — واتبع العمود المطابق مباشرة. يسمح هذا للمستخدمين باستدعاء تدفقات محددة عبر `/claude-api <subcommand>`. إذا لم يطابق أي جدول في المستند، فعامل الطلب كنصوص عادية.

---

## كشف اللغة

قبل قراءة أمثلة الأكواد، حدد اللغة التي يعمل بها المستخدم:

1. **انظر إلى ملفات المشروع** للاستدلال على اللغة:

- `*.py` أو `requirements.txt` أو `pyproject.toml` أو `setup.py` أو `Pipfile` → **Python** — اقرأ من `python/` - `*.ts` أو `*.tsx` أو `package.json` أو `tsconfig.json` → **TypeScript** — اقرأ من `typescript/` - `*.js` أو `*.jsx` (بدون ملفات `.ts`) → **TypeScript** — JavaScript يستخدم نفس SDK، اقرأ من `typescript/` - `*.java` أو `pom.xml` أو `build.gradle` → **Java** — اقرأ من `java/` - `*.kt` أو `*.kts` أو `build.gradle.kts` → **Java** — Kotlin يستخدم Java SDK، اقرأ من `java/` - `*.scala` أو `build.sbt` → **Java** — Scala يستخدم Java SDK، اقرأ من `java/` - `*.go` أو `go.mod` → **Go** — اقرأ من `go/` - `*.rb` أو `Gemfile` → **Ruby** — اقرأ من `ruby/` - `*.cs` أو `*.csproj` → **C#** — اقرأ من `csharp/` - `*.php` أو `composer.json` → **PHP** — اقرأ من `php/`

2. **إذا تم اكتشاف لغات متعددة** (على سبيل المثال، ملفات Python و TypeScript):

- تحقق من اللغة التي يتعلق بها ملف المستخدم الحالي أو السؤال - إذا ظلت غير واضحة، اسأل: "لقد اكتشفت ملفات Python و TypeScript. أي لغة تستخدمها لتكامل Claude API؟"

3. **إذا تعذر استنتاج اللغة** (مشروع فارغ أو بدون ملفات مصدر أو لغة غير مدعومة):

- استخدم AskUserQuestion مع خيارات: Python أو TypeScript أو Java أو Go أو Ruby أو cURL/raw HTTP أو C# أو PHP - إذا كانت AskUserQuestion غير متاحة، افترض أمثلة Python وأشر إلى: "عرض أمثلة Python. أخبرني إذا كنت بحاجة إلى لغة مختلفة."

4. **إذا تم اكتشاف لغة غير مدعومة** (Rust أو Swift أو C++ أو Elixir وغيرها):

- اقترح أمثلة cURL/raw HTTP من `curl/` وأشر إلى أن SDK المجتمع قد توجد - عرض أمثلة Python أو TypeScript كتطبيقات مرجعية

5. **إذا احتاج المستخدم إلى أمثلة cURL/raw HTTP**، اقرأ من `curl/`.

### دعم الميزات الخاص باللغة

| اللغة | أداة المشغل | الوكلاء المدارة | ملاحظات