Kimi Code CLI 教程:月之暗面终端 AI 编程上手(2026)
随着 K2 系列模型在编程能力上打出口碑,月之暗面(Moonshot AI)也推出了自己的官方终端 AI 编程工具——Kimi Code CLI。它和 Claude Code、Qwen Code 属于同一类「住在终端里的编程 agent」:你用自然语言描述需求,它读你的代码库、跨文件改代码、执行 Shell 命令、搜索网页,全程自主规划。这篇 Kimi Code CLI 教程带你从安装、登录、日常使用,到把 Kimi 当后端接进 Claude Code 等第三方工具,一次跑通。
Kimi Code 是什么:一个服务、三种形态
官方对 Kimi Code 的定位是「Kimi 会员权益中专为开发者提供的智能编程服务」。它不只是一个 CLI,而是一整套编程服务,有三种用法:一是 Kimi Code CLI,跑在终端里的完整 AI Agent;二是 Kimi Code for VS Code 官方插件,在编辑器里用;三是 API 接入,把 Kimi 当模型后端喂给 Claude Code、Roo Code、OpenCode 等第三方工具。三种形态共享同一套会员额度。模型方面你不用自己追版本号——统一的模型 ID 叫 kimi-for-coding,官方会自动把它指向当前最新的旗舰编程模型(K2 系列),订阅期间免费升级。
一句话定位
Kimi Code CLI = 月之暗面官方出品、国内直连、会员制计费的终端 AI 编程 agent。K2 系列旗舰模型加持,还能当 API 后端反向接入 Claude Code 等工具。
安装:一行命令搞定
Kimi Code CLI 支持 macOS、Linux、Windows,官方提供一键安装脚本,任选其一:
# macOS / Linux
curl -LsSf https://code.kimi.com/install.sh | bash
# Windows(PowerShell)
Invoke-RestMethod https://code.kimi.com/install.ps1 | Invoke-Expression
# 验证安装
kimi --versionmacOS 首次启动慢是正常的
macOS 上第一次运行 kimi 可能因为系统安全检查多等一会儿,属正常现象。另外 Kimi Code CLI 的底层运行时经历过从 Python 到 Node.js 的升级,如果你在旧教程里看到 uv tool install kimi-cli 之类的装法,以上面官方脚本为准即可。
第一次上手:/login 登录与 /init 初始化
进入你的项目目录,输入 kimi 启动。首次使用按下面的顺序走:
- 1运行 /login 配置 API 来源:推荐选 Kimi Code 走 OAuth 浏览器授权登录 Kimi 账号,系统会自动同步可用的模型配置;也可以手动填其它平台的 API Key。
- 2运行 /init:让 Kimi 分析项目结构,生成 AGENTS.md 上下文文件(这套「项目说明书」约定是各家 AI 编程工具的通用标准,站内有专文讲怎么写好它)。
- 3然后直接用自然语言下需求,比如「把登录接口的报错信息改成中文并加上重试」,它会自己读代码、改文件、跑命令。
- 4随时输入 /help 查看全部斜杠命令。
除了标准的终端交互,它还有两个特色启动方式:kimi web 会启动一个浏览器界面,不习惯纯终端的人也能用;kimi acp 则把它作为 Agent 服务运行,供支持 ACP 协议的编辑器调用(下文细说)。
定价与额度:会员制怎么算
CLI 工具本身是开源免费的,花钱的是背后的模型服务。Kimi Code 走 Kimi 会员订阅(月付/年付),额度规则是「按周刷新 + 5 小时滚动窗口」:大约每 5 小时可发 300–1200 次请求(视会员档位而定),最多 30 个并发连接。注意额度是账号级共享的——你在 CLI、VS Code 插件和 API Key 上的用量算在同一个池子里。具体档位价格以 Kimi 官网会员页实时显示为准。
不止终端:VS Code、JetBrains、Zed 都能接
- VS Code:装官方插件 Kimi Code for VS Code,直接在编辑器里用。
- JetBrains 系列(IntelliJ IDEA、PyCharm、WebStorm 等)与 Zed:通过 CLI 的 ACP(Agent Communication Protocol)协议接入——本地跑 kimi acp,编辑器里配置对应的 Agent 即可。
- 第三方 agent:Claude Code、Roo Code、OpenCode 等都可以把 Kimi 配成模型后端,见下一节。
把 Kimi 接进 Claude Code 等第三方工具
Kimi Code 对外提供两套兼容 API 端点:OpenAI 兼容端点 https://api.kimi.com/coding/v1,以及 Anthropic 兼容端点 https://api.kimi.com/coding/。这意味着大多数 AI 编程工具都能把模型换成 Kimi。以 Claude Code 为例,走 Anthropic 兼容端点:
# 在 Kimi 开放平台生成 API Key 后(Mac/Linux):
export ANTHROPIC_BASE_URL="https://api.kimi.com/coding/"
export ANTHROPIC_AUTH_TOKEN="你的 Kimi API Key"
claude
# Windows PowerShell:
$env:ANTHROPIC_BASE_URL = "https://api.kimi.com/coding/"
$env:ANTHROPIC_AUTH_TOKEN = "你的 Kimi API Key"
claudeRoo Code、OpenCode 等支持 OpenAI 兼容接口的工具,则填 https://api.kimi.com/coding/v1 作为 baseURL、模型名填 kimi-for-coding。Claude Code 接各家国产模型的完整玩法(GLM、DeepSeek、Kimi 对比),站内有专门的实测教程。
和其它国产终端 CLI 怎么选
| 工具 | 出品方 | 费用 | 特点 |
|---|---|---|---|
| Kimi Code CLI | 月之暗面 | 会员订阅(CLI 开源) | K2 旗舰模型、ACP 接 IDE、可当 API 后端 |
| Qwen Code | 阿里 | 开源免费 + 免费额度 | 由 Gemini CLI 改造而来,用法成熟 |
| iFlow CLI | 心流 | 免费 | 聚合多家国产模型可切换 |
| CodeBuddy Code | 腾讯 | 有免费额度 | 腾讯自研模型 + 云生态整合 |
简单说:想要当前最强的国产编程模型体验、且愿意付订阅费,选 Kimi Code CLI;想零成本先跑起来,Qwen Code、iFlow CLI 这些免费选项更合适——这几款站内都有单独的上手教程,可以对照着选。
国产终端 AI 编程工具里,Kimi Code CLI 是把「模型强度」和「工程化形态」结合得比较完整的一个:官方 CLI + IDE 插件 + 开放 API 三线齐全。但工具永远只是起点,能不能把 AI 的产出稳定变成能上线的产品,考验的是拆需求、写上下文、审代码的功夫。想系统掌握用 AI 编程工具做出完整产品的方法,欢迎来 IMAI 看看我们的体系化实战课程。
想系统学会用 AI 编程,从入门到做出真实产品?
查看系统课程