Kimi (Moonshot)

Kimi is Moonshot AI’s model family, served over an Anthropic-compatible endpoint — shunt forwards Claude Code’s Messages request as-is and injects the Moonshot API key. The kimi preset is built in, so configuration is one upstream entry plus routes.

Quick start

Let a coding agent wire it up for you — shunt add prints an embedded setup blueprint (offline and read-only; the agent edits the config, the command never does):

shunt add upstream kimi --print | claude

Or follow the manual steps below.

Configure the upstream

The kimi preset supplies kind = "anthropic", base_url = "https://api.moonshot.ai/anthropic", and API-key auth from MOONSHOT_API_KEY:

[[upstreams]]
name = "anthropic"
provider = "anthropic"   # keep Anthropic as the default for unrouted models (e.g. claude-*)

[[upstreams]]
name = "kimi"
provider = "kimi"

[[routes]]
model = "kimi-k3"
provider = "kimi"

[[routes]]
model = "kimi-k2.7-code"
provider = "kimi"

Ordered [[upstreams]] replace shunt’s built-in providers, so the config that routes to kimi must also declare the anthropic default it still points at (server.default_provider defaults to anthropic); drop the anthropic entry only if you also set default_provider to a declared upstream.

The legacy [providers.kimi] table form remains supported (older examples used api_key_env = "KIMI_API_KEY", which still works when set explicitly) — but do not mix [[upstreams]] and [providers.*] in one file.

Credentials

export MOONSHOT_API_KEY='...'

Never write the key into the config. shunt check validates the config’s structure but does not read the key’s value — if MOONSHOT_API_KEY is unset, the first request routed to kimi returns an authentication error.

Models

Select a routed id in Claude Code via ANTHROPIC_MODEL, ANTHROPIC_CUSTOM_MODEL_OPTION, or a subagent’s model: frontmatter. To surface an entry in the /model picker instead, advertise a claude-prefixed alias with a [models.upstream_model] map — see Model Discovery.

Verify

shunt check    # -> config ok
shunt run
curl -sS http://127.0.0.1:3001/v1/messages \
  -H 'anthropic-version: 2023-06-01' \
  -H 'content-type: application/json' \
  -d '{"model":"kimi-k2.7-code","max_tokens":16,"messages":[{"role":"user","content":"Reply with OK."}]}'

Confirm the response’s x-gateway-upstream header names kimi, then point Claude Code at shunt.

Subagent plugin

The shunt-kimi plugin ships one ready-made Claude Code subagent per model above:

/plugin marketplace add pleaseai/shunt
/plugin install shunt-kimi@shunt