阅读时长：8 分钟2026-06-22
Kimi Code CLI 是月之暗面的开源终端 AI 编程 agent——它能读取和编辑代码、运行 shell 命令，并根据你的反馈规划下一步。本快速参考汇总了开发者最常用的 Kimi Code 命令、斜杠命令、键盘快捷键、内置工具和日常工作流。把它放在终端旁随时查看；也可在 Kimi Code 内使用 /help，或在 shell 中运行 kimi --help，查看当前版本提供的功能。
安装 Kimi Code CLI
对大多数开发者来说，官方安装脚本是最快的方式：它会安装单个 Kimi Code 二进制文件，且不需要 Node.js。如果更符合你的本地工具链，也可以使用 Homebrew、npm 或 pnpm。
| 平台 / 管理器 | 命令 |
|---|---|
| macOS / Linux 脚本 | curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash |
| Homebrew | brew install kimi-code |
| Windows PowerShell | irm https://code.kimi.com/kimi-code/install.ps1 | iex |
| npm | npm install -g @moonshot-ai/kimi-code |
| pnpm | pnpm add -g @moonshot-ai/kimi-code |
在 Windows 上首次启动前，请先安装 Git for Windows，因为 Kimi Code CLI 会使用其中捆绑的 Git Bash 作为 shell 环境。安装后，打开一个新的终端并验证二进制文件：
kimi --version
从这里开始
首次进入项目时，按这个最小流程走：
cd your-project
kimi
# 会话内
/login # 首次启动时登录
/init # 生成或刷新 AGENTS.md
/plan on # 在范围大、风险高或不明确的工作前先规划
/help # 查看命令和快捷键
/compact # 对话变长时释放上下文
仅在你信任的工作区中使用 --yolo、/yolo 和 /auto。它们能减少审批阻力，但也会让 Kimi Code 拥有更高的自主性。
最常用命令
如果只记少数几个，请记住这些——它们覆盖了大多数日常会话。
| 命令 | 作用 |
|---|---|
kimi | 在当前目录启动交互式会话 |
kimi -C | 在此继续最近一次会话 |
kimi -p "..." | 运行单条提示词，不打开 TUI |
/login | 首次启动时登录 |
/init | 生成或刷新 AGENTS.md |
/plan on | 针对范围大或风险高的修改进入 Plan Mode |
/model | 切换本次会话使用的模型 |
/compact | 对话变长时释放上下文 |
/sessions | 浏览并恢复历史会话 |
/help | 列出所有命令和快捷键 |
Shift-Tab | 切换 Plan Mode |
启动与自动化
核心 CLI 选项
| 命令 / 标志 | 作用 |
|---|---|
kimi | 在当前目录启动交互式会话 |
kimi --continue, kimi -C | 在此目录继续最近一次会话 |
kimi --session [id], kimi -S [id] | 按 ID 恢复会话；不提供 ID 时打开会话选择器 |
kimi -p "...", kimi --prompt "..." | 运行单条非交互式提示词，不打开 TUI |
--output-format stream-json | 为脚本输出 JSONL 事件；仅与 --prompt 搭配使用 |
kimi --model <model>, kimi -m <model> | 使用指定模型别名启动 |
kimi --plan | 以 Plan Mode 启动新会话 |
kimi --yolo, kimi -y | 自动批准常规工具调用；仅在可信目录中使用 |
kimi --auto | 以自动权限模式启动；审批会自动处理，Agent 不会提问 |
--skills-dir <dir> | 从指定目录加载技能；本次启动时将替代自动发现的用户技能目录和项目技能目录 |
非交互式示例
kimi -p "总结当前仓库状态"
kimi -m kimi-code/kimi-for-coding -p "解释最新 diff"
kimi -p "列出已更改的文件" --output-format stream-json
CLI 子命令
| 子命令 | 作用 |
|---|---|
kimi login | 不进入 TUI，直接启动 Kimi Code OAuth 设备码登录 |
kimi acp | 将 Kimi Code 作为 Agent Client Protocol 服务器运行，以便 IDE 集成 |
kimi server | 运行、安装并管理本地 REST/WebSocket/web 服务 |
kimi web | 打开 Kimi 的浏览器 UI；等同于 kimi server run --open |
kimi doctor | 校验 config.toml 和 tui.toml |
kimi export [sessionId] | 将会话打包为 ZIP 归档 |
kimi migrate | 从旧版 kimi-cli 安装迁移本地数据 |
kimi upgrade | 检查最新版本并显示更新选项 |
kimi vis [sessionId] | 在浏览器中启动会话可视化器 |
kimi provider | 在终端中管理 provider |
常用服务器命令：
kimi server run # 启动或复用本地后台服务器
kimi server run --foreground # 以前台方式附着到终端运行
kimi server install # 注册由操作系统管理的服务
kimi server status # 显示已安装 / 运行中 / pid / 端口状态
kimi web # 打开浏览器 UI
斜杠命令
斜杠命令是 TUI 内置控件。在输入框中输入 / 可打开命令补全；别名也会参与匹配。如果以 / 开头的输入既不匹配内置命令，也不匹配技能命令，就会作为普通消息发送给 Agent。
账号与配置
| 命令 | 别名 | 作用 |
|---|---|---|
/login | — | 选择账号或平台并登录 |
/logout | — | 清除当前账号的凭据 |
/provider | — | 打开 provider 管理器，查看、添加和移除已配置的 provider |
/model | — | 切换当前会话使用的 LLM 模型 |
/settings | /config | 打开 TUI 内的设置面板 |
/experiments | /experimental | 打开实验性功能面板 |
/permission | — | 选择权限模式 |
/editor | — | 配置通过 Ctrl-G 启动的外部编辑器 |
/theme | — | 切换终端 UI 配色主题 |
会话管理
| 命令 | 别名 | 作用 |
|---|---|---|
/new | /clear | 开始全新会话，并丢弃当前上下文 |
/sessions | /resume | 浏览历史会话并切换过去 |
/tasks | /task | 浏览后台任务列表 |
/fork | — | 从当前对话 fork 出新会话 |
/title [...] | /rename | 显示或设置当前会话标题 |
/compact [...] | — | 压缩对话上下文；可选文本用于提示需要保留的内容 |
/undo [n] | — | 从当前活动上下文中撤销最近的提示词 |
/reload | — | 重新加载会话，并应用最新的 config.toml 和 tui.toml 设置 |
/reload-tui | — | 仅重新加载 tui.toml 的 UI 偏好设置 |
/init | — | 分析代码库并生成 AGENTS.md |
/export-md [...] | /export | 将当前会话导出为 Markdown |
/export-debug-zip | — | 将当前会话导出为调试 ZIP 归档 |
模式与运行控制
| 命令 | 别名 | 作用 |
|---|---|---|
/yolo [on|off] | /yes | 切换 YOLO 模式；启用后会跳过常规工具调用的审批 |
/auto [on|off] | — | 切换自动权限模式；审批会自动处理，并跳过提问 |
/plan [on|off] | — | 切换 Plan Mode；仅切换不会创建空计划文件 |
/plan clear | — | 清除当前计划 |
/swarm on|off | — | 在不发送提示词的情况下开启或关闭集群模式 |
/swarm <task> | — | 开启集群模式，将任务作为提示词发送，并在一个正常回合后关闭集群模式 |
/goal [...] | — | 启动或管理自主目标 |
Plan Mode 适用于范围大、风险高或不明确的工作。它会在修改文件前优先探索和规划。
不审阅计划就直接开始 40 个文件的重构。
运行
/plan on，让 Kimi Code 检查项目，审阅它提出的计划，然后在修改发生前批准。Goal 模式子命令包括 /goal status、/goal pause、/goal resume、/goal cancel、/goal replace <objective>、/goal next <objective> 和 /goal next manage。
信息与状态
| 命令 | 别名 | 作用 |
|---|---|---|
/help | /h, /? | 显示键盘快捷键和可用命令 |
/btw [question] | — | 在 fork 出的子 Agent 中开启旁路对话 |
/usage | — | 显示 token 用量、上下文消耗和配额信息 |
/status | — | 显示运行时状态：版本、模型、工作目录、权限模式等 |
/mcp | — | 列出 MCP 服务器及连接状态 |
/plugins | — | 打开插件管理器 |
/version | — | 显示 Kimi Code CLI 版本 |
/feedback | — | 提交产品反馈 |
/exit | /quit, /q | 退出 Kimi Code CLI |
技能与扩展
| 命令 | 作用 |
|---|---|
/mcp-config | 配置 MCP 服务器并处理 MCP OAuth 登录 |
/custom-theme [...] | 创建或编辑自定义 TUI 配色主题 |
/update-config | 查看或编辑 config.toml 和 tui.toml |
/import-from-cc-codex | 导入 Claude Code 和 Codex 指令、技能以及 MCP 设置 |
/sub-skill | 发现并重组本地技能清单 |
/skill:name [extra text] | 调用已安装的外部技能 |
/name [extra text] | 当没有同名系统命令时，作为外部技能的快捷调用方式 |
/parent.child [extra text] | 调用以点号命令名暴露的外部子技能 |
内置工具
内置工具由 Kimi Code CLI 自身提供。Read、Grep、Glob 等只读工具默认自动允许；写入文件、执行命令、停止任务或创建计划任务的工具通常需要审批，除非你的权限模式允许。
文件、shell 与网页
| 工具 | 默认审批 | 作用 |
|---|---|---|
Read | 自动允许 | 读取文本文件 |
Write | 需要审批 | 创建或覆盖文件 |
Edit | 需要审批 | 替换精确的文件内容 |
Grep | 自动允许 | 使用 ripgrep 搜索文件内容 |
Glob | 自动允许 | 按 glob 模式查找文件 |
ReadMediaFile | 自动允许 | 读取图片或视频文件 |
Bash | 需要审批 | 执行 shell 命令 |
WebSearch | 自动允许 | 在可用时搜索网页 |
FetchURL | 自动允许 | 获取指定 URL 的内容 |
规划、状态与协作
| 工具 | 默认审批 | 作用 |
|---|---|---|
EnterPlanMode | 自动允许 | 进入 Plan Mode |
ExitPlanMode | 自动允许；用户确认计划 | 退出 Plan Mode 并提交计划 |
TodoList | 自动允许 | 管理可见的任务待办列表 |
Agent | 自动允许 | 为聚焦的子任务启动子 Agent |
AgentSwarm | 在集群模式下自动允许；其他情况下可能需要审批 | 启动基于条目的子 agent，或恢复已有子 agent |
AskUserQuestion | 自动允许 | 提出结构化的多选问题 |
Skill | 自动允许 | 调用已注册的内联技能 |
后台任务与定时任务
| 工具 | 默认审批 | 作用 |
|---|---|---|
TaskList | 自动允许 | 列出后台任务 |
TaskOutput | 自动允许 | 查看后台任务输出 |
TaskStop | 需要审批 | 停止正在运行的后台任务 |
CronCreate | 需要审批 | 安排提示词在未来触发 |
CronList | 自动允许 | 列出定时任务 |
CronDelete | 需要审批 | 取消定时任务 |
键盘快捷键
在 TUI 中输入 /help，查看当前版本可用的快捷键列表。完整上游列表请参阅官方键盘快捷键参考。
常规输入
| 快捷键 | 操作 |
|---|---|
Enter | 提交当前输入 |
Shift-Enter / Ctrl-J | 插入新行 |
↑ / ↓ | 浏览输入历史 |
Esc | 关闭弹窗、取消补全，或中断流式输出 / 压缩 |
Ctrl-C | 中断流式输出或清空输入框 |
Ctrl-D | 输入框为空时退出 |
模式切换与编辑
| 快捷键 | 操作 |
|---|---|
Shift-Tab | 切换 Plan Mode |
Ctrl-G | 在外部编辑器中编辑当前输入 |
Ctrl-V | 在 Unix / macOS 上从剪贴板粘贴图片或视频 |
Alt-V | 在 Windows 上从剪贴板粘贴图片或视频 |
Ctrl-- | 撤销输入编辑 |
流式输出与工具输出期间
| 快捷键 | 操作 |
|---|---|
Ctrl-S | 引导：将当前输入注入正在运行的回合 |
Esc | 中断当前流式输出 |
Ctrl-C | 中断当前流式输出 |
Ctrl-O | 展开或折叠工具输出 |
审批面板与弹窗
| 快捷键 | 操作 |
|---|---|
↑ / ↓ | 在审批选项间移动，或滚动弹窗 |
Enter | 确认选中的审批选项；也可关闭帮助弹窗 |
1 – 9 | 按数字选择审批选项 |
Esc / Ctrl-C / Ctrl-D | 拒绝当前审批请求 |
Ctrl-E | 在审批面板中展开或折叠完整 diff 或文件预览内容 |
PageUp / PageDown | 每次滚动弹窗 10 行 |
q / Q | 关闭弹窗 |
常见工作流
启动新仓库
cd your-project
kimi
/init
/status
编辑前先规划重构
/plan on
Refactor the auth module to use the new token format and update all callers.
运行后台任务
运行测试套件，完成后向我汇报。
然后打开 /tasks 监控后台工作，或让 Kimi Code 在任务完成时通知你。
继续昨天的工作
kimi --continue
如需指定会话，请运行 kimi --session，或在 TUI 中使用 /sessions。
导出会话或调试会话
/export-md
/export-debug-zip
kimi export -y
结语
把 Kimi Code CLI 当作终端里的队友，并为它提供明确的项目上下文时，它的效果最佳。先用 /init 开始；面对大型或不确定的修改时使用 /plan；用 /tasks 关注长时间运行的任务；长会话里随时善用 /compact；并根据仓库的可信程度选择合适的权限模式。
常见问题
Kimi Code CLI 可以免费安装吗？
是的。Kimi Code CLI 是开源的，可免费安装。底层模型或服务的访问权限可能取决于你的 Kimi Code 套餐。详情请参阅 Kimi Code 定价。
为什么这个页面叫快速参考，而不只叫速查表？
“快速参考”是更正式、更偏文档风格的名称。本页依然满足速查表的用途：把可复制粘贴的命令、斜杠命令、快捷键、工具和工作流集中在一处。
安装 Kimi Code CLI 需要 Node.js 吗？
官方安装脚本不需要 Node.js。npm 和 pnpm 安装方式需要 Node.js 环境，因为它们使用 JavaScript 包管理器。
`/plan` 和普通模式有什么区别？
普通模式让 Agent 直接开展工作。Plan Mode 适用于范围大、风险高或不明确的任务：Kimi Code 会先探索、写出计划，并在计划获批后退出。
如何继续之前的会话？
在同一项目目录中运行
kimi --continue 可继续最近一次会话。要选择特定会话，可在 shell 中使用 kimi --session [id]，或在 TUI 内使用 /sessions。`--yolo` 安全吗？
--yolo 会跳过常规工具调用的审批。只应在可信且受版本控制的工作区使用。面对不熟悉的仓库或生产数据时，请保持审批开启。技能和 MCP 在 Kimi Code 中如何配合？
技能可封装可复用的工作流，并可作为斜杠命令出现。MCP 将 Kimi Code 连接到外部工具和数据源。使用
/skill:name、/mcp 和 /mcp-config 来发现并配置它们。