kimi-cli

普通人只想到如何度过时间，有才能的人设法利用时间。——叔本华

Kimi Code CLI：把“终端”变成你的 AI 开发拍档

很多人已经习惯用 ChatGPT、Claude 或各种 IDE 插件做一点辅助，但一旦切回终端，世界又回到敲命令、写脚本、grep 的纯手工时代。MoonshotAI 的 Kimi Code CLI 把这块补齐了：一个运行在终端里的“AI 代理”，不仅会读代码、改代码、执行命令、搜索和抓取信息，还能与 VS Code、JetBrains、Zed 等编辑器集成，通过 ACP（Agent Client Protocol）成为你的 IDE 内置助手；也能与 MCP 生态打通，把浏览器、数据源、工具能力作为“上下文协议”统一纳入。

• 仓库与主页
  • GitHub：MoonshotAI/kimi-cli
  • 文档：英文 · 中文
  • Kimi Code 页面：kimi.com/code
• 项目简介
  • Kimi Code CLI is your next CLI agent.
  • 许可：Apache-2.0
  • 语言：Python

如果你想要“命令行里的 IDE 助理”，或者“IDE 里更懂终端的代理”，它就是那种将两端连成一个整体的工具。

---

它到底能做什么

• Shell 命令模式
  在 Kimi Code CLI 里按 Ctrl-X 可切换“shell 命令模式”，无需离开代理界面就能运行系统命令。注意：当前不支持内建 shell 命令如 cd。

• VS Code 扩展
  配合官方 VS Code 扩展，直接把 Kimi Code CLI 接进 VS Code 的侧边栏与对话面板。

• ACP 集成（编辑器/IDE）
  原生支持 Agent Client Protocol，Zed、JetBrains 等 ACP 客户端可以把 Kimi 当作一个“代理服务”来启动和使用。

• Zsh 插件
  与 Zsh 整合增强你的 shell 体验，用 Ctrl-X 一键切到 agent 模式，获得“带智能的终端”。

• MCP 支持
  通过 MCP 统一管理外部工具与上下文，既可使用 kimi mcp 子命令管理，也可给 kimi 传 MCP 配置文件临时连接。

• 其他
  作为终端 AI 代理，它还能读编辑你的代码，执行脚本流程，串联搜索与抓取，帮助你完成开发与运维任务。

---

和 IDE/编辑器怎么连起来

ACP 是如今多个编辑器采用的“AI 代理客户端协议”。Kimi Code CLI 内置了 ACP 服务，用起来像是“在 IDE 里启动一个后端代理”。

{
  "agent_servers": {
    "Kimi Code CLI": {
      "command": "kimi",
      "args": ["acp"],
      "env": {}
    }
  }
}

在 Zed 或 JetBrains 的配置文件里添加上面的条目，再在终端里运行 Kimi Code CLI 并先 /login 完成登录，就可以在 IDE 的 Agent 面板里创建 Kimi Code CLI 的线程，与项目代码上下文一起协作。

---

命令行增强：直接把它融入 Zsh

通过 Oh My Zsh 或任何你喜欢的插件管理器，安装 zsh-kimi-cli 插件：

git clone https://github.com/MoonshotAI/zsh-kimi-cli.git \
  ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/kimi-cli

然后在 ~/.zshrc 里加入插件名，重启 Zsh：

plugins=(... kimi-cli)

启动后按 Ctrl-X 进 agent 模式，你的 shell 就同时拥有命令行与 AI 对话的双重能力。

---

MCP 支持：把外部能力“接到”代理里

Kimi Code CLI 既支持通过子命令管理 MCP 服务器，也支持临时配置文件方式一次性加载。

• 子命令方式（添加/列出/移除/授权）：

# Add streamable HTTP server:
kimi mcp add --transport http context7 https://mcp.context7.com/mcp --header "CONTEXT7_API_KEY: ctx7sk-your-key"

# Add streamable HTTP server with OAuth authorization:
kimi mcp add --transport http --auth oauth linear https://mcp.linear.app/mcp

# Add stdio server:
kimi mcp add --transport stdio chrome-devtools -- npx chrome-devtools-mcp@latest

# List added MCP servers:
kimi mcp list

# Remove an MCP server:
kimi mcp remove chrome-devtools

# Authorize an MCP server:
kimi mcp auth linear

• 临时配置文件方式：

{
  "mcpServers": {
    "context7": {
      "url": "https://mcp.context7.com/mcp",
      "headers": {
        "CONTEXT7_API_KEY": "YOUR_API_KEY"
      }
    },
    "chrome-devtools": {
      "command": "npx",
      "args": ["-y", "chrome-devtools-mcp@latest"]
    }
  }
}

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

这样就把 MCP 生态里的能力统一接入 Kimi Code CLI，在同一个对话与任务上下文里调用。

---

安装与启动：从“第一次使用”到“开发者模式”

• 新用户请查看文档的 Getting Started。Kimi Code CLI 支持多平台登录与使用方式。
• 如果你要参与开发，这些命令是你最常用的：

git clone https://github.com/MoonshotAI/kimi-cli.git
cd kimi-cli

make prepare  # prepare the development environment

uv run kimi  # run Kimi Code CLI

make format  # format code
make check   # run linting and type checking
make test    # run tests

make build-web  # build the web UI and sync it into the package (requires Node.js/npm)
make build      # build python packages
make build-bin  # build standalone binary
make help       # show all make targets

项目的 Web UI 会在构建阶段自动嵌入包内，发布独立二进制也很顺畅。

---

扩展与定制：写你自己的 Soul（代理循环）

Kimi Code CLI 的“心脏”是 Soul（agent loop）。你可以写一个最简的 Echo Soul，直接替换 Shell UI 的内核逻辑，让它按你的规则运作：

cd examples/custom-echo-soul
uv sync --reinstall
uv run main.py

也可以在内置 KimiSoul 的基础上扩展，定制它的行为，然后接入 Shell UI：

cd examples/custom-kimi-soul
uv sync --reinstall
uv run main.py

这套机制非常适合：“把代理的循环逻辑变成你团队的工作流约束”，例如：严格的 commit 流程、代码修复策略、命令执行白名单。

---

一个“在终端开发的一天”：工作流示例

• 早上打开终端，按 Ctrl-X 进入 Kimi 的 shell 模式，让它先读当前仓库、帮你总结未完成的任务。
• 它列出需要改动的文件、生成修改建议；你让它执行脚本，跑测试；过程中它可以帮你抓取文档、补全命令、生成 patch。
• 中途切到 VS Code 或 Zed，它通过 ACP 持续作为你的 IDE 代理存在，引用同一个会话上下文。
• 需要浏览器或外部能力的时候，MCP 即连即用。
• 当你想把某个流程固化为“团队的代理工作流”，就向下扩展 Soul 或写脚本，把它做成“可复用的任务模板”。

这种“在终端做事、在 IDE 写代码、在 MCP 扩展工具”的一致体验，才是它的核心价值。

---

贴士与注意

• Shell 模式不支持内置命令如 cd，此类场景建议直接在外层 shell 切换目录再进入。
• 作为 ACP 服务使用时，先 /login 完成登录，再在 IDE 里创建代理线程。
• MCP 服务器部分支持 OAuth，需要在 kimi mcp add 时指定 --auth oauth 并完成授权。
• VS Code 扩展请在市场搜索 Kimi Code Extension，按说明安装。
• 如果你是重度 Zsh 用户，zsh-kimi-cli 插件让“在终端里与代理共生”成为一种更舒服的日常。

---

总结

Kimi Code CLI 做的不是“再来一个聊天窗口”，而是把“终端、IDE、工具生态”拼成一个统一的智能工作台：你在终端里有一个会执行命令、会改代码、会查文档的拍档；在 IDE 里有一个懂上下文、懂项目结构的助手；在 MCP 里有一套即插即用的“工具协议”来扩展它的能力。
如果你希望把“编写与执行”合在一套可控的流程里，尤其习惯在命令行进行真实开发和运维，Kimi Code CLI 值得你认真试一试。

• 文档入口：moonshotai.github.io/kimi-cli
• 快速开始：Getting Started
• VS Code 扩展与 ACP 集成：Extension · Agent Client Protocol
• MCP 管理与配置：kimi mcp … · --mcp-config-file …
• 示例与开发者指南：仓库 examples/ 与 make 任务一应俱全

把你的终端交给一个真正懂你的 AI 伙伴，今天就把它连起来。