การรัน Kimi K3.1 Pro ใน Claude Code และ Codex: การตั้งค่า ความล้มเหลวแบบเงียบ และสวิตช์บรรทัดเดียว

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 ตัวแปรที่เขียนไว้ในนั้นจะเขียนทับชื่อตัวแปรเดียวกันที่ export ไว้ในเชลล์ของคุณ ซึ่งทั้งเป็นคุณสมบัติที่ดีและเป็นกับดัก: การ export ที่ค้างอยู่ในเทอร์มินัลของคุณจะไม่ช่วยคุณได้ หากไฟล์ระบุไว้เป็นอย่างอื่น

• 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 token จริง ๆ การใส่คีย์ 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 ใช้โมเดลที่แตกต่างกันสำหรับการสนทนาหลัก การสรุปเบื้องหลัง sub-agent และการเรียกใช้ยูทิลิตี้ขนาดเล็ก หากกำหนดค่าเพียงANTHROPIC_MODELเส้นทางอื่น ๆ จะไม่เกิดข้อผิดพลาด —但它们จะเงียบ ๆ ไม่ทำอะไรที่เป็นประโยชน์ หรือ fallback ในลักษณะที่ทำให้เครื่องมือดูเหมือนพังโดยไม่ระบุสาเหตุ ตารางอ้างอิงของ Moonshot ระบุชัดเจนว่าแต่ละระดับที่ไม่ได้กำหนดค่าจะทำให้งานที่เกี่ยวข้องล้มเหลว และอาการที่ปรากฏจะดูเหมือนเอเจนต์ที่ทำงานช้าหรือสับสน มากกว่าที่จะเป็นข้อผิดพลาดด้านการกำหนดค่า

เช็กลิสต์ที่ใช้ได้จริงคือการตั้งค่าตัวแปร tier ทั้งสี่ตัวบวกตัวแปร sub-agent ในการแก้ไขครั้งเดียว จากนั้นรีสตาร์ท Claude Code แล้วยืนยันในเซสชันว่ามี sub-agent ทำงานจริง ๆ หากมันค้าง สิ่งแรกที่ควรตรวจคือ 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.

ตัวคีย์เองควรอยู่ใน environment ไม่ใช่ในไฟล์ env_key ดังนั้นควรเก็บ config.toml ให้ปลอดจากความลับ และตั้งค่าตัวแปรใน shell profile หรือ environment ของระบบของคุณ

สองข้อจำกัดที่ควรรู้ก่อนแจ้งบั๊ก Codex CLI ไม่รับวิดีโอเป็นอินพุตแม้ว่าตัวโมเดลจะรับได้ — นั่นเป็นข้อจำกัดของเลเยอร์อินพุตของ Codex ดังนั้นงานที่เกี่ยวกับวิดีโอจึงต้องเรียกผ่าน API โดยตรง และการจัดการบริบทของ Codex เองก็ยังมีผลอยู่: หน้าต่าง 1M โทเคนไม่ได้หมายความว่าทุกเซสชันควรใช้หน้าต่างขนาดนั้น

ชี้เครื่องมือทั้งสองไปที่เกตเวย์เดียวแทน

ทุกอย่างข้างต้นทำงานได้โดยไม่ต้องแก้ไขหากคุณแทนที่ base URL ของ Moonshot ด้วยของ gateway ซึ่งมีประโยชน์เมื่อฐานโค้ดเดียวกันยังเรียกใช้โมเดลจากผู้ให้บริการรายอื่นด้วย OrcaRouter เปิดให้เข้าถึงทั้งสามส่วนเชื่อมต่อสำหรับ Kimi K3.1 Pro — /v1/chat/completions, /v1/responses และ /v1/messages — และเผยแพร่โมเดลภายใต้ id 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.

สิ่งที่คุณได้รับจากการเปลี่ยนมาใช้คือข้อมูลรับรองหนึ่งชุดสำหรับทุกโมเดลในแคตตาล็อก และนโยบายการกำหนดเส้นทางที่สามารถย้ายคำขอระหว่างผู้ให้บริการได้โดยไม่ต้องแก้ไขโค้ดแอปพลิเคชัน — สิ่งที่ทำให้แผนสำรองเป็นไปได้เมื่อ endpoint ของโมเดลใหม่ติดอัตราการเรียกใช้จำกัดในสัปดาห์ที่เปิดตัว สิ่งที่คุณต้องแลกไปคือคอนโซลของผู้ให้บริการเองและพื้นผิวเบต้าเฉพาะของผู้ให้บริการ ราคาจะถูกส่งต่อตามราคาตามรายการของผู้ให้บริการ: $2.00 ต่อล้านโทเค็นอินพุต และ $10.00 ต่อล้านโทเค็นเอาต์พุตสำหรับ Kimi K3.1 Pro โดยไม่มีการบวกกำไรเพิ่ม

การตรวจสอบห้านาที

ทดสอบ endpoint โดยตรงก่อนแตะไคลเอนต์: การส่ง POST ไปยังเส้นทาง Messages หรือ Chat Completions ด้วยคำขอแบบหนึ่งโทเคนควรคืนค่า JSON และ 401 หมายความว่าคีย์ผิดหรือเป็นของแพลตฟอร์มอีกตัว

ใน Claude Code ให้ถามคำถามที่บังคับให้เกิดซับเอเจนต์ — การค้นหาข้ามหลายไฟล์ — แล้วดูว่ามันทำงานเสร็จหรือไม่ นั่นคือการทดสอบการกำหนดค่าระดับชั้นที่เร็วที่สุด

• ใน Codex ให้เริ่มเซสชันบนรีโพซิทอรีขนาดเล็ก และตรวจสอบว่าโมเดลรายงานหน้าต่าง 1M หรือไม่; หากรายงานค่าเริ่มต้นที่เล็กกว่า แสดงว่า model_context_window ไม่ได้ถูกนำไปใช้

• ตั้งค่า effort อย่างตั้งใจ เพียงครั้งเดียว ตอนเริ่มเซสชัน: max สำหรับการดีบักที่ยาก high สำหรับการแก้ไขทั่วไป low สำหรับการสกัดและจัดรูปแบบ ค่าเริ่มต้นคือ max และบนโมเดลนี้ นั่นคือตัวเลือกที่แพง