📌 项目地址：MoonshotAI/kimi-cli | ⭐ 9,377 颗星 | 🔧 Python | 📜 未标注
项目现状：一个正在被迭代的老版
Kimi CLI 是 Moonshot AI（月之暗面）推出的终端 AI 代理，核心能力是在命令行中帮你读代码、写代码、执行 Shell 命令、搜索网页，并根据任务自主规划下一步行动。但根据官方 README（2025 年 7 月），这个项目正在逐步被 Kimi Code CLI 取代——后者是同一团队开发的下一代终端 AI 代理，安装后会自动迁移配置和历史会话。如果你现在刚接触，建议直接转向 Kimi Code CLI，现有用户仍可继续使用原版，官方文档仍有效。
不过，研究 Kimi CLI 仍然有意义，它能让你理解当前国产终端 AI 代理的设计思路，且部分集成方案（如 ACP 协议、VS Code 扩展）在新版中也会继承。
核心价值：融合 Shell 与 AI Agent
终端是开发者最常面对的战场，Kimi CLI 试图把“对话式 AI 助手”和“Shell 命令执行”合并到一个会话中，避免你在不同窗口之间反复切换。它主要解决以下痛点：
- 交互割裂：以往需要先在 ChatGPT 中描述问题、复制命令，再回到终端运行；Kimi CLI 让你在终端里直接问，它自己执行并反馈。
- 操作原子化：你可以说“给所有
.py文件添加 shebang”，它自动查找、修改、然后运行测试，整个过程不需要手动敲一个命令。 - 跨工具协作：通过 ACP 协议与 Zed、JetBrains 等 IDE 集成，Kimi CLI 可以作为 IDE 内的 AI 代理后端。
实际用法（基于 README 原文）
安装与启动
官方 README 没有列出具体安装命令，只提到「Getting Started」页面。你可以去那个页面获取 pip install kimi-cli 或 Homebrew 等安装方式。启动时直接在终端输入 kimi。
Shell 命令模式
这是 Kimi CLI 的一个独特设计：在不离开代理会话的情况下直接运行 Shell 命令。
– 普通对话时，Kimi CLI 会把你的自然语言转为代码或命令执行。
– 按 Ctrl-X 可进入 Shell 命令模式，像使用普通终端一样直接输入 ls, git status 等。不过内置的 cd 命令暂不支持（README 明确说明）。
与 IDE 集成（ACP 协议）
Kimi CLI 原生支持 Agent Client Protocol（ACP），这意味着它可以作为独立 agent server，与支持 ACP 的编辑器（如 Zed、JetBrains）配合使用。
配置步骤（来自 README）：
1. 在终端中运行 kimi，然后在 Kimi CLI 的交互界面里输入 /login 完成登录。
2. 在 Zed 或 JetBrains 的配置文件中（如 ~/.config/zed/settings.json）添加如下 JSON：
{
"agent_servers": {
"Kimi CLI": {
"type": "custom",
"command": "kimi",
"args": ["acp"],
"env": {}
}
}
}
- 之后你可以在 IDE 的 agent 面板中创建 Kimi CLI 线程，直接在编辑器里发指令给 Kimi CLI。
VS Code 扩展
Kimi CLI 官方提供了 VS Code 扩展（搜索 moonshot-ai.kimi-code），安装后可以在 VS Code 中直接使用 Kimi CLI 的功能，聊天窗口、自动补全等。
Zsh 插件
如果你使用 Zsh（特别是 Oh My Zsh），可以安装 zsh-kimi-cli 插件，在终端里用快捷键快速唤起 Kimi CLI。
安装方法：
git clone https://github.com/MoonshotAI/zsh-kimi-cli.git
${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/kimi-cli
然后在 .zshrc 中将 kimi-cli 添加到 plugins 列表中。
同类工具对比：为什么值得关注
市面上已有不少 Terminal AI Agent，比如 GitHub Copilot CLI、Cursor（集成 IDE）、Claude CLI（Anthropic）。Kimi CLI 的差异化在于：
- 国产原生中文支持：对话、文档、指令都优先面向中文用户，英文环境也兼容，但不会出现中英文混杂的问题。
- Shell 模式设计：其他工具大多只能把命令交出去执行，而 Kimi CLI 允许你通过 Ctrl+X 临时进入原生 Shell，解决了 AI 操作时的“白手套”问题（你仍可以手动补刀）。
- ACP 协议：它不强制绑定某个编辑器，而是用标准协议让任何 IDE 接入，未来生态扩展性更强。
当然，它的缺点是正在被新版取代，功能迭代可能停滞，且 README 未明确许可证（使用时需留意安全风险，因为 AI 代理默认拥有文件读写和执行权限）。
注意事项
- 迁移警告：如果你现在安装 kimi-cli 并开始使用，未来需要手动或自动迁移到 kimi-code。建议直接试用新版（GitHub 搜索
MoonshotAI/kimi-code）。 - 安全边界：Kimi CLI 可以执行任意 Shell 命令、读写文件、调用网络。默认情况下它会在执行前向你确认（README 未明确提及，但同类产品通常有确认机制），但建议在敏感环境中限制其访问范围，或通过配置禁用自动执行。
- 依赖登录：使用 ACP 集成和部分高级功能需要先
/login（使用 Kimi 账号），这意味着你的对话数据会经过月之暗面服务器，考虑隐私要求的项目需谨慎。 - 当前局限性：内置 Shell 命令模式下不会支持
cd（影响文件路径切换），复杂的多步骤任务可能超出上下文窗口（128K 上下文是 Kimi 的强项，但 CLI 默认可能有限制）。
如果你正在寻找一个“终端里的全栈 AI 助手”，并且不介意使用国产服务，Kimi CLI（或它的继任者 Kimi Code CLI）值得一试。但更推荐直接前往 github.com/MoonshotAI/kimi-code 了解最新版本。