كيفية استخدام مفتاح واجهة برمجة تطبيقات Claude: دليل كامل 2025

\n\n## مقدمة

Claude هو مساعد ذكاء اصطناعي قوي تم تطويره بواسطة Anthropic، وهو قادر على أداء مجموعة واسعة من المهام، من إنشاء محتوى إبداعي إلى تقديم تفسيرات مفصلة. للوصول إلى قدرات Claude برمجيًا، تحتاج إلى مفتاح API. سيرشدك هذا الدليل خلال عملية الحصول على مفتاح API الخاص بـ Claude واستخدامه، مع تقديم خطوات واضحة وقابلة للتنفيذ.

يفترض هذا الدليل أن لديك فهمًا أساسيًا لمفاهيم البرمجة وأنك على دراية باستخدام واجهات برمجة التطبيقات (APIs). لا يشترط وجود خبرة سابقة في التعامل مع Claude. بنهاية هذا البرنامج التعليمي، ستكون قادرًا على المصادقة باستخدام واجهة برمجة تطبيقات Claude وإجراء أول استدعاء API لك.

المتطلبات الأساسية

قبل أن تبدأ، تأكد من أن لديك ما يلي:

• حساب Anthropic: أنت بحاجة إلى حساب لدى Anthropic للوصول إلى واجهة برمجة التطبيقات الخاصة بهم. انتقل إلى موقع Anthropic وقم بالتسجيل للحصول على حساب.
• مفتاح API: تحتاج إلى الحصول على مفتاح API من Anthropic. هذا المفتاح ضروري لمصادقة طلباتك إلى واجهة برمجة تطبيقات Claude.
• بيئة البرمجة: اختر لغة برمجة (مثل Python أو Node.js) وقم بإعداد بيئة التطوير الخاصة بك. سيستخدم هذا الدليل Python بشكل أساسي في الأمثلة.
• مدير الحزم: تأكد من تثبيت مدير حزم لديك (مثل pip لـ Python أو npm لـ Node.js).
• معرفة أساسية بالبرمجة: الفهم الأساسي لمفاهيم البرمجة، مثل المتغيرات والدوال وإجراء طلبات HTTP، أمر ضروري.

الخطوة 1: التسجيل للحصول على حساب Anthropic

إذا لم يكن لديك حساب Anthropic بالفعل، فستحتاج إلى إنشاء حساب.

1. زيارة موقع Anthropic: انتقل إلى موقع Anthropic الرسمي (anthropic.com).
2. التسجيل: ابحث عن زر "Sign Up" أو "Get Started". قد تختلف الصياغة الدقيقة.
3. تقديم المعلومات: املأ المعلومات المطلوبة، مثل اسمك وعنوان بريدك الإلكتروني وكلمة المرور.
4. التحقق من بريدك الإلكتروني: تحقق من صندوق بريدك الإلكتروني بحثًا عن رسالة تحقق بالبريد الإلكتروني من Anthropic. انقر فوق رابط التحقق لتأكيد حسابك.
5. إكمال الملف الشخصي (إذا لزم الأمر): قد تتطلب منك بعض المنصات إكمال معلومات ملفك الشخصي بعد التحقق من بريدك الإلكتروني.

الخطوة 2: الحصول على مفتاح API الخاص بـ Claude

بمجرد حصولك على حساب Anthropic، يمكنك الحصول على مفتاح API الخاص بك.

1. تسجيل الدخول: قم بتسجيل الدخول إلى حساب Anthropic الخاص بك على موقعه على الويب.
2. الانتقال إلى إعدادات API: ابحث عن قسم متعلق بـ "API Keys" أو "Developers" أو "Account Settings". قد يختلف الموقع اعتمادًا على تصميم موقع Anthropic.
3. إنشاء مفتاح API: انقر فوق خيار إنشاء مفتاح API جديد. قد تحتاج إلى تقديم اسم أو وصف للمفتاح.
4. النسخ والتخزين بشكل آمن: بمجرد إنشاء المفتاح، انسخه إلى مكان آمن. هذا أمر بالغ الأهمية لأنك لن تتمكن من رؤية المفتاح مرة أخرى بعد إغلاق الصفحة. قم بتخزينه بشكل آمن، كما هو الحال في مدير كلمات المرور، وتجنب الالتزام به في أنظمة التحكم في الإصدار مثل Git.

الخطوة 3: إعداد بيئة البرمجة الخاصة بك

الآن، قم بإعداد بيئة البرمجة الخاصة بك لاستخدام واجهة برمجة تطبيقات Claude. سنستخدم Python في هذا المثال.

1. تثبيت Python: إذا لم يكن لديك Python مثبتًا، فقم بتنزيل وتثبيت أحدث إصدار من موقع Python الرسمي (python.org).

2. تثبيت مكتبة Anthropic Python: افتح الطرفية أو موجه الأوامر الخاص بك واستخدم pip لتثبيت مكتبة Anthropic Python:

   pip install anthropic
   

   يقوم هذا الأمر بتنزيل وتثبيت مكتبة Python الضرورية للتفاعل مع واجهة برمجة تطبيقات Claude.

3. التحقق من التثبيت: للتحقق من تثبيت المكتبة بشكل صحيح، قم بتشغيل الأمر التالي في الطرفية:

   pip show anthropic
   

   يجب أن يعرض هذا معلومات حول مكتبة Anthropic المثبتة، بما في ذلك إصدارها وموقعها.

الخطوة 4: المصادقة باستخدام واجهة برمجة تطبيقات Claude

قبل أن تتمكن من استخدام واجهة برمجة تطبيقات Claude، تحتاج إلى مصادقة طلباتك باستخدام مفتاح API الخاص بك.

1. استيراد مكتبة Anthropic: في برنامج Python النصي الخاص بك، قم باستيراد مكتبة Anthropic:

   import anthropic
   

2. تعيين مفتاح API: قم بتعيين متغير البيئة ANTHROPIC_API_KEY أو قم بتمرير مفتاح API مباشرة عند إنشاء العميل.

   الخيار 1: استخدام متغير البيئة (موصى به):

   قم بتعيين متغير البيئة ANTHROPIC_API_KEY في نظام التشغيل الخاص بك. هذا يمنعك من ترميز المفتاح في البرنامج النصي الخاص بك.

   • Linux/macOS:

     export ANTHROPIC_API_KEY="YOUR_API_KEY"
     

   • Windows:

     set ANTHROPIC_API_KEY=YOUR_API_KEY
     

   استبدل YOUR_API_KEY بمفتاح API الفعلي الذي حصلت عليه من Anthropic.

   الخيار 2: تمرير مفتاح API مباشرة (أقل أمانًا):

   يمكنك تمرير مفتاح API مباشرة عند إنشاء عميل Anthropic، لكن هذا أقل أمانًا وغير موصى به لبيئات الإنتاج.

   client = anthropic.Anthropic(api_key="YOUR_API_KEY")
   

   استبدل YOUR_API_KEY بمفتاح API الفعلي الخاص بك.

3. إنشاء عميل Anthropic: قم بإنشاء مثيل لفئة Anthropic للتفاعل مع واجهة برمجة التطبيقات:

   client = anthropic.Anthropic() # افتراض تعيين ANTHROPIC_API_KEY
   

   إذا كنت تستخدم طريقة متغير البيئة، فسوف يلتقط العميل مفتاح API تلقائيًا من البيئة.

الخطوة 5: إجراء أول استدعاء API لك

الآن بعد أن تمت المصادقة، يمكنك إجراء أول استدعاء API لك إلى واجهة برمجة تطبيقات Claude. سنستخدم نقطة النهاية messages.create لإرسال رسالة إلى Claude وتلقي رد.

1. إعداد المطالبة الخاصة بك: قم بإنشاء مطالبة لإرسالها إلى Claude. يجب أن تكون المطالبة واضحة وموجزة، وتخبر Claude بما تريد أن تفعله.

   prompt = "اكتب قصيدة قصيرة عن المحيط."
   

2. استدعاء نقطة النهاية messages.create: استخدم طريقة messages.create لإرسال المطالبة الخاصة بك إلى Claude وتلقي رد.

   message = client.messages.create(
       model="claude-3-opus-20240229", # استبدل بالنموذج الذي تريده
       max_tokens=1024,
       messages=[{"role": "user", "content": prompt}],
   )
   

   • model: يحدد نموذج Claude الذي تريد استخدامه. تحقق من وثائق Anthropic للحصول على أحدث النماذج المتاحة.
   • max_tokens: يحدد الحد الأقصى لعدد الرموز المميزة في الاستجابة التي تم إنشاؤها.
   • messages: قائمة بالرسائل التي تمثل سجل المحادثة. تحتوي كل رسالة على role (إما "user" أو "assistant") و content.

3. طباعة الرد: اطبع محتوى الرد لترى ما أنشأه Claude.

   print(message.content[0].text)
   

   سيؤدي هذا إلى طباعة القصيدة التي تم إنشاؤها بواسطة Claude.

الخطوة 6: مثال على التعليمات البرمجية الكاملة

إليك كود Python الكامل لإجراء استدعاء API إلى واجهة برمجة تطبيقات Claude: