Kimi Code CLI: كيفية تثبيت وتشغيل وكيل الترميز الذكي لمونشوت

أطلقت Moonshot AI أداة Kimi Code إلى جانب نموذج Kimi K2.7 Code: وهو وكيل برمجي أصيل يعمل من خلال الطرفية (terminal) ويقوم بقراءة مستودعك، وكتابة الملفات وتعديلها، وتشغيل أوامر shell، وإنشاء وكلاء فرعيين للعمل المتوازي. إذا كنت تستخدم Claude Code أو Codex، فسيبدو الشكل مألوفًا لك. يكمن الاختلاف في المحرك الأساسي والسعر. يعمل Kimi Code على نموذج مفتوح الوزن ويتم محاسبته باشتراك ثابت بدلاً من الدفع لكل رمز مميز (token).

يرشدك هذا الدليل من جهاز نظيف إلى مهمة وكيلك الأولى، ثم يغطي الأوامر والإعدادات التي ستستخدمها بالفعل.

ما هو Kimi Code

Kimi Code هو إطار عمل الوكلاء الخاص بشركة Moonshot، تم بناؤه للاستفادة من نقاط قوة نموذج K2.7 Code: التفكير المحفوظ عبر الأدوار، والاستدلال المتداخل، واستدعاءات الأدوات متعددة الخطوات. خارج الصندوق يمكنه:

• كتابة التعليمات البرمجية وتصحيحها وإعادة هيكلتها عبر ملفات متعددة
• استكشاف وشرح قواعد التعليمات البرمجية الكبيرة
• تشغيل أوامر shell ومعالجة الملفات
• البحث في الويب عن الوثائق والمعلومات الحالية
• إنشاء وكلاء فرعيين لتشغيل المهام بشكل متوازٍ

يعمل في الطرفية (terminal) الخاصة بك، وفي VS Code عبر إضافة، وفي JetBrains أو Zed عبر بروتوكول ACP. النموذج الذي يقف وراءه مفتوح الوزن، لذا فإن نفس الذكاء متاح للاستضافة الذاتية إذا احتجت إلى ذلك؛ راجع شرح Kimi K2.7 Code الخاص بنا للحصول على تفاصيل النموذج.

تثبيت Kimi Code

يقوم المثبت بسحب uv (مدير حزم بايثون) أولاً، ثم يقوم بتثبيت CLI من خلاله. سطر واحد يقوم بالمهمة بأكملها.

لنظامي التشغيل macOS و Linux:

curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash

لنظام التشغيل Windows (PowerShell):

irm https://code.kimi.com/kimi-code/install.ps1 | iex

عند الانتهاء، ابدأ تشغيل الوكيل من أي دليل مشروع:

kimi

تنقلك عملية التشغيل الأولى إلى جلسة تفاعلية في مجلدك الحالي. يتعامل Kimi Code مع هذا الدليل كجذر للمشروع، لذا قم بالدخول إلى المستودع الذي تريد العمل عليه باستخدام cd قبل تشغيله.

تسجيل الدخول

صادق من داخل الجلسة باستخدام أمر واحد:

/login

يبدأ ذلك تدفق OAuth مع حسابك في Kimi ويربط واجهة سطر الأوامر (CLI) بمنصة Kimi Code. إذا كنت تفضل استخدام مفتاح API، على سبيل المثال لتشغيل أداة خارجية، فقم بإنشاء واحد في وحدة تحكم Kimi Code. يسمح كل حساب بما يصل إلى 5 مفاتيح.

ملاحظة سريعة حول الحصص: يعمل Kimi Code بخطط اشتراك، ويتم تحديث الحدود على دورة مدتها 7 أيام بدلاً من شهريًا. تبلغ حدود المعدل حوالي 300 إلى 1200 طلب لكل 5 ساعات مع ما يصل إلى 30 طلبًا متزامنًا، اعتمادًا على خطتك. تحقق من /usage في منتصف الجلسة لترى وضعك.

مهمتك الأولى

بعد تسجيل دخول الوكيل، ما عليك سوى وصف ما تريده بلغة عادية. تشغيل جيد لأول مرة هو السماح له بتعلم المشروع:

/init

يقوم /init بتحليل قاعدة التعليمات البرمجية ويكتب ملف AGENTS.md الذي يلتقط البنية والاتفاقيات ونقاط الدخول الرئيسية. يقرأ الوكيل هذا الملف في عمليات التشغيل المستقبلية، لذلك يبدأ كل جلسة بالسياق بدلاً من إعادة اكتشاف مستودعك في كل مرة. إذا كنت قد استخدمت DESIGN.md لوكلاء البرمجة، فهذه هي نفس الفكرة المطبقة تلقائيًا.

بعد ذلك، أعطه عملاً حقيقيًا:

Add input validation to the POST /users endpoint and write a test for the empty-email case.

يخطط Kimi Code للتغيير، ويعدل الملفات، ويشغل الاختبار، ويقدم تقريرًا. افتراضيًا، يطلب الإذن قبل الإجراءات المدمرة. إذا كنت تثق به في مهمة وتريد منه التوقف عن السؤال، فقم بتبديل الموافقة التلقائية:

/yolo

استخدم هذا بحذر. إنه رائع للعمل الأولي الجديد تمامًا (greenfield scratch work)، ولكنه محفوف بالمخاطر على مستودع تهتم به.

أوامر الشرطة المائلة (Slash commands) التي تستحق المعرفة

تدير الجلسة باستخدام أوامر الشرطة المائلة. هذه هي الأوامر التي ستستخدمها يوميًا.

/compact هو الأمر الذي لا يُقدر حق قدره. تملأ عمليات تشغيل الوكيل الطويلة نافذة السياق بمخرجات الأدوات؛ يقوم الضغط بتلخيص التاريخ حتى تتمكن من المتابعة دون البدء من جديد أو تجاوز النافذة.

ربطه بمحررك أو وكيلك الحالي

ليس عليك التخلي عن إعداداتك الحالية لاستخدام نموذج K2.7 Code.

VS Code. قم بتثبيت إضافة "Kimi Code" من المتجر وسجل الدخول بنفس الحساب.

JetBrains و Zed. اتصل عبر بروتوكول ACP الخاص بـ CLI، بحيث يعمل الوكيل داخل المحرر الذي تستخدمه بالفعل.

Claude Code، و Cline، و RooCode. يتم تقديم النموذج عبر واجهة برمجة تطبيقات متوافقة مع OpenAI. وجه عنوان URL الأساسي للأداة إلى https://api.moonshot.ai/v1، اضبط النموذج على kimi-k2.7-code، وأدخل مفتاح API. التدفق هو نفسه الذي وثقناه لتشغيل Kimi داخل Claude Code و Cursor؛ يتغير معرف النموذج فقط.

التخصيص باستخدام MCP والوكلاء الفرعيين

ميزتان تجعلان Kimi Code يستحق التهيئة بدلاً من مجرد التشغيل.

بروتوكول سياق النموذج (MCP). Kimi Code هو عميل MCP، لذا يمكنك توصيل خوادم أدوات خارجية: قارئ قاعدة بيانات، متصفح، واجهة برمجة تطبيقات داخلية، ومتتبع مشكلاتك. يستدعي الوكيل بعد ذلك هذه الأدوات كجزء من مهمة. إذا كنت تقوم ببناء أو اختبار خادم MCP، فإن دليل اختبار خادم MCP الخاص بنا يغطي كيفية التحقق من صحة عقد الأداة قبل تسليمها إلى وكيل.

الوكلاء الفرعيون (Sub-agents). للعمل الذي ينقسم بوضوح، يمكن لـ Kimi Code إنشاء وكلاء فرعيين يعملون بالتوازي ويقدمون تقارير إلى الجلسة الرئيسية. فكر في "مسح كل خدمة بحثًا عن المكالمات المهملة" أو "صياغة اختبارات لهذه الوحدات الست دفعة واحدة". يمكنك تعريف وكلاء مخصصين في التكوين، تمامًا مثل الوكلاء الفرعيين لـ Claude Code.

اختبار واجهة برمجة التطبيقات (API) التي تكمن وراءه قبل البدء بالبناء

إذا كنت تقوم بربط kimi-for-coding بأداتك الخاصة عبر واجهة برمجة التطبيقات، فاختبر نقطة النهاية الأولية أولاً حتى تعرف بالضبط ما الذي تعيده. يوفر لك Apidog مساحة عمل مرئية لذلك.

1. أنشئ طلب POST إلى https://api.moonshot.ai/v1/chat/completions.
2. أضف عنوان Authorization: Bearer <your-key> باستخدام مفتاح من وحدة تحكم منصة Kimi.
3. أرسل نصًا بنمط OpenAI مع "model": "kimi-k2.7-code" و messages الخاصة بك.
4. اقرأ الاستجابة المنسقة واستخدام الرمز المميز، ثم احفظ الاستدعاء كاختبار قابل لإعادة الاستخدام.

من هناك يمكنك التأكد من رموز الحالة، والتحقق من بنية استدعاء الأداة التي يعتمد عليها الوكيل، وإعادة تشغيل الفحوصات كلما قامت Moonshot بتحديث النموذج. قم بتنزيل Apidog لإعداده.

هل يستحق Kimi Code الانتقال إليه؟

الإجابة الصادقة تعتمد على ما تسعى لتحسينه. يتخلف نموذج K2.7 Code عن GPT-5.5 و Claude Opus ببضع نقاط في معظم معايير البرمجة، لذلك إذا كنت تريد أعلى جودة ممكنة في لقطة واحدة، فإن النماذج المغلقة لا تزال تتفوق. لكن Kimi Code يجمع بين وكيل قادر ونموذج مفتوح الوزن وتسعير ثابت، مما يغير المعادلة لأي شخص يدير جلسات وكيل طويلة طوال اليوم. لمقارنة شاملة لوضع مشهد الوكلاء، راجع مقارنة Claude Code مقابل OpenAI Codex.

الخطوة منخفضة المخاطر: قم بتثبيته، قم بتشغيل /init على مشروع جانبي، وأعطه مهمة حقيقية. ستعرف خلال فترة ما بعد الظهر ما إذا كان يستحق مكانًا بجانب وكيلك الحالي.

الأسئلة الشائعة

كيف أقوم بتثبيت Kimi Code؟ قم بتشغيل المثبت ذي السطر الواحد (curl ... | bash على macOS/Linux، irm ... | iex على Windows)، ثم ابدأ تشغيله باستخدام kimi.

كيف أسجل الدخول؟ قم بتشغيل /login داخل الجلسة للمصادقة عبر OAuth، أو أنشئ مفتاح API في وحدة تحكم Kimi Code للأدوات الخارجية.

ما هو النموذج الذي يشغله؟ Kimi K2.7 Code. على اشتراك Kimi Code، معرف النموذج هو kimi-for-coding؛ وعلى واجهة برمجة تطبيقات Moonshot المدفوعة بالرمز المميز (pay-per-token)، هو kimi-k2.7-code.

هل يعمل في VS Code؟ نعم، عبر إضافة "Kimi Code". يتصل JetBrains و Zed عبر بروتوكول ACP.

هل يمكنني استخدامه مع Claude Code أو Cline؟ نعم. واجهة برمجة التطبيقات متوافقة مع OpenAI، لذا وجه عنوان URL الأساسي للأداة إلى نقطة نهاية Kimi واضبط معرف النموذج.

ما هي تكلفته؟ يعمل بخطط اشتراك مع حصة تتجدد كل 7 أيام، وليس بالدفع لكل رمز مميز. تحقق من /usage لمعرفة حصتك المتبقية.

هل يدعم MCP؟ نعم. Kimi Code هو عميل MCP ويدعم الوكلاء الفرعيين المخصصين.

ملخص

Kimi Code هو وكيل برمجة يعمل من خلال الطرفية (terminal) وبيئة التطوير المتكاملة (IDE) ومبني على نموذج K2.7 Code مفتوح الوزن من Moonshot. قم بتثبيته بأمر واحد، سجل الدخول باستخدام /login، شغل /init لتعليمه مستودعك، وابدأ في تكليفه بالمهام. إنه يدعم MCP، وينشئ وكلاء فرعيين، ويتصل بـ VS Code، و JetBrains، و Zed، والأدوات المتوافقة مع OpenAI مثل Claude Code. قد لا يكون الوكيل الأعلى أداءً على الورق، لكن التسعير الثابت على نموذج مفتوح يجعله خيارًا جادًا للاستخدام اليومي الكثيف. اختبر واجهة برمجة التطبيقات في Apidog أولاً، ثم ضع الوكيل في مهمة حقيقية واحكم عليه بناءً على التعليمات البرمجية الخاصة بك.