הרצת Kimi K3.1 Pro ב-Claude Code וב-Codex: התצורה, הכשלים השקטים, ומתג של שורה אחת
- MoonshotחדשMoonshotAI: Kimi K3.1 Pro2026-10-2455אינטליגנציה
- OrcaחדשOrcaCyber: DeepSeek V4.1 Flash Abliterated2026-10-23$0.70 / $1.60 לכל 1M טוקנים · 199 tok/s
- OrcaחדשOrca: OrcaCyber Ultra 1.02026-10-17$5.00 / $10.00 לכל 1M טוקנים · 14 tok/s
- deepseekחדשDeepSeek: DeepSeek V4.1 Flash 10172026-10-1745אינטליגנציה
- DeepSeekחדשDeepSeek: DeepSeek V4.1 Flash2026-10-1740אינטליגנציה
- OrcaOrca: OrcaCyber Zero 1.52026-10-10$3.00 / $7.50 לכל 1M טוקנים · 149 tok/s
- openaiOpenAI: GPT-6.1 Sol2026-09-2952אינטליגנציה
- anthropicAnthropic: Claude Sonnet 5.52026-09-2856אינטליגנציה
- typesafeTypeSafe: Jev 1.132026-09-24$0.04 / $0.00 לכל 1M טוקנים · 1063 tok/s
- OpenAIOpenAI: GPT-6 Luna2026-09-2238אינטליגנציה
- OpenAIOpenAI: GPT-6 Sol2026-09-2248אינטליגנציה
- AnthropicAnthropic: Claude Opus 5.52026-09-2258אינטליגנציה
- xAIGrok 4.72026-09-2146אינטליגנציה
- OrcaOrca: OrcaCyber Zero 1.02026-09-17$3.00 / $7.50 לכל 1M טוקנים · 159 tok/s
- OrcaOrca: OrcaVerify Text 1.02026-09-16$2.00 / $0.00 לכל 1M טוקנים · 1906 tok/s
- OpenAIOpenAI: GPT-6 Astra2026-09-0453אינטליגנציה77כתיבת קוד
- GoogleGoogle: Gemini 3.8 Flash2026-09-0241אינטליגנציה76כתיבת קוד
- AlibabaQwen: Qwen3.8 Max (0902)2026-09-0245אינטליגנציה76כתיבת קוד
- AnthropicAnthropic: Claude Fable 5.12026-09-0153אינטליגנציה82כתיבת קוד
- TencentTencent: Hy4 preview2026-08-28$0.83 / $2.50 לכל 1M טוקנים · 48 tok/s
Kimi K3.1 Pro תומך בשלושה פרוטוקולים: OpenAI Chat Completions, OpenAI Responses ו-Anthropic Messages. זו כל הסיבה שהוא יכול להשתלב ב-Claude Code וב-Codex בלי פרוקסי תרגום — כל כלי כבר מדבר באחד מהשלושה, ו-Moonshot מספק תמיכה מקורית בפרוטוקול הזה. ההגדרה היא קומץ משתני סביבה במקרה אחד ובלוק TOML בן חמישה שורות במקרה האחר. החלק שגובה מאנשים אחר צהריים שלם אינו הקונפיגורציה; זה אופן הכשל. Claude Code משתמש בארבע רמות מודל שונות למשימות שונות, וכל רמה שנותרת ללא הגדרה נכשלת בשקט ולא בקול רם.
מדריך זה נכתב מתוך תיעוד האינטגרציה של Moonshot עצמה, נבדק ב-24 באוקטובר 2026, עם ההסתייגויות שהתיעוד קובר. כאשר ערך שונה אם מפנים את אותם הכלים אל שער ניתוב ולא אל Moonshot ישירות, הדבר מוזכר במפורש.
למה אין צורך בפרוקסי
Claude Code talks to Anthropic's Messages API; Codex talks to the Responses API. Moonshot exposes both. Its Anthropic-compatible surface lives at https://api.moonshot.ai/anthropic and its Responses API at https://api.moonshot.ai/v1, and the model id is kimi-k3.1-pro on both. Nothing in either client needs to know it is not talking to the vendor it was built for.
יש תוצאה אחת שכדאי לציין לפני התצורה: המודל תמיד מבצע הסקה. אין מתג חשיבה, והעומק נקבע באמצעות שדה reasoning_effort ברמה העליונה שמקבל low, high ו-max, כאשר ברירת המחדל היא max. פרמטרי הדגימה קבועים — temperature 1.0, top-p 0.95, n הוא 1 — והעברת ערכים אחרים מחזירה שגיאה. אם ההגדרה הקודמת שלך כיווננה את temperature, הכיוונון הזה לא ישרוד את המעבר.
Claude Code: בלוק הסביבה
Claude Code קורא את התצורה שלו מבלוק ה-env של ~/.claude/settings.json. משתנים שנכתבים שם דורסים את אותם שמות שמיוצאים ב-shell שלך, וזה גם תכונה וגם מלכודת: ייצוא מיושן בטרמינל שלך לא יציל אותך אם הקובץ אומר משהו אחר.
• ANTHROPIC_BASE_URL — the Kimi endpoint root. Set it to https://api.moonshot.ai/anthropic. If you leave it unset, requests go to Anthropic and fail authentication.
• ANTHROPIC_AUTH_TOKEN — מפתח ה-API שלך של Kimi. זהו המשתנה ש-Claude Code משתמש בו בפועל עבור טוקן ה-bearer; מפתח API שממוקם ב-ANTHROPIC_API_KEY במקום זאת הוא הסיבה הנפוצה ביותר לכך שתצורה שנראית תקינה מחזירה 401.
• ANTHROPIC_MODEL — מודל השיחה הראשי: kimi-k3.1-pro.
• ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL, ANTHROPIC_DEFAULT_HAIKU_MODEL, ANTHROPIC_DEFAULT_FABLE_MODEL — אחד לכל דרג. הגדירו לפחות את שלושת הראשונים, והפנו את HAIKU למודל מהיר וזול ולא למודל הדגל; הדוגמה של Moonshot עצמה ממפה את הדרג הזה למודל הקידוד שלה.
• CLAUDE_CODE_SUBAGENT_MODEL — במה משתמשים סוכני־המשנה. ללא הגדרה, עבודתם של סוכני־המשנה נפגעת או נכשלת.
• CLAUDE_CODE_AUTO_COMPACT_WINDOW — מוגדר ל־1000000, בהתאמה לחלון ההקשר. ערך קטן מדי מפעיל דחיסה מוקדמת ומשליך הקשר; ערך גדול מדי מייצר שגיאות אורך הקשר.
• CLAUDE_CODE_EFFORT_LEVEL — המדריך של Moonshot מגדיר זאת ל-max, שזו גם ברירת המחדל של המודל. הורדת הרמה מפחיתה את האיכות במשימות מורכבות, ושינויה באמצע הסשן מבטל פגיעות ב-prefix-cache.
ארבע הרמות שנכשלות בשקט
זו התקלה שכדאי לתכנן לקראתה. Claude Code משתמש במודלים שונים לשיחה הראשית, לסיכום ברקע, לתת-סוכנים ולקריאות שירות קטנות. אם תגדירו רק ANTHROPIC_MODEL ושאר המסלולים לא יפיקו שגיאה — הם פשוט לא יעשו דבר מועיל בשקט, או ייפלו בחזרה בדרכים שגורמות לכלי להיראות שבור בלי לציין סיבה. טבלת ההפניה של Moonshot מפורשת שלכל דרגה שלא הוגדרה גורמת למשימה המתאימה להיכשל, והתסמינים נראים כמו סוכן איטי או מבולבל ולא כמו שגיאת תצורה.
רשימת הבדיקה המעשית היא להגדיר את כל ארבעת משתני ה-tier בתוספת משתנה תת-הסוכן בעריכה אחת, להפעיל מחדש את Claude Code, ואז לוודא בסשן שתת-סוכן אכן פועל. אם זה נתקע, ה-tier הוא הדבר הראשון שצריך לבדוק, לא המודל.
Codex: בלוק TOML אחד
Codex reads ~/.codex/config.toml (on Windows, %USERPROFILE%\.codex\config.toml). The connection is defined by four values in a provider block: the model id kimi-k3.1-pro, a provider named kimi, base_url pointing at https://api.moonshot.ai/v1, the environment-variable name that holds the key, and — the setting that makes the direct connection work — wire_api = "responses". Set model_context_window to 1048576 as well; without it Codex falls back to default model metadata, which degrades behaviour on long inputs.
המפתח עצמו שייך לסביבה, לא לקובץ. Codex קורא אותו מהמשתנה ששמו מצוין בenv_key, לכן יש להשאיר את config.toml נקי מסודות ולהגדיר את המשתנה בפרופיל ה-shell או בסביבת המערכת שלך.
שתי מגבלות שכדאי להכיר לפני שתדווחו על באג. {{1}}Codex CLI אינו מקבל וידאו כקלט אף שהמודל כן{{/1}} — זו מגבלה של שכבת הקלט של Codex, ולכן עבודה עם וידאו חייבת לעבור ישירות דרך ה-API. ו{{2}}ניהול ההקשר של Codex עצמו עדיין חל: חלון של 1M טוקנים לא אומר שכל סשן צריך להשתמש בו{{/2}}.
כיוון שני הכלים לעבר שער אחד במקום
כל מה שלמעלה עובד ללא שינוי אם מחליפים את כתובות ה-URL הבסיסיות של Moonshot בכתובות של שער, דבר שמועיל כאשר אותו בסיס קוד גם קורא למודלים מספקים אחרים. OrcaRouter חושף את כל שלושת משטחי ה-API עבור Kimi K3.1 Pro — /v1/chat/completions, /v1/responses וגם /v1/messages — ומפרסם את המודל תחת המזהה kimi/kimi-k3.1-pro.
For Claude Code, that means ANTHROPIC_BASE_URL set to the gateway root (https://api.orcarouter.ai) with the provider-prefixed model id in the four tier variables. For Codex, the same TOML block with the base URL pointing at https://api.orcarouter.ai/v1 and the model id kimi/kimi-k3.1-pro. The key variable stays the same shape; it just holds a gateway key instead of a vendor key.
מה שאתה מקבל תמורת ההחלפה הוא אישור גישה אחד לכל מודל בקטלוג ומדיניות ניתוב שיכולה להעביר בקשה בין ספקים בלי לשנות קוד אפליקציה — הדבר שמאפשר תוכנית גיבוי כשנקודת הקצה של מודל חדש מגבילה קצב בשבוע ההשקה. מה שאתה מוותר עליו הוא הקונסולה של הספק עצמו וכל משטח בטא ייחודי לספק. המחירים מועברים לפי מחירון הספק: $2.00 למיליון טוקני קלט ו-$10.00 למיליון טוקני פלט עבור Kimi K3.1 Pro, ללא תוספת רווח.
אימות של חמש דקות
• פנו ישירות לנקודת הקצה לפני שנוגעים בלקוח: POST לנתיב Messages או Chat Completions עם בקשת טוקן אחד אמור להחזיר JSON, וקוד 401 משמעו שהמפתח שגוי או שייך לפלטפורמה האחרת.
• ב-Claude Code, שאל שאלה שמכריחה תת-סוכן — חיפוש על פני כמה קבצים — ובדוק אם הוא משלים. זהו המבחן המהיר ביותר של תצורת הדרג.
• ב-Codex, פתח סשן על מאגר קטן ובדוק שהמודל מדווח על חלון של 1M; אם הוא מדווח על ברירת מחדל קטנה יותר, model_context_window לא נכנס לתוקף.
• קבע את רמת המאמץ במכוון, פעם אחת, בתחילת הסשן: max לדיבוג קשה, high לעריכות רגילות, low לחילוץ ועיצוב. ברירת המחדל היא max, ובמודל הזה זו הבחירה היקרה.
