كيفية استخدام كيمي K3 للبرمجة باستخدام كيمي كود

قامت شركة Moonshot AI ببناء Kimi K3 لأعمال البرمجة التي لا تتناسب مع موجه واحد. الفكرة هي هندسة بعيدة المدى: توجيه نموذج إلى مستودع كبير، وتركه يقرأ الملفات، ويشغل الأدوات، وينفذ الاختبارات، ويقرأ السجلات ولقطات الشاشة التي تعود، ويكرر العملية حتى تكتمل المهمة. هذه وظيفة مختلفة عن الإكمال التلقائي، وهي تحتاج إلى وكيل برمجي ملفوف حول النموذج. Moonshot توفر واحدًا يسمى Kimi Code. يغطي هذا الدليل كيفية تشغيل K3 بداخله، وكيف تبدو حلقة الوكيل الحقيقية، وموقعه بجانب Claude Code وCursor، وأين يقصر بصراحة.

باختصار: تشغيل Kimi K3 للبرمجة

Kimi K3 هو النموذج الرائد لشركة Moonshot AI، تم إطلاقه في 16 يوليو 2026، مع نافذة سياق بمليون رمز وبنية مُعدلة للعمل على نطاق المستودعات. يمكنك البرمجة باستخدامه من خلال Kimi Code، وكيل البرمجة للطرفيات وبيئات التطوير المتكاملة من Moonshot: حدد النموذج باستخدام الأمر /model وامنحه مهمة. K3 قوي في التنقل في قواعد الأكواد الكبيرة، واستخدام الأدوات، وتصحيح الأخطاء، والتكرار مقابل الصور والسجلات والاختبارات وملاحظات وقت التشغيل. إنه رخيص في الحلقات كثيفة التخزين المؤقت بفضل معدل إصابة التخزين المؤقت الذي يُبلغ عنه بأكثر من 90%، ولكنه ليس الأسرع بسرعة تقريبية تبلغ 62 رمزًا في الثانية، وتقول Moonshot نفسها إنه لا يزال يتخلف عن Claude Fable 5 وGPT-5.6 Sol في القدرة الخام. عندما يبني K3 واجهة برمجة تطبيقات لك، فإن Apidog هي أسرع طريقة للوصول إلى نقاط النهاية التي يولدها وتأكيد سلوكها. للحصول على خلفية النموذج، ابدأ بـ ما هو Kimi K3.

ما هو Kimi Code

Kimi Code هو وكيل البرمجة الخاص بـ Moonshot. يعمل في طرفيتك (ويتكامل مع بيئة التطوير المتكاملة الخاصة بك)، ويقرأ ويكتب الملفات، وينفذ أوامر الشيل، ويقوم بإدارة جلسة هندسية كاملة نيابة عنك بدلاً من مجرد الإجابة على سؤال. افتحه داخل دليل مشروع، صف ما تريده، وسيقوم بالتخطيط، والتعديل، والتشغيل، والتحقق من عمله في حلقة. النموذج بحد ذاته هو محرك نصوص وأدوات؛ Kimi Code هو اللجام الذي يمنحه نظام ملفات، وشيل، ومخرجات اختبار، ولقطات شاشة للعمل عليها. هذا اللجام يحول "نموذج جيد في البرمجة" إلى "وكيل يمكنه إغلاق تذكرة".

Kimi Code ليس جديدًا مع K3؛ عمل خط Kimi K2 السابق في نفس الوكيل. يغطي دليل Kimi Code CLI الخاص بنا عملية التثبيت من الصفر، وكيفية استخدام Kimi CLI هو المرجع الأوسع لأوامر سطر الأوامر. تفترض هذه المقالة تثبيت CLI وتركز على تشغيل K3.

تشغيل Kimi K3 في Kimi Code

يتغير أمر التثبيت والأعلام الدقيقة مع تحديث Moonshot للأداة، لذا تعامل مع الخطوات أدناه على أنها شكل سير العمل وتأكد من التركيب الدقيق في وثائق Kimi الرسمية أو دليل Kimi Code CLI الخاص بنا. الأوامر تمثيلية وليست دقيقة.

1. تثبيت الوكيل والمصادقة. قم بتثبيت أداة سطر الأوامر مرة واحدة، ثم سجل الدخول لتتمكن من الوصول إلى Kimi API. ستحتاج إلى حساب Kimi ومفتاح API من منصة مطوري Kimi. قم بتخزين المفتاح كمتغير بيئة بدلاً من لصقه في ملف تكوين قد تقوم بتثبيته عن طريق الخطأ.

# تمثيلي، وليس دقيقًا. تحقق من الوثائق الرسمية للتركيب الحالي.
export KIMI_API_KEY="مفتاحك هنا"
kimi-code   # يشغل الوكيل في الدليل الحالي

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

3. حدد K3 كالنموذج. داخل الجلسة، قم بتبديل النموذج النشط باستخدام الأمر /model واختر kimi-k3. هذه هي نفس الآلية التي ستستخدمها للتبديل بين K3 والنماذج القديمة مثل Kimi K2.7 Code الذي يركز على البرمجة في نفس المهمة.

/model kimi-k3

4. ضبط جهد التفكير. يوفر K3 جهد تفكير قابل للتكوين، بما في ذلك إعداد "أقصى". لتصحيح الأخطاء الصعبة أو إعادة هيكلة كبيرة، يساعد المزيد من التفكير؛ للتعديلات السريعة، قم بتقليله حتى لا تدفع مقابل عمق لا تحتاجه.

بمجرد تحديد النموذج وتوجيه الوكيل إلى مستودعك، تكون جاهزًا لإعطائه العمل. لتجربة K3 دون تثبيت Kimi Code، أو بدون تكلفة، يغطي كيفية استخدام Kimi K3 مجانًا المسارات المجانية.

سير عمل برمجي عملي باستخدام الوكلاء

النمط هو نفسه سواء كنت تقوم بإصلاح خطأ أو شحن ميزة: امنح K3 مهمة ملموسة، دعه يجمع السياق، واجعله يثبت النتيجة مقابل شيء موضوعي.

وجهه إلى المستودع وامنحه مهمة واضحة

التعليمات الغامضة تنتج عملًا غامضًا. بدلاً من "تحسين وحدة المصادقة"، امنح الوكيل مهمة يمكنه التحقق منها: "نقطة نهاية /login تعيد 500 عندما يكون حقل كلمة المرور فارغًا. أعد إنتاجه، ابحث عن السبب، أصلحه، وأضف اختبارًا يغطي حالة كلمة المرور الفارغة." الهدف المحدد والقابل للاختبار هو أكبر عامل وحيد في جودة الإخراج: إنه يمنح الوكيل خط نهاية للتحقق من نفسه مقابله.

سياق K3 الذي يبلغ مليون رمز هو ما يجعل "توجيهه إلى المستودع بأكمله" واقعيًا: يحتفظ الوكيل بشريحة كبيرة من قاعدة الشفرة الخاصة بك في وقت واحد، متتبعًا استدعاءً من معالج المسار عبر طبقة الخدمة دون أن تغذيه بالملفات الصحيحة. تشير Moonshot إلى التنقل في المستودعات الكبيرة كقوة أساسية لـ K3.

دعه يستخدم الأدوات ويقرأ الملاحظات

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

1. يقرأ الوكيل الملفات ذات الصلة ويشكل فرضية.
2. يقوم بإجراء تعديل.
3. يشغل الاختبارات أو التطبيق.
4. يقرأ الإخراج الفاشل، أو تتبع المكدس، أو سطر السجل.
5. يقوم بالمراجعة والتكرار حتى تمر الفحوصات.

تصف Moonshot K3 بأنه "قوي بشكل خاص في التنقل في المستودعات الكبيرة، واستخدام الأدوات، وتصحيح الأخطاء، والتكرار مقابل الصور، والسجلات، والاختبارات، وملاحظات وقت التشغيل." هذه الحلقة هي قلب سير العمل: أنت لا تطلب من النموذج أن يكون صحيحًا من التخمين الأول، ولكن أن يقوم بالتشغيل والملاحظة والتصحيح مثل مهندس بشري.

كرر العملية بناءً على الصور ومخرجات وقت التشغيل

الملاحظات لا تقتصر على النص. تسلط Moonshot الضوء على الاستدلال البصري كجزء من نطاق K3: يمكن للوكيل قراءة لقطة شاشة لتأكيد أن تغيير الواجهة الأمامية تم عرضه بشكل صحيح، أو استخدام صورة ملتقطة لتوجيه تطوير الألعاب وأعمال التصميم بمساعدة الكمبيوتر. لذا فإن حلقة واجهة المستخدم هي: تغيير CSS، العرض، لقطة الشاشة، التعديل. لأعمال الواجهة الخلفية، تكون الملاحظات تقرير اختبار، أو تدفق سجل، أو استجابة HTTP، والحلقة هي نفسها.

حافظ على صدق الحلقة بالاختبارات

الاختبارات تمنع الحلقة الذاتية من الانحراف. مع وجود مجموعة اختبارات ناجحة للاستهداف، يكون لدى الوكيل إشارة واضحة "تم" و "معطل"؛ وبدونها، يمكن أن تتجول عملية طويلة وتتلف شيئًا ما بهدوء في ثلاثة ملفات بعيدًا. اكتب الاختبار أولاً، ثم اترك K3 يكرر العملية حتى يصبح أخضر.

Kimi K3 مقابل Claude Code و Cursor للبرمجة

K3 في Kimi Code ليس هو الإعداد الوحيد للبرمجة الوكيلة. إليك مقارنة صادقة بين الطرق الثلاث الأكثر شيوعًا لتشغيل وكيل مقابل قاعدة الشفرة الخاصة بك في منتصف عام 2026.

بعض الاستنتاجات. للحصول على أعلى موثوقية خام في مهمة صعبة، فإن Fable 5 في Claude Code هو النموذج الذي تعترف Moonshot نفسها بأنه يتقدم على K3. إذا كنت تريد الوكيل داخل محرر مصقول، فإن Cursor وأدوات نمط Cline تناسب بشكل أفضل، ويمكنك تشغيل نماذج مفتوحة أخرى من خلالها، كما يوضح دليلنا GLM-5.2 في Claude Code و Cline و Cursor. ميزة K3 هي سياق كبير جدًا، وتنقل قوي في المستودعات، وتسعير مصمم للحلقات الطويلة والمتكررة التي ترفع الفاتورة في نماذج متطورة تعتمد على الرموز. بمجرد شحن الأوزان، سيكون هو الوحيد من بين الثلاثة الذي يمكنك استضافته ذاتيًا.

نقاط القوة والحدود الصادقة

ما الذي يميز K3

سياق على نطاق المستودع. تتيح نافذة المليون رمز للوكيل الاحتفاظ بقاعدة شفرة كبيرة في الرؤية دفعة واحدة، مما يقلل من مشكلة "أي الملفات يجب أن أقدمها" التي تعيق النماذج ذات السياق الأصغر في عمل المستودعات الموحدة (monorepo).

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

التكلفة في الحلقات كثيفة التخزين المؤقت. تعيد البرمجة الوكيلة إرسال نفس السياق (شجرة الملفات، موجه النظام، التعليمات) في كل خطوة. سعر إدخال K3 الذي يعتمد على إصابة التخزين المؤقت هو 0.30 دولار لكل مليون رمز مقابل 3.00 دولارات عند عدم إصابته، بفارق 10 أضعاف، ويُبلغ أن استنتاج Mooncake من Moonshot يحقق معدل إصابة للتخزين المؤقت يتجاوز 90% في أعباء عمل البرمجة. لذا فإن النمط الذي يجعل حلقات الوكيل باهظة الثمن في أماكن أخرى هو حيث يبقى K3 رخيصًا. الأرقام الكاملة موجودة في تحليل تسعير Kimi K3.

أين يقصر K3

إنه ليس الأفضل، و Moonshot تقول ذلك. ينص منشور الإطلاق بوضوح على أن K3 "لا يزال يتخلف عن أقوى النماذج الاحتكارية، Claude Fable 5 وGPT-5.6 Sol." في معايير البرمجة التي نشرتها Moonshot، الصورة قريبة ولكنها متسقة: في Terminal Bench 2.1، يسجل K3 88.3 مقابل 88.8 لـ GPT-5.6 Sol، وفي DeepSWE يسجل 67.5 مقابل 70.0 لـ Fable 5 و 73.0 لـ GPT-5.6 Sol. تنافسي، ليس الأول. انظر تحليل معايير Kimi K3 للحصول على الصورة الكاملة.

إنه ليس سريعًا. في قائمة Artificial Analysis، ينتج K3 حوالي 62 رمزًا في الثانية، وهو أقل من المتوسط لفئته السعرية، ويميل افتراضيًا إلى أقصى جهد تفكير. في حلقة تفاعلية حيث تشاهد تدفق المخرجات، يكون ذلك ملحوظًا. إذا كانت السرعة تهم أكثر من النقاط القليلة الأخيرة من الجودة، فقم بمقارنة نموذج أسرع أولاً.

"مفتوح" هو حدث مقرر. الأوزان الكاملة متوقعة حوالي 27 يوليو 2026، وليس في يوم الإطلاق. إذا كانت خطتك تعتمد على الاستضافة الذاتية، فهذا تاريخ للمراقبة بدلاً من مفتاح يمكنك قلبه الآن.

للمقارنات المباشرة، انظر Kimi K3 مقابل Claude Opus 4.8، وKimi K3 مقابل GPT-5.6 Sol، وKimi K3 مقابل Kimi K2.7 Code، والذي يغطي الترقية من بطل البرمجة السابق في السلسلة.

حالات الاستخدام في العالم الحقيقي

يتألق K3 في المهام التي صمم لها سير العمل المذكور أعلاه: عمليات إعادة الهيكلة الكبيرة عبر مستودع موحد (monorepo)، حيث تعرض نافذة السياق البالغة مليون رمز نطاق التأثير الكامل دفعة واحدة حتى تتمكن من العمل بجد في التعديلات حتى يصبح البناء أخضر؛ جلسات تصحيح الأخطاء الطويلة، حيث تعيد إنتاج فشل، وتقرأ تتبع المكدس، وتصلح، وتعيد التشغيل دون الحاجة إلى إشرافك؛ وبناء واجهة برمجة تطبيقات، حيث يقوم بإنشاء المعالج والمسار وغالبًا الاختبارات، ثم يسلمها إلى أداة API مخصصة للتحقق.

التحقق من واجهات برمجة التطبيقات التي يبنيها K3

عندما يبني K3 أو يعدل واجهة برمجة تطبيقات داخل Kimi Code، تخبرك اختباراته الخاصة بأن الكود يعمل. لكنها لا تخبرك بأن نقطة النهاية تتصرف بالطريقة التي يتوقعها العميل الحقيقي: رموز حالة صحيحة، شكل استجابة مناسب، معالجة أخطاء معقولة، مصادقة ترفض رمزًا غير صحيح. هذه وظيفة اختبار واجهة برمجة التطبيقات.

هنا يأتي دور Apidog. أرسل طلبات حقيقية إلى نقطة النهاية المولدة، افحص نص ورؤوس الاستجابة، وأضف تأكيدات على رمز الحالة وشكل JSON. إذا أنتج الوكيل مواصفات OpenAPI، فاستوردها وسيبني Apidog مجموعة الطلبات لك، بحيث تقوم بالتحقق مقابل العقد بدلاً من التخمين. احتفظ بمفاتيحك في متغيرات بيئة Apidog حتى لا تتسرب أبدًا إلى مجموعة مشتركة.

ولأن Apidog تعرض واجهة MCP، يمكنك أيضًا ربط أدوات API الخاصة بك مباشرة بسياق الوكيل؛ يوضح دليلنا حول تصحيح الأخطاء المرئي باستخدام عميل Apidog MCP كيف، ويحافظ Apidog في VS Code على حلقة الاختبار بجوار الكود الذي يكتبه K3. قم بتنزيل Apidog للتحقق من مخرجات النموذج فور وصولها، بدلاً من الثقة بتشغيل اختبار أخضر وحده.

ماذا يعني هذا بالنسبة لك

Kimi K3 هو وكيل برمجة قادر حقًا في Kimi Code عندما تعتمد على ما صُمم من أجله: المستودعات الكبيرة، الحلقات المستقلة الطويلة، والتكرار المستمر مقابل الاختبارات والسجلات ولقطات الشاشة. السياق البالغ مليون رمز وتسعير إصابة التخزين المؤقت يجعلان منه عمليًا تمامًا للعمل الشاق ومتعدد الخطوات الذي يصبح مكلفًا بسرعة في أماكن أخرى. إنه ليس أفضل مبرمج متاح بشكل مطلق، وتستحق Moonshot التقدير لقولها ذلك، ولكن بالنسبة للكثير من الأعمال الحقيقية، فإن الفجوة صغيرة ومزايا التكلفة والانفتاح حقيقية. ابدأ بمهمة ملموسة وقابلة للاختبار، ودع K3 يكرر العملية، وتحقق من واجهات برمجة التطبيقات التي ينتجها باستخدام Apidog قبل الشحن. للحصول على خلفية النموذج، فإن عمود ما هو Kimi K3 ودليل Kimi K3 API يكملان الموضوع من هناك.

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

كيف أستخدم Kimi K3 للبرمجة؟ قم بتشغيله داخل Kimi Code، وكيل البرمجة للطرفيات وبيئات التطوير المتكاملة من Moonshot. قم بتثبيت الوكيل، وافتحه في دليل مشروعك، وحدد النموذج باستخدام /model kimi-k3، ثم امنحه مهمة ملموسة وقابلة للاختبار ودعه يقرأ الملفات، ويشغل الأدوات، ويكرر العملية. دليل التثبيت الكامل موجود في دليل Kimi Code CLI الخاص بنا.

هل Kimi K3 جيد للبرمجة الوكيلة؟ نعم. إنه مصمم خصيصًا لما تحتاجه البرمجة الوكيلة: التنقل في المستودعات الكبيرة، واستخدام الأدوات، وتصحيح الأخطاء، والتكرار مقابل الاختبارات، والسجلات، وملاحظات وقت التشغيل عبر سياق بمليون رمز. إنه تنافسي في معايير البرمجة، على الرغم من أنه يتخلف قليلاً عن Fable 5 وGPT-5.6 Sol.

هل يدعم Kimi K3 استدعاء الأدوات لسير عمل الوكلاء؟ نعم. تدعم K3 API استدعاءات الأدوات، وقيود اختيار الأدوات، ووضع JSON، والمخرجات المهيكلة، والبحث في الإنترنت، والتحميل الديناميكي للأدوات، وجهد التفكير القابل للتكوين، وهو ما يسمح له بتشغيل الاختبارات، وتنفيذ أوامر الشيل، وتنسيق حلقة وكيل كاملة داخل Kimi Code. يغطي دليل Kimi K3 API التفاصيل من جانب المطور.

هل يمكنني اختبار واجهات برمجة التطبيقات التي يكتبها Kimi K3؟ نعم، ويجب عليك ذلك. تؤكد اختبارات الوكيل الخاصة أن الكود يعمل، لكنها لا تؤكد أن نقطة النهاية تعيد رموز الحالة الصحيحة، وشكل الاستجابة، وسلوك المصادقة الذي يتوقعه العميل الحقيقي. أرسل طلبات حقيقية إلى نقاط النهاية المولدة في Apidog، وأضف تأكيدات، واستورد أي مواصفات OpenAPI أنتجها الوكيل للتحقق مقابل العقد.