الرئيسيةالدليل
إعداد نقطة النهاية المخصصة لواجهة برمجة تطبيقات Claude Code في Cursor
هل تبحث عن تكوين واجهة برمجة تطبيقات Claude Code لـ Cursor لا يعتمد على مورد واحد؟ يمكن لـ Cursor التحدث مع أي نقطة نهاية متوافقة مع OpenAI، ويوضح هذا الدليل كل إعداد تحتاجه.
تم التحديث

ما تقوم بإعداده
Cursor محرر يحتوي على ميزات ذكاء اصطناعي مدمجة. من بين إعدادات النموذج الخاصة به يوجد حقل يتيح لك استبدال عنوان URL الأساسي لـ OpenAI بعنوان URL خاص بك، بالإضافة إلى مكان لإدخال مفتاحك الخاص. وهذا يتيح إرسال طلبات الدردشة إلى أي خدمة تتبع تنسيق OpenAI chat-completions. هذه الخدمة تتبع هذا التنسيق، لذا يمكن لـ Cursor استخدامه كنموذج خلف الدردشة والتعديلات المضمنة.
القيم التي ستدخلها ثابتة. Base URL: https://api.claudecodeapikey.com/v1. اسم النموذج: uncensored. المفتاح: هو المفتاح من حسابك، يُرسل كرمز Bearer. لا يحتاج الخادم إلى إعدادات أخرى.
كن واضحًا بشأن ماهية هذا. النموذج الموجود خلف نقطة النهاية هو نموذج مفتوح الأوزان من مزود مستقل. إنه ليس نموذج Claude وليس واجهة برمجة التطبيقات الرسمية لشركة Anthropic أو أي طرف آخر. إذا كنت قد أتيت إلى هنا متوقعًا وجود Claude نفسه داخل Cursor، فهذا شيء مختلف، وتشرح الأقسام الختامية كيفية الحكم على ما إذا كان كافيًا لعملك.
قبل فتح Cursor
جهّز هذه أولاً حتى لا تتوقف في منتصف الطريق.
- أنشئ حسابًا باستخدام Google أو باستخدام البريد الإلكتروني وكلمة المرور.
- افتح صفحة مفتاح API وأنشئ مفتاحاً. يوضح دليل المفاتيح مكان كل زر.
- احصل على رصيد تجريبي مجاني بقيمة $0.50 إذا كنت تريد الاختبار دون الدفع. يتطلب نقرة واحدة، ولا يحتاج إلى بطاقة، ويستمر لمدة 7 أيام.
- قم بإجراء فحص سريع من الطرفية للتأكد من أن المفتاح يعمل قبل إلقاء اللوم على المحرر.
curl https://api.claudecodeapikey.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Say ready."}]}'
يعني الرد بصيغة JSON مع رسالة أن المفتاح وعنوان URL صحيحان. يعني خطأ HTTP 401 أن المفتاح خاطئ أو يحتوي على مسافة زائدة. أصلح ذلك هنا، لأن رسائل الخطأ في Cursor أقل تحديدًا من رسائل curl.
تكوين خطوة بخطوة في Cursor
تتغير أسماء القوائم بين إصدارات Cursor، لذا تعامل مع التسميات أدناه كدليل وابحث عن أقرب تطابق.
- افتح إعدادات Cursor وانتقل إلى قسم النماذج.
- ابحث عن حقل مفتاح API الخاص بـ OpenAI والصق مفتاحك من هذه الخدمة.
- فعّل خيار تجاوز Base URL الخاص بـ OpenAI، وأدخل
https://api.claudecodeapikey.com/v1. أضف/v1في النهاية ولا تضف أي مسار إضافي مثل/chat/completions. - استخدم خيار إضافة نموذج مخصص، واكتب
uncensoredبالضبط، بحروف صغيرة. - اضغط على زر التحقق أو الحفظ بجانب حقل المفتاح. يرسل Cursor طلب اختبار صغير.
- افتح لوحة الدردشة، واختر
uncensoredمن قائمة اختيار النموذج، وأرسل موجّهًا قصيرًا.
إذا فشل خطوة التحقق ولكن فحص curl نجح، فتأكد من أنك أدخلت عنوان URL في حقل عنوان URL الأساسي وليس في حقل المفتاح، وأن إصدار Cursor الخاص بك لم يعيد تعيين التجاوز بعد التحديث. يحتفظ دليل البدء السريع بالخطوات الحالية لهذا المحرر.
تفاصيل تستحق المعرفة: ينطبق التجاوز الواحد على فتحة مزود OpenAI. إذا كنت تستخدم أيضًا نماذج OpenAI الحقيقية عبر هذه الفتحة، فسيتم توجيهها إلى نقطة النهاية هذه أيضًا. يحتفظ العديد من الأشخاص بملف تعريف Cursor منفصل أو يعطلون التجاوز عندما يريدون العودة.
اختبر بموجه برمجة حقيقي
تحية بسيطة لا تثبت شيئاً. استخدم موجّهاً يختبر السياق والتعليمات. حدد دالة في مشروعك، افتح الدردشة، واطلب شيئاً محدداً، مثل إضافة التحقق من المدخلات واختبار وحدة. راقِ ثلاثة أشياء.
- البث المتدفق. يجب أن يظهر الجواب رمزًا تلو الآخر. نقطة النهاية تبث عبر SSE، لذا فإن الانتظار الطويل ثم ظهور كتلة نصية يشير إلى أن وسيطًا أو إعدادًا يقوم بتخزينه مؤقتًا.
- استخدام السياق. أرفق ملفين أو ثلاثة واسأل سؤالًا يتطلب جميعها. نافذة السياق تتسع لـ 100,000 رمز، وهو ما يحتوي على قدر كبير من المصادر، لكن محررك هو الذي يقرر الكمية التي يرسلها فعليًا.
- اتباع التعليمات. اطلب ردّاً يقتصر على الاختلافات (diff-only) أو طلب تنسيق مخرج صارم، وشاهد ما إذا كان النموذج يلتزم بذلك. تختلف النماذج مفتوحة الأوزان في هذا الجانب، ومن الأفضل أن تتعلم ذلك منذ اليوم الأول.
احتفظ بقائمة قصيرة من خمس مهام حقيقية من مستودعك الخاص، وأعد تشغيلها كلما غيّرت إعداداً مثل درجة الحرارة (temperature). الحكم على أساس كودك الخاص يتفوق على أي ادعاء عام، بما في ذلك ادعاءاتنا.
تصحيح الأخطاء الشائعة
401 أو مفتاح غير صالح
المفتاح غير صحيح، أو انتهت صلاحيته في الحافظة، أو يحتوي على مسافات بيضاء حوله. أعد لصقه مرة أخرى. تأكد من أن مخطط المصادقة (Authorization scheme) هو Bearer، وهو ما يقوم به Cursor لك عند استخدام حقل مفتاح OpenAI.
404 أو النموذج غير موجود
في الغالب، المشكلة تتعلق بـ Base URL. يؤدي فقدان /v1 أو وجود /chat/completions إضافي إلى كسر المسار. يجب أن يكون اسم النموذج هو uncensored، بدون أحرف كبيرة أو مسافات.
429 مع حدّ المعدل أو الطلبات المتزامنة
لقد تجاوزت حداً معيناً. يسمح المفتاح التجريبي بـ 2 طلب متزامن (concurrent requests) و60 طلب في الدقيقة، بينما يسمح المفتاح الكامل بـ 8 طلبات متزامنة و300 طلب في الدقيقة. يمكن للمحرر إطلاق عدة طلبات في وقت واحد، مثل المحادثة بالإضافة إلى التعديلات الخلفية، وتحتفظ عمليات البث المتدفق (streaming) بمكانها حتى تنتهي. يوضح رمز الخطأ الحد الذي تم تجاوزه: يشير rate_limited إلى الطلبات في الدقيقة، ويشير concurrency إلى تعدد الطلبات في وقت واحد. يؤدي الحمل الزائد المؤقت أيضاً إلى إرجاع خطأ 429 مع Retry-After: 5، لذا فإن الانتظار لمدة خمس ثوانٍ ثم إعادة المحاولة هو الإجراء الصحيح.
انقطاع الإجابة
تتسع نافذة السياق لـ 100,000 رمز (token)، وتشمل الموجّه (prompt) والإكمال (completion). يترك المرفق الكبير جداً مساحة ضئيلة للرد. أرسل ملفات أقل، أو ابدأ محادثة جديدة.
ميزات لا فائدة منها
الواجهة البرمجية (API) مخصصة للنصوص فقط، ولا تقدم خدمات التضمين (embeddings). إذا كانت ميزة في Cursor تتطلب نموذج تضمين أو إدخال صورة، فلن تعمل عبر نقطة النهاية (endpoint) هذه.
إعدادات تستحق الضبط بمجرد أن تعمل
بعد أول محادثة ناجحة، ستؤدي بعض التعديلات إلى سلاسة الاستخدام اليومي.
خفض درجة الحرارة (temperature) لمهام التحرير. إذا كان محرر الكود يتيح لك ذلك، فإن القيمة حوالي 0.2 تعطي استقراراً أكبر للكود. ولأجل العصف الذهني، ارفعها. بعد ذلك، انتبه إلى مقدار نافذة السياق التي ترفقها. تتسع النافذة كثيراً، لكن كل ملف مرفق يُحسب كمدخلات، لذا فإن إغلاق التبويبات غير ذات الصلة واستبعاد مجلدات البناء (build folders) يقلل التكلفة ويركّز الإجابات.
إذا كنت تستخدم وضع الوكيل (agent) أو الوضع متعدد الخطوات، فتذكر دعم استدعاء الدوال (function calling): تقبل نقطة النهاية (endpoint) المعامل tools و tool_choice، وتُبثّ (streams) tool_calls. يعتمد ما إذا كانت ميزة معينة في Cursor تستخدمها أم لا على الإصدار، لذا قم بتشغيل مهمة وكيل صغيرة واقرأ ما يحدث قبل الوثوق بها لإجراء تغيير كبير. وأخيراً، ألقِ نظرة على رأس الاستجابة X-Balance-USD في اختبار طرفي (terminal) من حين لآخر، حتى لا يفاجئك انخفاض الرصيد في منتصف العمل.
استخدام نفس المفتاح في السكربتات
أحد مزايا نقطة النهاية (endpoint) المتوافقة مع OpenAI هو أن المفتاح الذي تضبطه في Cursor يعمل أيضاً في الكود. إليك مثال بلغة Node.js، وهو مفيد لسكربتات البناء أو أدوات رسائل الالتزام (commit-message).
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.claudecodeapikey.com/v1",
apiKey: process.env.API_KEY,
});
const out = await client.chat.completions.create({
model: "uncensored",
messages: [
{ role: "user", content: "Write a conventional commit message for: fixed null check in parser" },
],
});
console.log(out.choices[0].message.content);
احفظ المفتاح في متغير بيئة، وليس في ملف تقوم بإدراجه في المستودع. يتضمن كل رد رأس استجابة X-Balance-USD، لذا يمكن للسكربت أن ينبهك عندما ينفد الرصيد.
التكلفة ومتى تكتفي بإعدادك الحالي
استخدام المحرر كثيف المدخلات لأن كل طلب يحمل سياق الملفات. بتكلفة $0.15 لكل مليون رمز مدخل و$0.50 لكل مليون رمز مخرج، يكلف الطلب الذي يحتوي على 15,000 رمز مدخل و1,000 رمز مخرج: 0.015 × $0.15 + 0.001 × $0.50 = $0.00225 + $0.0005 = $0.00275. ومائة طلب من هذا النوع تكلف $0.275. تحتوي صفحة التسعير على مبالغ شحن الرصيد (top up)، بدءاً من $20، مع مكافآت من $50.
احتفظ بإعدادك الحالي إذا كنت تعتمد على نموذج مورد معين لإعادة الهيكلة الصعبة (hard refactors)، أو إذا كان سير عملك يعتمد على ميزات لا يمكن لنقطة نهاية المحادثة العادية توفيرها. استخدم هذا الإعداد عندما تريد سعرًا منخفضًا لكل رمز (token)، وواجهة برمجية (API) بسيطة، ورفضاً أقل للمحتوى في الأعمال القانونية. يحتفظ العديد من المطورين بكلا الإعدادين ويبدّلان بينهما حسب المهمة.
المزيد من الأدلة
أسئلة وأجوبة
ما هي Base URL التي أدخلها في Cursor؟
أدخل https://api.claudecodeapikey.com/v1 بما في ذلك /v1. لا تضيف /chat/completions في النهاية.
ما اسم النموذج الذي يجب أن أضيفه؟
أضف نموذجاً مخصصاً باسم uncensored، بحروف صغيرة. إنه معرف النموذج الوحيد الذي تخدمه API.
هل يمنحني هذا نماذج Claude في Cursor؟
لا. نقطة النهاية تقدم نموذجًا واحدًا مفتوح الأوزان من مزود مستقل. إنها ليست API رسمية من Anthropic أو أي مورد آخر.
لماذا أحصل على أخطاء 429 في المحرر؟
إما أنك تجاوزت الحد لكل دقيقة أو لديك طلبات كثيرة في آن واحد. المفتاح التجريبي يسمح بـ 2 طلب متزامن و60 طلب في الدقيقة، والمفتاح الكامل يسمح بـ 8 و300.
هل يمكنني تجربته دون دفع؟
نعم. يمكن للمستخدمين الجدد الحصول على $0.50 من رصيد تجريبي في صفحة مفتاح API. لا يتطلب بطاقة وهو صالح لمدة 7 أيام.
مفتاحك على بُعد نموذج تسجيل واحد
أنشئ حساباً، وانسخ المفتاح، ثم غيّر URL الأساسي. هذه هي الإعدادات الكاملة.