Kimi CLI Setup Guide: China’s Answer to Claude Code

Claude Code proved that the best place for an AI coding agent is your terminal, not a chat window. Now Moonshot AI has shipped its own: Kimi CLI, a terminal agent that runs Kimi K3 — the model that topped Code Arena’s frontend-coding board. This guide covers what it is, how to install it, the honest cost, and when to reach for it.

What Kimi CLI is

Kimi CLI (github.com/MoonshotAI/kimi-cli, ~9,800 stars) is an AI agent that runs in your terminal — it reads your project, writes files, runs commands, and builds features from a single prompt, exactly like Claude Code. Its default model is Kimi K3.

One honesty note up front: the original kimi-cli repo is evolving into Kimi Code CLI (MoonshotAI/kimi-code) and the old one is being wound down. When you install today, you get the Kimi Code lineage — the banner shows Model: K3.

Why people care about K3 specifically:

• It ranked #1 on Code Arena’s frontend board (score 1679, ahead of Claude Fable 5 at 1631) at the time of testing.
• It is genuinely strong at building complete, polished single-file web pages from one prompt.

What it costs (read this before “free”)

This is where you need the truth: Kimi CLI running K3 is not free. K3 is available on Moonshot’s Moderato plan or above — the CLI banner says so on launch. And the K3 API is priced at roughly $3 per million input tokens / $15 per million output — among the most expensive models from a Chinese lab.

So how do you try K3 for free?

• Free way: chat with Kimi at kimi.com — the web chat lets you use the model at no cost. Great for testing its coding ability before you pay.
• Paid way: the CLI (K3 in your terminal, building real files) needs a Moderato plan.

Don’t let anyone tell you “the CLI is free” — the chat is free; the terminal agent is a paid plan.

Step 1 — Install

# via the official installer (see the repo for your platform)
# after install, the command is:
kimi

On launch you’ll see the welcome banner with Model: K3. To run it without stopping for confirmations on every step:

kimi --yolo

Step 2 — Build something real

Point it at an empty folder and give it one clear prompt. For example:

Create index.html — a complete single-file landing page for a campus
events app. Dark theme, gradient hero, 3 feature cards, an upcoming-events
section, smooth scroll animations. Pure HTML/CSS/JS in one file.

K3 will write the whole page in a single file. Open it in your browser and you have a working, polished landing page from one prompt — this is exactly where K3 shines.

Kimi CLI vs Claude Code — when to use which

• Use Kimi CLI (K3) for frontend and single-file UI work — it is genuinely top-tier at building complete, good-looking pages fast.
• Use Claude Code for large multi-file codebases, refactoring, and agentic workflows where you want the broader tool ecosystem (skills, hooks, MCP).
• Try K3 free first at kimi.com before committing to a plan. Judge the model on your own tasks, then decide if the terminal agent is worth the subscription.

The takeaway

Kimi CLI is a real, serious competitor to Claude Code, powered by a model that is genuinely #1 at frontend code. Just go in with clear eyes on the cost: test K3 free in the web chat, and only pay for the CLI once you know it earns its place in your workflow.