Kimi Code CLI 文档

简体中文

English

简体中文

English

Appearance

交互与输入 ​

Kimi Code CLI 提供了丰富的交互功能，帮助你高效地与 AI 协作。

Agent 与 Shell 模式 ​

Kimi Code CLI 有两种输入模式：

  • Agent 模式：默认模式，输入的内容会发送给 AI 处理
  • Shell 模式：直接执行 Shell 命令，无需离开 Kimi Code CLI

按 Ctrl-X 可以在两种模式之间切换。当前模式会显示在底部状态栏中。

在 Shell 模式下，你可以像在普通终端中一样执行命令：

sh
$ ls -la
$ git status
$ npm run build

Shell 模式也支持部分斜杠命令，包括 /help、/exit、/version、/editor、/changelog、/feedback、/export、/import 和 /task。

注意

Shell 模式中每个命令独立执行，cd、export 等改变环境的命令不会影响后续命令。

Plan 模式 ​

Plan 模式是一种只读的规划模式，让 AI 在动手编码之前先制定实施方案，避免在错误方向上浪费精力。

在 Plan 模式下，AI 只能使用只读工具（Glob、Grep、ReadFile）探索代码库，不能修改任何文件或执行命令。AI 会将方案写入一个专门的 plan 文件，然后提交给你审批。你可以选择批准、拒绝或提供修改意见。

进入 Plan 模式 ​

有四种方式进入 Plan 模式：

  • 启动参数：使用 kimi --plan 直接以 Plan 模式启动新会话
  • 快捷键：按 Shift-Tab 切换 Plan 模式的开关
  • 斜杠命令：输入 /plan 或 /plan on
  • AI 主动触发：面对复杂任务时，AI 可能会通过 EnterPlanMode 工具请求进入 Plan 模式，你可以选择同意或拒绝

你也可以在配置文件中设置 default_plan_mode = true，让每次新建会话都默认进入 Plan 模式。详见 配置文件。

在 YOLO 模式下，AI 主动请求进入 Plan 模式会自动通过，但通过 ExitPlanMode 退出 Plan 模式时仍会请求你审批方案。在 AFK 模式下，因为用户不在场，进入和退出 Plan 模式都会自动批准。

进入 Plan 模式后，提示符会变为 📋，底部状态栏会显示蓝色的 plan 标识。

审批方案 ​

AI 完成方案后会通过 ExitPlanMode 提交审批。审批面板会显示完整的方案内容，你可以：

  • 批准执行：如果方案包含多个可选实施路径，AI 会列出 2–3 个带标签的选项（如 "方案 A"、"方案 B (Recommended)"）供你选择，选中后 AI 退出 Plan 模式并按该路径执行；如果方案只有一条路径，则显示 Approve 按钮
  • Reject：拒绝方案，保持 Plan 模式，你可以在对话中提供反馈
  • Reject and Exit：拒绝方案并退出 Plan 模式，一步完成拒绝和退出操作
  • Revise：输入修改意见，AI 会据此修订方案并重新提交

按 Ctrl-E 可以在全屏分页器中查看完整方案内容。

管理 Plan 模式 ​

使用 /plan 命令可以管理 Plan 模式：

  • /plan：切换 Plan 模式开关
  • /plan on：开启 Plan 模式
  • /plan off：关闭 Plan 模式
  • /plan view：查看当前方案内容
  • /plan clear：清除当前方案文件

Thinking 模式 ​

Thinking 模式让 AI 在回答前进行更深入的思考，适合处理复杂问题。

你可以通过 /model 命令切换模型和 Thinking 模式。在选择模型后，如果模型支持 Thinking 模式，系统会询问是否开启。也可以在启动时通过 --thinking 参数启用：

sh
kimi --thinking

提示

Thinking 模式需要当前模型支持。部分模型（如 kimi-k2-thinking-turbo）始终使用 Thinking 模式，无法关闭。

运行中发送消息 ​

当 AI 正在执行任务时，你可以通过两种方式发送后续消息，无需等待当前轮次结束：

  • 排队（Enter）：按 Enter 将消息放入队列，等当前轮次完成后再自动发送。排队消息数量会显示在输入区标题中（如 ── input · 2 queued ──），在空输入框中按 ↑ 可召回最后一条排队消息进行编辑
  • 立即注入（Ctrl+S）：按 Ctrl+S 将消息立即注入到正在运行的轮次上下文中，模型会立即看到你的消息

在 AI 运行期间，审批请求和问答面板也支持内联键盘交互。

提示

如果需要立即中断 AI 的执行，请使用 Ctrl-C。

侧问 ​

在 AI 工作期间，你可以使用 /btw 命令提出快速侧问，不会打断主对话流程。

/btw 这个函数的返回类型是什么？

侧问在隔离的上下文中运行：能看到对话历史但不会修改它，也不会调用工具。响应会显示在一个可滚动的模态面板中，使用 ↑/↓ 滚动，Escape 关闭。

详见 斜杠命令参考。

后台任务 ​

当 AI 需要执行耗时较长的命令（如构建项目、运行测试套件、启动开发服务器）时，可以将命令作为后台任务启动。后台任务在独立进程中运行，AI 可以继续处理其他请求，无需等待命令完成。

后台任务的工作流程：

  1. AI 使用 Shell 工具的 run_in_background=true 参数启动命令
  2. 工具立即返回任务 ID，AI 继续处理其他工作
  3. 任务完成后，如果 AI 处于空闲状态（等待用户输入），系统会自动触发新的 Agent 轮次来处理结果，无需你手动输入

你可以使用 /task 斜杠命令打开交互式任务浏览器，实时查看所有后台任务的状态和输出（包括正在运行中的任务）。详见 斜杠命令参考。

提示

默认最多同时运行 4 个后台任务，可在配置文件的 [background] 节中调整。CLI 退出时默认会终止所有后台任务。详见 配置文件。

多行输入 ​

有时你需要输入多行内容，比如贴入一段代码或错误日志。按 Ctrl-J 或 Alt-Enter 可以插入换行，而不是直接发送消息。

输入完成后，按 Enter 发送整条消息。

剪贴板与媒体粘贴 ​

按 Ctrl-V 可以粘贴剪贴板中的文本、图片或视频文件。

在 Agent 模式下，较长的粘贴文本（超过 1000 字符或 15 行）会自动折叠为 [Pasted text #n] 占位符显示在输入框中，保持界面整洁。完整内容仍会在发送时展开并传递给模型。使用外部编辑器（Ctrl-O）时，占位符会自动展开为原始文本，保存后未修改的部分重新折叠。

如果剪贴板中是图片，Kimi Code CLI 会将图片缓存到磁盘并在输入框中显示为 [image:…] 占位符。发送消息后，AI 可以看到并分析这张图片。如果剪贴板中是视频文件，其文件路径会以文本形式插入输入框。

提示

图片输入需要当前模型支持 image_in 能力，视频输入需要支持 video_in 能力。

斜杠命令 ​

斜杠命令是以 / 开头的特殊指令，用于执行 Kimi Code CLI 的内置功能，如 /help、/login、/sessions 等。输入 / 后会自动显示可用命令列表。完整的斜杠命令列表请参考 斜杠命令参考。

@ 路径补全 ​

在消息中输入 @ 后，Kimi Code CLI 会自动补全工作目录中的文件和目录路径。这让你可以方便地引用项目中的文件：

帮我看一下 @src/components/Button.tsx 这个文件有没有问题

输入 @ 后开始输入文件名，会显示匹配的补全项。按 Tab 或 Enter 选择补全项。在 Git 仓库中，文件发现优先使用 git ls-files 查询，可以在包含数万文件的大型仓库中快速定位文件；非 Git 项目则回退到目录扫描。

结构化问答 ​

在执行过程中，AI 可能需要你做出选择来决定下一步方向。此时 AI 会使用 AskUserQuestion 工具向你展示结构化的问题和选项。

问题面板会显示问题描述和可选项，你可以通过键盘选择：

  • 使用方向键（上 / 下）浏览选项
  • 按 Enter 确认选择
  • 按 Space 切换多选模式下的选中状态
  • 选择 "Other" 选项可以输入自定义文本
  • 按 Esc 跳过问题

每个问题支持 2–4 个预定义选项，AI 会根据当前任务上下文设置合适的选项和说明。如果有多个问题需要回答，面板会以标签页形式展示，使用左右方向键或 Tab 键在问题间切换，已回答的问题会标记为已完成状态，切换回已回答的问题时会恢复之前的选择。

提示

AI 只会在你的选择真正影响后续操作时才使用此工具。对于能从上下文推断的决策，AI 会自行判断并继续执行。

审批与确认 ​

当 AI 需要执行可能有影响的操作（如修改文件、运行命令）时，Kimi Code CLI 会请求你的确认。

确认提示会显示操作的详情，包括 Shell 命令和文件 Diff 预览。如果内容较长被截断，可以按 Ctrl-E 展开查看完整内容。你可以选择：

  • 允许：执行这次操作
  • 本会话允许：在当前会话中自动批准同类操作（此决策会随会话持久化，恢复会话时自动还原）
  • 拒绝：不执行此操作
  • 附带反馈拒绝：拒绝操作并输入文字反馈，告诉 Agent 应该如何调整

如果你信任 AI 的操作，或者你正在安全的隔离环境中运行 Kimi Code CLI，可以启用「YOLO 模式」来自动批准所有工具调用：

sh
# 启动时启用
kimi --yolo

# 或在运行中切换
/yolo

你也可以在配置文件中设置 default_yolo = true，每次启动时默认开启 YOLO 模式。详见 配置文件。

开启 YOLO 模式后，底部状态栏会显示黄色的 YOLO 标识。再次输入 /yolo 可关闭。

YOLO 只解除“审批确认”的摩擦——Agent 仍然把你当作在场的用户，在关键决策点仍可能通过 AskUserQuestion 向你提问。如果你实际上要离开终端，请改用下面的 AFK 模式。

注意

YOLO 模式会跳过所有审批确认，请确保你了解可能的风险。建议仅在可控环境中使用。

AFK 模式 ​

当你要暂时离开终端、又希望 Agent 在你不在时也能继续运行，可以启用「AFK 模式」（away-from-keyboard）：

sh
# 启动时启用
kimi --afk

# 或在运行中切换
/afk

AFK 模式也会自动批准所有工具调用，并且会自动 dismiss 模型发出的任何 AskUserQuestion——让 Agent 自己做决策，而不是傻等一个永远不会到来的回答。--print 模式出于同样的原因会隐式启用 --afk。

开启 AFK 后，状态栏会显示独立的橙色 AFK 标识，与 YOLO 标识各不相干。再次输入 /afk 可关闭。

注意

AFK 会跳过所有审批确认，并且去掉了通过提问澄清的安全网。仅在你确实无法守在终端前、且信任当前任务范围时使用。