Kimi K3.1 Pro draaien in Claude Code en Codex: de configuratie, de stille fouten en de schakelaar van één regel

Kimi K3.1 Pro spreekt drie protocollen: OpenAI Chat Completions, OpenAI Responses en Anthropic Messages. Dat is precies de reden waarom het zonder vertaalproxy in Claude Code en Codex kan worden ingezet — elk van die tools spreekt al een van de drie, en Moonshot levert dat protocol native. De installatie bestaat in het ene geval uit een handvol omgevingsvariabelen en in het andere uit een TOML-blok van vijf regels. Wat mensen een middag kost, is niet de configuratie; het is de manier waarop het misgaat. Claude Code gebruikt vier verschillende modelniveaus voor verschillende taken, en elk niveau dat niet is ingesteld, faalt stil in plaats van luid.

Deze gids is geschreven op basis van Moonshots eigen integratiedocumentatie, gecontroleerd op 24 oktober 2026, met de kanttekeningen die de documentatie verbergt. Waar een waarde afwijkt wanneer je dezelfde tools naar een routeringsgateway in plaats van rechtstreeks naar Moonshot laat wijzen, wordt dat expliciet vermeld.

Waarom er geen proxy nodig is

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.

Eén gevolg is het vermelden waard vóór de configuratie: het model redeneert altijd. Er is geen denk-schakelaar, en de diepte wordt ingesteld met een veld reasoning_effort op het hoogste niveau dat low, high en max accepteert, met max als standaard. De samplingparameters liggen vast — temperature 1.0, top-p 0.95, n op 1 — en andere waarden doorgeven levert een foutmelding op. Als je vorige setup was afgestemd op temperature, overleeft die afstelling de overstap niet.

Claude Code: het omgevingsblok

Claude Code leest zijn configuratie uit het env-blok van ~/.claude/settings.json. Variabelen die daar worden geschreven, overschrijven dezelfde namen die in je shell zijn geëxporteerd. Dat is zowel een feature als een valkuil: een verouderde export in je terminal redt je niet als het bestand iets anders zegt.

• 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 — je Kimi API-sleutel. Dit is de variabele die Claude Code daadwerkelijk gebruikt voor het bearer-token; een API-sleutel die in plaats daarvan in ANTHROPIC_API_KEY wordt geplaatst, is de meest voorkomende reden waarom een configuratie die er correct uitziet een 401 retourneert.

• ANTHROPIC_MODEL — het hoofdmodel voor gesprekken: kimi-k3.1-pro.

• ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL, ANTHROPIC_DEFAULT_HAIKU_MODEL, ANTHROPIC_DEFAULT_FABLE_MODEL — één per niveau. Stel er minimaal de eerste drie van in en laat HAIKU wijzen naar een goedkoop, snel model in plaats van naar het topmodel; het eigen voorbeeld van Moonshot koppelt dat niveau aan zijn codeermodel.

• CLAUDE_CODE_SUBAGENT_MODEL — wat sub-agents gebruiken. Indien niet ingesteld, verslechtert het werk van sub-agents of mislukt het.

• CLAUDE_CODE_AUTO_COMPACT_WINDOW — ingesteld op 1000000, afgestemd op het contextvenster. Te klein comprimeert vroeg en gooit context weg; te groot levert contextlengtefouten op.

• CLAUDE_CODE_EFFORT_LEVEL — De gids van Moonshot zet dit op max, wat ook de standaardwaarde van het model is. Als je dit verlaagt, gaat de kwaliteit bij complexe taken omlaag, en als je het midden in een sessie wijzigt, worden prefix-cachetreffers ongeldig.

De vier lagen die geruisloos falen

Dit is de fout waar je op moet anticiperen. Claude Code gebruikt verschillende modellen voor het hoofdgesprek, achtergrondsamenvatting, sub-agents en kleine hulpaanroepen. Configureer je alleen ANTHROPIC_MODEL, dan geven de andere paden geen foutmelding — ze doen stilletjes niets nuttigs, of vallen terug op manieren waardoor de tool kapot aanvoelt zonder de oorzaak te benoemen. Moonshots referentietabel is expliciet dat elke niet-ingestelde tier ertoe leidt dat de bijbehorende taak mislukt, en de symptomen lijken op een trage of verwarde agent in plaats van op een configuratiefout.

De praktische checklist is: stel alle vier tier-variabelen plus de sub-agent-variabele in één bewerking in, herstart Claude Code en bevestig daarna in een sessie dat er daadwerkelijk een sub-agent draait. Als het vastloopt, is de tier het eerste dat je moet controleren, niet het model.

Codex: één TOML-blok

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.

De sleutel zelf hoort in de omgeving, niet in het bestand. Codex leest hem uit de variabele waarvan de naam in env_key staat, dus houd config.toml vrij van geheimen en stel de variabele in je shellprofiel of systeemomgeving in.

Twee beperkingen die je moet kennen voordat je een bug meldt. Codex CLI accepteert geen video als invoer, ook al kan het model dat wel — dat is een beperking van Codex' invoerlaag, dus videowerk moet rechtstreeks via de API verlopen. En Codex' eigen contextbeheer geldt nog steeds: een venster van 1M tokens betekent niet dat elke sessie er een zou moeten gebruiken.

In plaats daarvan beide tools naar één gateway laten wijzen

Alles hierboven werkt ongewijzigd als je de basis-URL's van Moonshot vervangt door die van een gateway, wat handig is wanneer dezelfde codebase ook modellen van andere leveranciers aanroept. OrcaRouter biedt alle drie de interfaces voor Kimi K3.1 Pro — /v1/chat/completions, /v1/responses en /v1/messages — en publiceert het model onder de 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.

Wat je voor de substitutie krijgt, is één credential voor elk model in de catalogus en een routeringsbeleid dat een verzoek tussen leveranciers kan verplaatsen zonder applicatiecode te wijzigen — hetgeen een fallbackplan mogelijk maakt wanneer de endpoint van een nieuw model in de lanceringsweek tegen rate limits aanloopt. Wat je opgeeft, is de eigen console van de leverancier en elk leverancierspecifiek bèta-oppervlak. Prijzen worden doorgegeven tegen de lijstprijs van de provider: $2,00 per miljoen inputtokens en $10,00 per miljoen output voor Kimi K3.1 Pro, zonder opslag.

Een verificatie van vijf minuten

• Roep het endpoint rechtstreeks aan voordat je de client aanraakt: een POST naar de route Messages of Chat Completions met een verzoek van één token zou JSON moeten teruggeven, en een 401 betekent dat de sleutel onjuist is of bij het andere platform hoort.

• Stel in Claude Code een vraag die een subagent afdwingt — een zoekopdracht over meerdere bestanden — en kijk of die wordt voltooid. Dat is de snelste test van de tierconfiguratie.

• Start in Codex een sessie op een kleine repository en controleer of het model het venster van 1M rapporteert; als het een kleinere standaardwaarde rapporteert, model_context_window heeft dan geen effect gehad.

• Stel de inspanning bewust één keer in, aan het begin van de sessie: max voor lastig debuggen, hoog voor gewone wijzigingen, laag voor extractie en opmaak. De standaard is max, en op dit model is dat de dure keuze.