הכנסת Kimi K3.1 Pro אל Kimi Code CLI: התקנה, התחברות ומלכודת Windows

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. הסקריפט מוריד את הגרסה האחרונה, מאמת את ה-checksum שלה, ומציב את קובץ ההרצה kimi ב-PATH שלך. אין צורך ב-runtime של Node.js או Python.

ל-Windows יש תנאי מוקדם אחד שקל לפספס: התקינו קודם את Git for Windows. Kimi Code CLI משתמש ב-Git Bash המצורף כסביבת ה-shell שלו. אם Git Bash נמצא במקום לא סטנדרטי, הגדירו את משתנה הסביבה KIMI_SHELL_PATH לנתיב המוחלט של bash.exe לפני ההפעלה — אחרת הסוכן מתחיל לפעול, אבל כל פקודת shell שהוא מנסה להריץ נכשלת.

התחברות באמצעות מפתח API

הפעל את ה-CLI בתוך ספריית הפרויקט שבה ברצונך לעבוד:

• הפעל kimi כדי לפתוח את הממשק האינטראקטיבי.

• הקלד /login. Kimi Code CLI פותח בורר פלטפורמות.

• בחר Kimi Platform (מפתח 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, עם אותן השלכות לגבי הרשאות: סוכן שיכול להריץ פקודות מעטפת צריך להיות מופעל בספרייה שאתה מוכן לאפשר לו לשנות, ויש לבדוק אותו לפני שדוחפים משהו.

שני מודלי חיוב נפגשים בלקוח הזה. אפליקציית 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 חושף את המודל; ברירת המחדל של המאמץ היא היקרה, כך שסשן שמרגיש איטי הוא בדרך כלל סשן שפועל ב-max ולא חיבור תקול. גרסת המהירות הגבוהה מחליפה השהיה במחיר — $4.00 ו-$20.00 למיליון טוקנים במקום $2.00 ו-$10.00 — והיא ברירת המחדל ההגיונית לעבודה אינטראקטיבית שבה המודל ממילא ממתין לאדם.

שני אילוצים מלווים את המודל לכל לקוח: פרמטרי הדגימה קבועים (temperature 1.0, top-p 0.95, n = 1), ושינוי ה-effort באמצע שיחה מבטל פגיעות ב-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 יקר הן מבחינת השהיה והן מבחינת טוקנים.

• Model-not-found לאחר עדכון — ה-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.