Kimi CLI 使用指南：一句话让 AI 在终端里替你读代码、改代码、修 bug-开发者社区

Kimi CLI 使用指南：一句话让 AI 在终端里替你读代码、改代码、修 bug

【免费下载链接】kimi-cliKimi Code CLI is your next CLI agent.项目地址: https://gitcode.com/GitHub_Trending/ki/kimi-cli

你有没有遇到过这样的场景：项目里有个报错，你一边翻文档一边敲命令，光定位问题就花了半小时；或者你想批量改一批文件，结果sed命令写了三行还没调通。Kimi CLI 就是为解决这类问题而生的——它是一个跑在终端里的 AI 命令行助手，你用中文或英文说清楚想干什么，它就自己去读代码、跑命令、改文件、验证结果。这篇教程带你从零安装，到把日常开发任务交给它处理。

Kimi CLI 是什么，适合哪些人

一句话定位：Kimi CLI 是一个常驻终端的 AI Agent，它不仅能对话，还能真正动手——阅读和编辑代码、执行 shell 命令、搜索和抓取网页，并在执行过程中自己规划、自己调整。

它适合这几类人：

日常写代码的开发者：加功能、修 bug、重构，让它承担「读代码 + 动手改」的活
刚接手陌生项目的人：让它先带你把目录结构和核心模块过一遍
常被重复劳动折磨的人：批量处理文件、跑构建和测试、写脚本，这些交给它
想给 IDE 接 AI 能力的用户：通过 ACP 协议把 Kimi CLI 挂进编辑器里用

准备与安装：从下载到能对话的完整步骤

整个过程不到五分钟，跟着下面四步走。

把仓库克隆到本地

git clone https://gitcode.com/GitHub_Trending/ki/kimi-cli cd kimi-cli

运行安装脚本
```
./scripts/install.sh
```
脚本会先帮你装好uv（Python 包管理工具），再用它安装 Kimi CLI，依赖问题不用你操心。
验证安装
```
kimi --version
```
能打印出版本号就说明装好了。macOS 用户注意：因为系统的安全检查，第一次运行kimi可能会慢一点，之后就会快起来。
在项目目录里完成初始化
进入你想让它干活的项目目录，启动它：
```
cd your-project kimi
```
首次启动时输入/login开始配置。系统会让你先选 API 平台，推荐选Kimi For Coding（会自动打开浏览器走 OAuth 授权）；选 Moonshot AI 开放平台等其他平台则手动填 API 密钥。配置会自动保存，无需额外操作。

上手第一个任务：用一句自然语言跑命令

登录完成后，别急着干大活，先做一个热身任务：

显示当前目录下的所有文件

你不用敲ls，Kimi CLI 会自己理解你的意思，调用相应的命令，然后把结果贴回给你。这就是它的核心交互方式——你说话，它执行。

再试一个更有代表性的：

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

它会列出目录树并简单解释各部分的作用。如果项目里还没有AGENTS.md文件，顺手输入/init，让它分析项目并生成一份描述文件，后面它对你项目的理解会更准。随时输入/help可以查看全部可用命令。

代码实战：读懂代码、加功能、修 bug

下面按真实开发中三个最高频的场景，给你可以直接照抄的指令模板。

第一步：读懂代码

接手新项目或排查问题前，先让它带你过一遍：

解释一下 src/soul 目录下的模块分别负责什么，重点说明 kimisoul.py 的执行流程

它会自己搜索、阅读相关文件，然后用人话给你讲清楚——相当于请了个随叫随到的讲解员。

第二步：加功能

描述清楚需求就行，不必告诉它改哪个文件：

给用户列表页面添加分页功能，每页显示 20 条记录

它的工作习惯大致是三段式的：先检索并通读相关代码弄清现状，再动手编写或修改（尽量贴合项目既有风格），最后跑测试或构建确认没把东西改坏。你全程可以在终端里看到它的每一步动作。

第三步：修 bug

把现象或错误日志直接甩给它：

运行 npm test 时报了 TypeError: Cannot read property 'map' of undefined 位置在 src/components/UserList.jsx:15，帮我查原因并修复

它会顺着报错去翻相关代码、定位根因，改完之后自己验证一遍再交付。

效率放大器：把重复劳动打包给它

单独一次任务可能只是省几分钟，但批量和重复任务才是 Kimi CLI 真正拉开差距的地方：

批量改写：「把 src 目录下所有 .js 文件里的 var 声明改成 const 或 let」
补文档：「给所有没有 docstring 的公开函数加上文档注释」
补测试：「为 API 模块生成单元测试」
升级依赖：「更新 package.json 中的依赖到最新版，然后跑测试确认没问题」
日志分析：「分析 logs 目录下的访问日志，统计每个接口的调用次数和平均响应时间」
技术调研：「对比 FastAPI、Starlette、Sanic 三个异步 Web 框架的优缺点，给个选型建议」

这类任务的特点是规则明确、步骤重复，人做起来枯燥且容易出错，交给 Kimi CLI 后你只需要检查结果。

进阶扩展：用 ACP 把它接进 IDE

如果你更习惯在编辑器里工作，Kimi CLI 原生支持 ACP（Agent Client Protocol），可以作为 Agent 服务被 IDE 调用，支持 Zed、JetBrains 系列等 ACP 客户端。

接入方式很简单，分两步：

先在终端里跑一次kimi并完成登录
在 IDE 的 ACP 配置中把启动命令设为kimi acp，然后在 IDE 的 Agent 面板里直接发起会话即可

具体的协议细节和客户端配置方法，建议直接看 ACP 文档和 IDE 集成指南。

小贴士：官方文章里没细说的几个点

Ctrl-X切换模式：在输入框里按Ctrl-X，Kimi CLI 会在「AI 对话模式」和「纯 shell 模式」之间切换。切到 shell 模式后你可以直接敲命令，不需要退出界面。
浏览器界面：嫌终端界面信息密度高？跑kimi web可以在本地浏览器打开图形界面，支持会话管理、文件引用和代码高亮，详见 kimi web 参考。
快捷键速查：常用按键都在键盘参考里，建议收藏。
斜杠命令全集：/help只能看一部分，完整的命令清单见斜杠命令参考。
版本升级：装好后想升级，跑uv tool upgrade kimi-cli --no-cache即可；不需要时uv tool uninstall kimi-cli卸载。