إعداد Kilo Code

اربط QCode.cc في إضافة Kilo Code لـ VS Code: الإعدادات -> Providers -> Custom provider، مع ضبط Provider API على Anthropic Messages لـ Claude

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

آخر تحقق: 2026-09-18 · 📄 وفق الوثائق الرسمية (إضافة Kilo Code؛ الوثائق على kilo.ai)

⚠️ تغيّرت الملكية وواجهة المستخدم: في 2026-07-15 أعلنت Anaconda استحواذها على Kilo Code. منذ ذلك الحين أعاد Kilo تصميم إدخال نقطة النهاية المخصصة: لم يعد إدخال Roo Code «API Provider dropdown + tick Use custom base URL»، بل أصبح الإعدادات → تبويب Providers → مربع حوار Custom provider (كما ورد حرفيًا في صفحتي anthropic وopenai-compatible الرسميتين). تتبع الخطوات أدناه واجهة المستخدم الجديدة.

نظرة سريعة¶

Kilo Code هي إضافة مفتوحة المصدر للبرمجة بالذكاء الاصطناعي لـ VS Code. وهي تفرّع من Roo Code، الذي تفرّع بدوره من Cline — الأصل نفسه، وواجهات مختلفة: يستخدم Kilo مربع حوار Custom provider في تبويب Providers، بينما لا يزال Roo Code وCline يستخدمان قائمة منسدلة API Provider. لا تنسخ هذه الخطوات إلى هاتين الأداتين؛ اقرأ صفحتيهما الخاصتين.

أي بروتوكول¶

🔴 لا تستدعِ Claude أبدًا عبر OpenAI Compatible — ترفض نقطة نهاية OpenAI لدى QCode نماذج Claude مع رسالة الخطأ model_not_available_on_endpoint. وتضع الوثائق الرسمية كذلك Anthropic وMiniMax ضمن Anthropic Messages.

التثبيت¶

ابحث عن Kilo Code في سوق إضافات VS Code، أو اتبع التعليمات على kilo.ai.

إعداد Claude (مزوّد مخصص)¶

1. افتح الإعدادات في الشريط الجانبي لـ Kilo Code (أيقونة الترس) وانتقل إلى علامة التبويب المزوّدون
2. مرّر إلى الأسفل وانقر مزوّد مخصص
3. املأ مربع الحوار:

1. انقر إرسال؛ تظهر النماذج في منتقي النموذج
2. أرسل رسالة في الدردشة للتحقق

الصين القارية: استبدل المضيف بـ https://asia.qcode.cc/api (عقدة آسيا، قريبة من كوريا / تايوان / هونغ كونغ)؛ يبقى المفتاح نفسه. تُكتب أمثلة Base URL الرسمية بصيغة تحمل رقم إصدار (على غرار https://api.your-provider.com/v1)، ويجلب Kilo قائمة النماذج تلقائيًا من URL صالح. بالنسبة إلى نقطة نهاية Anthropic Messages، نقترح التوقف عند /api وترك الإضافة تُلحق /v1/messages. دون شرطة مائلة لاحقة. لم نختبر ما إذا كانت الشرطة المائلة الإضافية تُنتج فعليًا 404، لذا اتبع الصيغة المقترحة. أيًا كان ما تضبطه في الواجهة، فإنه يُخزَّن في ملف إعدادات (تسميه الصفحات الرسمية kilo.json في موضع وkilo.jsonc في موضع آخر) ويمكن تحريره مباشرة.

إعداد GPT والنماذج الصينية (متوافق مع OpenAI)¶

نفس مربع الحوار مزوّد مخصص، مع تغيير حقلين فقط:

1. اضبط API المزوّد على OpenAI Compatible
2. Base URL: https://api.qcode.cc/openai/v1
3. مفتاح API: المفتاح نفسه cr_
4. النماذج: اكتب gpt-6-sol، أو gpt-5.6-terra، أو معرّف نموذج صيني مثل glm-5.2

بالنسبة إلى الواجهة ذات النمط Responses في GPT / xAI، القيمة الرسمية هي OpenAI Responses؛ لا تزال نماذج Anthropic تعمل فقط عبر Anthropic Messages (Base URL https://api.qcode.cc/api). نقطتا النهاية غير قابلتين للتبادل.

التحقق من الاتصال¶

تحقق من نقطة النهاية والمفتاح باستخدام curl أولًا، لتعرف ما إذا كان عليك تصحيح واجهة الإضافة:

KEY="cr_your_qcode_key"
curl -X POST https://api.qcode.cc/api/v1/messages \
  -H "x-api-key: $KEY" -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":32,"messages":[{"role":"user","content":"ping"}]}'

وجود JSON يحتوي على content يعني أن جانب نقطة النهاية سليم؛ وإذا استمر فشل الإضافة، فالمشكلة في إعداداتها.

استكشاف الأخطاء وإصلاحها¶

ذات صلة¶

• نقاط النهاية ومسارات API — جدول البروتوكول × عائلة النموذج
• إعداد Roo Code — المشروع الذي تفرّع عنه Kilo Code، بإعداد شبه مطابق
• تكامل Cline — المشروع الذي تفرّع عنه Roo Code
• النماذج الصينية

المؤسسات ←