MoonshotAI/kimi-cli —— Kimi Code CLI，你的下一代CLI智能代理

这是什么

MoonshotAI/kimi-cli 是一个运行在终端中的 AI 代理（AI Agent），主要面向软件开发和终端操作场景。它由月之暗面（Moonshot AI）开发，基于 Python 语言，当前在 GitHub 上获得了 9294 星。项目正在逐步演进为下一代的 Kimi Code CLI，两者共享相同的配置和会话数据，安装 Kimi Code CLI 会自动迁移现有设置。Kimi CLI 本身仍然可用，文档和现有安装不受影响。

Kimi CLI 不仅是一个单纯的编码助手，它还是一个“可切换的 Shell”：在 AI 代理模式下，它能自主规划、执行动作并调整计划；通过 Ctrl-X 快捷键，用户可以切换到 Shell 命令模式，直接执行原生终端命令，无需离开 Kimi CLI 界面。此外，它还支持 Visual Studio Code 扩展集成、Agent Client Protocol（ACP）以及 MCP（Model Context Protocol）工具扩展。

解决的问题

开发者日常工作中面临大量重复性、跨工具的操作切换：写代码、查文档、执行 shell 命令、调试、搜索网页等，这些任务往往分散在多个窗口和工具中。Kimi CLI 解决了以下核心痛点：

• 上下文割裂：传统模式下，开发者需要在 IDE、终端、浏览器之间频繁切换，导致思维流中断。Kimi CLI 将 AI 对话、代码编辑、命令执行、网页搜索整合在同一个终端界面中。
• 手动重复操作：许多开发任务（如修 bug、重构、部署）需要多次执行相似命令或修改代码。Kimi CLI 可以自主规划步骤，自动执行，并在过程中根据反馈调整策略。
• 多工具集成成本高：开发者需要配置各种插件和脚本才能让 AI 助手访问本地文件系统、执行命令或调用外部 API。Kimi CLI 通过内置的 MCP 支持和 ACP 协议，统一了工具接入方式，降低了集成门槛。
• 终端环境智能缺失：传统终端没有上下文感知能力，无法理解用户意图。Kimi CLI 在 Shell 模式下依然可以调用 AI 能力，让终端操作更智能。

核心功能

| 功能 | 描述 | |------|------| | 代码读写与编辑 | 能读取当前项目目录中的代码文件，进行增删改操作，并自动保存。 | | Shell 命令执行 | 可执行任意 shell 命令，包括文件操作、构建、测试、部署等，并返回输出结果。 | | 网页搜索与抓取 | 能搜索互联网并获取网页内容，用于查阅文档、查找解决方案或获取实时信息。 | | 自主规划与调整 | 在复杂任务中，AI 代理会自主规划步骤，执行过程中遇到错误时能自动调整策略重试。 | | Shell 命令模式切换 | 按 Ctrl-X 切换到原生 Shell 模式，直接运行 cd、ls、git 等命令（内置的 cd 暂不支持，但可通过原生 Shell 执行）。 | | VS Code 扩展集成 | 通过 Kimi Code VS Code 扩展，可在 IDE 内直接使用 Kimi CLI 的能力。 | | ACP 协议支持 | 支持 Agent Client Protocol，可与 Zed、JetBrains 等 ACP 兼容编辑器配合，在 IDE 的 Agent 面板中创建 Kimi CLI 线程。 | | MCP 工具扩展 | 支持 Model Context Protocol，可添加外部 MCP 服务器（如 Context7、Linear、Chrome DevTools 等），扩展 AI 代理的能力边界。 | | Zsh 插件集成 | 提供 zsh-kimi-cli 插件，让 Zsh 用户能通过 Ctrl-X 快速切换 AI 代理模式。 |

亮点 / 与同类相比

相比其他终端 AI 代理（如 Warp AI、GitHub Copilot CLI、Open Interpreter 等），Kimi CLI 有几个突出差异：

• 双模式设计：既是一个能自主执行任务的 AI 代理，又是一个可随时切换的原生 Shell 环境。用户无需退出即可在 AI 对话和传统终端操作之间自由切换，减少了工具切换成本。
• ACP 协议原生支持：Kimi CLI 是少数直接实现 Agent Client Protocol 的终端 AI 工具之一。这意味着它可以无缝接入任何支持 ACP 的编辑器或 IDE（如 Zed、JetBrains），而不需要绑定特定平台。
• MCP 工具生态：通过 Model Context Protocol 扩展，Kimi CLI 可以调用外部服务（如 API 查询、浏览器 DevTools 等），而不仅仅是本地文件系统或 shell。这使其比单纯依赖内置工具的函数调用更开放、更灵活。
• 自主决策与纠错：相比于一些仅按指令执行的工具，Kimi CLI 的 AI 代理能自主规划多个步骤，并在执行过程中根据环境反馈（如命令报错、文件内容变化）动态调整后续行为，更像一个“有头脑的开发者助手”。
• 从项目到生态的演进：项目正在向 Kimi Code CLI 迁移，说明团队正在将其打造成更通用的 AI 终端代理，而非仅针对 Moonshot 自家模型。用户可继续使用，未来升级路径清晰。

适合谁用 / 上手

适合人群：

• 日常使用终端进行开发的软件工程师（前端、后端、全栈、DevOps 等）。
• 希望减少在 IDE、终端、浏览器之间切换频率的开发者。
• 需要 AI 帮助自动化重复性任务（如代码审查、批量重构、环境配置）的团队。
• 对 Agent Client Protocol 或 MCP 工具生态感兴趣，想尝试下一代 AI 集成方式的开发者。
• Zsh 用户，希望让终端变得更智能、更高效。

上手步骤：

1. 安装：按照 Getting Started 文档指引，使用 pip 或 uv 安装 Kimi CLI。
2. 登录：在终端运行 kimi，首次使用会引导完成登录（需月之暗面账号或 API Key）。
3. 基本使用：输入自然语言指令，例如“列出当前目录下所有 Python 文件”或“修改 src/main.py 中的日志级别为 debug”。AI 代理会自动执行并反馈结果。
4. 切换 Shell 模式：按 Ctrl-X 切换到原生 Shell 模式，运行 ls -la 等命令；再按 Ctrl-X 回到 AI 对话模式。
5. 集成到 IDE：若使用 VS Code，安装 Kimi Code 扩展；若使用 Zed 或 JetBrains，在配置文件中添加 ACP 服务器配置（见项目 README 示例），然后即可在 IDE 的 Agent 面板中创建线程。
6. 添加 MCP 工具：使用 kimi mcp add 命令添加外部 MCP 服务器，例如 kimi mcp add --transport http context7 https://mcp.context7.com/mcp --header "CONTEXT7_API_KEY: ctx7sk-your-key"，扩展 AI 能力。
7. Zsh 集成