مفاتيح API المخصصة وBase URL في Cursor: دليل عملي
اعتبارًا من 2026-10-07، يقبل Cursor مفاتيح API الخاصة بك ضمن Cursor Settings → Models، بخانة لكل من OpenAI وAnthropic وGoogle وAzure وAWS Bedrock. في وثائق Cursor الرسمية، عثرت هذه الصفحة على Base URL override (مفتاح تبديل بحقل خاص به) لخانة OpenAI فقط، ولم تعثر على نص يقول إنه يمكن تغيير عنوان خانة Anthropic. تعمل مفاتيحك الخاصة مع نماذج المحادثة فقط؛ ويستمر إكمال Tab في استخدام نماذج Cursor المدمجة. مع QCode، ضع مفتاح cr_ الخاص بك في خانة OpenAI وhttps://api.qcode.cc/openai/v1 كـ Base URL لنماذج GPT وDeepSeek وGLM وKimi أو Qwen؛ ولـ Claude، شغّل Claude Code في الطرفية المدمجة في Cursor.
آخر تحديث 2026-11-14
وجّه هذه الأداة إلى نقطة نهاية QCode — مفتاح واحد لـ Claude وGPT والنماذج الصينية.
- الفوترة حسب token — الأسعار المباشرة على /models
- الدفع بالبطاقة (Visa / Mastercard) أو Apple Pay أو Google Pay أو العملات الرقمية
- خدمة ذاتية: شحن الرصيد والتفعيل فورًا
أربعة أمور يجب معرفتها أولًا
المزوّدون الذين يقبلون مفتاحك الخاص
يسرد مركز المساعدة الرسمي OpenAI وAnthropic وGoogle وAzure وAWS Bedrock. هناك أربع خطوات: افتح Cursor Settings → Models، واعثر على المزوّد، والصق المفتاح في حقل النص، وانقر فوق Save.
خانة موثّقة بخيار Base URL override
تذكر ملاحظات إصدار Agents Window 3.20 (2026-09-10) أن لكل مزوّد حقل API Key خاصًا به ومفتاح تبديل Use API Key، وأن OpenAI تحصل أيضًا على مفتاح تبديل Base URL override مع حقل خاص به. واعتبارًا من 2026-10-07، لم تعثر هذه الصفحة على نص في وثائق Cursor الرسمية يقول إنه يمكن تغيير Base URL الخاص بخانة Anthropic.
أين يسري مفتاحك الخاص
الصياغة الرسمية: لا تعمل مفاتيح API المخصصة إلا مع نماذج المحادثة. ويستمر إكمال Tab في استخدام نماذج Cursor المدمجة. بعبارة أخرى، لا يعمل Tab أبدًا على مفتاحك.
Teams / Enterprise، لكل مليون tokens
في هاتين الخطتين، لا تزال طلبات نماذج الطرف الثالث التي تُجرى بمفتاحك الخاص تُحتسب عليها Cursor Token Rate بقيمة $0.25 لكل مليون tokens (الإدخال والإخراج والمخزّن مؤقتًا)؛ وفي خطط الأفراد Pro وPro+ وUltra، لا تُخصم هذه الطلبات من الاستخدام المشمول.
ماذا يعني إحضار مفتاحك الخاص في Cursor
اعتبارًا من 2026-10-07، يتيح لك Cursor إدخال مفتاح API الخاص بك ضمن Cursor Settings → Models كي تعمل نماذج ذلك المزوّد على مفتاحك، ويفوترك مزوّدك مباشرةً بتكلفة النموذج؛ وخانة OpenAI هي التي تُظهر وثائق Cursor لها Base URL يمكن توجيهه إلى مكان آخر. ويقول مركز المساعدة الرسمي أيضًا إن مفتاحك لا يُخزَّن على خوادم Cursor، لكنه يُرسَل إلى الواجهة الخلفية لـ Cursor مع كل طلب، لأن جميع الطلبات تمر عبر خوادم Cursor لبناء prompt النهائي — لذا فإن إحضار مفتاحك الخاص لا يعني أن المحرر يتواصل مع خدمة النموذج لديك مباشرةً. ومع مفتاحك الخاص، لا تنطبق سياسة Zero Data Retention الخاصة بـ Cursor؛ بل تتبع معالجة البيانات سياسة الخصوصية الخاصة بالمزوّد الذي اخترته.
تغييران رسميان حديثان
من جانب Cursor، رتّب Agents Window 3.20 (بتاريخ 2026-09-10 في تغذية ملاحظات الإصدار الرسمية) إعدادات المفاتيح لـ OpenAI وAnthropic وGoogle: يحصل كل مزوّد على حقل API Key موسوم خاص به، ويظهر مفتاح تبديل Use API Key بعد حفظ مفتاح، وتحصل OpenAI أيضًا على مفتاح تبديل Base URL override مع حقل خاص به؛ وتُحفظ المفاتيح عند مغادرة الحقل أو الضغط على Enter، ومسح الحقل يزيل مفتاحًا محفوظًا. ومن جانب OpenAI، ورد في بيانها بتاريخ 2026-08-28: «نعتزم إنهاء عقدنا لتزويد Cursor بنماذج OpenAI، مع تاريخ إيقاف مقترح هو 12 نوفمبر 2026»، ويضيف أن OpenAI لن تزوّد Cursor بنماذج مستقبلية. ولا يذكر البيان أي شيء عن مفاتيح API الخاصة بالمستخدمين.
الجدول الزمني
تنشر OpenAI بيانًا: تعتزم إنهاء عقدها لتزويد Cursor بنماذج OpenAI، مع تاريخ إيقاف مقترح هو 2026-11-12، ولن تزوّد Cursor بنماذج مستقبلية.
يصدر Cursor Agents Window 3.20: في Settings → Models يحصل كل مزوّد على حقل API Key خاص به ومفتاح تبديل Use API Key، وتكتسب خانة OpenAI مفتاح تبديل Base URL override مع حقل خاص به.
تاريخ الإيقاف المقترح في بيان OpenAI. واعتبارًا من 2026-10-07، لم تعثر هذه الصفحة على ملاحظة مطابقة في وثائق Cursor الرسمية.
ما تأكد مقابل ما لم يُذكر رسميًا
مؤكد (بنص حرفي في الصفحات الرسمية)
يمكن التحقق من كل ما يلي حرفيًا في مركز المساعدة الرسمي ووثائق Cursor وملاحظات الإصدار، وفي بيان OpenAI: تُوضع مفاتيحك الخاصة في Cursor Settings → Models؛ والمزوّدون المدعومون هم OpenAI وAnthropic وGoogle وAzure وAWS Bedrock؛ وتُوصَف خانة OpenAI بأنها «نماذج محادثة قياسية غير استدلالية»، وتُوصَف خانة Anthropic بأنها جميع نماذج Claude المتاحة عبر Anthropic API؛ وتعمل مفاتيحك الخاصة مع نماذج المحادثة فقط، ويبقى Tab على النماذج المدمجة؛ وإذا كان المفتاح غير صالح أو رفضه المزوّد، فستفشل الطلبات التي تستخدم ذلك المزوّد إلى أن تحدّث المفتاح أو تزيله؛ وتحتوي خانة OpenAI على مفتاح تبديل لتجاوز Base URL مع حقل خاص به؛ وتمر الطلبات عبر خوادم Cursor لبناء prompt؛ ولا ينطبق Zero Data Retention؛ ويمكن لخطة Enterprise منع مفاتيح الأعضاء الخاصة؛ ومعدل Cursor Token Rate في خطتي Teams وEnterprise هو $0.25 لكل مليون token.
لم يُنص عليه رسميًا، لذا لا تخمين هنا
أربعة أمور غير منصوص عليها، لذا لا تضبط الإعدادات بالتخمين: ① ما إذا كانت خانة Anthropic تستطيع تغيير Base URL الخاص بها — حتى 2026-10-07 لم تجد هذه الصفحة أي نص من هذا القبيل في وثائق Cursor الرسمية أو ملاحظات الإصدار، لذا لا تعرض هذه الصفحة استدعاء Claude عبر عنوان مخصص في محادثة Cursor المدمجة كإعداد يعمل؛ ② ما إذا كان Cursor يطبّق حد نماذج المحادثة القياسية غير الاستدلالية على نماذج أخرى يُوصَل إليها عبر التجاوز؛ ③ وما إذا كانت ميزة التحرير المضمّن وCloud Agents وواجهات أخرى، عدا Tab، تستخدم مفتاحك الخاص — تقول صفحة Cloud Agents فقط إنها تستخدم مجموعة مختارة من النماذج؛ ④ وما إذا كان التوقف التدريجي لدى OpenAI يؤثر في مفاتيحك الخاصة وعناوين Base URL المخصصة — لا تقول OpenAI ولا Cursor ذلك.
طريقتان لاستخدام QCode داخل Cursor
محادثة Cursor المدمجة + تجاوز خانة OpenAI
ضع مفتاح cr_ الخاص بك في خانة OpenAI، وhttps://api.qcode.cc/openai/v1 كـ Base URL، لاستخدام نماذج GPT وDeepSeek وGLM وKimi أو Qwen. تمر الطلبات أولًا عبر خوادم Cursor لبناء prompt؛ ولا يستخدم Tab هذا المسار؛ ولا تزال خطط Teams وEnterprise تحمل Cursor Token Rate. لا يمكن لـ Claude أن يسلك هذا المسار: إذ ترفض نقطة النهاية المتوافقة مع OpenAI في QCode النماذج التي تبدأ بـ claude- مع model_not_available_on_endpoint.
Claude Code في الطرفية المدمجة في Cursor
في الطرفية المدمجة في Cursor، اضبط ANTHROPIC_BASE_URL=https://api.qcode.cc/api وANTHROPIC_AUTH_TOKEN (مفتاح cr_ الخاص بك)، ثم شغّل claude. يستخدم هذا نقطة نهاية Anthropic لدى QCode، وهي الوجهة التي تذهب إليها نماذج Claude. تشير وثائق QCode إلى أن الاثنين يستخدمان مصادقة منفصلة لكنهما يتشاركان الحصة عند استخدام المفتاح نفسه.
خطوات إعداد QCode في Cursor
① افتح Cursor Settings → Models وابحث عن خانة OpenAI. ② الصق مفتاح cr_ الذي أنشأته في لوحة التحكم في حقل API Key (كاملًا، دون مسافات في البداية أو النهاية)؛ يُحفظ المفتاح عند مغادرة الحقل أو الضغط على Enter، ثم يظهر مفتاح Use API Key — تأكد من أنه مفعّل. ③ فعّل مفتاح تجاوز Base URL في الخانة نفسها وأدخل https://api.qcode.cc/openai/v1، دون شرطة مائلة في النهاية ودون حذف /v1. ④ أضف معرّفات النماذج التي تريدها في قائمة Models وضع علامة عليها، مثل gpt-6.1-sol وgpt-5.6-terra وdeepseek-v4.1-flash أو glm-5.3؛ المعرّفات حساسة لحالة الأحرف، وإعادة تشغيل Cursor مرة واحدة تحدّث القائمة. ⑤ اختبر من سطر الأوامر: اطلب https://api.qcode.cc/openai/v1/models مع Authorization: Bearer ومفتاحك — قائمة JSON تعني أن العنوان والمفتاح كلاهما صحيح. ⑥ بالنسبة إلى Claude، لا تضف معرّفات claude- هنا؛ شغّل Claude Code في الطرفية المدمجة بدلًا من ذلك (راجع القسم أعلاه).
على QCode
على QCode، يعمل مفتاح cr_ واحد عبر البروتوكولات، ويحدد مسار الطلب البروتوكول المستخدم. عنوان https://api.qcode.cc/openai/v1 في خانة OpenAI في Cursor هو نقطة النهاية المتوافقة مع OpenAI، لنماذج GPT (مثل gpt-6.1-sol وgpt-6-sol وgpt-5.6-terra) ونماذج DeepSeek وGLM وKimi وQwen (مثل deepseek-v4.1-flash وglm-5.3 وkimi-k3 وqwen3.8-max). لا تستخدم نماذج Claude إلا نقطة نهاية Anthropic https://api.qcode.cc/api؛ وداخل Cursor، استخدم Claude Code في الطرفية المدمجة، مع claude-sonnet-5-5 أو claude-opus-5-5 كنموذج. تُحتسب التكلفة لكل token؛ والأسعار لكل نموذج على /models.
الأسئلة الشائعة
هل يمكن ضبط Base URL مخصص في Cursor، وأين؟
نعم، في خانة OpenAI؛ وحتى 2026-10-07 فإنها الخانة الوحيدة التي وجدت هذه الصفحة لها تجاوزًا لـ Base URL في وثائق Cursor الرسمية. افتح Cursor Settings → Models: تحتوي خانة OpenAI على خيار تبديل لتجاوز Base URL مع حقل خاص به، كما ورد في ملاحظات إصدار Agents Window 3.20. أما خانات Anthropic وGoogle والخانات الأخرى، فلم تجد هذه الصفحة أي نص رسمي عن تغيير العنوان؛ إذ تصف الوثائق إدخال مفتاح API فقط. وتسمّي وثائق الخصوصية في Cursor هذا الإعداد نموذجًا مخصصًا يُوصل إليه عبر تجاوز Base URL متوافق مع OpenAI.
ما الميزات التي لا تعمل مع مفتاح API الخاص بي؟
لن يستخدم Tab completion مفتاحك. الصياغة الرسمية هي «مفاتيح API المخصصة تعمل مع نماذج المحادثة فقط. ويستمر Tab completion في استخدام نماذج Cursor المدمجة». ولا تُدرج الواجهات الأخرى واحدة واحدة؛ فصفحة Cloud Agents تقول فقط إنها تستخدم مجموعة مختارة من النماذج ولا تذكر ما إذا كان مفتاحك الخاص ينطبق. ويمكن لمسؤولي المؤسسات أيضًا منع الأعضاء من استخدام مفاتيحهم الخاصة في إعدادات الفريق.
هل يمكن لـ Cursor استخدام مفتاح Claude API الخاص بي؟ وماذا عن Claude عبر QCode؟
مفتاح Anthropic الخاص بك: نعم، ضعه في خانة Anthropic، التي تصفها الوثائق بأنها جميع نماذج Claude المتاحة عبر Anthropic API. أما Claude عبر QCode، فلا تستخدم خانة OpenAI: إذ يقدّم QCode Claude فقط على نقطة نهاية Anthropic لديه، وتعيد نقطة النهاية المتوافقة مع OpenAI الخطأ model_not_available_on_endpoint (يعني هذا الخطأ بروتوكولًا خاطئًا، لا مفتاحًا غير صالح؛ فالمفتاح غير الصالح يعيد Invalid API key). لاستخدام Claude من QCode داخل Cursor، شغّل Claude Code في الطرفية المدمجة مع ضبط ANTHROPIC_BASE_URL على https://api.qcode.cc/api.
هل يستهلك مفتاحي الخاص استخدام Cursor أو يكلّف أي شيء في Cursor؟
لا في الخطط الفردية؛ أما في Teams وEnterprise فنعم. في الخطط الفردية Pro وPro+ وUltra: لا؛ إذ يفوتر مزوّدك تكلفة النموذج ولا تُخصم تلك الطلبات من استخدامك المشمول. أما في Teams وEnterprise فنعم: إذ يترتب على كل طلب إلى نموذج من طرف ثالث سعر Cursor Token Rate البالغ $0.25 لكل مليون token (الإدخال والإخراج والمخزّن مؤقتًا)، بما في ذلك الطلبات المرسلة بمفتاحك الخاص، ويظهر ذلك ضمن Other Models؛ وتُستثنى نماذج Cursor نفسها مثل Grok وComposer.
مع مفتاحي الخاص، هل تذهب الطلبات مباشرة إلى خدمة النموذج لدي؟
لا. يقول مركز المساعدة الرسمي إن مفتاحك لا يُخزّن على خوادم Cursor، لكنه يُرسل إلى الواجهة الخلفية لـ Cursor مع كل طلب لأن جميع الطلبات تمر عبر خوادم Cursor لبناء الـ prompt النهائي، ولا يُحتفظ بالمفتاح بعد اكتمال الطلب. ولا ينطبق Zero Data Retention مع مفاتيحك الخاصة؛ كما لا تشمل إقامة البيانات الأمريكية في خطة المؤسسات BYOK أيضًا، والنموذج المخصص الذي يُوصل إليه عبر تجاوز Base URL متوافق مع OpenAI يحمل منطقة تلك البوابة أو ذلك النموذج.
تعتزم OpenAI التوقف عن توريد النماذج إلى Cursor. فهل يؤثر ذلك في مفتاحي الخاص؟
لم تصرّح أي من الشركتين بذلك. يقتصر بيان OpenAI الصادر في 2026-08-28 على أنها تعتزم إنهاء عقدها لتوريد نماذج OpenAI إلى Cursor، مع تاريخ إيقاف مقترح هو 2026-11-12، وأنها لن تورّد نماذج مستقبلية إلى Cursor؛ ولا يذكر البيان مفاتيح المستخدمين الخاصة ولا عناوين Base URL المخصصة. وحتى 2026-10-07 لم تجد هذه الصفحة أي ملاحظة مطابقة في وثائق Cursor الرسمية، لذا اعتمد على الإعلانات الرسمية للشركتين عند حلول ذلك التاريخ.
المصادر
Cursor: صفحتا Bring your own API key وCursor Token Rate في مركز المساعدة الرسمي؛ والوثائق الرسمية عن خصوصية المؤسسات وحوكمة البيانات، وإدارة النماذج والتكاملات، وCloud Agents؛ وملاحظات إصدار Agents Window وخلاصة RSS لملاحظات الإصدار (3.20، 2026-09-10)؛ إضافة إلى بحث في كل صفحة وثائق رسمية مدرجة في cursor.com/llms.txt، وجميعها تم الزحف إليها في 2026-10-07. OpenAI: بيان «Our decision on Cursor following its acquisition by SpaceX» (2026-08-28) على openai.com، مقروءًا من نسخ Internet Archive بتاريخ 2026-08-29 و2026-09-13 (النص نفسه) لأن الوصول المباشر كان محظورًا، وتم التحقق منه في 2026-10-07. QCode: صفحة إعداد Cursor وصفحة نقاط النهاية ومسارات API في وثائق QCode (كلتاهما محدّثتان في 2026-09-25)، وتم الزحف إليهما في اليوم نفسه.
مفتاح cr_ واحد لـ Cursor وClaude Code
توضع نماذج GPT وDeepSeek وGLM وKimi وQwen في خانة OpenAI في Cursor، أما Claude فيمر عبر Claude Code على نقطة نهاية Anthropic؛ وتُحتسب التكلفة لكل token، مع أسعار لكل نموذج على /models.
قراءات ذات صلة
شرح مجموعتَي الاستخدام في Cursor
مجموعة نماذج Cursor مقابل مجموعة Other Models، وقواعد إعادة الضبط.
بدائل Cursor في 2026: ثلاثة أنواع وكيفية استخدام مفتاح API الخاص بك
تم التحقق في 2026-11-05: ثلاثة أنواع من بدائل Cursor (IDE، وكيل طرفية، نماذج صينية)، وإصداراتها، ودعم Base URL المخصص، وإعداد QCode.
CodeBuddy models.json: نموذج مخصص وAPI مخصص (2026-11)
يستطيع CodeBuddy استخدام مفتاح API الخاص بك: أين يوجد models.json، وهل يحتاج url إلى /chat/completions، وكيفية تعيين CODEBUDDY_BASE_URL، مع نتائج اختبار CLI 2.182.0.
دليل الدفع بالعملات المشفرة
تسع عملات، و56 شبكة، وبدون رسوم منصة لرصيد API للبرمجة بالذكاء الاصطناعي.
تم التحقق من الخطوات والاقتباسات في هذه الصفحة في 2026-10-07 مقابل الوثائق الرسمية لـ Cursor وملاحظات الإصدار وبيان OpenAI الرسمي؛ وقد تحدث تغييرات من جانب المورّدين دون إشعار. تتغير شاشة إعدادات Cursor بين الإصدارات، لذلك اعتمد على التسميات في إصدارك؛ أما توفر النماذج فهو ما يعرضه /models.