Kör Kimi K3.1 Pro i Claude Code och Codex: konfigurationen, de tysta felen och den enradiga växlingen

Kimi K3.1 Pro talar tre protokoll: OpenAI Chat Completions, OpenAI Responses och Anthropic Messages. Det är hela anledningen till att den kan användas i Claude Code och Codex utan en översättningsproxy – varje verktyg talar redan ett av de tre, och Moonshot tillhandahåller det protokollet inbyggt. Uppsättningen består av en handfull miljövariabler i det ena fallet och ett femradigt TOML-block i det andra. Det som kostar folk en eftermiddag är inte konfigurationen; det är felbeteendet. Claude Code använder fyra olika modellnivåer för olika uppgifter, och varje nivå som lämnas oinställd misslyckas tyst snarare än högljutt.

Den här guiden bygger på Moonshots egen integrationsdokumentation, granskad den 24 oktober 2026, med de förbehåll som dokumentationen gömmer undan. Där ett värde skiljer sig när du riktar samma verktyg mot en routing-gateway i stället för direkt mot Moonshot, påpekas detta.

Varför ingen proxy behövs

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.

En konsekvens är värd att nämna före konfigurationen: modellen resonerar alltid. Det finns ingen växlingsknapp för tänkande, och djupet ställs in med ett fält på toppnivå, reasoning_effort, som accepterar low, high och max, med max som standard. Samplingsparametrarna är fasta – temperature 1,0, top-p 0,95, n satt till 1 – och att skicka in andra värden returnerar ett fel. Om din tidigare konfiguration justerade temperature, överlever den justeringen inte bytet.

Claude Code: miljöblocket

Claude Code läser sin konfiguration från env-blocket i ~/.claude/settings.json. Variabler som skrivs där åsidosätter samma namn som exporterats i ditt skal, vilket är både en funktion och en fälla: en inaktuell export i din terminal räddar dig inte om filen säger något annat.

• 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 — din Kimi API-nyckel. Det här är variabeln som Claude Code faktiskt använder för bearer-token; en API-nyckel som placeras i ANTHROPIC_API_KEY i stället är den vanligaste orsaken till att en konfiguration som ser korrekt ut returnerar 401.

• ANTHROPIC_MODEL — den huvudsakliga konversationsmodellen: kimi-k3.1-pro.

• ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL, ANTHROPIC_DEFAULT_HAIKU_MODEL, ANTHROPIC_DEFAULT_FABLE_MODEL — en per nivå. Ange minst de tre första och låt HAIKU peka på en billig snabb modell i stället för på flaggskeppet; Moonshots eget exempel mappar den nivån till sin kodmodell.

• CLAUDE_CODE_SUBAGENT_MODEL — vad underagenter använder. Om den inte är satt försämras underagenternas arbete eller misslyckas.

• CLAUDE_CODE_AUTO_COMPACT_WINDOW — ställ in på 1000000, vilket matchar kontextfönstret. För litet komprimerar tidigt och kastar bort kontext; för stort ger fel om kontextlängden.

• CLAUDE_CODE_EFFORT_LEVEL — Moonshots guide ställer in detta på max, vilket också är modellens standard. Att sänka det försämrar kvaliteten på komplexa uppgifter, och att ändra det mitt i en session ogiltigförklarar träffar i prefixcachen.

De fyra nivåerna som misslyckas tyst

Det här är felet som är värt att planera för. Claude Code använder olika modeller för huvudkonversationen, bakgrundssammanfattning, subagenter och små verktygsanrop. Konfigurera bara ANTHROPIC_MODEL och de andra vägarna ger inget fel — de gör tyst ingenting användbart, eller faller tillbaka på sätt som får verktyget att verka trasigt utan att ange någon orsak. Moonshots referenstabell är tydlig med att varje nivå som inte är inställd gör att motsvarande uppgift misslyckas, och symptomen ser ut som en långsam eller förvirrad agent snarare än ett konfigurationsfel.

Den praktiska checklistan är att ställa in alla fyra nivåvariablerna plus subagentvariabeln i en enda redigering, starta om Claude Code och sedan i en session bekräfta att en subagent faktiskt körs. Om den fastnar är nivån det första man bör kontrollera, inte modellen.

Codex: ett TOML-block

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.

Själva nyckeln hör hemma i miljön, inte i filen. Codex läser den från variabeln som anges i env_key, så håll config.toml fri från hemligheter och ställ in variabeln i din shell-profil eller systemmiljö.

Två begränsningar att känna till innan du rapporterar en bugg. Codex CLI tar inte emot video som indata även om modellen gör det – det är en begränsning i Codex indatalager, så arbete med video måste gå direkt via API:et. Och Codex egen kontexthantering gäller fortfarande: ett 1M-tokenfönster innebär inte att varje session bör använda ett sådant.

Rikta båda verktygen mot en gemensam gateway i stället

Allt ovan fungerar oförändrat om du ersätter Moonshots bas-URL:er med en gateways, vilket är användbart när samma kodbas även anropar modeller från andra leverantörer. OrcaRouter exponerar alla tre ytorna för Kimi K3.1 Pro – /v1/chat/completions, /v1/responses och /v1/messages – och publicerar modellen under id:t 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.

Det du får för utbytet är en enda autentiseringsuppgift för varje modell i katalogen och en routningspolicy som kan flytta en förfrågan mellan leverantörer utan att ändra applikationskoden – det som gör en reservplan möjlig när en ny modells slutpunkt får hastighetsbegränsningar under lanseringsveckan. Det du avstår från är leverantörens egen konsol och alla leverantörsspecifika betaytor. Priserna förs vidare enligt leverantörens prislista: 2,00 USD per miljon indatatoken och 10,00 USD per miljon utdatatoken för Kimi K3.1 Pro, utan påslag.

En verifiering på fem minuter

• Anropa slutpunkten direkt innan du rör klienten: en POST till Messages- eller Chat Completions-rutten med en förfrågan på en token bör returnera JSON, och ett 401 innebär att nyckeln är fel eller tillhör den andra plattformen.

• I Claude Code, ställ en fråga som tvingar fram en underagent – en sökning över flera filer – och se om den slutförs. Det är det snabbaste testet av nivåkonfigurationen.

• I Codex, starta en session i ett litet repository och kontrollera att modellen rapporterar 1M-fönstret; om den rapporterar ett mindre standardvärde, har model_context_window inte tillämpats.

• Ställ in effort medvetet, en gång, i början av sessionen: max för svår felsökning, high för vanliga redigeringar, low för extrahering och formatering. Standardvärdet är max, och på den här modellen är det det dyra valet.