إعداد Base URL ومفتاح API المخصصين في Cursor

اربط QCode بـ Cursor باستخدام Base URL مخصص من OpenAI أو Anthropic ومفتاح API: الإعداد، ومعرّفات النماذج، والميزات التي تبقى على نماذج Cursor المدمجة.

تحتاج مفتاح API؟ أنشئ حسابًا ←·نقاط النهاية وعناوين Base URL ←

آخر تحقق: 2026-10-20 · 📄 وفق الوثائق الرسمية (ما زالت صفحة تنزيل Cursor تدرج 3.24 كأحدث إصدار في 2026-10-20، وأحدث إدخال في سجل التغييرات مؤرخ 2026-10-16؛ وقد فُحصت صفحة مساعدة BYOK في اليوم نفسه؛ ويُحتفظ برد المنتدى المؤرخ 2026-08-11 حول حقول Override كسجل تاريخي)

نعم. يتيح لك Cursor إدخال مفتاح API الخاص بك وتفعيل Override OpenAI Base URL (أو Override Anthropic Base URL) الموجّه إلى QCode، لتشغيل Chat وComposer وInline Edit عبر QCode. ويظل Tab completion يستخدم نماذج Cursor المدمجة، وما زالت الطلبات تمر عبر الواجهة الخلفية لـ Cursor لبناء الـ prompt النهائي.

نظرة سريعة¶

أين توجد الحقول، وخلل معروف¶

المكان الذي تُكتب فيه URL هو Settings → Models → API Keys. تسرد صفحة مساعدة BYOK الخاصة بـ Cursor (cursor.com/help/models-and-usage/api-keys) أربع خطوات فقط: افتح Cursor Settings → Models، واختر المزوّد (OpenAI أو Anthropic أو Google أو Azure أو AWS Bedrock)، ثم الصق مفتاح API الخاص بك في حقل النص، وانقر على Save — ولا تسرد حقول Override. الحقول موجودة فعلًا؛ وقد سمّاها عضو فريق Cursor المدعو deanrie في المنتدى الرسمي:

«أُدمج إصلاح حقول OpenAI API Key وOverride OpenAI Base URL، وحقول مفاتيح المزوّدين الأخرى، التي لم تكن تستقبل التركيز عند النقر بالفأرة، وسيُطرح في تحديث 3.15 قادم. وهو ليس في 3.15.6 بعد. بعد التحديث إلى إصدار أحدث من 3.15.6، يُرجى المحاولة مرة أخرى.» (2026-08-11، الموضوع الأصلي)

ثلاث نقاط عملية:

• الحقلان هما Override OpenAI Base URL (بروتوكول OpenAI) وOverride Anthropic Base URL (بروتوكول Anthropic)، ولكل منهما مفتاح تمكين خاص به.
• 3.15.6 فيه خلل تراجعي معروف: لا تستطيع الفأرة نقل التركيز إلى حقلي الإدخال هذين. الحل الرسمي البديل هو تفعيل مفتاح التبديل ذي الصلة في Settings → Models، ثم الضغط على Tab لنقل التركيز إلى الحقل — وبعد ذلك يعمل الإدخال وCtrl+V. كما يعمل الرجوع إلى 3.14.27 أيضًا. يُطرح الإصلاح في تحديث بعد 3.15.6، لذا رقّ إلى إصدار أحدث من 3.15.6 وأعد المحاولة (أُعيد التحقق في 2026-10-20: صفحة التنزيل أصبحت عند 3.24 بالفعل، ويُحتفظ برد المنتدى هذا المؤرخ 2026-08-11 كسجل تاريخي لفترة 3.15.6).
• تذكر الصفحة نفسها، بالحرف: «لا يُخزَّن مفتاح API الخاص بك على خوادمنا. يُرسل إلى الواجهة الخلفية لدينا مع كل طلب لأن جميع الطلبات تُوجَّه عبر خوادم Cursor لبناء الـ prompt النهائي» — حتى مع مفتاحك الخاص، تمر الطلبات عبر الواجهة الخلفية لـ Cursor؛ ولا يتحدث المحرر إلى مزوّد نموذجك مباشرة.

ثلاثة قيود إضافية وخطر زمني واحد:

• في خطط Teams / Enterprise، يظل Cursor Token Rate ساريًا حتى مع مفتاحك الخاص، ويقتصر وصف OpenAI BYOK على «نماذج الدردشة القياسية غير الاستدلالية».
• لإبقاء حركة المرور بعيدة تمامًا عن الواجهة الخلفية لـ Cursor، تحتاج إلى عميل يدعم Base URL مخصصًا: Claude Code، Codex CLI، Cline، Zed وما شابه.
• خطر زمني: في بيان مؤرخ 2026-08-28 كتبت OpenAI أنها «تعتزم إنهاء عقدنا الذي يوفّر نماذج OpenAI لـ Cursor، مع تاريخ إيقاف مقترح في 12 نوفمبر 2026» — مقترح، ولم يدخل حيز التنفيذ بعد. ولم تنشر Cursor أي إشعار مماثل حتى 2026-09-18. المصدر: openai.com.

Cursor محرر أصلي للذكاء الاصطناعي مبني فوق VS Code. سجل تغييرات Cursor غير منظم حسب رقم الإصدار، وأحدث إدخال فيه مؤرخ 2026-10-16؛ وقد أدرجت صفحة التنزيل 3.24 كأحدث إصدار في 2026-10-20. يشرح هذا الدليل كيفية توصيل QCode.cc بـ Cursor — لكن اقرأ القسم التالي أولًا، لأنه يحدد ما إذا كان هذا المسار يناسبك أصلًا.

لماذا تستخدم Cursor¶

• Agents Window (جديدة في v3): شغّل عدة وكلاء ذكاء اصطناعي بالتوازي في الشريط الجانبي دون تداخل
• Cursor Composer: تحرير متعدد الملفات مع إعادة هيكلة واعية بالسياق، وأنسب من Cursor Chat للتغييرات الكبيرة
• Inline Edit (Cmd+K): حدّد الشيفرة وأصدر تعليمة ضمن السطر — أسرع حلقة تكرار
• مبني على VS Code: يرث منظومة إضافات VS Code بالكامل (بما فيها إضافة Claude Code لـ VS Code)

المتطلبات المسبقة¶

• تثبيت Cursor (macOS / Windows / Linux)
• مفتاح API من QCode.cc (يبدأ بـ cr_)، متاح من لوحة التحكم
• المفتاح نفسه يعمل عبر جميع بروتوكولات QCode ونطاقات الدخول الثلاثة كلها (api / asia / us)؛ على المستخدمين في البر الرئيسي للصين تفضيل asia.qcode.cc

النماذج المتاحة¶

يسرد الجدول أدناه معرّفات النماذج التي نستخدمها عادةً على QCode (القائمة الحية والأسعار على qcode.cc/models)؛ وهي بالضبط ما تكتبه في Cursor. أما مواضع الحقول وخلل الإدخال في 3.15.6 فمغطاة في القسم أعلاه.

لا تقدّم QCode حاليًا سلسلة Gemini، ولا gpt-6-luna / gpt-5.6-luna. الجدول أعلاه هو التوصية الحالية؛ لا يزال بإمكانك استدعاء claude-opus-5 وclaude-sonnet-5 وclaude-sonnet-4-6 وclaude-opus-4-8 وغيرها. النماذج القابلة للاستدعاء والأسعار على qcode.cc/models.

خطوات الإعداد¶

يتوافق المسارَان أدناه مع حقلي التجاوز؛ المسار A (بروتوكول OpenAI) هو الأفضل توافقًا. إذا لم تقبل حقول الإدخال التركيز، فاستخدم حل Tab أعلاه أو حدّث إلى إصدار أحدث من 3.15.6.

المسار A: نقطة نهاية مخصصة متوافقة مع OpenAI (موصى به)¶

استخدم بروتوكول OpenAI للتحدث إلى مسار /openai/v1 في QCode، الذي يخدم نماذج GPT والعائلات الصينية الأربع (GLM / Kimi / DeepSeek / Qwen).

🔴 هذا المسار لا يمكنه خدمة Claude. نقطة نهاية OpenAI في QCode تقبل هاتين المجموعتين فقط؛ ومعرّف claude-… يعيد model_not_available_on_endpoint. لا تقدّم QCode حاليًا نماذج Gemini. لاستخدام Claude، استخدم المسار B أدناه. راجع نقاط النهاية ومسارات API.

1. افتح إعدادات Cursor: Cmd + , (macOS) / Ctrl + , (Windows/Linux)
2. النماذج → مرّر إلى الأسفل وابحث عن تجاوز Base URL الخاص بـ OpenAI
3. املأ:

1. في قائمة النماذج، حدّد النماذج التي تريد تمكينها (مثل gpt-6.1-sol، gpt-5.6-terra)؛ ولأي نموذج غير مدرج، انقر + إضافة نموذج وأدخل معرّف النموذج يدويًا
2. انقر تحقق لاختبار الاتصال؛ وبعد نجاحه، يمكنك استخدامه من Cursor Chat / Composer

يجب ألا ينتهي Base URL بشرطة مائلة زائدة. طلب الفحص الذاتي من QCode يعيد 401، وهذا يعني أن المسار صحيح وأن المصادقة وحدها ناقصة — هذا طبيعي ويؤكد أن نقطة النهاية قابلة للوصول.

مرجع Base URL حسب البروتوكول (المفتاح نفسه يعمل معها جميعًا):

المسار B: نقطة نهاية مخصصة لـ Anthropic (بروتوكول Claude الأصلي)¶

إذا أردت استخدام بروتوكول Anthropic الأصلي لنماذج Claude، فإن Base URL الخاص بـ Anthropic في QCode هو https://api.qcode.cc/api (يضيف SDK تلقائيًا /v1/messages).

في إعدادات Cursor، افتح النماذج → Anthropic API، وأدخل مفتاح QCode الخاص بك، وفعّل تجاوز Base URL الخاص بـ Anthropic بالعنوان أعلاه.

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

⚠️ في وضع الوكيل، تستخدم بعض الإمكانات نمط OpenAI Responses API غير المتوافق مع مسار بروتوكول Anthropic في بعض السيناريوهات (عادةً فشل تحويل المخطط لبعض استدعاءات الأدوات). تتغير خيارات تبديل نقاط النهاية في Cursor من وقت لآخر، لذا ارجع إلى وثائق Cursor الرسمية.

أي الميزات تعمل عبر نقطة نهاية مخصصة¶

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

باختصار: ثلاثي Chat / Composer / Inline Edit هو الأكثر موثوقية عبر نقطة نهاية QCode؛ قد تبقى الميزات المُدارة بشكل مكثف (أجزاء من تدفق الوكيل) على نماذج Cursor الخاصة. يتبع صف Tab الآن الصياغة الرسمية (تم التحقق في 2026-10-20، انظر الجدول أعلاه)؛ باقي هذا القسم ملاحظات مبنية على المشاهدة، وليس وثائق رسمية — تابع إعلانات Cursor.

سير عمل نموذجي¶

بعد إعداد نقطة النهاية، يبدو سير عمل Composer اليومي تقريبًا كما يلي:

1. اختر نموذجًا في Composer (مثل claude-sonnet-5-5 للعمل اليومي، وclaude-opus-5-5 للتغييرات الكبيرة)
2. افتح Composer باستخدام Cmd + I واسحب الملفات التي تريد تحريرها إلى منطقة السياق
3. صف الهدف بلغة طبيعية، مثل «رحّل إدارة حالة هذا المكوّن من useState إلى useReducer مع إبقاء الـ props الحالية دون تغيير»
4. راجع الـ diff واقبل / ارفض كتلة بكتلة
5. لإجراء تعديلات محلية سريعة، استخدم Inline Edit (Cmd + K) بدلًا من فتح Composer في كل مرة

يعمل سير العمل هذا بالكامل عبر نقطة نهاية QCode التي أعددتها، وتُسوّى الحصة وفق قواعد الفوترة.

نقاط الدخول الأخرى¶

النطاقات الثلاثة هي نقاط دخول مختلفة إلى الخدمة نفسها، ومفتاح API نفسه يعمل على جميعها. للاطلاع على المرجع الكامل، راجع نقاط النهاية ومسارات API.

إدخال الصور مقابل توليد الصور¶

• إدخال الصور (تمكين النموذج من «رؤية» صورة): يتيح لك Cursor لصق لقطات الشاشة أو نماذج التصميم أو سحبها إلى المحادثة ليتمكن نموذج قادر على الرؤية من قراءتها — على سبيل المثال، بناء مكوّن من رسم واجهة مستخدم أو تصحيح خطأ من لقطة شاشة لخطأ. تشمل النماذج القادرة على الرؤية على QCode كلاً من Claude Opus 5.5 / Sonnet 5.5 / Haiku 5.5 ونماذج GPT (مثل gpt-6.1-sol وgpt-5.6-terra).
• توليد الصور (تمكين النموذج من «الرسم»): هذا أمر مختلف. لتوليد الصور، استخدم نموذج gpt-image-2 من QCode عبر نقطة النهاية المخصصة للصور — وليس ضمن تدفق محرر Cursor. راجع توليد الصور باستخدام gpt-image-2.

الاستخدام إلى جانب Claude Code¶

لا يتعارض الذكاء الاصطناعي المدمج في Cursor مع Claude Code CLI المستقل — إذ يمكن تشغيلهما جنبًا إلى جنب في نافذة Cursor نفسها:

• Cursor Chat / Composer: ذكاء اصطناعي داخل المحرر يستخدم نقطة النهاية المهيأة في إعدادات Cursor
• Claude Code CLI: شغّل claude في الطرفية المدمجة في Cursor (Ctrl + `)، وهو يستخدم متغير البيئة ANTHROPIC_BASE_URL الخاص بـ CLI نفسه

وجّه Claude Code إلى QCode (بروتوكول Anthropic) من الطرفية المدمجة:

export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="cr_your_key"
claude

تتم المصادقة عبر المسارين بشكل مستقل، لكن استخدام مفتاح API نفسه من QCode على كليهما يعني حصة مشتركة (راجع الفوترة للتفاصيل). يعمل كل من Subagents والأتمتة وCI/CD في Claude Code مباشرةً في هذه الطرفية.

القيود والملاحظات¶

• وضع الخصوصية: يرسل Cursor مقتطفات الشيفرة إلى نقطة النهاية المهيأة افتراضيًا. إذا كان وضع الخصوصية مفعّلًا في إعدادات Cursor، فتحقق من أن تهيئة مفتاح API لا تزال تتيح لك الوصول إلى QCode؛ لا يؤثر وضع الخصوصية على حركة المرور الصادرة، بل يمنع Cursor نفسه فقط من تخزين الـ prompts الخاصة بك
• اشتراك Cursor Pro ومفتاح API الخاص بـ QCode نظامان مستقلان — يمنحك Cursor Pro الحصة المدمجة في Cursor (باستخدام مجموعة النماذج الخاصة بـ Cursor)، بينما يمر مفتاح API الخاص بـ QCode عبر خدمة QCode. عند تفعيل كليهما، يتبع التوجيه الأولوية المهيأة في Cursor
• نافذة Agents والوكلاء في الخلفية تعمل على أفضل نحو مع المزوّدين السائدين (بروتوكولات OpenAI / Anthropic)؛ أما خوادم النماذج مفتوحة المصدر والمستضافة ذاتيًا فنتائجها غير متوقعة
• التجاوز إعداد عام: إدخال «Override OpenAI Base URL» يوجّه الطلبات التي تعتمد افتراضيًا على بروتوكول OpenAI نحو QCode، ومسحه يعيد الإعداد الافتراضي لـ Cursor. لكن وفقًا للصياغة الرسمية، لا تزال الطلبات تمر عبر الواجهة الخلفية لـ Cursor لبناء الـ prompt، لذا لا يصح افتراض «أن حركة المرور وحدها انتقلت، ولم يتغير شيء آخر»
• لا ينطبق Zero Data Retention على مفتاحك الخاص (صفحة BYOK الخاصة بـ Cursor، تم التحقق منها في 2026-10-20): عند استخدامك مفتاح API الخاص بك، لا تنطبق سياسة Zero Data Retention الخاصة بـ Cursor؛ تتبع معالجة البيانات سياسة الخصوصية للمزوّد الذي تختاره (OpenAI، Anthropic، Google، Azure أو AWS)
• لا تزال خطط الفرق والمؤسسات تدفع Cursor Token Rate (صفحة BYOK الخاصة بـ Cursor، تم التحقق منها في 2026-10-20): حتى مع مفتاحك الخاص، يحمل كل طلب إلى نموذج طرف ثالث على خطتي الفرق / المؤسسات Cursor Token Rate البالغ $0.25 لكل مليون tokens (الإدخال والإخراج والمخزّن مؤقتًا)؛ أما على الخطط الفردية (Premium وSuper وUltra، إضافة إلى خطط Pro القديمة) فلا تُخصم طلبات المفتاح الخاص من استخدامك المشمول

نصائح عملية¶

• اختر نموذجًا لكل مهمة: على المسار B (Anthropic، https://api.qcode.cc/api)، يمنح claude-sonnet-5-5 أفضل قيمة للتحرير اليومي، ويتعامل claude-opus-5-5 مع عمليات إعادة الهيكلة الكبيرة؛ وعلى المسار A (OpenAI)، جرّب gpt-5.6-terra لإكمال الشيفرة الخالص وgpt-6.1-sol للأعمال العامة
• فضّل فئة 1M للسياق الطويل: تناسب نماذج بسياق 1M مثل claude-opus-5-5 / gpt-6.1-sol تغييرات Composer التي تُدخل مستودعًا كاملًا
• وفّر المال: عيّن نموذجًا متوسط الفئة كافتراضي في Composer وانتقل يدويًا إلى نموذج رائد فقط للمشكلات الصعبة
• استخدم أقرب نقطة نهاية: في البر الرئيسي للصين، غيّر Base URL إلى نقطة دخول آسيا https://asia.qcode.cc/openai/v1 (موصى به للبر الرئيسي)
• اضغط Verify أولًا عندما يصبح السلوك غريبًا: قد يتغير سلوك نقطة النهاية بعد تحديث Cursor، لذا انقر Verify مرة واحدة قبل تتبع مشكلات أخرى

الأسئلة الشائعة¶

يبلّغ Cursor عن «مفتاح API غير صالح»¶

1. تحقّق من أن مفتاح API كامل، ويبدأ بـ cr_، ولا يحتوي على مسافات بادئة أو لاحقة
2. انقر على Verify في إعدادات Cursor لعرض الخطأ المحدد
3. اختبر الاتصال من سطر الأوامر: bash curl -H "Authorization: Bearer YOUR_KEY" \ https://api.qcode.cc/openai/v1/models إذا كانت الاستجابة قائمة JSON، فإن نقطة النهاية ومفتاح API كلاهما سليم

يفشل التحقق لكن curl يعمل¶

يكون السبب عادةً شرطة مائلة زائدة في Base URL أو مسارًا ينقصه /v1. تأكد من أنك أدخلت https://api.qcode.cc/openai/v1 (بروتوكول OpenAI) دون / زائدة في النهاية. ملاحظة: إن طلب المسار الأساسي مباشرةً والحصول على 401 أمر طبيعي (المسار صحيح، والمصادقة مفقودة) ولا يعني أن الإعداد خاطئ.

لا يستطيع Composer استخدام نماذج Claude¶

يعتمد Composer على بروتوكول OpenAI افتراضيًا، ونقطة نهاية OpenAI لدى QCode لا تقبل نماذج Claude — ولن تفيد إضافة claude-opus-5-5 إلى قائمة Models، لأن الطلب يُرفض بالرمز model_not_available_on_endpoint.

استخدم Path B بدلًا من ذلك: في Models → Anthropic API، أدخل المفتاح الخاص بك من QCode، وفعّل Override Anthropic Base URL بالقيمة https://api.qcode.cc/api، وأفرغ Override OpenAI Base URL (وإلا فإن Cursor يرسل طلبات Claude إلى نقطة نهاية OpenAI ويعيد 422).

التحرير المضمّن (Cmd+K) بطيء¶

يستخدم Cmd+K في Cursor نموذج Cursor السريع افتراضيًا؛ ويؤدي التبديل إلى QCode إلى التوجيه عبر Base URL المُهيأ، لذا يكون زمن الوصول إلى أول token أعلى قليلًا من الخيار المدمج في Cursor (قفزة إضافية واحدة). في الإعدادات، يمكنك إبقاء Cursor Tab على الوضع الافتراضي في Cursor مع توجيه Chat / Composer عبر نقطة نهاية QCode.

Agents Window / الوكلاء في الخلفية تفشل أو لا تستخدم QCode¶

لبعض القدرات الفرعية للوكلاء متطلبات تتعلق بمصدر النموذج، وقد تفرض استخدام نماذج Cursor المدمجة بدلًا من نقطة نهاية مخصصة. هذا مقصود من جانب Cursor ويتغير بين الإصدارات، لذا ارجع إلى وثائق Cursor الرسمية؛ يمكنك تبديل Chat / Composer إلى QCode مع ترك مسارات الوكلاء على الوضع الافتراضي في Cursor.

لا أرى معرّف النموذج الذي أضفته في القائمة المنسدلة¶

تأكد من أنك في قائمة Models قد وضعت علامة على النموذج وأدخلت معرّفه بشكل صحيح عبر + Add model (يراعي حالة الأحرف، ودون مسافات عشوائية). أعد تشغيل Cursor مرة واحدة بعد التغيير لتحديث القائمة.

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

• تكامل VS Code — محرر من العائلة نفسها مع أنماط تهيئة مشتركة
• نقاط النهاية ومسارات API — مرجع كامل لبروتوكولات QCode.cc الثلاثة ونطاقات الدخول الثلاثة
• توليد الصور بـ gpt-image-2 — نقطة نهاية مخصصة لتوليد الصور
• الوكلاء الفرعيون — استخدام الوكلاء الفرعيين في Claude Code
• الأتمتة وCI/CD — سير العمل بلا واجهة
• دليل Claude Code التعليمي — مرجع سير عمل CLI
• الفوترة — قواعد الحصة المشتركة

ليس لديك مفتاح API بعد؟ اختر خطة من qcode.cc/pricing — يعمل المفتاح الواحد في Cursor وClaude Code وكل أداة تدعم نقاط النهاية المخصصة.

المؤسسات ←