دليل إعداد Cursor
مناسب لإصدارات Cursor التي تتيح إدخال OpenAI Key / Base URL مخصصين.
اقرأ هذه الملاحظة أولاً: يختلف موضع إعدادات النماذج بين إصدارات Cursor. لا يناسب الاتصال المباشر بـ LLM API Gateway إلا الإصدارات التي تعرض ضمن إعدادات Cursor خيارات مثل OpenAI API Key وOverride OpenAI Base URL / Custom Base URL.
| عنصر الإعداد | القيمة المدخلة | الشرح |
|---|---|---|
| API Key | sk-xxxxxxxx | أدخل مفتاح LLM API Gateway الخاص بك. |
| Base URL | https://api.llm-token.cn/v1 | إذا كان خيار Override / Custom Base URL متاحًا، فأدخله هنا. |
| Model ID | اسم النموذج الكامل من قائمة النماذج | يجب أن يتطابق اسم النموذج بالكامل. |
أولاً: فتح إعدادات النماذج في Cursor
- افتح Cursor.
- انتقل إلى Cursor Settings.
- ابحث عن إعدادات Models أو الإعدادات المتعلقة بـ API Keys.
- ابحث عن حقلي الإدخال المتعلقين بـ OpenAI API Key وBase URL.
تعرض الصورة واجهة إعدادات Models في Cursor، مع تحديد “Models” في شريط ال…
ثانيًا: إدخال واجهة LLM API Gateway
- فعّل OpenAI API Key أو API Key مخصصة.
- أدخل في API Key المفتاح الخاص بك الذي يبدأ بـ
sk-. - أدخل في Base URL / Override OpenAI Base URL القيمة
https://api.llm-token.cn/v1. - إذا كان تخصيص النموذج مدعومًا، فأدخل معرّف النموذج، مثل
claude-sonnet-4-6أوgpt-5.5. - انقر على Verify / Save، ثم أنشئ محادثة جديدة للاختبار.
طريقة التحقق: بعد الحفظ، أنشئ Chat جديدًا واختر النموذج الذي أعددته للتو، ثم أرسل العبارة «مرحبًا، يُرجى الرد بجملة واحدة». إذا ظهر الرد بصورة طبيعية، فقد نجح الإعداد.
ثالثًا: قيود Cursor
| الحالة | التوصية |
|---|---|
| خيار Override Base URL غير متاح | قد لا يدعم الإصدار الحالي الاتصال المباشر ببوابة مخصصة؛ ويُنصح باستخدام VS Code + Cline أو Trae + Cline أو OpenCode أو WorkBuddy. |
| فشل Verify | تحقق من Key وBase URL ومعرّف النموذج. لا تجعل Base URL مسار الواجهة الكامل. |
| استمرار بعض الوظائف في استخدام نماذج Cursor المدمجة | هذا قيد في Cursor نفسه. تُستخدم Key المخصصة عادةً أساسًا مع نماذج المحادثة القياسية، بينما قد تظل بعض الوظائف المدمجة تستخدم نماذج Cursor الخاصة. |
| قائمة النماذج لا تظهر | اختبر أولاً باستخدام معرّف نموذج واضح؛ وإذا استمر الفشل، فانتقل إلى برنامج عميل من فئة Cline. |
رابعًا: البدائل الموصى بها
إذا كان إصدار Cursor لديك لا يدعم Base URL مخصصًا، فأكثر البدائل موثوقية هو VS Code + Cline أو Trae + Cline. يتوفر دليلاهما في الدليل الرئيسي، وعناصر الإعداد فيهما أوضح.