开始使用

Kimi CLI 是什么

Kimi CLI 是一个运行在终端中的 AI Agent，帮助你完成软件开发任务和终端操作。它可以阅读和编辑代码、执行 Shell 命令、搜索和抓取网页，并在执行过程中自主规划和调整行动。

Kimi CLI 适合以下场景：

• 编写和修改代码：实现新功能、修复 bug、重构代码
• 理解项目：探索陌生的代码库，解答架构和实现问题
• 自动化任务：批量处理文件、执行构建和测试、运行脚本

Kimi CLI 在终端中提供类似 Shell 的交互体验，你可以用自然语言描述需求，也可以随时切换到 Shell 模式直接执行命令。除了终端使用，Kimi CLI 还支持通过 Agent Client Protocol 集成到 IDE 和其他本地 Agent 客户端中。

注意

Kimi CLI 目前处于技术预览阶段，功能和 API 可能会发生变化。如果你遇到问题或有建议，欢迎在 GitHub Issues 反馈。

安装

运行安装脚本即可完成安装。脚本会先安装 uv（Python 包管理工具），再通过 uv 安装 Kimi CLI：

# Linux / macOS
curl -LsSf https://cdn.kimi.com/binaries/kimi-cli/install.sh | bash

# Windows (PowerShell)
Invoke-RestMethod https://cdn.kimi.com/binaries/kimi-cli/install.ps1 | Invoke-Expression

验证安装是否成功：

kimi --version

提示

由于 macOS 的安全检查机制，首次运行 kimi 命令可能需要较长时间。可以在「系统设置 → 隐私与安全性 → 开发者工具」中添加你的终端应用来加速后续启动。

如果你已经安装了 uv，也可以直接运行：

uv tool install --python 3.14 kimi-cli

升级与卸载

升级到最新版本：

uv tool upgrade kimi-cli --no-cache

卸载 Kimi CLI：

uv tool uninstall kimi-cli

第一次运行

在你想要工作的项目目录中运行 kimi 命令启动 Kimi CLI：

cd your-project
kimi

首次启动时，你需要配置 API 平台和模型。输入 /setup 命令进入配置向导：

1. 选择 API 平台（如 Kimi Code、Moonshot AI 开放平台）
2. 输入你的 API 密钥
3. 选择要使用的模型

配置完成后，Kimi CLI 会自动保存设置并重新加载。详见 平台与模型。

现在你可以直接用自然语言和 Kimi CLI 对话了。试着描述你想完成的任务，比如：

帮我看一下这个项目的目录结构

提示

如果项目中没有 AGENTS.md 文件，可以运行 /init 命令让 Kimi CLI 分析项目并生成该文件，帮助 AI 更好地理解项目结构和规范。

输入 /help 可以查看所有可用的 斜杠命令 和使用提示。