قامت شركة Moonshot AI ببناء Kimi K3 لمهام برمجية تتجاوز موجهًا واحدًا: توجيه النموذج إلى مستودع كبير، وتركه يقرأ الملفات، ويشغّل الأدوات والاختبارات، ويحلل السجلات ولقطات الشاشة، ثم يكرر العمل حتى تكتمل المهمة. لتحقيق ذلك تحتاج إلى وكيل برمجي حول النموذج، وهو ما توفره Moonshot عبر Kimi Code. يشرح هذا الدليل إعداد K3، وتشغيل حلقة وكيل عملية، والتحقق من النتائج، ومقارنته بـ Claude Code وCursor.
باختصار: تشغيل Kimi K3 للبرمجة
Kimi K3 هو النموذج الرائد لشركة Moonshot AI، أُطلق في 16 يوليو 2026، ويقدم نافذة سياق تصل إلى مليون رمز. لتشغيله في مهام البرمجة الوكيلة، استخدم Kimi Code وحدد النموذج بالأمر /model، ثم امنحه مهمة قابلة للاختبار.
يستهدف K3 التنقل في قواعد الأكواد الكبيرة، واستخدام الأدوات، وتصحيح الأخطاء، والتكرار بالاعتماد على الاختبارات والسجلات ولقطات الشاشة. تشير Moonshot إلى معدل إصابة للتخزين المؤقت يتجاوز 90% في أحمال عمل البرمجة، ما قد يجعله مناسبًا لحلقات الوكيل الطويلة. لكنه ليس الأسرع، بسرعة تقارب 62 رمزًا في الثانية، وتذكر Moonshot أنه ما زال خلف Claude Fable 5 وGPT-5.6 Sol في القدرة الخام.
إذا أنشأ K3 واجهة API، فاستخدم Apidog لإرسال طلبات حقيقية والتحقق من سلوك نقاط النهاية. ولخلفية أوسع، ابدأ بـ ما هو Kimi K3.
ما هو Kimi Code؟
Kimi Code هو وكيل البرمجة من Moonshot للطرفية وبيئات التطوير المتكاملة. بدلاً من الإجابة عن سؤال أو اقتراح مقتطف فقط، يمكنه العمل داخل مشروعك عبر:
- قراءة الملفات وبنية المستودع.
- تعديل الملفات وكتابتها.
- تشغيل أوامر الشيل.
- تنفيذ الاختبارات والبناء.
- تحليل المخرجات والسجلات.
- تكرار التعديل حتى يصل إلى نتيجة قابلة للتحقق.
ببساطة: K3 هو النموذج، وKimi Code هو طبقة الوكيل التي تمنحه الوصول إلى نظام الملفات والأدوات ونتائج التنفيذ.
عملت نماذج Kimi K2 السابقة داخل الوكيل نفسه. راجع دليل Kimi Code CLI للتثبيت، وكيفية استخدام Kimi CLI لمرجع أوامر سطر الأوامر. تفترض الخطوات التالية أنك ثبتت CLI بالفعل.
تشغيل Kimi K3 في Kimi Code
تتغير أوامر التثبيت والأعلام مع تحديث Moonshot للأداة. استخدم الخطوات التالية كسير عمل عملي، ثم تحقق من الصيغة الحالية في وثائق Kimi الرسمية أو دليل Kimi Code CLI.
1. ثبّت الوكيل وصادق باستخدام مفتاح API
أنشئ مفتاح API من منصة مطوري Kimi، ثم خزّنه في متغير بيئة. لا تضع المفتاح في ملف إعدادات قد يصل إلى Git.
# مثال تمثيلي — تحقق من الوثائق للصيغة الحالية.
export KIMI_API_KEY="مفتاحك هنا"
# شغّل الوكيل من الدليل الحالي.
kimi-code
يمكنك التحقق من أن المفتاح موجود قبل التشغيل:
test -n "$KIMI_API_KEY" && echo "KIMI_API_KEY مضبوط"
2. شغّل Kimi Code من جذر المستودع
شغّل الوكيل من الدليل الجذر للمشروع، لا من مجلد فرعي عشوائي. بهذه الطريقة يستطيع قراءة بنية المشروع وملفات الإعداد وسكربتات الاختبار.
cd path/to/your-repository
kimi-code
إذا كان المشروع monorepo، ابدأ من الجذر الذي يحتوي على ملفات مثل package.json أو pnpm-workspace.yaml أو turbo.json أو إعدادات البناء الرئيسية.
3. حدّد نموذج Kimi K3
داخل جلسة Kimi Code، اختر K3:
/model kimi-k3
هذه الآلية نفسها تتيح التبديل إلى نماذج أخرى، مثل Kimi K2.7 Code، عند الحاجة إلى مقارنة النتائج على المهمة نفسها.
4. اضبط جهد التفكير حسب المهمة
يوفر K3 جهد تفكير قابلًا للضبط، بما فيه إعداد «أقصى». استخدم جهدًا أعلى عند:
- تتبع خطأ متداخل بين عدة طبقات.
- إعادة هيكلة تمتد عبر ملفات كثيرة.
- تحليل فشل اختبار غير واضح.
- تعديل API حساس يحتاج فحص آثار جانبية.
أما للتعديلات الصغيرة، مثل تغيير رسالة خطأ أو تحديث اسم متغير، فاختر إعدادًا أقل إن كان متاحًا لتجنب استهلاك غير ضروري.
لتجربة النموذج دون تثبيت Kimi Code أو باستخدام المسارات المجانية، راجع كيفية استخدام Kimi K3 مجانًا.
سير عمل عملي باستخدام K3 كوكيل برمجي
لا تبدأ بطلب عام مثل: «حسّن وحدة المصادقة». حوّل الطلب إلى هدف يمكن للوكيل إثباته عبر اختبار أو أمر أو استجابة HTTP.
اكتب مهمة قابلة للتحقق
مثال ضعيف:
حسّن وحدة تسجيل الدخول.
مثال عملي:
نقطة النهاية /login تعيد 500 عندما تكون password فارغة.
1. أعد إنتاج المشكلة.
2. حدد مصدر الاستثناء.
3. أعد استجابة 400 برسالة خطأ مناسبة.
4. أضف اختبارًا لحالة كلمة المرور الفارغة.
5. شغّل اختبارات وحدة المصادقة.
لا تعدّل المسارات غير المرتبطة بالمصادقة.
هذا النوع من التعليمات يحدد:
- السلوك المعطّل.
- النتيجة المطلوبة.
- دليل التحقق.
- حدود التعديل المقبولة.
نافذة السياق البالغة مليون رمز تجعل العمل على المستودعات الكبيرة أكثر واقعية، لأن الوكيل يستطيع تتبع استدعاء من معالج المسار إلى طبقة الخدمة وقاعدة البيانات دون أن تزوده يدويًا بكل ملف.
اطلب منه اتباع حلقة: اقرأ، عدّل، شغّل، تحقق
في مهمة تصحيح نموذجية، يجب أن يعمل الوكيل بهذه الدورة:
- يقرأ الملفات ذات الصلة.
- يبحث عن نقطة دخول الخطأ.
- يشكل فرضية.
- يجري أقل تعديل ممكن.
- يشغل الاختبارات أو التطبيق.
- يقرأ الخطأ أو السجل الناتج.
- يراجع التعديل ويكرر حتى تمر الفحوصات.
يمكنك صياغة ذلك مباشرة في موجهك:
لا تفترض سبب المشكلة.
ابدأ بتحديد اختبار أو طريقة لإعادة إنتاجها.
بعد كل تعديل، شغّل الاختبارات المرتبطة.
اعرض ملخصًا للملفات المعدلة ونتيجة الاختبارات قبل الإنهاء.
تصف Moonshot K3 بأنه قوي في التنقل في المستودعات الكبيرة، واستخدام الأدوات، وتصحيح الأخطاء، والتكرار مقابل الصور والسجلات والاختبارات وملاحظات وقت التشغيل. القيمة هنا ليست في التخمين الصحيح من المحاولة الأولى، بل في تشغيل الحلقة التصحيحية.
استخدم ملاحظات واجهة المستخدم والسجلات
في الواجهة الأمامية، لا تكتفِ بطلب تعديل CSS. اطلب من الوكيل التحقق بصريًا إن كانت بيئتك تدعم ذلك:
عدّل تخطيط صفحة الملف الشخصي على الشاشات الصغيرة.
شغّل التطبيق، والتقط لقطة شاشة بعرض 375px.
تحقق من عدم وجود تمرير أفقي ومن بقاء زر الحفظ ظاهرًا.
في الواجهة الخلفية، اجعل الملاحظة موضوعية عبر اختبار أو طلب HTTP:
curl -i -X POST http://localhost:3000/login \
-H "Content-Type: application/json" \
-d '{"email":"dev@example.com","password":""}'
ثم حدد السلوك المتوقع:
يجب أن تعيد نقطة النهاية 400، لا 500.
يجب أن يحتوي جسم الاستجابة على رسالة تحقق.
يجب ألا يظهر تتبع مكدس في الاستجابة.
اجعل الاختبارات شرطًا للانتهاء
الاختبارات تمنع الوكيل من إنهاء المهمة بعد تعديل يبدو صحيحًا فقط. ابدأ باختبار يعيد إنتاج الخطأ إن أمكن، ثم اطلب من K3 تحقيق حالة نجاح واضحة.
مثال لموجه مناسب:
أضف اختبار انحدار أولًا يثبت أن password الفارغة تعيد 400.
بعد ذلك أصلح التنفيذ.
لا تعتبر المهمة مكتملة قبل مرور الاختبار الجديد ومجموعة الاختبارات المرتبطة.
Kimi K3 مقابل Claude Code وCursor للبرمجة
ليس Kimi Code الإعداد الوحيد لتشغيل وكيل على قاعدة الشفرة. إليك مقارنة عملية بين الخيارات الشائعة في منتصف 2026.
| البعد | Kimi Code (Kimi K3) | Claude Code (Fable 5) | Cursor |
|---|---|---|---|
| العامل الشكلي | وكيل للطرفية وبيئة التطوير المتكاملة | وكيل برمجة للطرفية | محرر أكواد كامل يعتمد على الذكاء الاصطناعي |
| النموذج الافتراضي | Kimi K3، قابل للتبديل عبر /model
|
Claude Fable 5، بالإضافة إلى نماذج Claude الأخرى | نماذج خاصة أو مدمجة |
| نافذة السياق | مليون رمز | كبيرة وتعتمد على النموذج | تعتمد على النموذج المحدد |
| التنقل في المستودع | قوي؛ موجه للمستودعات الكبيرة والعمل طويل المدى | قوي؛ وصول وكيل للملفات والشيل | فهرسة واسترجاع قويان داخل المحرر |
| استخدام الأدوات | استدعاءات أدوات، شيل، اختبارات، لقطات شاشة | استدعاءات أدوات، شيل، MCP | أدوات المحرر والطرفية وMCP |
| رافعة التكلفة | مناسب للحلقات كثيفة التخزين المؤقت | تسعير حسب رموز Claude | اشتراك بالإضافة إلى استخدام النموذج |
| الأوزان المفتوحة | متوقعة نحو 27 يوليو 2026 | مغلقة | المحرر خاص؛ النماذج تختلف |
| الأفضل لـ | جلسات وكيل طويلة على نطاق المستودع بميزانية محدودة | المهام التي تتطلب موثوقية واستدلالًا عاليين | المطورين الذين يريدون الوكيل داخل المحرر |
عمليًا:
- اختر Claude Code إذا كانت المهمة بالغة الصعوبة وكانت الأولوية للموثوقية الخام. تشير Moonshot نفسها إلى تقدم Fable 5 على K3.
- اختر Cursor إذا كنت تريد سير عمل الوكيل داخل محرر متكامل. راجع GLM-5.2 في Claude Code وCline وCursor لمقارنة خيارات مشابهة.
- اختر Kimi K3 في Kimi Code عندما تحتاج إلى سياق كبير جدًا، وتنقل واسع داخل المستودع، وحلقة تكرار طويلة تعتمد على الاختبارات والسجلات.
للمقارنة مع Claude Code، راجع Claude Fable 5 في Claude Code.
نقاط القوة والحدود
نقاط قوة K3
سياق على نطاق المستودع
نافذة المليون رمز تساعد الوكيل على الاحتفاظ بجزء كبير من قاعدة الشفرة في السياق، وهو مفيد خصوصًا في مشاريع monorepo أو التعديلات التي تعبر طبقات متعددة.
استخدام الأدوات والاستقلالية طويلة المدى
K3 مصمم لجلسات هندسية ممتدة: قراءة ملفات، تشغيل أوامر، تحليل نتائج، ثم تعديل جديد. هذا مناسب لتذاكر تحتاج أكثر من اقتراح كود واحد.
التكلفة في الحلقات كثيفة التخزين المؤقت
تعيد البرمجة الوكيلة إرسال السياق نفسه مرارًا: شجرة الملفات، التعليمات، موجه النظام، ومخرجات سابقة. يذكر المحتوى أن سعر إدخال K3 عند إصابة التخزين المؤقت هو 0.30 دولار لكل مليون رمز مقابل 3.00 دولارات عند عدم الإصابة. راجع تحليل تسعير Kimi K3 للأرقام الكاملة.
حدود K3
ليس النموذج الأقوى مطلقًا
تنص Moonshot على أن K3 ما زال خلف Claude Fable 5 وGPT-5.6 Sol. في معايير البرمجة المنشورة، يسجل K3 88.3 في Terminal Bench 2.1 مقابل 88.8 لـ GPT-5.6 Sol، ويسجل 67.5 في DeepSWE مقابل 70.0 لـ Fable 5 و73.0 لـ GPT-5.6 Sol. راجع معايير Kimi K3.
السرعة ليست نقطة تفوقه
في Artificial Analysis، ينتج K3 نحو 62 رمزًا في الثانية. إذا كان سير عملك تفاعليًا جدًا وتحتاج استجابات فورية، قارن نموذجًا أسرع قبل اعتماده.
الاستضافة الذاتية ليست متاحة بعد يوم الإطلاق
الأوزان الكاملة متوقعة قرب 27 يوليو 2026. إذا كانت خطتك تعتمد على الاستضافة الذاتية، تعامل مع ذلك كتاريخ مستقبلي يجب متابعته، لا كخيار متاح فورًا.
للمقارنات المباشرة، راجع:
حالات استخدام مناسبة
يكون K3 أكثر فائدة عندما يمكنه تشغيل حلقة تحقق حقيقية، مثل:
- إعادة هيكلة كبيرة في monorepo: تتبع الاستخدامات عبر الحزم، تعديل الواجهات، ثم تشغيل البناء والاختبارات.
- تصحيح خطأ متكرر: إعادة إنتاج الفشل، قراءة تتبع المكدس، تطبيق إصلاح، ثم إضافة اختبار انحدار.
- تنفيذ ميزة API: إنشاء المسار والمعالج والتحقق والاختبارات، ثم اختبار نقطة النهاية فعليًا.
- تعديلات واجهة المستخدم: تغيير الواجهة، تشغيل التطبيق، تحليل لقطة شاشة، ثم تكرار التعديل.
تجنب استخدامه كمراجع وحيد للتغييرات الحساسة في الأمان أو البيانات أو عمليات النشر. اجعل الاختبارات، ومراجعة الكود، والتحقق من API جزءًا من تعريف الإنجاز.
التحقق من واجهات API التي يبنيها K3
اختبارات المشروع قد تثبت أن الكود يعمل داخليًا، لكنها لا تثبت دائمًا أن العميل الحقيقي سيحصل على:
- رمز الحالة الصحيح.
- جسم استجابة متوافقًا مع العقد.
- رؤوس استجابة متوقعة.
- سلوك مصادقة صحيح.
- معالجة أخطاء سليمة.
هنا يفيد Apidog. بعد أن ينشئ K3 نقطة نهاية، اختبرها بطلبات حقيقية وأضف تأكيدات على حالة الاستجابة وشكل JSON.
مثال تحقق من نقطة تسجيل الدخول:
POST /login
الحالة المتوقعة:
- 200 عند بيانات اعتماد صحيحة.
- 400 عند password فارغة.
- 401 عند كلمة مرور غير صحيحة.
- لا تتضمن الاستجابة تفاصيل داخلية أو تتبع مكدس.
إذا أنشأ الوكيل مواصفة OpenAPI، استوردها إلى Apidog لإنشاء مجموعة الطلبات والتحقق من التنفيذ مقابل العقد. استخدم متغيرات البيئة لحفظ المفاتيح والرموز السرية بدل وضعها داخل مجموعات مشتركة.
يمكنك أيضًا ربط أدوات API بسياق الوكيل عبر MCP. راجع تصحيح الأخطاء المرئي باستخدام عميل Apidog MCP، أو استخدم Apidog في VS Code لإبقاء الاختبار بجوار الكود. يمكنك تنزيل Apidog للتحقق من مخرجات الوكيل قبل الشحن.
ماذا يعني هذا بالنسبة لك؟
Kimi K3 خيار عملي داخل Kimi Code عندما تكون المهمة كبيرة وقابلة للتحقق: مستودع واسع، تذكرة متعددة الخطوات، إصلاح يحتاج اختبارات، أو ميزة API تحتاج فحصًا فعليًا.
ابدأ بهذه القائمة:
- شغّل Kimi Code من جذر المستودع.
- اختر
/model kimi-k3. - اكتب مهمة محددة تتضمن معيار نجاح واضحًا.
- اطلب من الوكيل تشغيل الاختبارات بعد كل تعديل مهم.
- راجع الملفات المعدلة قبل الدمج.
- اختبر أي API مولدة بطلبات حقيقية في Apidog.
- لا تشحن التغيير لمجرد أن الوكيل قال إنه انتهى.
لخلفية إضافية، اقرأ ما هو Kimi K3 ودليل Kimi K3 API.
الأسئلة الشائعة
كيف أستخدم Kimi K3 للبرمجة؟
شغّله داخل Kimi Code، ثم افتح الوكيل من دليل مشروعك واختر النموذج:
/model kimi-k3
بعد ذلك، امنحه مهمة محددة وقابلة للاختبار، واطلب منه قراءة الملفات، وتشغيل الأدوات، وتنفيذ الاختبارات، وتلخيص التعديلات. راجع دليل Kimi Code CLI للتثبيت.
هل Kimi K3 مناسب للبرمجة الوكيلة؟
نعم. صُمم للتنقل في المستودعات الكبيرة، واستخدام الأدوات، وتصحيح الأخطاء، والتكرار مقابل الاختبارات والسجلات وملاحظات وقت التشغيل ضمن سياق يصل إلى مليون رمز. لكنه يتخلف قليلًا عن Fable 5 وGPT-5.6 Sol في بعض المقاييس المنشورة.
هل يدعم Kimi K3 استدعاء الأدوات؟
نعم. تدعم K3 API استدعاءات الأدوات، وقيود اختيار الأدوات، ووضع JSON، والمخرجات المهيكلة، والبحث في الإنترنت، والتحميل الديناميكي للأدوات، وجهد التفكير القابل للتكوين. هذه الإمكانات تسمح بتشغيل الاختبارات وأوامر الشيل داخل حلقة وكيل. راجع دليل Kimi K3 API.
هل يمكنني اختبار واجهات API التي يكتبها Kimi K3؟
نعم، ويجب عليك ذلك. اختبارات الوكيل قد تثبت عمل الكود، لكنها لا تتحقق بالضرورة من رموز الحالة وشكل الاستجابة وسلوك المصادقة الذي يتوقعه العميل. أرسل طلبات حقيقية إلى نقاط النهاية عبر Apidog، وأضف تأكيدات، واستورد أي مواصفة OpenAPI يولدها الوكيل للتحقق من التطبيق مقابل العقد.
Top comments (0)