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脚本会先帮你装好uvPython 包管理工具再用它安装 Kimi CLI依赖问题不用你操心。验证安装kimi --version能打印出版本号就说明装好了。macOS 用户注意因为系统的安全检查第一次运行kimi可能会慢一点之后就会快起来。在项目目录里完成初始化进入你想让它干活的项目目录启动它cd your-project kimi首次启动时输入/login开始配置。系统会让你先选 API 平台推荐选Kimi For Coding会自动打开浏览器走 OAuth 授权选 Moonshot AI 开放平台等其他平台则手动填 API 密钥。配置会自动保存无需额外操作。上手第一个任务用一句自然语言跑命令登录完成后别急着干大活先做一个热身任务显示当前目录下的所有文件你不用敲lsKimi 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 原生支持 ACPAgent Client Protocol可以作为 Agent 服务被 IDE 调用支持 Zed、JetBrains 系列等 ACP 客户端。接入方式很简单分两步先在终端里跑一次kimi并完成登录在 IDE 的 ACP 配置中把启动命令设为kimi acp然后在 IDE 的 Agent 面板里直接发起会话即可具体的协议细节和客户端配置方法建议直接看 ACP 文档 和 IDE 集成指南。小贴士官方文章里没细说的几个点Ctrl-X切换模式在输入框里按Ctrl-XKimi CLI 会在「AI 对话模式」和「纯 shell 模式」之间切换。切到 shell 模式后你可以直接敲命令不需要退出界面。浏览器界面嫌终端界面信息密度高跑kimi web可以在本地浏览器打开图形界面支持会话管理、文件引用和代码高亮详见 kimi web 参考。快捷键速查常用按键都在 键盘参考 里建议收藏。斜杠命令全集/help只能看一部分完整的命令清单见 斜杠命令参考。版本升级装好后想升级跑uv tool upgrade kimi-cli --no-cache即可不需要时uv tool uninstall kimi-cli卸载。现在就开始到这里你已经会安装、登录并让 Kimi CLI 完成从列文件、读代码到修 bug 的完整闭环。建议今天就找一个手头的小项目把「加功能 修 bug」各试一次——亲手跑一遍比看十篇教程都管用。更多配置项、MCP 工具接入、技能Skills定制等玩法都可以从 官方文档 慢慢逛起。【免费下载链接】kimi-cliKimi Code CLI is your next CLI agent.项目地址: https://gitcode.com/GitHub_Trending/ki/kimi-cli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考