إدخال Kimi K3.1 Pro إلى Kimi Code CLI: التثبيت، تسجيل الدخول، وفخ ويندوز

Kimi Code CLI هو وكيل البرمجة الطرفي من Moonshot، وهو العميل الوحيد الذي لا يكون فيه Kimi K3.1 Pro تكاملًا من طرف ثالث بل الخيار الافتراضي. الإعداد أقصر من مسارات Claude Code أو Codex — نص تثبيت واحد، و/login واحد، واختيار منصة واحد — لأن العميل والنموذج يأتيان من الشركة نفسها. العقبة خاصة بالمنصة: على Windows، تعمل CLI داخل Git Bash التي تحزمها، وإذا لم تكن تلك الصدفة حيث يتوقعها المثبّت، تبدأ الأداة ثم تفشل بطرق تبدو وكأنها أخطاء في النموذج.

هذا هو التسلسل الذي يعمل، وقد جرى التحقق منه مقابل وثائق Moonshot في 24 أكتوبر 2026، مع الإشارة إلى أنماط الفشل حيث تحدث فعليًا.

تثبيت

يحتاج 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 على PATH لديك. لا يلزم وجود بيئة تشغيل Node.js أو Python.

لدى Windows متطلب أساسي واحد يسهل تفويته: ثبّت Git for Windows أولًا. تستخدم Kimi Code CLI بيئة Git Bash المضمّنة كبيئة الصدفة الخاصة بها. إذا كان Git Bash موجودًا في مكان غير قياسي، فاضبط متغير البيئة KIMI_SHELL_PATH على المسار المطلق لـ bash.exe قبل التشغيل — وإلا فسيبدأ الوكيل لكن كل أمر صدفة يحاول تشغيله سيفشل.

تسجيل الدخول باستخدام مفتاح API

ابدأ CLI داخل دليل المشروع الذي تريد العمل فيه:

• شغّل kimi لفتح الواجهة التفاعلية.

• اكتب /login. يفتح Kimi Code CLI محدد المنصة.

• اختر منصة Kimi (مفتاح API · platform.kimi.ai). هذا هو الخيار المخصص لمفتاح تم إنشاؤه على المنصة المفتوحة؛ أما الخيارات الأخرى فتقابل واجهات حساب مختلفة.

الصق المفتاح. أنشئ مفتاحًا على platform.kimi.ai ضمن API Keys إذا لم يكن لديك واحد. تخزّن أداة CLI المفتاح محليًا، لذا تعامل مع دليل الإعدادات كما لو كان مخزنًا لبيانات الاعتماد.

هذا هو الاتصال بأكمله. يسرد مُحدِّد النموذج داخل CLI نماذج Kimi الحالية، وKimi K3.1 Pro ونسخته عالية السرعة هما النموذجان المهمان للعمل الوكيلي.

تبديل إعداد موجود، واستبدال مفتاح

هجرتان شائعتان، وكلتاهما تمرّان عبر الشاشة نفسها. إذا كان Kimi Code CLI مسجّل الدخول بالفعل عبر اشتراك بدلاً من مفتاح API، فإن تشغيل /login مرة أخرى واختيار منصة مفتاح API يبدّل ذلك دون إعادة التثبيت. إذا كنت تدوّر مفتاحًا — لأنه تسرّب، أو لأن مشروعًا يحتاج إلى فوترة خاصة به — فإن التدفق نفسه يستبدل بيانات الاعتماد المخزّنة.

الشيء الوحيد الذي يجب ألا تفعله هو تحرير التكوين المخزّن يدويًا أثناء تشغيل CLI؛ إذ تقرأ العملية بيانات الاعتماد عند بدء التشغيل، وأي تعديل أثناء الجلسة يُستبدَل عند الخروج.

ما الذي يفعله الوكيل فعليًا

Kimi Code CLI ليس نافذة دردشة في الطرفية. بل يقرأ الكود ويعدّله، ويبحث في المستودع، ويشغّل الأوامر ويقرأ النتائج، ويمكنه جلب محتوى من الويب أو البحث عندما تحتاج مهمة إلى شيء خارج المشروع. تصفه Moonshot بأنه وكيل برمجة يعمل على جهازك مع قيام النموذج بالتخطيط — بالشكل نفسه الذي عليه Claude Code أو Codex، وبنفس التبعات المتعلقة بالأذونات: فالوكيل القادر على تشغيل أوامر shell ينبغي تشغيله في دليل تقبل أن يعدّله، ومراجعته قبل دفع أي شيء.

يلتقي نموذجا فوترة في هذا العميل. يُباع تطبيق Kimi Code كاشتراك بفئات خطط، ويمكن لـ CLI استخدام ذلك الاشتراك أو مفتاح API من المنصة المفتوحة. ومسار مفتاح API هو الذي يمنحك اقتصاديات لكل توكن — 2.00 دولار و10.00 دولارات لكل مليون توكن لـ K3.1 Pro، و4.00 دولارات و20.00 دولارًا للنسخة عالية السرعة — بينما الاشتراك رسم ثابت مع حصة. بالنسبة لفريق يدفع بالفعل مقابل استخدام API في مكان آخر، يُبقي مسار المفتاح الإنفاق في مكان واحد؛ وبالنسبة لشخص يبرمج طوال اليوم، يكون الاشتراك عادةً أرخص، وCLI هو التنزيل نفسه في الحالتين.

اختيار النموذج والجهد

Kimi K3.1 Pro يفكّر دائمًا، ويُضبط مستوى الجهد عبر حقل في المستوى الأعلى يقبل القيم low وhigh وmax، ويكون افتراضيًا max. ويعرض Kimi Code CLI هذا النموذج؛ وبما أن القيمة الافتراضية للجهد هي الخيار المكلف، فإن الجلسة التي تبدو بطيئة تكون عادةً جلسة تعمل عند الحد الأقصى بدلًا من أن تكون اتصالًا معطلًا. ويقايض البديل عالي السرعة زمن الاستجابة بالسعر — 4.00 دولار و20.00 دولار لكل مليون رمز بدلًا من 2.00 دولار و10.00 دولار — وهو الخيار الافتراضي المعقول للعمل التفاعلي حيث ينتظر النموذج إنسانًا على أي حال.

ثمة قيدان يلازمان النموذج في أي عميل: معاملات أخذ العينات ثابتة (temperature 1.0، top-p 0.95، n عند 1)، وتغيير الجهد في منتصف المحادثة يبطل إصابات ذاكرة التخزين المؤقت للبادئة (prefix-cache). حدِّد المستوى في بداية الجلسة.

كيف يقارن هذا المسار بـ Claude Code وCodex؟

تستخدم العملاء الثلاثة ثلاثة بروتوكولات مختلفة للوصول إلى النموذج نفسه، والاختيار في الغالب يتعلق بالواجهة التي يعمل ضمنها فريقك بالفعل. يُعد Kimi Code CLI الأقل إعدادًا: فلا توجد كتلة متغيرات بيئة ولا ملف TOML، والمورّد يدير الطرفين. يحتاج Claude Code إلى نقطة النهاية المتوافقة مع Anthropic وإلى ضبط أربعة متغيرات لمستويات النماذج بشكل صحيح، بينما يحتاج Codex إلى كتلة مزوّد مع wire_api = "responses"، لكن كليهما يعملان بعد ذلك مع أي مزوّد يتحدث تلك البروتوكولات — بما في ذلك بوابة تخدم أيضًا نماذج مورّدين آخرين.

التقسيم العملي: استخدم Kimi Code CLI عندما يكون Kimi هو النموذج الوحيد الذي تحتاجه وتريد أقصر مسار؛ واستخدم Claude Code أو Codex عندما تضطر الجلسة نفسها إلى التبديل بين مورّدين مختلفين، أو عندما تكون أدوات فريقك وأذوناته ومهاراته موجودة بالفعل في تلك العملاء.

تسلسل استكشاف الأخطاء وإصلاحها الذي يوفّر الوقت

• تبدأ أداة CLI لكن لا يتم تشغيل أي أمر shell — تحقق من Git Bash وKIMI_SHELL_PATH أولًا، قبل إلقاء اللوم على النموذج.

• أخطاء المصادقة بعد إعداد كان يعمل — أعد تشغيل /login وتأكّد من أنّ خيار المنصّة يطابق المكان الذي أُنشئ فيه المفتاح؛ فالمفاتيح الآتية من أسطح مختلفة غير قابلة للتبادل.

• الجلسات التي تبدو بطيئة — تحقّق من القيمة الافتراضية لمستوى الجهد قبل تغيير النماذج؛ فمستوى max مكلف من حيث زمن الاستجابة وعدد الرموز معًا.

• خطأ «النموذج غير موجود» بعد التحديث — تعرض واجهة CLI قائمة بما تقدّمه المنصّة؛ وإذا كان K3.1 Pro غائبًا، فإنّ العميل موجَّه إلى واجهة لم تُحدَّث بعد.

يُتاح Kimi K3.1 Pro على المنصة بسعر 2.00 دولار لكل مليون رمز إدخال و10.00 دولارات لكل مليون رمز إخراج، مع سياق بطول 1M رمز وما يصل إلى 943,718 رمز إخراج. وإذا كنت تفضّل الوصول إليه عبر واجهة API التي تستخدمها أدواتك الأخرى بالفعل، فإن OrcaRouter يقدّم النموذج نفسه باسم kimi/kimi-k3.1-pro بسعر قائمة المزوّد دون إضافة أي هامش — ويُغطّى إعداد هذا المسار في دليل Claude Code وCodex.