ContextQMD
Back to Claude Code Router

Kimi CLI setup and configuration

docs/src/content/docs/en/configuration/agents/kimi.md

3.0.223.0 KB
Original Source

Who this is for

Kimi CLI is Moonshot's coding agent. In CCR it is CLI only and always uses Only opened from CCR.

Use this page to route Kimi CLI to any CCR provider or Fusion model, expose several switchable models, or run separate Kimi CLI sessions.

New to CCR? Add a provider and model first. See Add a provider and the Agent Config overview.

Prerequisites

  1. CCR Desktop is running with at least one provider + model configured.
  2. Kimi CLI is installed (available as kimi on PATH).
  3. You are on Agent Config and click Add profile.

Create the profile

  1. On Agent Config, click Add profile and choose Kimi CLI.
  2. Enter a Config name (for example Kimi - Work).
  3. Choose a Kimi model (the default) and one or more Available models.
  4. Leave advanced environment settings empty unless you have a specific local setup need.
  5. Save, then copy and run the command from the profile card.

Configuration reference

Kimi CLI is fixed to Only opened from CCR and CLI only, so those two fields are not editable. The fields you configure are:

FieldHow to set itEffect
AgentChoose Kimi CLICreates a Kimi CLI launch entry in CCR.
Config nameFree text, e.g. Kimi - WorkIdentifies the profile. Desktop commands use ccr-app "<name>"; CLI commands use ccr "<name>".
EnabledToggle on/offDisabled profiles are not applied and not offered as launch entries.
Kimi modelA provider model or Fusion modelThe default model. At least one model is required.
Available modelsOne or more provider/Fusion modelsModels available from Kimi's /model menu. The default model is always included.
Environment variablesKey/value rowsOptional advanced overrides; leave empty for normal use.

Open and use

Desktop command copied from the profile card:

text
ccr-app "Kimi - Work"

For CLI, run:

text
ccr "Kimi - Work"

Inside Kimi CLI, use /model to switch among the default and available models. Every selection stays routed through CCR's providers, routing, and Fusion.

Multi-instance

Create separate Kimi CLI profiles when you want different default models or model sets.

Verify

  1. Run the desktop ccr-app command copied from the profile card, or the CLI ccr command.
  2. Send one message in Kimi CLI and confirm it replies.
  3. Open Request logs in CCR and confirm the request passed through the gateway.
  4. Run /model and confirm the default plus available models appear.

Common issues

  • /model is empty or missing models: add at least one Available model (the default counts); confirm a provider + model is configured in CCR.
  • Profile cannot be saved: Kimi CLI requires both a default model and at least one available model.
  • kimi not found: make sure Kimi CLI is installed and available from the same shell environment used to start CCR Desktop.