استخدام مفتاح Claude API في تطبيق دون برمجة

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

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

من المفيد أن تعرف أي حساب من Anthropic تستخدم. تطبيقات Claude على claude.ai، بخططها Free و Pro و Max، اشتراكات للاستخدام العادي. أما Claude Console على platform.claude.com فهو منصة المطورين، وفيها مفاتيح الـ API وفوترتها. ويذكر مركز مساعدة Anthropic نفسه أن اشتراك Claude المدفوع لا يشمل الوصول إلى Claude API ولا إلى Console، وأن كلًّا منهما يُشترى على حدة. يمكنك الدخول إلى الاثنين بالبريد نفسه، لكن فوترتهما منفصلة.

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

توثّق Anthropic العملية في صفحة «Get your Claude API key». يُنشأ المفتاح مرة واحدة ولا يمكن عرضه مرة أخرى، لذلك يلزم مكان آمن لحفظه، مثل مدير كلمات المرور.

• الدخول إلى platform.claude.com وتسجيل الدخول، أو إنشاء حساب في Console.
• فتح الإعدادات ثم API keys (platform.claude.com/settings/keys).
• الضغط على Create key، وكتابة اسم تعرفه، مثل «Oriveo على هاتفي»، واختيار تاريخ انتهاء.
• نسخ المفتاح. يبدأ بـ «sk-ant-» ولا يعرض Console المفتاح كاملًا إلا مرة واحدة، عند إنشائه.
• إذا ضاع المفتاح فلا يمكن استرجاعه؛ يُنشأ مفتاح جديد ويُلغى القديم.

الخطوة 2: إضافة رصيد وتحديد سقف

يُدفع استخدام Claude API من رصيد مدفوع مسبقًا. في Console: الإعدادات ثم Billing، ومنها شراء الرصيد؛ يصبح متاحًا بمجرد اكتمال الشراء. ويمكنك اختياريًا تفعيل الشحن التلقائي، فيشتري رصيدًا إضافيًا حين ينزل رصيدك عن حد تختاره. وما دمتَ تتعرف على حجم استخدامك، فإبقاء الشحن التلقائي مغلقًا طريقة بسيطة لتقييد إنفاقك بما دفعته مسبقًا.

يوضع حسابك تلقائيًا في مستوى استخدام معيّن، ولكل مستوى حدود للطلبات (طلبات و tokens في الدقيقة) وسقف شهري للإنفاق. يمكنك رؤية الاثنين في Console، في صفحتي Rate limits و Billing. وفي الدردشة الشخصية نادرًا ما تكون الحدود الأولى هي العائق، لكنها تفسّر خطأ «rate limit» الذي قد يظهر إذا أرسلتَ رسائل طويلة كثيرة في وقت قصير.

كم يكلّف Claude عبر الـ API

يُسعَّر الـ API لكل token، بسعر منفصل لما ترسله (الإدخال) وما يكتبه Claude (الإخراج). يعرض الجدول أسعار Anthropic المنشورة للنماذج الحالية بتاريخ 28 سبتمبر 2026، مع تكلفة تقديرية لرسالة عادية من 2,000 token إدخال و600 token إخراج. الإدخال يشمل الأدوار السابقة من المحادثة، لأن التطبيق يعيد إرسالها مع كل رسالة.

حساب Sonnet 5: 2,000 × $2 ÷ 1,000,000 + 600 × $10 ÷ 1,000,000 = $0.010. رسائلك أنت ستختلف، فالعمود الأخير دليل على الرتبة التقريبية فقط. وفاتورة Anthropic، لا أي تقدير، هي المبلغ النهائي.

الخطوة 3: إضافة المفتاح في Oriveo

Oriveo تطبيق دردشة متعدد النماذج على iPhone و Android والويب، يعمل بمفاتيحك أنت. Anthropic واحد من مزوّديه الرسميين الـ 15، ويظهر ضمن «ربط مباشر بمزودي AI الرسميين». والتسميات في الجدول أدناه هي ما يعرضه التطبيق بالعربية.

يتحقق Oriveo من المفتاح فور «متابعة»، بأن يطلب من Anthropic قائمة النماذج التي يسمح بها المفتاح، ثم يزامن هذه القائمة. فإذا فشل التحقق، وغالبًا بسبب خطأ في النسخ واللصق أو لأن حساب Console بلا رصيد، ستظهر رسالة خطأ ويمكنك تصحيح المفتاح قبل الدردشة. وعلى iPhone، المفتاح الذي يُحفظ ولا يُتحقق منه يُعلَّم بذلك لتراجعه لاحقًا من إعدادات المزوّد.

الخطوة 4: اختيار نموذج وبدء الدردشة

بعد ربط Anthropic تظهر نماذجه في قائمة اختيار النموذج. ويبقى الاختيار بحسب المهمة: Haiku للأسئلة اليومية السريعة، و Sonnet خيارًا قويًا متوازنًا، و Opus أو Fable لأصعب مسائل التفكير والكتابة. ويمكنك تغيير النموذج في منتصف المحادثة، ومنه إلى نماذج مزوّدين آخرين ربطتهم، وتستمر المحادثة مع النموذج الجديد.

في تطبيقَي iPhone و Android، أول مرة ترسل رسالة إلى مزوّد يعرض Oriveo تنبيهًا قصيرًا، «أنت على وشك استخدام Anthropic»، يوضح أن رسالتك ستُرسل إلى Anthropic لتوليد الرد. وعلى كل المنصات تظهر بجانب كل رسالة تكلفتها التقديرية، محسوبة من سعر Anthropic المنشور ومن الـ tokens التي يعلنها الرد.

حماية مفتاحك

مفتاح Anthropic يستطيع إنفاق رصيدك، فعامله معاملة كلمة المرور. يحتفظ Oriveo بمفاتيح المزوّدين على جهازك أو في متصفحك، ولا يخزّنها كسجلات في الحساب. تطبيقا iPhone و Android يرسلان طلبات Claude إلى Anthropic مباشرة، أما تطبيق الويب فيستخدم نقطة تمرير لحظية لا تحتفظ بالمفتاح ولا بمحتوى محادثات BYOK. ولا يضيف Oriveo أي هامش على أسعار Anthropic.

• إنشاء مفتاح لكل تطبيق أو جهاز، لتلغي واحدًا دون أن يتأثر الباقي.
• استخدام رصيد مدفوع مسبقًا دون شحن تلقائي، أو بحد شحن منخفض، ما دمتَ تتعرف على استخدامك.
• مراجعة صفحة الاستخدام في Console بعد أيام ومقارنتها بتقديرات التطبيق.
• إذا لُصق المفتاح في مكان عام، يُلغى في Console ويُنشأ بديل عنه.

مشكلات شائعة وحلولها

أغلب مشكلات الإعداد تعود إلى سبب من قلة قليلة، وتشير رسالة الخطأ عادةً إلى أيها.

• خطأ مصادقة عند الإعداد: المفتاح نُسخ ناقصًا أو أُلغي. يُنسخ من جديد، أو يُنشأ مفتاح جديد.
• خطأ في الفوترة أو الرصيد: حساب Console بلا رصيد. يُشترى رصيد من الإعدادات ثم Billing.
• خطأ تجاوز الحد (rate limit): أُرسلت طلبات كثيرة أو رسائل طويلة جدًا في وقت قصير. الانتظار دقيقة، أو مراجعة حدود مستواك في Console.
• نموذج Claude جديد لا يظهر: تحديث قائمة نماذج المزوّد في التطبيق بعد إطلاق Anthropic له.
• الظن بأن خطة Claude Pro تغطي هذا الاستخدام: هي لا تغطيه. استخدام الـ API يُفوتر دائمًا عبر Console.