ربط Cursor / Claude Code / Cherry Studio ببوابة AI مخصصة

درس تعليمي · 2026-11-20 · 7 دقائق قراءة

الأدوات الذكية الرئيسية كلها تدعم API المخصص — أي يمكنك توجيهها إلى بوابتك الخاصة (مثل 4-4 AI) وتوحيد المفاتيح والفوترة. تغطي هذه المقالة إعداد أدوات الاستخدام الأوسع الثلاث والمنهج العام لتشخيص الأخطاء.

شرط مسبق: لديك مفتاح API بالفعل. إن لم يكن، أكمل أولًا التسجيل وإنشاء المفتاح عبر «الاتصال بواجهة AI موحدة في 5 دقائق». تستخدم المقالة كمثال Base URL الخاص بـ 4-4 AI (https://www.4-4.vip/v1)، وبوابات OpenAI المتوافقة الأخرى تعمل بالطريقة نفسها.

Cursor

نموذج المحادثة في Cursor يمكن أن يعمل عبر واجهة مخصصة متوافقة مع OpenAI:

  1. افتح Settings → Models (أو صفحة إعدادات Models)؛
  2. وسّع منطقة OpenAI API Key: أدخل مفتاح البوابة (sk-...)؛
  3. علّم/املأ Override OpenAI Base URL: https://www.4-4.vip/v1؛
  4. أضف إلى قائمة النماذج الأسماء المتاحة في بوابتك (مطابقة تمامًا لأسماء قنوات البوابة، مع حساسية لحالة الأحرف)؛
  5. بعد نجاح التحقق Verify، بدّل في أسفل المحادثة إلى النموذج المخصص فقط.

ملاحظة: الإكمال Tab المدمج في Cursor وجزء من Composer يسيران عبر خدمة Cursor الذاتية ولا تتأثر بهذا الإعداد؛ النماذج المخصصة تُستخدم أساسًا في المحادثة.

Claude Code

يستخدم Claude Code بروتوكول Anthropic. شرط المرور عبر البوابة أن تدعم البوابة نقطة نهاية بروتوكول Anthropic (/v1/messages) — البوابات المبنية على منظومة new-api (ومنها 4-4 AI) تدعم هذا التحويل؛ تُحوَّل طلبات بروتوكول Claude ثم تُوجَّه إلى قناة النموذج الفعلية.

الإعداد عبر متغيرات البيئة (في الطرفية التي تشغّل claude من خلالها):

export ANTHROPIC_BASE_URL="https://www.4-4.vip"
export ANTHROPIC_AUTH_TOKEN="sk-YOUR_GATEWAY_KEY"

# start
claude

وفي Windows PowerShell:

$env:ANTHROPIC_BASE_URL = "https://www.4-4.vip"
$env:ANTHROPIC_AUTH_TOKEN = "sk-YOUR_GATEWAY_KEY"
تفصيلان: ① ANTHROPIC_BASE_URL بلا لاحقة /v1 (مسار بروتوكول Anthropic يبنيه أدوات الاستدعاء تلقائيًا)؛ ② إن أردت أن يستخدم Claude Code نماذج من خارج عائلة Claude، تأكد من أن قناة البوابة عليها تعيين النماذج المناسب واستخدم الأسماء من جانب البوابة.

Cherry Studio

Cherry Studio هو الأكثر مباشرةً في دعم المزودين المخصصين المتوافقين مع OpenAI:

  1. الإعدادات ← خدمات النماذج: أضف/اختر مزودًا متوافقًا مع OpenAI؛
  2. عنوان API: https://www.4-4.vip/v1 (بعض الإصدارات تكمل /v1 تلقائيًا، انتبه إلى التكرار)؛
  3. مفتاح API: مفتاح البوابة؛
  4. أضف يدويًا أسماء النماذج المتاحة في إدارة النماذج، ثم اخترها في المحادثة بعد الحفظ.

القاعدة العامة: أي أداة متوافقة مع OpenAI

عشرات الأدوات (LobeChat وOpen WebUI وImmersive Translate وإضافات IDE المختلفة) تتبع المخطط نفسه في الإعداد — احفظ الثلاثية:

عنصر الإعدادالقيمةفخاخ شائعة
Base URLhttps://www.4-4.vip/v1بعض الأدوات تحتاج /v1 وبعضها لا — عند ظهور 404 جرّب بإضافة /v1 وإزالتها
API Keyمفتاح البوابة (sk-...)مسافات في البداية أو النهاية، مفتاح منتهٍ، رصيد مستنفد
اسم النموذجالاسم كما هو في قناة البوابةيجب أن يطابق جانب البوابة تمامًا؛ الأسماء غير الموجودة في إعدادات الأداة المسبقة لن تعمل

دليل سريع للأخطاء

401 Unauthorized

404 Not Found

400 Model Not Found / لا قناة متاحة

التدفق ينقطع / لا استجابة

الأسئلة الشائعة (FAQ)

هل بياناتي آمنة عند المرور عبر البوابة؟

تنتقل طلباتك عبر البوابة إلى قناة النموذج الأمامية. تحقق من سياسات السجلات والخصوصية للبوابة عند اختيارها؛ ومع البيانات الحساسة أوقف تخزين سجلات المحادثات من جانب البوابة أو استخدم قنوات لا تحتفظ بالبيانات.

هل يمكن إعداد عدة بوابات في أداة واحدة؟

معظم الأدوات تدعم عدة مزودين مع تبديل فوري (مثل Cherry Studio وCursor). وبتعيين رمز مختلف لكل أداة تنفصل أيضًا إحصاءات الاستخدام وحدود الحصص.

لماذا يُنصح ببوابة موحدة بدل اتصال كل أداة مباشرة بمزودها؟

ثلاثة أسباب: إدارة مركزية للمفاتيح (تضييق مساحة التسرب)، فوترة واستخدام مرئيان في مكان واحد (بلا مطابقة بين منصات متعددة)، نماذج قابلة للاستبدال في أي وقت (فصل عن المزود — التغيير يمس إعداد البوابة فقط).

مقالات ذات صلة

ابدأ بسرعة مع 4-4 AI: اتصل بواجهة AI موحدة في 5 دقائق واجهة متوافقة مع OpenAI: مفتاح واحد لنماذج GLM وDeepSeek وQwen وغيرها. أمثلة قابلة للتنفيذ بثلاث لغات. 7 ممارسات هندسية لخفض تكلفة رموز التطبيقات الذكية توجيه حسب مستوى النموذج، واقتطاع السياق، والتخزين المؤقت للبادئات، وقيود الميزانية — سبع ممارسات دائمة يمكن بر
هل أنت مستعد للاتصال؟

مفتاح واحد للاتصال الموحد بنماذج GLM وDeepSeek وQwen وغيرها: فوترة موحدة واستخدام مرئي.

عرض النماذج والأسعار جرّب مجانًا