MoonshotAI/kimi-code 来源：https://github.com/MoonshotAI/kimi-code

Kimi Code CLI

许可协议 · 文档 (https://moonshotai.github.io/kimi-code/en/) · 文档 (https://moonshotai.github.io/kimi-code/en/) · 问题反馈 (https://github.com/MoonshotAI/kimi-code/issues) · 中文

使用 Kimi Code 的演示

什么是 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
  

• Homebrew（macOS/Linux）：

  brew install kimi-code
  

• Windows（PowerShell）：

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

在 Windows 上，首次启动前请安装 Git for Windows (https://gitforwindows.org/)，因为 Kimi Code CLI 使用随附的 Git Bash 作为其 shell 环境。如果 Git Bash 安装在自定义位置，请将 KIMI_SHELL_PATH 设置为 bash.exe 的绝对路径。

然后，在新的 shell 会话中运行：

kimi --version

关于 npm 安装、升级、卸载，请参阅入门指南 (https://moonshotai.github.io/kimi-code/en/guides/getting-started)。

快速开始

打开一个项目并启动交互式界面：

cd your-project
kimi

首次启动时，在 Kimi Code CLI 内运行 /login，选择 Kimi Code OAuth 或 Moonshot AI 开放平台的 API 密钥。登录后，尝试你的第一个任务：

查看这个项目并解释其主要目录。

主要特性

• 单一二进制分发。 一条命令安装：无需设置 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 (https://agentclientprotocol.com/) 的客户端直接驱动 Kimi Code CLI 会话。

在编辑器中使用（ACP）

Kimi Code CLI 支持 Agent Client Protocol (https://agentclientprotocol.com/)，因此兼容 ACP 的编辑器和 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 中使用 (https://moonshotai.github.io/kimi-code/en/guides/ides)，完整功能矩阵请参阅 kimi acp 参考 (https://moonshotai.github.io/kimi-code/en/reference/kimi-acp)。

文档

• 入门指南 (https://moonshotai.github.io/kimi-code/en/guides/getting-started)
• 交互与审批 (https://moonshotai.github.io/kimi-code/en/guides/interaction)
• 会话 (https://moonshotai.github.io/kimi-code/en/guides/sessions)
• 在 IDE 中使用（ACP）(https://moonshotai.github.io/kimi-code/en/guides/ides)
• 配置 (https://moonshotai.github.io/kimi-code/en/configuration/config-files)
• 命令参考 (https://moonshotai.github.io/kimi-code/en/reference/kimi-command)

开发

要求：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。

社区

• 问题反馈 (https://github.com/MoonshotAI/kimi-code/issues)
• 安全漏洞请参阅 SECURITY.md。

致谢

我们的 TUI 构建在 pi-tui (https://github.com/earendil-works/pi-mono/tree/main/packages/tui) 之上。感谢 pi-tui 作者们的宝贵工作。

许可协议

本作品采用 MIT 许可证 发布。