Kimi CLI 上手指南今天就可以交给终端AI的4件事【免费下载链接】kimi-cliKimi Code CLI is your next CLI agent.项目地址: https://gitcode.com/GitHub_Trending/ki/kimi-cliKimi CLI 是运行在终端里的 AI Agent你用一句话描述任务它替你读代码、跑命令改文件前先跟你确认。本文先完整跑通一个真实任务再讲 3 个进阶用法和最容易踩的 3 个坑。当你不想再翻 200 行测试日志的时候你刚接手一个项目跑make test挂了 3 个用例。日志一大段堆栈在几个文件之间跳来跳去真正的原因可能藏在某一行深处。一行行读要花 20 分钟还不一定能找到。把报错粘到聊天窗口里问帮助也有限——它不能替你跑命令、翻文件每步都得你手动复制。用 IDE 里的编码助手也行但它被限制在那个编辑窗口里动不了系统层的操作。缺的是一个既会聊又能动手的同事坐在终端里。Kimi CLI 就是干这个的你描述任务它自己跑命令、读代码改动文件前会先征得你同意。⚡ 两条命令装好开始第一次对话Kimi CLI 基于 Python 3.12 构建安装一条命令的事。如果你已经装了 uvuv 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 acpAgent 就能出现在 IDE 的面板里不用来回切窗口 避坑与 FAQ3 个我实际踩过的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冒号后面要有空格写成KEYVALUE不会生效。写在最后一句话带走Kimi CLI 把跑命令、看结果、开文件的三步循环变成了一次对话而每个危险操作签字权仍在你手里。打开你的项目目录敲下kimi把那个你最不想碰的任务扔给它。【免费下载链接】kimi-cliKimi Code CLI is your next CLI agent.项目地址: https://gitcode.com/GitHub_Trending/ki/kimi-cli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考