1في جملة واحدة
API هي الطريقة التي يتحدث بها برنامج مع Claude مباشرة: يرسل رسالة ويحصل على إجابة على شكل بيانات، حتى تتمكن من بناء Claude داخل تطبيقك أو موقعك أو سير عملك.
2كلمات جديدة
- API (واجهة برمجة التطبيقات) — باب للبرامج. بدلًا من نافذة دردشة، يرسل كودك طلبات ويستقبل ردودًا.
- مفتاح API (API key) — سلسلة سرية طويلة تعرّف حسابك. أي شخص يملكها يستطيع إنفاق أموالك؛ عامله ككلمة مرور.
- الطلب والرد (Request and response) — ما ترسله (الرسالة، النموذج (model)، الإعدادات) وما يعود إليك (الإجابة بالإضافة إلى معلومات مثل عدد الرموز (tokens) المستخدمة).
- الرمز (Token) — الوحدة التي يعدّ بها Claude النص، نحو ثلاثة أرباع كلمة. تدفع لكل رمز داخل وخارج.
- لوحة التحكم (Console) — موقع Anthropic للمطورين، حيث تحصل على المفاتيح وترى الاستخدام وتضع حدود الإنفاق.
3لماذا تحتاجه
كل ما في هذا الدليل حتى الآن هو شخص يتحدث مع Claude. أما API فهي Claude داخل شيء ما: بوت دعم على موقعك، أداة تلخّص كل مستند وارد، تقرير ليلي. الدفع حسب الاستخدام، وأرخص النماذج تكلف جزءًا من السنت لكل طلب.
4جرّبه الآن
(حساب مطوّر لدى Anthropic)
- أنشئ حسابًا في لوحة تحكم المطورين، وأضف مبلغًا صغيرًا من الرصيد، وضع حدًا شهريًا للإنفاق، وأنشئ مفتاح API. (خطط Max وUltra وTeam تتضمن الآن رصيد API شهريًا؛ اطلبه من Billing في إعدادات Claude بربط حساب في لوحة التحكم.)
- في منصة العمل (workbench) داخل لوحة التحكم، أرسل رسالة تجريبية إلى أصغر نموذج واقرأ الرد.
- اطلب من Claude Code: اكتب سكربتًا من 20 سطرًا يرسل رسالة إلى Claude API باستخدام مفتاحي من متغير بيئة، ويطبع الإجابة. شغّله.
5ماذا سترى
[الصورة قيد الإعداد: منصة العمل في لوحة التحكم مع طلب ورده.] رد يحتوي على نص الإجابة، وأي نموذج أجاب، ولماذا توقف، وأعداد الرموز. يطبع سكربتك النص. وتعرض لوحة التحكم التكلفة.
6انتبه
- لا تلصق مفتاحًا أبدًا في الدردشة، أو في كود تشاركه، أو في ملف داخل مستودع. احفظه في متغير بيئة أو مخزن أسرار.
- ضع حدًا للإنفاق قبل أول استخدام حقيقي. حلقة تستدعي API بالخطأ قد تنفق بسرعة.
- النماذج القديمة تتقاعد. في 30 نوفمبر 2026 يتوقف Claude Sonnet 4.5 عن العمل على API، ويُزال الوضع السريع (fast mode) لـ Opus 4.8؛ انقل سكربتاتك إلى Sonnet 5.5 أو Opus 5.5.
7خطوة أبعد
غيّر اسم النموذج والإعدادات في سكربتك وقارن الإجابات والتكلفة. الفصل 6.7 يسرد ميزات API التي تصنع الفرق بين عرض تجريبي ومنتج.