🚀 kimi-cli：月之暗面开源AI Agent 9.2k Stars终端神器

kimi-cli 是月之暗面开源的终端 AI Agent,9.2k Stars。原生支持代码读写、Shell 执行、Web 搜索与 MCP 工具接入,内置 Plan/Yolo 模式与 Subagent 并行,VS Code/ACP 全兼容,国产 Claude Code 平替神器。

🎤 引言

国产大模型厂商这两年是真的卷疯了。DeepSeek 开了个开源的头,Kimi 直接把 Claude Code 的活给"借鉴"过来了 —— 终端里直接跑 AI Agent,不用 VS Code、不用 IDE 插件,一条命令搞定编码、写脚本、读代码、改 Bug。

kimi-cli 是月之暗面(Moonshot AI)今年 1 月底跟着 K2.5 一并放出的命令行 AI Agent 项目,GitHub 上已经攒到 9.2k stars / 1.1k forks(截至 2026-07-22),Apache 2.0 开源协议,Python + TypeScript 双栈实现。

跟 Claude Code 比起来,kimi-cli 有个最大的杀手锏:国内直连 + Kimi 模型本身就是顶配。不用折腾 API Key 转发,不用挂代理,SWE-Bench 跑分 76.8% 的 Kimi K2.5/K2.6/K2.7 系列模型随便用,价格还只要 Claude 的 1/10。

本文带你从安装到实战,把这玩意儿掰开揉碎讲清楚。

⭐ 核心功能

1. 终端原生 AI Agent

不是那种"在网页里聊代码"的玩具,而是直接在终端里跑。你可以:

读代码、编辑代码、改文件
执行 Shell 命令
搜索并抓取网页内容
自动规划步骤并根据执行反馈调整策略

最爽的是 反馈驱动 —— Agent 改完代码会自己跑测试,跑挂了再回去修,直到搞定。

2. Shell 命令模式(Ctrl-X)

按一下 Ctrl-X 就从 Agent 模式切到 Shell 模式,直接当 bash 用。相当于终端里塞了个"既能对话又能执行命令"的混合体,不用退出再开新窗口。

注意:目前内置 cd 命令还不支持(版本 1.48.0),用 Shell 模式绕过。

3. VS Code 扩展集成

官方有 Kimi Code VS Code Extension,装好之后能在 VS Code 里直接调 kimi-cli,IDE 不卡顿的同时享受终端 AI 能力。

4. ACP(Agent Client Protocol)支持

原生支持 ACP 协议,任何 ACP 兼容的编辑器/IDE 都能接入:

kimi acp

配合 Zed、Helix、Neovim 这些 ACP 客户端,直接当 Claude Code 替代品。

5. MCP 工具生态

支持完整的 Model Context Protocol:

# 添加 HTTP MCP server
kimi mcp add --transport http context7 --header "CONTEXT7_API_KEY: ctx7sk-your-key"

# 添加 stdio MCP server
kimi mcp add --transport stdio chrome-devtools -- npx chrome-devtools-mcp@latest

# 列出/删除/授权
kimi mcp list
kimi mcp remove chrome-devtools
kimi mcp auth linear

Chrome DevTools、Context7、Linear 这些工具都能直接装上,生态一下子就丰富起来。

6. Plan 模式 + Yolo 模式

Plan 模式(Shift-Tab 或 kimi --plan):Agent 先输出完整研究计划再动文件,适合大改
Yolo 模式(--yolo 或 /yolo):跳过所有确认,批量任务一把梭

7. Subagent 并行调度

主 Agent 可以分发独立子 Agent 做并行任务:

coder:写代码
explore:探索代码库
plan:制定计划
各个跑在隔离上下文里,大项目分析速度直接翻倍。

8. `/fork` + `/compact` 命令

/fork:开实验分支,改坏了直接丢弃
/compact:压缩上下文释放 token,长会话必备

📥 安装与使用

系统要求

macOS / Linux / Windows 全平台
无需 Node.js(单二进制分发)
推荐 Python 3.10+(源码安装时)

一键安装(macOS / Linux)

curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash

重启终端即可使用 kimi 命令。

Homebrew 安装(macOS / Linux)

brew install kimi-code

Windows 安装(PowerShell)

irm https://code.kimi.com/install.ps1 | iex

源码安装

git clone https://github.com/MoonshotAI/kimi-cli.git
cd kimi-cli
make build  # 构建 Python 包
make build-bin  # 构建单二进制

构建过程会自动调用 make build-web 嵌入 Web UI。

首次启动 + 登录

kimi
# 首次启动会提示 /login,按指引完成 OAuth 登录即可

登录后默认绑定 Kimi K2.6 / K2.7 模型,直接用。

实战示例

示例 1:批量重命名文件

kimi "把当前目录下所有 .txt 文件改名为 .md 扩展名"

Agent 会先列出文件 → 确认计划 → 执行 mv 命令 → 反馈结果。

示例 2:读代码 + 提 PR

kimi "分析 src/ 目录下的所有 Python 文件,找出性能瓶颈并优化"

示例 3:网页搜索 + 写文档

kimi "搜一下 FastAPI 最新版本,然后更新 README 里的安装命令"

示例 4:Shell 模式跑命令

按 Ctrl-X 切到 Shell 模式:

ls -la
git status
docker ps

示例 5:加载 MCP 配置

kimi --mcp-config-file /path/to/mcp.json

mcp.json 格式:

{
  "mcpServers": {
    "context7": {
      "url": "https://mcp.context7.com",
      "headers": {
        "CONTEXT7_API_KEY": "YOUR_KEY"
      }
    }
  }
}

🎯 适用场景

终端党开发者:喜欢 vim/tmux 不开 IDE,又想用 AI 改代码
国产项目团队:需要国内直连 + 不依赖外网 API
大代码库分析:Subagent 并行调度,千行级项目也能快速摸清
DevOps / SRE:写脚本、改配置、批量服务器操作,Shell 模式 + Agent 模式无缝切换
预算敏感用户:Kimi K2.6 模型 $0.60 / 百万 token,比 Claude Opus 4.7 便宜 10 倍
教育/学习:跟着 Agent 一步步看它怎么改代码,比纯文档直观

🔍 对比/替代方案

工具	厂商	Stars	模型	国内直连	开源
kimi-cli	月之暗面	9.2k	Kimi K2.6/K2.7	✅	Apache 2.0
Claude Code	Anthropic	闭源	Claude Opus 4.7	❌	闭源
Gemini CLI	Google	闭源	Gemini 2.5	❌	Apache 2.0
Codex CLI	OpenAI	闭源	GPT-5	❌	Apache 2.0

核心差异

国内直连:kimi-cli 唯一原生支持,其他三款都需要 API 中转或科学上网
价格优势:Kimi K2.6 API 定价 $0.60 输入 / $2.50 输出(每百万 token),Claude Opus 4.7 大概是 $5/$25,差 8-10 倍
Subagent 调度:kimi-cli 的 coder/explore/plan 三件套比较成熟,Claude Code 也有但配置复杂
MCP 生态:四家都支持,差异化不大
VS Code 集成:Claude Code / kimi-cli / Gemini CLI 都有官方扩展,Codex CLI 目前较弱

如果你的项目主要在国内团队跑 + 需要控制成本,kimi-cli 是目前最优解。要做最复杂的推理任务(比如跨文件大型重构)还是建议 Claude Opus。

⚠️ 注意事项

项目正在过渡到 Kimi Code CLI:官方在 README 顶部明确写了 —— kimi-cli 将逐步迁移到 Kimi Code CLI(下一代替代品)。安装 Kimi Code CLI 会自动迁移配置和会话记录,但文档和现有安装保持可用。
内置 cd 还不支持:1.48.0 版本仍然有这个坑,Agent 模式下改工作目录会失败。临时方案:用 Shell 模式(Ctrl-X)或显式指定文件绝对路径。
Python → Bun + TypeScript 重构中:2026 年 4-5 月起社区有重写技术栈的动向,目前仓库还是 Python 主导(78.4%)+ TypeScript 20.5%,但未来可能完全迁移。
API 调用需要 Kimi 账号或 OAuth 登录:CLI 本身免费,但模型调用要走 Moonshot AI Open Platform 或 Kimi Code 订阅。
配置文件位于 ~/.kimi/:包括认证信息、MCP 配置、Agent 历史等,迁移到新机器时记得备份。
Windows 兼容性:PowerShell 一键脚本没问题,但 WSL2 环境更稳定,推荐开发用 WSL。

✅ 总结

kimi-cli 是 2026 年国产终端 AI Agent 的代表作品 —— 开源、免费、国内直连、模型能打。9.2k Stars 的社区热度说明开发者已经在用脚投票。

优点:

真正的终端原生体验,不是网页套壳
Kimi K2.6/K2.7 模型加持,编码能力一流
Subagent + MCP + ACP 全栈集成,生态完整
国内直连 + 价格优势,Claude Code 10x 成本
Apache 2.0 开源,可商用

缺点:

项目正在过渡,长期维护需要关注 Kimi Code CLI
内置 cd 仍不支持(等官方修)
社区文档比 Claude Code 少,踩坑靠自己

推荐指数 ⭐⭐⭐⭐ (4/5)
适合人群:终端党、国内团队、预算敏感、需要 AI 写代码的开发者。
不建议场景:完全依赖 IDE 不愿碰终端、已经在用 Claude Code 没问题的不必迁移。

仓库地址:github.com/MoonshotAI/kimi-cli
官方文档:code.kimi.com
安装脚本:curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash

一句话总结:国产终端 AI Agent,该有的都有,该卷的都卷到位了。