kimi-code/README.zh-CN.md

Kimi Code CLI

Documentation · Issues · English

什么是 Kimi Code CLI

Kimi Code CLI 是一个运行在终端里的 AI 编程 agent，可以帮你读写代码、执行 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

随后在新的终端会话中运行：

kimi --version

npm 安装、升级、卸载方式，见快速上手。

快速开始

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

cd your-project
kimi

首次启动时，在 Kimi Code CLI 里输入 /login，选择 Kimi Code OAuth 或 Moonshot AI Open Platform API 密钥登录。登录完成后，可以先让它熟悉项目：

帮我看一下这个项目的目录结构，简单介绍一下每个目录是做什么的

核心特性

• 二进制发行，零环境依赖 一行命令安装，不需要预装 Node.js，不用折腾 PATH，也不会和全局模块冲突。
• 极速启动 TUI 在毫秒级就绪，开一个新会话没有任何心智负担。
• 精致的 TUI 体验 为长时间、专注的 Agent 会话精心打磨的交互界面。
• 视频也能输入 屏幕录像、演示视频也能拖进对话。
• AI-native 的 MCP 配置 通过 /mcp-config 对话式添加、编辑、认证 MCP 服务器，无需手写 JSON。
• 子 Agent 聚焦并行工作 内置 coder、explore、plan 子 Agent 在隔离上下文中处理子任务，主对话保持清爽。
• 生命周期 hooks 在关键节点执行本地命令：拦截高风险工具调用、审计决策、发送桌面通知，或对接你自己的自动化脚本。

文档

• 快速上手
• 交互与审批
• 会话
• 配置
• 命令参考

本地开发

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

社区

• Issues
• 安全漏洞反馈，请见 SECURITY.md。

致谢

我们的 TUI 构建在 pi-tui 之上。我们衷心感谢 pi-tui 作者的工作。

许可证

基于 MIT 协议发布。