بديل OpenAI لـ Claude Code: إعداد وكيل البرمجة
يتصل Claude Code بواجهة Anthropic API الخاصة بها، لذا لا يمكن ببساطة توجيهه إلى نقطة نهاية على نمط OpenAI. إليك ما يعمل بدلاً من ذلك: وكلاء البرمجة الذين يقبلون عنوان URL أساسي مخصصًا لـ OpenAI، وكيفية توصيلهم بهذه الواجهة.
محدّث

نقاط رئيسية
- تم بناء Claude Code حول تنسيق واجهة Anthropic API، بينما تتحدث هذه الخدمة بتنسيق إكمال الدردشة الخاص بـ OpenAI.
- تقبل أدوات Aider و Continue و Cline والأدوات على نمط Cursor عنوان URL أساسي مخصص متوافق مع OpenAI واسم النموذج.
- استخدم عنوان URL الأساسي https://api.minimaxapikey.com/v1 مع معرف النموذج uncensored ومفتاح Bearer.
- اختبر باستخدام curl أولاً، ثم حافظ على التزامن عند أو أقل من 8 طلبات، لأن الوكلاء يطلقون العديد من المكالمات في وقت واحد.
الإجابة المختصرة
إذا كنت تبحث عن بديل OpenAI لـ Claude Code، فإن أول شيء يجب حسمه هو ما تريد استبداله. يُعد Claude Code وكيل برمجة طرفي من Anthropic. وهو مصمم للتواصل مع واجهة Anthropic API الخاصة بها، والتي تستخدم تنسيق طلب مختلف عن تنسيق OpenAI. تطبق هذه الخدمة تنسيق إكمال الدردشة الخاص بـ OpenAI، لذا لا يتكامل الاثنان مع بعضهما البعض بمجرد تغيير عنوان URL.
ما يعمل هو عائلة كبيرة من وكلاء البرمجة وملحقات المحرر التي تقبل أي نقطة نهاية متوافقة مع OpenAI. تقدم لهم عنوان URL أساسيًا ومفتاحًا واسم نموذج، ويرسلون طلبات POST /v1/chat/completions عادية. Aider و Continue و Cline كلها تقع ضمن هذه المجموعة، ولعدة محررات تجاوز عنوان URL الأساسي للنماذج على طراز OpenAI. بالنسبة لهذه الواجهة، فإن القيم الثلاث هي عنوان URL الأساسي https://api.minimaxapikey.com/v1، ومعرف النموذج uncensored، ومفتاحك كرمز Bearer.
حافظ على توقعاتك واقعية. النموذج الذي يقف وراء نقطة النهاية هو نموذج مفتوح الأوزان يشغّله مزود مستقل، مضبوط للإجابة بدون رفض المحتوى للاستخدام القانوني للبالغين. إنه ليس Claude، وليس واجهة برمجة تطبيقات رسمية من أي مورد نموذج. ما إذا كان يناسب مستودعك هو شيء تكتشفه بمهامك الخاصة، وتوضح هذه المقالة كيفية تشغيل هذا الاختبار بتكلفة منخفضة.
لماذا لا يمكنك تغيير عنوان URL في Claude Code فحسب
تنسيق API هو أكثر من مجرد عنوان. يحتوي API الخاص بـ Anthropic على هيكل رسائل خاص به، وطريقة خاصة للتعبير عن الموجّهات النظامية، وكتل استخدام الأدوات الخاصة به، وأحداث البث المتدفق الخاصة به. يتوقع الخادم بأسلوب OpenAI مصفوفة messages تحتوي على الأدوار، ومصفوفة tools لتعريفات الدوال، وأحداث HTTP المرسلة من الخادم تحمل choices[0].delta. سيفشل العميل المصمم لتنسيق واحد أو سيعمل بشكل غير صحيح عند الاتصال بخادم للتنسيق الآخر، حتى لو كان عنوان URL قابلاً للوصول.
يضع بعض الأشخاص طبقة ترجمة بين الاثنين، وهي وكيل صغير يعيد كتابة الطلبات والاستجابات. يمكن أن يعمل ذلك، لكنه برنامج منفصل تقوم بتشغيله وتصحيح الأخطاء فيه بنفسك، وتميل السلوكيات المتعلقة باستدعاء الدوال والبث المتدفق إلى أن تكون نقاط الفشل في مثل هذه الطبقات. هل يقدم Claude Code إعدادًا رسميًا للنقاط النهائية للجهات الخارجية؟ هذا ما يجب التحقق منه في وثائق Anthropic الحالية، لأن هذه الخيارات تتغير.
المسار الأبسط هو اختيار وكيل يتكلم بالفعل بتنسيق OpenAI. لن تخسر شيئًا من حيث الحلقة الأساسية: يقرأ الوكيل ملفاتك، يبني الموجّه، يطلب من النموذج إجراء تعديل، ثم يطبقه. النموذج هو الجزء الذي تقوم بتبديله، وهذا الجزء يحتاج فقط إلى نقطة نهاية متوافقة.
اختبر نقطة النهاية باستخدام curl قبل لمس أي أداة
كل مشكلة تكامل تكون أسهل في التشخيص إذا كنت تعرف بالفعل أن API الخام يعمل. أنشئ مفتاحًا على صفحة مفتاح API، قم بتصديره، وقم بإرسال طلب واحد. إذا نجح هذا، فإن أي فشل لاحق يكون في إعدادات الأداة، وليس في المفتاح أو الشبكة.
export UNCENSORED_KEY="paste-your-key-here"
curl -s https://api.minimaxapikey.com/v1/chat/completions \
-H "Authorization: Bearer $UNCENSORED_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "system", "content": "You are a concise coding assistant."},
{"role": "user", "content": "Write a Python function that parses an ISO date string."}
]
}'
يمكنك أيضًا سرد النماذج باستخدام GET /v1/models. تستدعي العديد من الأدوات هذه نقطة النهاية عند حفظ مزود، للتحقق من صحة المفتاح، لذا من الجدير رؤيتها تعيد النتيجة قبل تكوين أي شيء. يحتوي صفحة التوثيق على مرجع الطلب الكامل.
أين يضع كل أداة عنوان URL الأساسي
تختلف أسماء الإعدادات، لكن الفكرة واحدة في كل مكان. يعرض الجدول أدوات الترميز الشائعة والحقل الذي تملؤه. تتحرك القوائم بين الإصدارات، لذا تعامل معه كخريطة وتحقق من وثائق كل أداة حاليًا.
| الأداة | أين أدخل نقطة النهاية | اسم النموذج للاستخدام |
|---|---|---|
| Aider | متغيرات البيئة أو أعلام سطر الأوامر لعنوان URL الأساسي لـ OpenAI والمفتاح | openai/uncensored |
| متابعة | مدخل نموذج في ملف تكوينه، مع المزود openai وapiBase | uncensored |
| كلاين | قائمة المزود، اختر الخيار المتوافق مع OpenAI | uncensored |
| المؤشر | إعدادات النماذج، قسم مفتاح API لـ OpenAI مع تجاوز عنوان URL الأساسي | uncensored كنموذج مخصص |
| سكربتك الخاص | حجة base_url لأي SDK لـ OpenAI | uncensored |
نظرًا لأن هذا الخدمة تعرض نموذجًا واحدًا فقط، فلا يوجد منتقي نماذج لتكوينه. في أي مكان تريد فيه الأداة اسم نموذج، اكتب uncensored. إذا أصرّت الأداة على قائمة من النماذج المعروفة ورفضت الأسماء المجهولة، ابحث عن خيار "نموذج مخصص" أو "إضافة نموذج".
مثال Aider
يعمل Aider في طرفيتك، ويحرر الملفات في مستودع git ويلتزم بالنتيجة، مما يجعله الأقرب روحًا إلى Claude Code. يستخدم LiteLLM في الخلفية، لذا يحمل اسم النموذج بادئة مزود. للخادم المتوافق مع OpenAI، تكون هذه البادئة openai/.
pip install aider-chat
export OPENAI_API_BASE="https://api.minimaxapikey.com/v1"
export OPENAI_API_KEY="paste-your-key-here"
cd your-repo
aider --model openai/uncensored
بمجرد أن يبدأ، اطلب إجراء تغيير صغير في ملف واحد وشاهد الـ diff. ابدأ بشيء يمكنك التحقق منه في ثوانٍ، مثل إضافة تعليق docstring أو إعادة تسمية دالة، قبل أن تسنده إلى مهمة متعددة الملفات. يرسل Aider خريطة المستودع والملفات التي أضفتها إلى الدردشة في كل خطوة، لذا ينمو الـ prompt بسرعة. نافذة السياق التي تبلغ 100,000 رمز (الموجّه والإكمال) سخية، لكن المستودع الكبير لا يزال يتطلب منك إضافة الملفات ذات الصلة فقط.
إذا حذر Aider من أنه لا يعرف حجم السياق أو سعر النموذج، فهذا متوقع: ليس لديه إدخال لاسم نموذج مخصص. التحذير لا يمنع العمل.
متابعة المثال
Continue هو إضافة محرر يضيف ميزات الدردشة والتحرير والاقتراح التلقائي داخل VS Code وJetBrains. تتضمن تكوينه قائمة بالنماذج، ولكل منها مزود وتجاوزات اختيارية. يبدو إدخال نموذج لهذه الواجهة البرمجية كما يلي. يعتمد اسم الملف الدقيق والبيانات على إصدار Continue المثبت لديك، لذا قارنه مع الوثائق الحالية.
{
"models": [
{
"title": "Uncensored API",
"provider": "openai",
"model": "uncensored",
"apiBase": "https://api.minimaxapikey.com/v1",
"apiKey": "paste-your-key-here"
}
]
}
تعمل طلبات الدردشة والتحرير بشكل جيد مع نقطة نهاية مثل هذه. إكمال Tab التلقائي هو عبء عمل مختلف: يتم تشغيله عند كل توقف تقريبًا أثناء الكتابة ويريد زمن استجابة منخفضًا جدًا، وهو ما تخدمه بشكل أفضل نموذج محلي صغير. استخدام نموذج دردشة مستضاف للإكمال المضمن سيحرق الطلبات مقابل حد 300 طلب في الدقيقة لديك مع قليل من المخرجات.
بناء وكيل أساسي بنفسك
إذا لم يكن هناك أداة موجودة تناسبك، فإن دعم استدعاء الدوال يجعل كتابة وكيل صغير أمرًا سهلاً. تقبل الواجهة البرمجية tools و tool_choice، وتُبث tool_calls مرة أخرى، وتأخذ النتائج كرسائل مع role: "tool". تعطي الحلقة أدناه النموذج دالة واحدة لقراءة ملف، ثم يستمر في العمل حتى يجيب النموذج بنص عادي.
import json
from openai import OpenAI
client = OpenAI(base_url="https://api.minimaxapikey.com/v1", api_key="paste-your-key-here")
tools = [{
"type": "function",
"function": {
"name": "read_file",
"description": "Return the text of a file in the current project.",
"parameters": {
"type": "object",
"properties": {"path": {"type": "string"}},
"required": ["path"],
},
},
}]
messages = [{"role": "user", "content": "Summarise what main.py does."}]
while True:
resp = client.chat.completions.create(model="uncensored", messages=messages, tools=tools)
msg = resp.choices[0].message
messages.append(msg)
if not msg.tool_calls:
print(msg.content)
break
for call in msg.tool_calls:
args = json.loads(call.function.arguments)
with open(args["path"], encoding="utf-8") as f:
result = f.read()
messages.append({"role": "tool", "tool_call_id": call.id, "content": result})
أضف دالة كتابة وموجه تأكيد قبل تشغيلها، وستحصل على أساس وكيل برمجي في حوالي خمسين سطرًا. تحقق دائمًا من المسارات قبل القراءة أو الكتابة: يمكن للنموذج طلب أي مسار يريده.
الحدود والتكاليف للتخطيط حولها
يتصرف الوكلاء بشكل مختلف عن شخص يشارك في الدردشة. يرسلون دفعات من الطلبات، وغالبًا عدة طلبات متزامنة. يسمح المفتاح الكامل بـ 8 طلبات متزامنة و300 طلب في الدقيقة. يسمح مفتاح التجربة بـ 2 طلب متزامن و60 طلب في الدقيقة، وهو ما قد يكون ضيقًا بالنسبة لوكيل. عند تجاوز حد، تجيب الواجهة البرمجية بـ HTTP 429 ورمز الخطأ rate_limited أو concurrency. عند التحميل الزائد المؤقت، تعيد أيضًا 429 مع Retry-After: 5. معظم العملاء الجيدين يعيدون المحاولة عند 429، ولكن إذا لم يفعل عميلك ذلك، فقلل من إعداداته المتزامنة. يحتفظ الطلب المتدفق بمكان التزامن الخاص به حتى ينتهي البث، لذا فإن تعديلات البث الطويلة تحسب ضمن الـ 8.
من حيث التكلفة، الفوترة هي الدفع حسب الاستخدام من رصيد مسبق الدفع بسعر $0.15 لكل مليون رمز إدخال و $0.50 لكل مليون رمز إخراج. لنفترض أن جلسة إرسال 40 طلبًا تحمل 30,000 رمز إدخال لكل منها، وتتلقى 1,000 رمز إخراج لكل منها. هذا 1,200,000 رمز إدخال، أو $0.18، بالإضافة إلى 40,000 رمز إخراج، أو $0.02، بمجموع $0.20. الطلبات الفاشلة أو المرفوضة لا تُحسب، ولا ينتهي الرصيد المسبق. انظر صفحة الأسعار لمبالغ الشحن والمكافآت.
يمكن للحسابات الجديدة المطالبة بـ $0.50 من رصيد تجريبي بنقرة واحدة على صفحة المفتاح، دون الحاجة إلى بطاقة، صالح لمدة 7 أيام. هذا يكفي لتشغيل اختبار curl وعدة تعديلات صغيرة في Aider. لا تُستخدم الموجّهات للتدريب.
المزيد من الأدلة
أسئلة وأجوبة
هل يمكنني توجيه Claude Code نفسه إلى هذه الواجهة البرمجية؟
ليس مباشرة. تم بناء Claude Code لتنسيق API الخاص بـ Anthropic، بينما تنفذ هذه الخدمة إكمال دردشة بأسلوب OpenAI. تحقق من وثائق Anthropic الحالية حول ما يدعمه Claude Code، واستخدم وكيلًا متوافقًا مع OpenAI إذا كنت تريد استخدام نقطة النهاية هذه.
أي أدوات البرمجة تعمل مع Base URL مخصص لـ OpenAI؟
تسمح Aider و Continue و Cline جميعها بإدخال Base URL متوافق مع OpenAI، ومفتاح واسم نموذج. يوفر Cursor أيضًا تجاوز Base URL للنماذج بأسلوب OpenAI، على الرغم من أنه يجب عليك التحقق من إعداداته الحالية وحدود الخطط.
هل تدعم الواجهة البرمجية استدعاء الدوال للوكلاء؟
نعم. يمكنك إرسال الأدوات وtool_choice، واستلام tool_calls عبر البث المتدفق، وإرجاع النتائج باستخدام role: tool. يعتمد ما إذا كان ملحق محرر معين يستخدم هذه الحقول على البرنامج الإضافي.
كم تبلغ تكلفة جلسة البرمجة؟
التسعير هو $0.15 لكل مليون رمز إدخال و $0.50 لكل مليون رمز إخراج. تعيد الوكلاء إرسال الكثير من السياق، لذا تهيمن رموز الإدخال عادةً على الفاتورة.
مفتاحك على بُعد استمارة واحدة
أنشئ حساباً، وانسخ المفتاح، ثم غيّر URL الأساسي. هذه هي الإعدادات الكاملة.