Cursor محرر شيفرة بالذكاء الاصطناعي واسع الانتشار. وإلى جانب حصة النماذج المدمجة، يتيح إدخال مفتاح API وعنوان Base URL خاصين بك. وبالنسبة للفرق المحلية، فإن ربط Cursor ببوابة موحدة متوافقة مع OpenAI يثبّت مسار الوصول ويجمع الفواتير ويتيح التبديل بين النماذج.

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

ملاحظة: Cursor علامة تجارية لشركة Anysphere, Inc. هذا المقال تقني فقط، ولا توجد علاقة تبعية أو وكالة مع Cursor/Anysphere؛ والواجهة والباقات وقواعد الفوترة مرجعها صفحات Cursor الرسمية.

أولًا: ميّز بين نوعي «Cursor API»

النوع الأول هو API الذي توفره منصة Cursor نفسها، مثل Cloud Agents وواجهات الإدارة، ويُنشأ المفتاح في حساب Cursor لاستدعاء خدمات Cursor. والنوع الثاني هو «مفتاح النموذج الخاص بك» (BYOK): إدخال مفتاح مزوّد النموذج في Cursor ليستخدم المحرر حسابك في استدعاء النموذج. هذا المقال يتناول النوع الثاني.

هناك افتراض يسهل إغفاله: طلبات النماذج في Cursor يمررها خادم Cursor، ولا تتصل من جهازك مباشرة. لذلك يجب أن يكون Base URL عنوانًا متاحًا على الإنترنت العام. وأي بوابة متاحة فقط على الشبكة الداخلية للشركة ستنتهي عادة بمهلة من جهة Cursor. بوابة ZSQH AI Gateway خدمة عامة، ولا تخضع عادة لهذا القيد.

ثانيًا: تجهيز المفتاح وعنوان Base URL واسم النموذج

قبل البدء جهّز ثلاثة أشياء: مفتاح API، وعنوان متوافق، ومعرّف نموذج دقيق.

  1. افتح صفحة التسجيل في ZSQH AI Gateway، وسجّل الدخول إلى لوحة التحكم.
  2. ادخل إلى «مفاتيح API»، وأنشئ مفتاحًا جديدًا باسم يوضح الغرض، مثل cursor-حاسوب-العمل.
  3. اضبط سقف الحصة وتاريخ الانتهاء. يُنصح بذلك حتى للحسابات الشخصية تجنبًا للاستهلاك غير الطبيعي.
  4. انسخ المفتاح واحفظه في مدير كلمات المرور. تعرضه لوحة التحكم كاملًا مرة واحدة عادة.
  5. افتح أسعار النماذج وسجّل معرّف النموذج المطلوب. تتغير الأسعار والنماذج، فالمرجع هو ما تعرضه الصفحة حاليًا.

صيغة الإعدادات الثلاثة كالتالي:

Base URL: https://ai.zhongshangqihang.com/v1
API Key:  sk-... (يُنشأ في لوحة التحكم ويُحفظ في مدير كلمات المرور فقط)
Model:    وفق معرّف النموذج المعروض حاليًا في صفحة «أسعار النماذج»

يستخدم Base URL العنوان المتوافق مع OpenAI وينتهي بـ/v1. لا تُدخل عنوان Anthropic الجذري، ولا تضف /chat/completions بنفسك، وإلا فمن السهل أن يتكرر المسار.

ثالثًا: إدخال الإعدادات في Cursor

المسار الشائع هو Cursor Settings → Models → API Keys. تختلف الخيارات بين الإصدارات، لكن الخطوات الجوهرية متقاربة.

  1. افتح Cursor Settings، والاختصار عادة Cmd/Ctrl + ,.
  2. ادخل إلى Models ووسّع قسم API Keys.
  3. افتح OpenAI API Key، والصق المفتاح الذي أنشأته، ثم اضغط Save.
  4. افتح Override OpenAI Base URL، وأدخل https://ai.zhongshangqihang.com/v1.
  5. اضغط + Add Custom Model (يُسمى في بعض الإصدارات + Add model)، وأدخل معرّف النموذج من صفحة الأسعار، وفعّل النموذج.
  6. اختر هذا النموذج من محدد النماذج في المحادثة، وأرسل طلبًا بسيطًا.

إذا لم تجد Override OpenAI Base URL، فالإصدار أو الباقة الحالية لا تدعم توجيه حركة متوافقة مع OpenAI إلى عنوان مخصص. لا تكرر المحاولة حينها، بل رقّي الإصدار أو استخدم حزمة تثبيت تدعم هذا الخيار.

اسم النموذج معرّف للتوجيه وليس ملاحظة. يجب أن تتطابق حالة الأحرف والشرطات ولاحقة الإصدار مع البوابة. الخطأ في ذلك يظهر عادة كعدم وجود النموذج أو 404 أو رفض الطلب.

رابعًا: كيف تختار النموذج

يمكن إضافة عدة نماذج مخصصة في Cursor، لكن نجاح الطلب يعتمد على توفير البوابة لنموذج بالاسم نفسه ودعمها لطريقة الاستدعاء المقابلة.

حالة الاستخدام الفئة المقترحة طريقة الإدخال ملاحظات
الأسئلة اليومية والتعديلات الصغيرة نموذج خفيف سريع نسخ معرّف النموذج من صفحة الأسعار زمن استجابة منخفض، وقدرة محدودة على إعادة الهيكلة المعقدة
تعديل عدة ملفات والوكيل نموذج الشيفرة الأساسي نسخ معرّف النموذج من صفحة الأسعار يتطلب دعم استدعاء الأدوات
تصميم البنية ومعالجة المشكلات الصعبة نموذج عالي القدرة نسخ معرّف النموذج من صفحة الأسعار تكلفة أعلى، يُستخدم عند الحاجة
الإكمال التلقائي Tab نموذج Cursor المدمج لا يمر عبر المفتاح المخصص BYOK لا يغطي الإكمال التلقائي

قد يعتمد وضع الوكيل على Responses API أو استدعاء الأدوات. وإذا كانت البوابة متوافقة مع Chat Completions فقط، فستفشل بعض وظائف الوكيل. في هذه الحالة، تحقق أولًا في محادثة عادية، ثم حدد ما إذا كانت المشكلة في النموذج أم في عدم توافق الوظيفة.

إضافة إلى ذلك، قد لا تمر أوضاع Auto وComposer والإكمال Tab عبر مفتاحك. وفق صفحة مساعدة Cursor، يستخدم الإكمال Tab النموذج المدمج دائمًا؛ وقد يوجّه وضع Auto الطلبات داخليًا أيضًا. تعامل مع النموذج المخصص كقناة لا تسري إلا عند اختياره صراحة، فهذا أقرب إلى الواقع.

خامسًا: التحقق من سريان الإعدادات

لا يكفي أن ترى ردًا من Cursor، لأن الرد قد يأتي من القناة المدمجة. تحقق بالترتيب التالي.

  1. أنشئ محادثة فارغة لتجنب تداخل السياق السابق.
  2. اختر النموذج المخصص صراحة من محدد النماذج، ولا تستخدم Auto.
  3. أرسل طلبًا قصيرًا، مثل شرح مقطع شيفرة لا يزيد على عشرة أسطر.
  4. افتح الاستخدام أو سجل الطلبات في لوحة تحكم البوابة، وتأكد من وجود سجل بالوقت والنموذج والمفتاح نفسها.
  5. سجّل نتيجة التحقق. إذا لم يظهر السجل، فالطلب لم يصل إلى البوابة، فعُد إلى فحص Base URL والمفتاح.

يمكن مطابقة الأخطاء الشائعة كالتالي:

  • 401 أو 403: مفتاح خاطئ أو معطّل أو الحصة مستنفدة.
  • 404: مسار Base URL غير صحيح أو اسم النموذج غير موجود.
  • 429: تجاوز حد المعدل أو الوصول إلى سقف حصة المفتاح.
  • مهلة: نقطة النهاية غير قابلة للوصول أو مسار الشبكة غير سليم.
  • فشل الوكيل فقط: قد يكون عدم توافق في قدرات الواجهة، وليس بالضرورة مشكلة في المفتاح.

سادسًا: قيود يجب معرفتها

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

سابعًا: خطوات تطبيقها في الفريق

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

ثامنًا: قائمة الأمان

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

تاسعًا: الأسئلة الشائعة

هل يدعم Cursor أي واجهة متوافقة مع OpenAI؟

ليس بالضرورة. يعتمد الاستخدام على توفير إصدار Cursor لخيار Override OpenAI Base URL، وعلى توافق الواجهة مع المسارات والمعاملات التي يستدعيها فعليًا. تحقق أولًا في محادثة عادية، ثم جرّب وظائف الوكيل.

أدخلت مفتاحي الخاص، فلماذا ما زال يطلب اشتراكًا؟

المفتاح الخاص لا يعني فتح كل الوظائف. بعض وظائف المحرر وإدارة الفريق والنماذج المدمجة تظل مقيدة بالباقة، وفق قواعد باقة Cursor الحالية.

لماذا لا يستهلك الإكمال Tab مفتاحي؟

وفق صفحة مساعدة Cursor، يستخدم الإكمال Tab دائمًا نموذج Cursor المدمج ولا يمر بالمفتاح الخاص. هذا تصميم المنتج وليس خطأ في الإعداد.

هل أضع العنوان الجذري أم /v1 في Base URL؟

عند استخدام بروتوكول متوافق مع OpenAI، أدخل العنوان حتى /v1. لا تضف /chat/completions، وإلا فمن السهل تكرار المسار وظهور 404.

هل يمكن للفريق مشاركة مفتاح واحد؟

تقنيًا ممكن، لكنه غير مستحسن. المفتاح المشترك لا يميز استهلاك الأعضاء، ويصعب تتبعه بعد التسريب. مفتاح لكل شخص مع حصص وسجلات هو الخيار الأسلم.

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

سجّل في ZSQH AI Gateway أولًا، وأنشئ مفتاحًا مخصصًا لـ Cursor، وأدخل Base URL والنموذج وفق هذا المقال. بعد نجاح المحادثة العادية، راجع أسعار النماذج لتعديل النموذج الأساسي والحصص.

قراءات ذات صلة: