دليل Kilo Code

برنامج تعليمي لـ Kilo Code: الإعداد والرصيد المجاني والترحيل من Roo

وكيل البرمجة بالذكاء الاصطناعي الذي ورث مجتمع Roo Code: ثبّته في VS Code، واحصل على 20 دولارًا من الرصيد الإضافي، واربط DeepSeek بمفتاحك الخاص، وأكمل الترحيل قبل أن تنطفئ إعدادات Roo نهائيًا.

الخلاصة السريعة

  • أعلنت Roo Code إيقافها في 21 أبريل 2026 وتوقفت إضافتها في VS Code عن العمل في 15 مايو — وأصبح Kilo Code، وهو فرق (Fork) من Roo، وجهة الترحيل الرسمية لـ 3 ملايين عملية تثبيت.
  • الإضافة مفتوحة المصدر ومجانية مع مفتاح API الخاص بك (BYOK)؛ وتحصل الحسابات الجديدة على 20 دولارًا من الرصيد الإضافي عند أول شحن، إضافة إلى نسخة تجريبية للمؤسسات لمدة 14 يومًا دون بطاقة ائتمان.
  • يتصل DeepSeek مباشرة: Settings ← Providers ← أضف مفتاح DeepSeek API مع العنوان https://api.deepseek.com واختر deepseek-flash أو deepseek-v4-pro.
  • الترحيل شبه تلقائي: أعد تسمية ملفات إعدادات Roo، ودع معالج الترحيل يحوّلها، واكتب ملف kilo.jsonc مصغرًا — وأعد المصادقة على كل مفتاح API، لأن المفاتيح لا تنتقل تلقائيًا.

Just Signed Up? Your first 14 minutes with Kilo Code

فيديو الشرح التطبيقي:Kilo (official)14:02

شاهده على يوتيوب

How to Migrate from Roo to Kilo

فيديو الترحيل:Kilo (official)2:07

شاهده على يوتيوب

سُجّل فيديو الشرح التطبيقي في يونيو 2025 على الواجهة السابقة لإعادة البناء القائمة على OpenCode (الإتاحة العامة في 2 أبريل 2026) — تغيّرت مواقع القوائم لكن التسلسل نفسه. أما فيديو الترحيل فيعرض الواجهة الحالية.

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

إعداد Kilo Code وترحيله، خطوة بخطوة

1 · التعرّف على Kilo Code (ولماذا ينتقل مستخدمو Roo إليه)

  1. 1

    اعرف الخلفية: Roo Code يُوقف عمله

    في 21 أبريل 2026 أعلن فريق Roo Code إيقاف الإضافة والتركيز الكامل على Roomote؛ وتوقفت إضافة VS Code عن العمل في 15 مايو وتحوّل مستودع GitHub إلى أرشيف للقراءة فقط. ونشر Kilo Code — وهو فرق من Roo — رسالة الوداع الرسمية وأصبح الملاذ لنحو 3 ملايين تثبيت من مستخدمي Roo.

    dev.to post announcing the Roo Code shutdown with its 3 million installs headline and a Kilo Code maintainer reply proposing always-approve options in the comment box
    إعلان الإيقاف، مع رد أحد مشرفي Kilo في التعليقات منذ اللحظات الأولىشاهد عند 0:04
  2. 2

    تعرّف على أنماط التفاعل الخمسة

    يأتي Kilo Code بخمسة أنماط: Code للكتابة والتنفيذ، وArchitect للتخطيط قبل لمس الكود، وAsk للشرح، وDebug لتعقّب الأخطاء، وOrchestrator لتقسيم المهمة الضخمة إلى مهام فرعية. ويمكنك إنشاء أنماط مخصصة — وتُحوَّل أنماط Roo المخصصة إلى هنا أثناء الترحيل.

    Kilo Code interaction mode dropdown in VS Code listing the Code, Architect, Ask, Debug and Orchestrator modes used to plan, build and debug an app
    محدد الأنماط يقع مباشرة فوق صندوق الكتابة في لوحة Kilo Codeشاهد عند 0:22
  3. 3

    ماذا ينتج طلب واحد (Prompt)؟

    في الشرح التطبيقي الرسمي، أنتج طلب مفصّل واحد — غرض التطبيق وبنية البيانات وسلوك الترتيب والبحث وتصميم الواجهة — تطبيقًا عاملًا لإدارة الملاحظات في ملف HTML واحد، فتحه Kilo في المتصفح مباشرة. وكلفة عملية التوليد كلها نحو 3 سنتات من رصيد API فقط.

    Note Organizer web app that Kilo Code generated from a single prompt, showing note cards, tag filters, instant search and date-created sorting in the browser
    تطبيق إدارة الملاحظات النهائي: بطاقات ووسوم وبحث وترتيب من طلب واحدشاهد عند 5:06
  4. 4

    دع نمط Architect يطرح الأسئلة عليك

    عندما لا تعرف ماذا تحدد، يجري نمط Architect مقابلة معك: في لعبة الشطرنج سأل عن مستوى القواعد، واللعب ضد شخص أم ضد الذكاء الاصطناعي، وقوة الخصم الآلي — بخيارات قابلة للنقر. وتُكتب الخطة النهائية — بمخططها المعماري — في ملف markdown قبل أن ينفذها نمط Code.

    Kilo Code Architect mode asking what level of chess functionality to implement and offering Full chess implementation or Basic piece movement answer buttons
    يحوّل نمط Architect الأفكار الغامضة إلى خيارات ملموسة قابلة للإجابةشاهد عند 8:12

2 · تثبيت الإضافة والحصول على 20 دولارًا من الرصيد

  1. 5

    ثبّت إضافة Kilo Code

    ابحث عن "Kilo Code" في متجر إضافات VS Code أو نفّذ الأمر الظاهر هنا: code --install-extension kilocode.Kilo-Code. الإضافة مفتوحة المصدر ومتاحة لـ VS Code وJetBrains وواجهة سطر أوامر مستقلة.

    macOS terminal finishing the code --install-extension kilocode.Kilo-Code command that installs the Kilo Code extension after the Roo Code shutdown
    تثبيت بسطر واحد في الطرفية من فيديو الترحيل الرسميشاهد عند 0:10
  2. 6

    احصل على رصيد التسجيل المجاني

    بعد التسجيل مباشرة تحصل على ملف تعريف API مستضاف من Kilo Code محمّل مسبقًا برصيد مجاني — يُظهر التسجيل أدناه لافتة "$20 for free"، ولا تزال صفحة kilo.ai/pricing تذكر 20 دولارًا من الرصيد الإضافي عند أول شحن مع نسخة تجريبية مؤسسية لمدة 14 يومًا دون بطاقة. ويبقى أسلوب BYOK مجانيًا للأبد.

    Kilo Code settings Providers page showing the default Kilo Code API profile with its sign-up credit notice, API key field and Claude 3.7 Sonnet model picker
    Settings ← Providers: ملف تعريف Kilo Code الافتراضي ورصيده الترحيبي البالغ 20 دولارًاشاهد عند 1:18

3 · ربط DeepSeek بمفتاحك الخاص

  1. 7

    أضف ملف تعريف موفّر لمفتاحك الخاص

    افتح Settings ← Providers وانقر + لإنشاء New Configuration Profile. سمّه — "DeepSeek" أو "OpenRouter" — وستحصل على ملف تعريف ثانٍ تنتقل إليه من اللوحة الرئيسية دون المساس بالمدمج.

    New Configuration Profile dialog in Kilo Code settings with the name OpenRouter typed in, the first step of adding a second BYOK provider
    إنشاء ملف تعريف ثانٍ باسم OpenRouterشاهد عند 1:46
  2. 8

    الصق مفتاح API واختر نموذجًا

    اختر نوع الموفّر، والصق مفتاح API، ثم اختر نموذجًا. للاتصال المباشر بـ DeepSeek اتبع kilo.ai/docs/ai-providers/deepseek: اجعل العنوان الأساسي https://api.deepseek.com واختر deepseek-flash للبرمجة اليومية أو deepseek-v4-pro للاستدلال الثقيل. وتُحفظ المفاتيح بأمان في SecretStorage داخل VS Code.

    Kilo Code provider profile switched to OpenRouter with an empty API key raising the You must provide a valid API key warning next to the custom base URL option
    نوع الموفّر ومفتاح API والنموذج — الحقول الثلاثة نفسها التي يملؤها دليل Kilo الرسمي من DeepSeekشاهد عند 1:52

4 · الترحيل من Roo Code

  1. 9

    أعد تسمية ملفات Roo (في كل مستودع)

    لا يقرأ معالج الترحيل الملفات السابقة بـ Roo، فانقلها أولًا بأوامر دليل الترحيل من Kilo: ‎.roorules ← AGENTS.md و‎.roo/rules/* ← ‎.kilo/rules/ و‎.roomodes ← ‎.kilocodemodes و‎.roo/mcp.json ← ‎.kilocode/mcp.json و‎.rooignore ← ‎.kilocodeignore. وخذ نسخة احتياطية من مجلد globalStorage الخاص بـ Roo قبل البدء.

    VS Code terminal running the porting commands that copy .roorules to AGENTS.md, .roomodes to .kilocodemodes and .roo/mcp.json to .kilocode/mcp.json
    سكربت النقل الرسمي: خمسة أوامر نسخ وإعادة تسمية لكل مستودعشاهد عند 0:34
  2. 10

    اكتب ملف kilo.jsonc مصغرًا

    يستبدل kilo.jsonc مجموعات أدوات Roo بأذونات صريحة — كل شيء إما allow أو ask أو deny مع أنماط مسارات اختيارية. انسخ المثال المصغر من دليل الترحيل، وحدد نموذجك، وسرد ملفات القواعد ضمن instructions.

    kilo.jsonc open in VS Code with a model entry and allow or ask permissions that replace Roo Code tool groups after migration
    kilo.jsonc: اختيار النموذج وأذونات القراءة والكتابة وأوامر bash لكل إجراءشاهد عند 1:10
  3. 11

    تحقق عبر kilo config check

    نفّذ kilo config check في الطرفية للتأكد من أن الإعدادات المُرحَّلة تُقرأ بنجاح وأن كل ملف مُشار إليه موجود. وعند أول تشغيل، يحوّل معالج الترحيل في الإضافة الملفات القديمة تلقائيًا أيضًا — تتحول ‎.kilocodemodes إلى ملفات markdown للوكلاء بصورة سليمة، ويُحتفظ بـ ‎.kilo/rules كخيار احتياطي.

    VS Code terminal validating the migrated Kilo Code setup with the kilo config check command beside the repository file tree
    أمر واحد يؤكد صحة الإعدادات بعد الترحيلشاهد عند 1:15
  4. 12

    تحقق، ثم عطّل Roo (لا تُلغِ تثبيته)

    افتح مستودعًا، واختر وكيل Code، واطلب منه سرد الوكلاء والقواعد المخصصة التي حمّلها — يجب أن يذكر الرد وكلاءك وقواعدك ونموذجك وأذوناتك بعد الترحيل. وعند التأكد من سلامة كل شيء، عطّل Roo من لوحة الإضافات واحتفظ به نحو أسبوع كخيار احتياطي قبل حذفه.

    Kilo Code answering a list the custom agents and rules request with the agents, style rules, model and permissions it loaded from the migrated config
    يسرد رد التحقق كل وكيل وقاعدة ونموذج وإذن حمّلها Kiloشاهد عند 1:36

Kilo Code مقابل Roo Code في لمحة

الجانبKilo CodeRoo Code
الحالةنشط — وجهة الترحيل الرسمية لمستخدمي Rooأُعلن الإيقاف في 21 أبريل 2026؛ والإضافة خارج الخدمة منذ 15 مايو 2026
الأصلفرق من Roo Code (الذي هو نفسه فرق من Cline)، تطوره شركة مستقلةفرق من Cline؛ انتقل الفريق الأصلي إلى Roomote
الإضافة الحاليةأُعيد بناؤها على خادم OpenCode — الإتاحة العامة في 2 أبريل 2026 — مع إصدارات لـ JetBrains وسطر الأوامر والسحابةتجمد الخط القديم v5.x عند الإيقاف؛ ومستودع GitHub أرشيف للقراءة فقط
مسار الترحيلإعادة تسمية ثم معالج ترحيل، وأذونات kilo.jsonc، وإعادة مصادقة إلزامية للموفّرينلا يوجد — تبقى الملفات في مسارات ‎.roo؛ وللاستفسارات المالية: billing@roocode.com

الأسئلة الشائعة حول Kilo Code

أدلة ذات صلة