Edgee CLI setup (recommended)
The fastest way to connect Kimi Code to Edgee is the CLI. It authenticates, points Kimi Code at the gateway for the duration of the session, and starts it, no config file to edit by hand.1
Install the Edgee CLI
- macOS / Linux
- Homebrew (macOS)
- Windows (PowerShell)
2
Launch Kimi Code through Edgee
Choose how you want to launch. Both options route requests through Edgee.If you are not signed in, Edgee starts sign-in automatically at launch. Follow the prompts and select your organization when asked.The CLI authenticates, configures routing, and starts Kimi Code, all in one command. Token compression is enabled automatically.
- With aliases (recommended)
- Without aliases
With aliases installed in the previous step, use your usual command:The alias runs
edgee launch for you, so requests go through Edgee.Kimi Code must already be installed. See the Kimi Code documentation for install instructions, or run
curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash.What the session runs on
Kimi Code launched through Edgee runs on Edgee credentials and the Edgee model catalog, not on a Moonshot subscription. The CLI provisions a Kimi Code key against your Edgee organization on first launch; a Moonshot plan is not required and is not used. The provider Edgee configures lives in memory for the length of the session. Nothing is written to~/.kimi-code/config.toml, and running kimi on its own afterwards is unaffected.
Model selection
The session is pinned tomoonshotai/kimi-k2.7-code. That is a starting point, not a restriction: Edgee’s routing engine decides which provider and model actually serve each request, so routing strategies and retry and fallback apply as they do for any other agent.
To pin a different catalog model instead, set EDGEE_KIMI_MODEL before launching:
Compression settings
Compression, fallback, and rerouting for the Kimi Code key are managed like any other agent:Manual setup (advanced)
Get your coding-agent key
Manual setup uses the key of your enrolled Kimi Code agent, not a standard API key created for LLM Router applications.- Open the Edgee Console and select your organization.
- In the header, click Set up coding agent or +, select Kimi Code, and click Enroll. If your agent is already enrolled, use its existing icon.
- Click the agent’s icon, then Advanced settings → Advanced.
- Under Edgee API key (for manual setup), click Reveal key, then the copy icon.
<YOUR_CODING_AGENT_KEY>.
Configure Kimi Code
Prefer to configure Kimi Code yourself? Kimi Code does not read provider credentials from the usual environment variables —api_key and base_url come from config.toml. The one channel that does read the shell is the KIMI_MODEL_* family, which synthesizes a provider and a model alias in memory:
Replace
<YOUR_CODING_AGENT_KEY> with the coding-agent key copied above.KIMI_MODEL_NAMEis both the model id and the switch. Unset, none of the other variables are read. Set with a required one missing, Kimi Code fails at startup rather than quietly calling Moonshot.KIMI_MODEL_BASE_URLcarries no/v1suffix. WithKIMI_MODEL_PROVIDER_TYPE=anthropic, the SDK appends/v1/messagesitself, the same wayANTHROPIC_BASE_URLworks for Claude Code.KIMI_CODE_CUSTOM_HEADERStakes oneName: Valueper line and is what groups requests into a session in the Console. Withoutx-edgee-session-id, requests are still routed and metered, but they do not group into one session.
edgee launch kimi sets all of these for you, including a fresh session id and your repository origin, and adds nothing to your shell configuration.
Next Steps
- Learn more about the Edgee CLI and its launch commands
- Set up observability to monitor usage and costs
- Explore retry and fallback for resilient routing