Kimi 代码助手

Kimi Code CLI 简介

Kimi Code CLI 是一款运行在终端中的 AI 编码代理，能够读取和编辑代码、执行 Shell 命令、搜索文件、抓取网页，并根据反馈自主决定下一步操作。它开箱即用支持 Moonshot AI 的 Kimi 模型，也可配置接入其他兼容的模型服务。

安装

通过官方脚本一键安装，无需 Node.js 环境。

macOS 或 Linux：

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

Windows（PowerShell）：

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

Windows 首次启动前需安装 Git for Windows，CLI 会使用内置的 Git Bash 作为 Shell 环境。若 Git Bash 安装在非默认路径，可通过环境变量 KIMI_SHELL_PATH 指定 bash.exe 的绝对路径。

安装完成后打开新的终端会话验证：

kimi --version

npm 安装、升级、卸载方式参见入门文档。

快速开始

进入项目目录启动交互界面：

cd your-project
kimi

首次启动后在 CLI 内执行 /login，选择 Kimi Code OAuth 或 Moonshot AI 开放平台的 API Key 完成登录，然后即可输入首个任务，例如：

Take a look at this project and explain its main directories.

核心特性

• 单二进制分发：一条命令完成安装，免去 Node.js 配置、PATH 调整和全局模块冲突。
• 极速启动：TUI 毫秒级就绪，启动会话几乎无感。
• 专为长任务调优的 TUI：界面经过精心打磨，适合长时间专注的代理会话。
• 视频输入：将录屏或演示视频拖入聊天，代理可“观看”难以用文字描述的内容，例如将参考片段转成 LUT、长视频剪成短片、录屏转为可运行代码。
• AI 原生的 MCP 配置：通过 /mcp-config 以对话方式添加、编辑并完成 Model Context Protocol 服务器的鉴权，无需手写 JSON。
• 丰富的插件生态：从市场或任意 GitHub 仓库安装技能、MCP 服务器与数据源，安装前会清晰展示信任级别。
• 子代理机制：在隔离上下文中调度内置的 coder、explore、plan 子代理并行处理任务，保持主对话整洁。
• 生命周期钩子：在关键节点执行本地命令，可用于拦截高风险工具调用、审计决策、触发桌面通知或对接自定义自动化。
• 编辑器与 IDE 集成（ACP）：通过 kimi acp 子命令，由 Zed、JetBrains 等支持 Agent Client Protocol 的客户端直接驱动 CLI 会话。

在编辑器中使用（ACP）

Kimi Code CLI 实现 Agent Client Protocol，支持该协议的编辑器与 IDE（如 Zed、JetBrains）可通过 stdio 驱动会话。一次登录后，将编辑器指向 kimi acp 子命令即可复用凭证。

Zed 用户可在 ~/.config/zed/settings.json 中添加：

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

随后在 Zed 的 Agent 面板新建会话即可。JetBrains 的配置与排错方法参见 IDE 集成指南。

开发

环境要求：Node.js ≥ 24.15.0、pnpm 10.33.0。

git clone https://github.com/MoonshotAI/kimi-code.git
cd kimi-code
pnpm install

常用脚本：

pnpm dev:cli    # 开发模式运行 CLI
pnpm test       # 运行测试
pnpm typecheck  # TypeScript 类型检查
pnpm lint       # oxlint 代码检查
pnpm build      # 构建所有包

完整贡献流程参见 CONTRIBUTING.md。

许可证

本项目基于 MIT 许可证发布。