دليل إعداد API لـ Claude / GPT / النماذج الصينية في Kilo Code
اعتبارًا من 2026-10-07، يمكنك توصيل Kilo Code بـ API الخاص بـ Claude على النحو التالي: Settings → Providers tab ← مرّر إلى الأسفل ← Custom provider، واضبط Provider API على Anthropic Messages، وBase URL على https://api.qcode.cc/api (من دون شرطة مائلة في النهاية)، ومفتاح cr_ الخاص بك، واكتب معرّف النموذج يدويًا. أما GPT والنماذج الصينية، فاختر OpenAI Compatible مع Base URL https://api.qcode.cc/openai/v1. تجمع هذه الصفحة الخطوات ومعرّفات النماذج والأخطاء الشائعة من وثائق QCode ووثائق Kilo الرسمية.
آخر تحديث 2026-11-14
وجّه هذه الأداة إلى نقطة نهاية QCode — مفتاح واحد لـ Claude وGPT والنماذج الصينية.
- الفوترة حسب token — الأسعار المباشرة على /models
- الدفع بالبطاقة (Visa / Mastercard) أو Apple Pay أو Google Pay أو العملات الرقمية
- خدمة ذاتية: شحن الرصيد والتفعيل فورًا
أربعة أمور يجب معرفتها قبل البدء
Provider API الخاص بـ Claude
Base URL https://api.qcode.cc/api. توصي وثائق QCode بالتوقف عند /api وترك الإضافة تُلحق /v1/messages.
GPT والنماذج الصينية
Base URL https://api.qcode.cc/openai/v1، ومفتاح cr_ نفسه، ومعرّفات النماذج مكتوبة يدويًا، مثل gpt-6-sol أو glm-5.2.
أين يوجد الإعداد
Settings (gear) → Providers tab ← أسفل القائمة ← Custom provider. تشير وثائق QCode إلى أنه لم يعد قائمة منسدلة API Provider بأسلوب Roo Code.
أحدث إصدار مستقر (2026-10-01)
أحدث إصدار مستقر على GitHub اعتبارًا من 2026-10-07؛ أضاف زر Fetch Models اليدوي إلى نافذة Custom Provider. تلاه إصدار تجريبي v7.8.7 في 2026-10-07.
كيف يتصل Kilo Code بـ API مخصص
اعتبارًا من 2026-10-07، يعني توصيل Claude في Kilo Code إضافة Custom provider في أسفل Providers tab: Provider API هو Anthropic Messages، وBase URL هو https://api.qcode.cc/api، ومفتاح cr_ الخاص بك، ومعرّف نموذج مكتوب يدويًا. أما GPT والنماذج الصينية، فاستخدم النافذة نفسها مع OpenAI Compatible وhttps://api.qcode.cc/openai/v1. يصفه README الرسمي لـ Kilo بأنه وكيل برمجة مفتوح المصدر لـ VS Code وJetBrains وCLI. وتقول وثائق QCode إنه نسخة متفرعة من Roo Code، الذي تفرّع بدوره من Cline، لكن الواجهات تباعدت، لذا لا تنطبق خطوات هاتين الأداتين.
هل لا يزال Kilo Code قيد الصيانة؟ (اعتبارًا من 2026-10-07)
اعتبارًا من 2026-10-07، يُحدَّث Kilo Code بنشاط: مستودع GitHub Kilo-Org/kilocode غير مؤرشف، ويستخدم رخصة MIT، وآخر عملية push تلقاها كانت في 2026-10-07 (UTC). أحدث إصدار مستقر هو v7.8.3 بتاريخ 2026-10-01 (UTC)؛ وتذكر ملاحظاته «إضافة زر Fetch Models اليدوي إلى نافذة إعدادات Custom Provider». ظهر إصدار تجريبي v7.8.7 في 2026-10-07، وإضافة JetBrains 7.1.9-rc.1 في 2026-09-28 (UTC). بخصوص الملكية، تقول وثائق Kilo الرسمية إن Kilo قد استحوذت عليها Anaconda. وتقول وثائق QCode إن مدخل نقطة النهاية المخصصة قد أعيد تصميمه؛ وتتبع هذه الصفحة الواجهة الجديدة.
الجدول الزمني للإصدارات والوثائق
تم تحديث دليل QCode لـ Kilo Code وصفحة نقاط النهاية، مع خطوات مكتوبة للواجهة الجديدة لـ Custom provider (آخر تحقق من دليل Kilo كان في 2026-09-18).
صدر Kilo Code v7.8.3 كإصدار مستقر (UTC)؛ وتذكر ملاحظاته زر Fetch Models اليدوي في نافذة Custom Provider.
ينشر Kilo Code الإصدار التجريبي v7.8.7 (UTC) ويتلقى المستودع عمليات push في اليوم نفسه؛ ويظل v7.8.3 أحدث إصدار مستقر.
مؤكد مقابل غير موثق
مؤكد (حرفيًا في الوثائق)
كل ما يلي يمكن مطابقته كلمة بكلمة في وثائق QCode أو وثائق Kilo الرسمية أو على GitHub: نقطة الإدخال هي Settings → Providers tab → Custom provider في الأسفل؛ وحقول النافذة هي Provider ID وDisplay name وProvider API وBase URL وAPI key وModels وHeaders الاختيارية، وبعد Submit تظهر النماذج في منتقي النماذج؛ وتذكر Kilo أن نماذج Anthropic تستخدم Anthropic Messages، بينما تستخدم OpenAI وxAI واجهة OpenAI Responses؛ ويستخدم Claude الرابط https://api.qcode.cc/api، وتستخدم GPT والنماذج الصينية الرابط https://api.qcode.cc/openai/v1، وكلاهما بمفتاح cr_ نفسه؛ وعند استخدام Claude ضمن OpenAI Compatible يُرجع model_not_available_on_endpoint؛ وصدر v7.8.3 في 2026-10-01.
غير موثق أو غير متحقق منه
أربع نقاط تتركها هذه الصفحة مفتوحة: 1) ما إذا كانت النماذج تُجلب تلقائيًا ضمن Anthropic Messages: يقول Kilo إنه يجلبها تلقائيًا عندما يعرّض Base URL نقطة نهاية نماذج متوافقة مع OpenAI؛ لم يُختبر ذلك هنا، لذا تفترض هذه الصفحة أنك تكتب معرّفات النماذج. 2) ما إذا كانت شرطة مائلة زائدة في النهاية تسبب 404 فورًا: يقول دليل QCode Kilo إن هذا لم يُختبر؛ وتقول صفحة نقاط النهاية إنه ينتج عمومًا //v1/messages و404. 3) خطوات إضافة JetBrains غير موجودة في وثائق QCode؛ تغطي هذه الصفحة إضافة VS Code فقط. 4) تسمي وثائق Kilo الرسمية ملف الإعداد kilo.json في موضع وkilo.jsonc في موضع آخر؛ لا تقدم هذه الصفحة أي إعداد قائم على ملفات.
كيف تختار
Anthropic Messages مقابل OpenAI Compatible
اختر حسب عائلة النموذج: لا يعمل Claude إلا مع Anthropic Messages (https://api.qcode.cc/api)، لأن نقطة نهاية OpenAI في QCode لا تقبل نماذج Claude؛ ويستخدم GPT وضع OpenAI Compatible (https://api.qcode.cc/openai/v1). يعمل GLM وKimi وDeepSeek وQwen على نقطتي النهاية وفقًا لصفحة نقاط النهاية في QCode، ويعرض دليل Kilo إعداد OpenAI Compatible.
Kilo Code مقابل Roo Code / Cline
الأصل البرمجي نفسه، لكن الواجهات مختلفة: يستخدم Kilo مربع حوار Custom provider في علامة تبويب Providers، بينما لا يزال Roo Code وCline يستخدمان قائمة منسدلة API Provider. تحذر وثائق QCode من أن الخطوات لا تنتقل بين الأدوات؛ اتبع صفحة الإعداد للأداة التي تستخدمها فعليًا.
ست خطوات نحو Claude (مع GPT والنماذج الصينية)
1) افتح الإعدادات (أيقونة الترس) في الشريط الجانبي لـ Kilo Code، وانتقل إلى علامة تبويب Providers، ومرّر إلى الأسفل وانقر على Custom provider. 2) أدخل Provider ID فريدًا (أي اسم يصلح؛ وتستخدم الوثائق qcode كمثال) وأي Display name. 3) اضبط Provider API على Anthropic Messages، وBase URL على https://api.qcode.cc/api (دون شرطة مائلة في النهاية)، ومفتاح API على مفتاح QCode الخاص بك الذي يبدأ بـ cr_. 4) اكتب معرّف النموذج ضمن Models، مثل claude-sonnet-5؛ ويُكتب claude-sonnet-5-5 وclaude-opus-5-5 بالطريقة نفسها. يمكن أن تبقى Headers فارغة. 5) انقر على Submit؛ تظهر النماذج في منتقي النماذج. أرسل رسالة واحدة في الدردشة للتحقق. 6) بالنسبة إلى GPT والنماذج الصينية، أضف Custom provider آخر: Provider API OpenAI Compatible، وBase URL https://api.qcode.cc/openai/v1، والمفتاح cr_ نفسه، ونماذج مثل gpt-6-sol أو gpt-5.6-terra أو glm-5.2.
على QCode
على QCode، يعمل مفتاح cr_ واحد عبر البروتوكولات، ويحدد مسار الطلب البروتوكول: تمر claude-sonnet-5 وclaude-sonnet-5-5 وclaude-opus-5-5 عبر Anthropic Messages على https://api.qcode.cc/api؛ وتمر gpt-6-sol وgpt-5.6-terra وglm-5.2 وdeepseek-v4.1-flash وkimi-k3 عبر OpenAI Compatible على https://api.qcode.cc/openai/v1. يعمل المفتاح نفسه على نطاقات الوصول الثلاثة: يخدم us.qcode.cc أمريكا الشمالية وأوروبا، وتقترح الوثائق على الشبكات في البر الرئيسي للصين تبديل النطاق إلى asia.qcode.cc مع المفتاح نفسه. تتم الفوترة حسب token؛ راجع /models لسعر كل نموذج. تظهر سجلات الطلبات على probe.qcode.cc بعد إدخال مفتاحك.
الأسئلة الشائعة
أي Provider API ينبغي اختياره لـ Claude في Kilo Code؟
Anthropic Messages. في مربع حوار Custom provider، اضبط Base URL على https://api.qcode.cc/api، وأدخل مفتاح cr_ الخاص بك، واكتب معرّف نموذج مثل claude-sonnet-5 ضمن Models. تقول وثائق Kilo الرسمية إن نماذج Anthropic تستخدم Anthropic Messages، وتحذر وثائق QCode من استدعاء Claude عبر OpenAI Compatible.
ماذا يعني model_not_available_on_endpoint؟
اخترت البروتوكول الخطأ؛ المفتاح سليم. مع Claude ضمن OpenAI Compatible، يعيد QCode خطأً مثل «Model 'claude-sonnet-5' is not available on this endpoint». تنص الوثائق على أن هذا الفحص يتم قبل المصادقة، لذا يظهر حتى مع مفتاح غير صالح. انتقل إلى Anthropic Messages مع Base URL https://api.qcode.cc/api.
هل ينبغي أن يتضمن Base URL المسار /v1 أم شرطة مائلة في النهاية؟
بالنسبة إلى Anthropic Messages، توقف عند /api (https://api.qcode.cc/api) ودع الإضافة تُلحق /v1/messages؛ وبالنسبة إلى OpenAI Compatible، استخدم https://api.qcode.cc/openai/v1 كما تُظهر وثائق QCode. لا تُدرج الشرطة المائلة في النهاية في الحالتين: يقول دليل QCode Kilo إنه لم يختبر ما إذا كانت الشرطة الزائدة تسبب 404، وتقول صفحة نقاط النهاية إنها تنتج عمومًا //v1/messages و404.
claude-sonnet-5-5 ليس في القائمة المنسدلة للنماذج. ماذا الآن؟
اكتب معرّف النموذج بنفسك. تقول وثائق QCode إنه عندما لا تتضمن القائمة المدمجة معرّفًا، تدخله في حقل معرّف النموذج المخصص؛ وتقول وثائق Kilo الرسمية أيضًا إنه يمكنك إدخال معرّفات النماذج يدويًا إذا فشل الاكتشاف التلقائي. بعد تصحيح Base URL أو مفتاح API، انقر على Fetch models بجوار قائمة النماذج لإعادة المحاولة. إذا ظهر Model Not Found، فتحقق من أن معرّف النموذج صالح.
تم تعيين المفتاح لكن الاتصال لا يزال يفشل. ما الذي ينبغي التحقق منه؟
أرسل أولًا اختبار POST إلى https://api.qcode.cc/api/v1/messages باستخدام curl في الطرفية: إذا احتوى رد JSON على محتوى، فنقطة النهاية سليمة والمشكلة في إعدادات الإضافة. عند ظهور Invalid API key، تأكد من أن المفتاح يبدأ بـ cr_ ولا يحتوي على مسافات بادئة أو لاحقة. لا تعتمد على فتح https://api.qcode.cc/api مباشرة للحكم: فهو يعيد صفحة تعريف HTML (HTTP 200)، وهي ليست خطأً ولا دليلًا على أن المسار يعمل.
هل ما زال Kilo Code قيد الصيانة؟
نعم. اعتبارًا من 2026-10-07، مستودع GitHub Kilo-Org/kilocode غير مؤرشف، وآخر عملية دفع تلقّاها كانت في 2026-10-07 (UTC)؛ صدر أحدث إصدار مستقر v7.8.3 في 2026-10-01، ثم صدر إصدار تمهيدي يحمل الرقم v7.8.7 في 2026-10-07.
المصادر
خطوات الإعداد وأنواع API الخاصة بالمزوّد وعناوينها: دليل Kilo Code في وثائق QCode (محدّث 2026-09-25) وصفحة نقاط النهاية وتنسيقات API (محدّثة 2026-09-25، وتغطي النماذج التي تستخدم كل نقطة نهاية، ونص الخطأ الدقيق، ونطاقات الوصول الثلاثة)، وتم استرجاعهما في 2026-10-07. واجهة Kilo وحقولها: صفحتا OpenAI Compatible وAnthropic في وثائق Kilo الرسمية (kilo.ai/docs)، وتم استرجاعهما في اليوم نفسه. حالة الصيانة والإصدارات: README في مستودع GitHub Kilo-Org/kilocode، والبيانات الوصفية للمستودع، وReleases، وتم استرجاعها في اليوم نفسه.
اربط QCode في Kilo Code
مفتاح cr_ واحد: Claude عبر Anthropic Messages، وGPT والنماذج الصينية عبر OpenAI Compatible. تتم الفوترة لكل token؛ راجع /models لمعرفة سعر كل نموذج.
قراءات ذات صلة
ما هو T3 Code وكيف تستخدم مفتاح API الخاص بك (2026-11)
ما هو T3 Code، واجهة تحكم مفتوحة المصدر لـ Claude Code وCodex وغيرهما من الوكلاء، وكيف تشغّل نسخته من Claude باستخدام مفتاح API الخاص بك عبر ANTHROPIC_BASE_URL.
Kilo Code 7.8.12: تتجه حركة مرور البوابة إلى ai-gateway.kilo.ai
بدءًا من Kilo Code 7.8.12، تتجه حركة مرور البوابة افتراضيًا إلى ai-gateway.kilo.ai: الصياغة الرسمية للإصدار، والفرق بين KILO_AI_GATEWAY_URL وKILO_API_URL، وما لا ينص عليه الإصدار، وحقول QCode.
إعداد نقطة نهاية مخصصة لـ Claude Code
متغيرا البيئة، وصيغة settings.json، وapiKeyHelper.
دليل الدفع بالعملات المشفرة
تسع عملات، و56 شبكة، وبدون رسوم منصة لرصيد API للبرمجة بالذكاء الاصطناعي.
تم التحقق من الخطوات والاقتباسات في هذه الصفحة في 2026-10-07 بمقارنتها مع وثائق QCode ووثائق Kilo الرسمية وملاحظات إصدار GitHub؛ والصفحات الرسمية هي المرجع، وقد تحدث تغييرات من المزوّد دون إشعار. تتغير تسميات الإضافة بين الإصدارات، لذا اعتمد على الإصدار الذي لديك؛ وتُدرج إتاحة النماذج على /models.