Kimi CLI 上手指南：今天就可以交给终端AI的4件事
【免费下载链接】kimi-cliKimi Code CLI is your next CLI agent.项目地址: https://gitcode.com/GitHub_Trending/ki/kimi-cli
Kimi CLI 是运行在终端里的 AI Agent：你用一句话描述任务，它替你读代码、跑命令，改文件前先跟你确认。本文先完整跑通一个真实任务，再讲 3 个进阶用法和最容易踩的 3 个坑。
当你不想再翻 200 行测试日志的时候
你刚接手一个项目，跑make test，挂了 3 个用例。
日志一大段，堆栈在几个文件之间跳来跳去，真正的原因可能藏在某一行深处。
一行行读要花 20 分钟，还不一定能找到。
把报错粘到聊天窗口里问，帮助也有限——它不能替你跑命令、翻文件，每步都得你手动复制。
用 IDE 里的编码助手也行，但它被限制在那个编辑窗口里，动不了系统层的操作。
缺的是一个"既会聊又能动手"的同事，坐在终端里。
Kimi CLI 就是干这个的：你描述任务，它自己跑命令、读代码，改动文件前会先征得你同意。
⚡ 两条命令装好，开始第一次对话
Kimi CLI 基于 Python 3.12+ 构建，安装一条命令的事。如果你已经装了 uv：
uv tool install --python 3.13 kimi-cli然后在你的项目目录里运行kimi启动。
首次启动输入/login选择平台：选 Kimi Code 会自动打开浏览器授权；选其他平台则输入 API 密钥并挑一个模型。配置会自动保存到~/.kimi/config.toml。
全部设置完大约两分钟。如果项目里还没有AGENTS.md，可以顺手运行/init，让它扫描一遍项目结构生成"项目说明书"，之后的对话里它会更快理解你的代码库。
跑通一个完整任务：定位测试失败
看一次真实的交互。
你输入的是：
跑一下 make test，定位这 3 个失败用例的原因。先给我修复方案，不要改代码。系统做了什么：它用 Shell 工具执行make test，读取失败输出，再用文件工具逐个查看失败的测试文件和被测代码，顺着调用链找到真正的失败点。
你拿到的是什么：一份原因清单（指向具体文件和行号），外加 2-3 个带取舍说明的修复选项。之后它要动手改代码时，会弹出审批面板，展示文件 diff 预览；按Ctrl-E可以展开完整 diff，再决定允许、本会话允许，还是拒绝。
和旧工作流对比一下：
| 旧方式 | 用 Kimi CLI |
|---|---|
| 手动跑测试、逐行读日志 | Agent 跑命令，结果直接喂回模型 |
| 复制报错、搜索、手动开文件核对 | 读文件、追调用链在一次循环里完成 |
省下的不只是分钟数，还有在终端和浏览器之间反复横跳。
原理通俗化：像一位新入职的工程师坐在你旁边
核心循环和新员工的工作方式一模一样：先读项目的"入职手册"（AGENTS.md 和系统提示词），再动手在终端里试，遇到危险操作先找你签字。
模型不是全知全能的，靠的是这个循环在转。
"选择工具"这一步对应一套标准工具集，文件操作、shell、网页抓取都集中在 src/kimi_cli/tools/，调度逻辑则在 src/kimi_cli/soul/。每一步都会被记录到~/.kimi/sessions/下的会话文件里，这也是之后能恢复、回放、回退对话的原因。
🧩 进阶玩法 3 个：Plan 模式、运行中转向、IDE 接入
1. Plan 模式：先出方案再动手
按Shift-Tab，或用kimi --plan启动。这个模式下 AI 是只读的，只能 Glob、Grep 和读文件，它先把实施方案写进 plan 文件再提交给你审批。你可以批准、拒绝，或者提修改意见让它改。改核心链路前开一次，等于先看方向再让它动手。
2. 运行中转向：不等回合结束
AI 跑起来后你发现方向不对，不用干等。按Enter把消息排队（当前轮结束后自动发出），按Ctrl-S则立即注入，模型马上能看到。想问一个不打断主线的小问题，用/btw侧问。
3. Shell 模式与 IDE 接入
按Ctrl-X进入 Shell 模式，不离开会话直接跑普通终端命令：
通过 ACP 协议，在 Zed 或 JetBrains 的设置里把命令指向kimi acp，Agent 就能出现在 IDE 的面板里，不用来回切窗口：
🕳 避坑与 FAQ：3 个我实际踩过的
1. Shell 模式里cd不生效
Shell 模式下每条命令都在独立子进程里执行，目录切换只在那次进程内有效，命令结束就没了。解法：用绝对路径，或者启动时用--work-dir指定工作目录。
2./login时模型列表是空的
最常见两个原因：密钥过期或打错，以及KIMI_API_KEY环境变量覆盖了配置文件。先echo $KIMI_API_KEY查一下，必要时重新签发密钥再走/login。
3. MCP 服务器加上了，工具却没加载
stdio 类型的服务器多半是命令（比如npx）不在 PATH 里。用kimi mcp list看配置，用kimi mcp test <name>验证连通性。
⚠️ 另外注意：添加 HTTP 服务器时 header 格式是KEY: VALUE，冒号后面要有空格，写成KEY=VALUE不会生效。
写在最后
一句话带走：Kimi CLI 把"跑命令、看结果、开文件"的三步循环变成了一次对话，而每个危险操作签字权仍在你手里。
打开你的项目目录，敲下kimi，把那个你最不想碰的任务扔给它。
【免费下载链接】kimi-cliKimi Code CLI is your next CLI agent.项目地址: https://gitcode.com/GitHub_Trending/ki/kimi-cli
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
