استخدام Cursor مع واجهة LLM مجانية
يستطيع Cursor إرسال طلبات الدردشة إلى مفتاح OpenAI API الخاص بك. يوضح هذا الدليل كيف توصل هذا المفتاح بنماذج مجانية عبر FreeLLMAPI. كما يبيّن لك الحدود. يوجّه Cursor كل طلب عبر خوادمه، ويستخدم إكمال Tab دائماً نماذج Cursor.
تُعرض الشيفرة وأسماء النماذج وتسميات الكتالوج المباشر باللغة الإنجليزية.
ما الذي يعمل وما الذي لا يعمل
اقرأ هذا القسم قبل أن تبدأ. دعم Cursor للمفاتيح الخاصة أضيق من معظم المحررات الأخرى.
| ميزة Cursor | مع مفتاحك الخاص | المصدر |
|---|---|---|
| الدردشة مع نموذج بصيغة OpenAI القياسية | نعم. يوثّق Cursor مفاتيح OpenAI الخاصة لنماذج الدردشة القياسية غير الاستدلالية. | صفحة مساعدة مفاتيح API في Cursor |
| إكمال Tab | لا. يقول Cursor إن Tab يستمر في استخدام نماذج Cursor المدمجة. | صفحة مساعدة مفاتيح API في Cursor |
| وضع الوكيل وComposer | غير مؤكد. تذكر وثائق Cursor نماذج الدردشة فقط. اختبره في خطتك قبل أن تعتمد عليه. | غير موثّق |
| الطلبات من localhost | لا. يرسل Cursor كل الطلبات عبر خوادمه لبناء المطالبات، لذلك لا يمر localhost على حاسوبك في المسار. | صفحة مساعدة مفاتيح API في Cursor |
الخطط مهمة أيضاً. تعرض صفحة الأسعار في Cursor النماذج الخارجية والمفاتيح الخاصة في خطط Premium وSuper وUltra. وتذكر أن خطة Plus لا تتيح مفاتيح خاصة. أما الخطة Free، فتعرض الصفحة النماذج الخارجية على أنها غير متاحة. تحقق من صفحة الأسعار لخطتك قبل أن تتابع.
localhost مباشرة. اقرأ Cline وRoo Code وKilo Code مع واجهة مجانية.الخطوة 1: ثبّت FreeLLMAPI واجعله متاحاً
FreeLLMAPI مفتوح المصدر ويعمل على حاسوبك داخل Docker. ثبّته، ثم أضف مفتاحين مجانيين على الأقل من مزوّدين في صفحة Keys.
التثبيت على macOS أو Linux
curl -fsSL https://freellmapi.co/install.sh | bashانسخ مفتاحك الموحد من صفحة Keys. ثم أعطِ البوابة عنوان HTTPS عاماً، لأن خوادم Cursor لا تستطيع الوصول إلى localhost لديك. استخدم نفقاً موثوقاً لـ HTTPS أو خادماً تتحكم فيه. تطبع وثيقة FreeLLMAPI لـ Cursor هذه الخطوات:
اطبع دليل Cursor
npx freellmapi setup-cursorلا يكتب هذا الأمر أي ملف. لا يملك Cursor ملف إعداد لهذا الخيار، لذلك تُدخل القيم في إعدادات Cursor.
Authorization، فأنشئ رمز عنوان قابلاً للإلغاء بشكل منفصل من Keys, Agents. ألغِه عندما تتوقف.الخطوة 2: اضبط المفتاح والعنوان الأساسي في Cursor
- افتح Cursor Settings.
- افتح Models.
- ابحث عن حقل مفتاح OpenAI API. الصق مفتاحك الموحد من FreeLLMAPI. انقر Save.
- فعّل تجاوز عنوان OpenAI الأساسي. تسمي وثيقة FreeLLMAPI هذا الإعداد Override OpenAI Base URL.
- أدخل عنوانك العام مع
/v1في النهاية، مثلاًhttps://<your-tunnel-host>/v1. - اختر نموذجاً من منتقي النماذج، وأرسل رسالة دردشة قصيرة.
تذكر وثائق الخصوصية في Cursor تجاوز العنوان الأساسي المتوافق مع OpenAI. لا يوثّق Cursor الخطوات الدقيقة. قد تختلف التسميات في نسختك.
للتأكد من وصول الطلبات إلى البوابة، افتح سجل الطلبات في لوحة التحكم. تحتوي كل استجابة أيضاً على ترويسة X-Routed-Via تُظهر المزوّد والنموذج اللذين أجابا.
الخطوة 3: اختر النماذج
استخدم معرّف النموذج auto ليختار الموجّه نموذجاً مجانياً لكل طلب. يمكنك أيضاً استخدام معرّف من الكتالوج من GET /v1/models. ترسل دردشة Cursor سياق الملفات مع كل رسالة، لذلك استخدم نماذج ذات نافذة سياق كبيرة. يعرض الجدول النماذج المجانية التي تدعم استدعاء الأدوات ولها سياق 128K على الأقل اليوم.
| النموذج | مجاني على | السياق | الحدود المجانية (أفضل عرض) | الأدوات | الرؤية |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 طلب/دقيقة 1 req/min per model | نعم | لا |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 طلب/دقيقة 40 RPM | نعم | نعم |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | نعم | نعم |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | نعم | لا |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | نعم | نعم |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 طلب/دقيقة 20 طلب/يوم 250,000 رمز/دقيقة ~3M | نعم | نعم |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | نعم | نعم |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 طلب/دقيقة 50 طلب/يوم 50 req/day account-wide (1,000 after a $10 purchase) | نعم | نعم |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 طلب/دقيقة 50 طلب/يوم Shared rate limit | نعم | لا |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 طلب/دقيقة 250 طلب/يوم 70,000 رمز/دقيقة ~6M | نعم | نعم |
يعرض 10 من أصل 109 نموذجًا مجانيًا مطابقًا. عرض كل النماذج.
بيانات مباشرة من كتالوج FreeLLMAPI (الإصدار 2026.11.19، تم التحقق 2026-11-19). تتغير الحدود المجانية كثيرًا. يُفحص الكتالوج كل يوم.
يوثّق Cursor مفاتيح OpenAI الخاصة لنماذج الدردشة غير الاستدلالية. قد تفشل نماذج الاستدلال عبر التجاوز. إذا فشل نموذج، فاستخدم auto أو نموذجاً آخر من الجدول.
حدود المعدل والاحتياط
لكل مستوى مجاني حدود في الدقيقة وفي اليوم. يحسب FreeLLMAPI استخدام كل مفتاح. عندما يرسل مزوّد واحد الخطأ 429، يرسل الموجّه الطلب إلى النموذج التالي في سلسلة الاحتياط. تستمر الدردشة، ولا تغيّر أي إعداد في Cursor.
- أضف مفاتيح من أربعة مزوّدين أو أكثر. يعطي المزوّدون الأكثر طلبات أكثر في اليوم.
- استخدم
auto:fastللأسئلة القصيرة، وauto:smartلأسئلة البرمجة الصعبة. - ابدأ دردشة جديدة لكل مهمة. يرسل السجل الأقصر رموزاً أقل.
استكشاف الأخطاء وإصلاحها
| المشكلة | السبب | الحل |
|---|---|---|
لا يستطيع Cursor الاتصال بـ http://localhost:3001/v1 | يرسل Cursor الطلبات من خوادمه، وليس من حاسوبك | استخدم عنوان HTTPS عاماً للبوابة |
| لا يوجد خيار لمفتاح خاص | خطة Cursor لديك لا تتضمن مفاتيح API خاصة | راجع جدول الخطط في صفحة أسعار Cursor |
401 "Invalid API key" | المفتاح في Cursor ليس مفتاحك الموحد من FreeLLMAPI | انسخ المفتاح الموحد مرة أخرى من صفحة Keys |
| إكمال Tab لا يستخدم البوابة | يستخدم Cursor نماذجه الخاصة لـ Tab دائماً | لا يوجد حل. استخدم Continue في VS Code للإكمال التلقائي المجاني |
| "بلغت كل النماذج حد المعدل بعد N محاولة" | بلغت كل المفاتيح في السلسلة حدها | أضف مفاتيح من مزوّدين أكثر، أو انتظر فترات التبريد |
| تتوقف النماذج المدمجة عن العمل | تجاوز العنوان الأساسي ما زال مفعّلاً | أوقف التجاوز |
الأسئلة الشائعة
هل أستطيع استخدام Cursor مجاناً بمفتاح API الخاص بي؟
تعرض صفحة أسعار Cursor مفاتيح API الخاصة في خطط Premium وSuper وUltra، وتذكر أن خطة Plus لا تتيح مفاتيح خاصة. في خطة تتيح المفاتيح الخاصة، يمنح FreeLLMAPI الدردشة نماذج مجانية، لذلك تكلفة الاستدلال 0 دولار.
لماذا لا يتصل Cursor بـ localhost؟
يرسل Cursor كل الطلبات عبر خوادمه لبناء المطالبات. ولا تستطيع تلك الخوادم الوصول إلى localhost على حاسوبك، لذلك تحتاج البوابة إلى عنوان HTTPS عام.
هل يعمل الإكمال التلقائي Tab في Cursor مع واجهة مخصصة؟
لا. تذكر وثائق Cursor أن مفاتيح API المخصصة تعمل مع نماذج الدردشة فقط، ويستمر إكمال Tab في استخدام نماذج Cursor المدمجة.
ما أفضل نموذج مجاني لـ Cursor؟
استخدم auto، أو نموذجاً يدعم استدعاء الأدوات ولديه سياق 128K على الأقل من الجدول في هذه الصفحة. يرسل Cursor سياق الملفات مع كل رسالة، لذلك نافذة السياق الكبيرة مهمة.
هل يُرسل كودي إلى Cursor عندما أستخدم مفتاحي الخاص؟
نعم. يقول Cursor إن الطلبات تمر عبر خوادمه لبناء المطالبة النهائية. لا تنطبق Zero Data Retention عندما تستخدم مفاتيحك الخاصة.
أدلة ذات صلة
- نماذج ذكاء اصطناعي مجانية في VS Code
- Cline وRoo Code وKilo Code مع واجهة مجانية
- Continue مع واجهة LLM مجانية
- أفضل واجهات نماذج البرمجة المجانية
- عناوين Base URL لواجهات OpenAI المجانية المتوافقة
المصادر
- Cursor help: API keys (تم التحقق 20 November 2026)
- Cursor docs: models and pricing (تم التحقق 20 November 2026)
- Cursor docs: privacy and data governance (تم التحقق 20 November 2026)
- FreeLLMAPI docs: clients and coding agents (تم التحقق 20 November 2026)
- FreeLLMAPI CLI generators (تم التحقق 20 November 2026)