كيفية الحصول على مفتاح API أنثروبيك وإجراء أول طلب لكلود

مفتاح API الخاص بـ Anthropic هو بيانات الاعتماد التي ترسلها مع كل طلب إلى Claude API. يبدأ بـ sk-ant-، وتقوم بإنشائه في وحدة تحكم Claude Console، ويتم احتساب الاستخدام مقابل أرصدة مؤسستك المدفوعة مسبقًا. إذا لم يسبق لك التعامل مع أحدها، فإن مقدمتنا حول ما هو مفتاح API تغطي الفكرة العامة. يغطي هذا الدليل الفكرة المحددة: إنشاء حساب Console، تحميل الأرصدة، إنشاء مفتاح بالنطاق الصحيح، إرسال أول طلب رسائل باستخدام curl وحزمة Python SDK، والحفاظ على المفتاح آمنًا بعد ذلك.

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

ما تحتاجه قبل أن تبدأ

• بريد إلكتروني لوحدة تحكم Claude على platform.claude.com (الآن console.anthropic.com يعيد التوجيه إليه).

• بطاقة دفع. الـ API مدفوع مسبقًا، ويمكن للمسؤول أو دور الفوترة فقط شراء الأرصدة.
• curl، أو Python 3.10+ لمثال SDK.
• Apidog لتخزين المفتاح كمتغير محلي وحفظ الطلب كاختبار قابل للتكرار. الخطة المجانية تغطي فرقًا تصل إلى أربعة أفراد.

الخطوة 1: إنشاء حساب في Claude Console

سجل في platform.claude.com. يؤدي ذلك إلى إنشاء مؤسسة بها مساحة عمل افتراضية (Default Workspace)، وتتعلق بها مفاتيحك وأرصدتك وحدود المعدل. إذا كان أحد زملائك قد قام بإنشاء حساب بالفعل، فاطلب دعوة بدلاً من إنشاء مؤسسة ثانية: فالأرصدة ومستويات الاستخدام لا تنتقل.

الخطوة 2: إضافة أرصدة قبل اتصالك الأول

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

افتح Settings > Billing (الإعدادات > الفوترة) وانقر على Buy credits (شراء أرصدة). قم بتشغيل إعادة التحميل التلقائي (auto-reload) إذا كنت تدير أي شيء دون مراقبة. راجع كيفية شراء الأرصدة للاطلاع على الخطوات الحالية. تنضم مؤسستك أيضًا إلى مستوى استخدام مع حد أقصى للإنفاق الشهري، والذي يتم تغطيته في قسم حدود المعدل.

الخطوة 3: إنشاء مفتاح API

انتقل إلى Settings > API keys (الإعدادات > مفاتيح API) وانقر على Create key (إنشاء مفتاح). أربعة خيارات مهمة:

• Name (الاسم): سمه باسم التطبيق، وليس الشخص. orders-service-staging أفضل من مفتاحي.
• Expiration (انتهاء الصلاحية): من 3 ساعات إلى 30 يومًا، مخصص، أو أبدًا. اختر مدة قصيرة للاختبار؛ لا يمكن تغييرها لاحقًا.
• Linked account (الحساب المرتبط): نفسك لمفتاح شخصي، أو حساب خدمة لأي شيء مشترك. يموت المفتاح الشخصي عند مغادرتك للمؤسسة.
• Workspace (مساحة العمل): حددها لمساحة عمل واحدة ويمكنك تخطي رأس anthropic-workspace-id. يجب على المفتاح متعدد مساحات العمل إرساله في كل طلب وإلا ستحصل على 400.

تعرض وحدة التحكم المفتاح كاملاً مرة واحدة فقط، لذا انسخه مباشرة إلى مدير أسرارك. لا يوجد زر إظهار. إذا كان زر Create key (إنشاء مفتاح) رماديًا، فهذا يعني أن دورك لا يسمح بإنشاء المفاتيح؛ اطلب من مسؤول.

الخطوة 4: رؤوس الطلب الثلاثة التي يحتاجها كل طلب

كل استدعاء إلى POST https://api.anthropic.com/v1/messages يحمل ثلاثة رؤوس:

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

الخطوة 5: إرسال أول طلب رسائل لك

يحتاج النص الأساسي (body) إلى model و max_tokens و messages. استخدم معرف نموذج حالي: اعتبارًا من سبتمبر 2026، هو claude-opus-5 (الموصى به افتراضيًا)، claude-fable-5-1 (الأكثر قدرة)، claude-sonnet-5، و claude-haiku-4-5. المعرفات القديمة 3.x و 4.x تعيد 404 أو تشير إلى نماذج متقاعدة، والمعرفات الحالية لا تحمل لاحقة تاريخ. دليل Claude Opus 5 API يتعمق في التفكير والجهد والتدفق.

curl

export ANTHROPIC_API_KEY="sk-ant-api03-..."

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-opus-5",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "Write a one-sentence OpenAPI description for POST /orders, which creates an order and returns 201."}
    ]
  }'

استجابة ناجحة، مختصرة:

{
  "id": "msg_01...",
  "role": "assistant",
  "model": "claude-opus-5",
  "content": [{"type": "text", "text": "Creates a new order and returns it with a 201 status."}],
  "stop_reason": "end_turn",
  "usage": {"input_tokens": 31, "output_tokens": 24}
}

اقرأ النص من content[].text، وتحقق من أن stop_reason هو end_turn، واحتفظ بـ usage لتتبع التكلفة. رأس الاستجابة request-id هو ما يطلبه الدعم عندما يفشل شيء ما.

حزمة Python SDK

pip install anthropic

import anthropic

client = anthropic.Anthropic()  # reads ANTHROPIC_API_KEY from the environment

message = client.messages.create(
    model="claude-opus-5",
    max_tokens=1024,
    messages=[{
        "role": "user",
        "content": "Write a one-sentence OpenAPI description for POST /orders, which creates an order and returns 201.",
    }],
)

for block in message.content:
    if block.type == "text":
        print(block.text)

تقرأ حزمة SDK متغير البيئة ANTHROPIC_API_KEY، وتضيف رؤوس الإصدار ونوع المحتوى، وتعيد محاولة 429 و 5xx مرتين مع التراجع. لا تمرر المفتاح كقيمة حرفية (string literal) أبدًا؛ فمتغير البيئة هو الغرض الرئيسي.

الخطوة 6: تخزين واختبار المفتاح في Apidog

المفتاح الملصق في الشل يعيش في ملف السجل الخاص بك. المفتاح المخزن في طلب مشترك يتزامن مع الزملاء. يفصل Apidog بين الاثنين: يتم مشاركة هيكل الطلب، ويبقى السر على جهازك.

تخزين المفتاح كمتغير محلي. افتح Environment Management (إدارة البيئة)، أنشئ بيئة باسم Anthropic، وأضف متغيرًا باسم ANTHROPIC_API_KEY. اترك القيمة المشتركة كـ SET_LOCALLY والصق المفتاح الحقيقي في القيمة المحلية، التي تبقى في ذاكرة التخزين المؤقت لعميلك ولا تتم مزامنتها أبدًا. يغطي دليلنا حول بيئات Apidog والمتغيرات السرية قواعد النطاق.

تعيين الرؤوس مرة واحدة. في نفس اللوحة، أضف معايير عامة تحت Headers (الرؤوس): x-api-key مع تعيينه إلى {{ANTHROPIC_API_KEY}}، و anthropic-version مع تعيينه إلى 2023-06-01. تنطبق هذه على كل طلب في المشروع، ويضيف Apidog content-type تلقائيًا لهيكل JSON.

إرسال الطلب الأول. طلب جديد، POST إلى https://api.anthropic.com/v1/messages، الصق هيكل JSON من مثال curl، ثم أرسل. افتح علامة التبويب Actual Request (الطلب الفعلي) لتأكيد أن كلا الرأسين قد أُرسلا مع حل المتغير. هذه العلامة التبويب هي أسرع طريقة لإثبات أن 401 هي مشكلة في الرأس، وليست مشكلة في المفتاح.

احفظه كاختبار. احفظ الطلب كحالة نقطة نهاية، ثم أضف ثلاثة تأكيدات: الحالة تساوي 200، stop_reason يساوي end_turn، و usage.output_tokens أكبر من 0. قم بتشغيله من سطر أوامر Apidog وادخل المفتاح من مخزن أسرار CI الخاص بك في وقت التشغيل. هذا اختبار دخان بنقرة واحدة للمفتاح، الرؤوس، ومعرف النموذج. قم بتنزيل Apidog للمتابعة؛ الخطة المجانية تشمل أربعة مقاعد.

حدود المعدل وتكلفة الطلب

الحدود هي لكل مؤسسة ولكل نموذج: طلبات في الدقيقة (RPM)، رموز إدخال في الدقيقة (ITPM)، ورموز إخراج في الدقيقة (OTPM). الرموز المدخلة غير المخزنة مؤقتًا فقط هي التي تحتسب ضمن ITPM، لذلك يزيد التخزين المؤقت للمطالبات من الإنتاجية دون تغيير المستوى. من وثائق حدود المعدل:

يتشارك Sonnet 5 و Haiku 4.5 أرقام Opus 5 في كل مستوى. تحمل كل استجابة رؤوس anthropic-ratelimit-*-remaining و -reset، لذا يمكنك مراقبة المساحة المتبقية دون الحاجة إلى استطلاع وحدة التحكم.

لكل مليون رمز، من صفحة الأسعار: Opus 5 يكلف 5 دولارات إدخال / 25 دولارًا إخراج، Sonnet 5 يكلف 2 دولار / 10 دولارات، Fable 5.1 يكلف 10 دولارات / 50 دولارًا، Haiku 4.5 يكلف 1 دولار / 5 دولارات. قراءات ذاكرة التخزين المؤقت تكلف 10% من الإدخال (2.5% على Fable 5.1) ويخفض Batch API كلا الجانبين إلى النصف. يكلف طلب curl الأول جزءًا من سنت.

الأخطاء الشائعة وكيفية إصلاحها

تأتي الأخطاء بتنسيق JSON مع error.type و request_id. مرجع الأخطاء يسرد كل رمز؛ هذه هي الأخطاء التي ستواجهها أولاً.

صيانة المفتاح: التدوير، النطاق، وعدم وجوده أبدًا في كود العميل

لا ترسل المفتاح أبدًا إلى متصفح أو تطبيق جوال. أي شيء في حزمة JavaScript أو APK يصبح عامًا في غضون دقائق. ضع الاستدعاء خلف الواجهة الخلفية الخاصة بك. لتطبيقات Apple التي يجب أن تستدعي Claude مباشرة، يصدر App Attest رموزًا قصيرة الأجل للبنيات الموثقة بدلاً من مفتاح ثابت.

مفتاح واحد لكل تطبيق وبيئة. تفصل مفاتيح التدريج والإنتاج في مساحات عمل منفصلة مما يتيح لك تحديد سقف الإنفاق للتدريج وإلغاء مفتاح دون التأثير على الآخر.

التدوير بجدول زمني. أنشئ المفتاح الجديد، انشره، تأكد من عمله، ثم احذف المفتاح القديم. التعطيل (Disable) قابل للإلغاء؛ الحذف (Delete) دائم. إذا شككت في وجود تسرب، قم بالتعطيل أولاً ثم التحقيق ثانيًا. ماسح الأسرار في مستودعك يلتقط المفاتيح التي تم التعهد بها قبل أن يلاحظ أحد.

تفضل بيانات الاعتماد قصيرة الأجل في الإنتاج. يقوم Workload Identity Federation بتبديل رمز الهوية الخاص بمزود السحابة الخاص بك برمز Claude قصير الأجل، لذلك لا يوجد سلسلة sk-ant- لتتسرب على الإطلاق.

الأسئلة الشائعة

هل مفتاح API الخاص بـ Anthropic هو نفسه مفتاح API الخاص بـ Claude؟

نعم. تقول وحدة التحكم (Console) وحزم SDK والوثائق الآن "Claude API"، وتنسيق المفتاح ورؤوس الطلب متطابقة. تشير الدروس التعليمية القديمة التي تقول "Anthropic API key" إلى نفس بيانات الاعتماد.

هل يمكنني الحصول على مفتاح API خاص بـ Anthropic مجانًا؟

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

هل يشمل اشتراك Claude Pro أو Max الوصول إلى API؟

لا. يتم احتساب اشتراكات Claude.ai وأرصدة Console API بشكل منفصل. تحتاج إلى مؤسسة Console بها أرصدة، حتى لو كنت تدفع بالفعل لـ Claude.ai.

ماذا يحدث عندما تنتهي صلاحية مفتاحي؟

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

الخطوة التالية

أنشئ المفتاح بمدة صلاحية 7 أيام، وضعه في متغير محلي في Apidog، وقم بتشغيل اختبار الدخان، وفقط بعد ذلك قم بتوصيله بالرمز. إذا نجح ذلك، فبيانات الاعتماد ورؤوس الطلب ومعرف النموذج كلها صحيحة، وكل خطأ 401 بعد ذلك سيكون مشكلة حقيقية بدلاً من خطأ مطبعي.