Kimi Code CLI 快速参考

Kimi Code CLI 速查表与快速参考,涵盖命令、斜杠命令、键盘快捷键、内置工具、规划模式、技能、MCP 以及日常开发者工作流。

阅读时长:8 分钟更新于:2026-09-15
Kimi Code CLI 界面预览

Kimi Code CLI 是月之暗面的开源终端 AI 编程智能体,可读取和编辑代码、运行 shell 命令,并根据你的反馈规划下一步操作。本快速参考汇集了开发者最常使用的 Kimi Code 命令、斜杠命令、键盘快捷键、内置工具和日常工作流。将它与终端一同打开;在 Kimi Code 中使用 /help,或在 shell 中运行 kimi --help,即可查看当前版本提供的功能。

如需了解上游详情,请参阅官方的 kimi command斜杠命令内置工具键盘快捷键参考文档。

安装 Kimi Code CLI

对大多数开发者而言,官方安装脚本是最快的方式:它会安装一个独立的 Kimi Code 二进制文件,且无需 Node.js。如果 Homebrew、npm 或 pnpm 更符合你的本地工具链,也可以使用它们。

平台 / 包管理器命令
macOS / Linux 脚本curl -fsSL https://code.kimi.com/kimi-code/install.sh \| bash
Homebrewbrew install kimi-code
Windows PowerShellirm https://code.kimi.com/kimi-code/install.ps1 \| iex
npmnpm install -g @moonshot-ai/kimi-code
pnpmpnpm add -g @moonshot-ai/kimi-code

在 Windows 上,由于 Kimi Code CLI 使用随附的 Git Bash 作为 shell 环境,首次启动前请先安装 Git for Windows。安装完成后,打开新的终端并验证该二进制文件:

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针对大范围或有风险的变更进入规划模式
/model切换本次会话使用的模型
/compact当对话变长时释放上下文空间
/sessions浏览并恢复过去的会话
/help列出所有命令和快捷键
Shift-Tab切换规划模式

启动与自动化

核心 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以计划模式启动新会话
kimi --yolo, kimi -y自动批准常规工具调用;仅在受信任的目录中使用
kimi --auto以自动权限模式启动;审批将自动处理,智能体不会提问
--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 doctor验证 config.tomltui.toml
kimi export [sessionId]将会话打包为 ZIP 归档文件
kimi rc通过远程控制打开 Web UI(别名为 kimi remote
kimi session list列出脚本会话
kimi upgrade检查最新版本并显示更新选项
kimi web运行本地 Web UI 和 REST/WebSocket API 服务

Web UI 与远程访问:

kimi web # 运行本地 Web UI + REST/WebSocket API 服务 kimi rc # 通过远程控制打开 Web UI(别名:kimi remote) kimi session list # 列出脚本会话

斜杠命令

斜杠命令是内置的 TUI 控件。在输入框中键入 / 即可打开命令补全,也会匹配别名。如果以 / 开头的输入未匹配内置命令或技能命令,它会作为普通消息发送给智能体。

账号与配置

命令别名用途
/login通过 kimi.ai / kimi.com OAuth 或 API 密钥登录
/logout清除当前账户的凭据
/provider打开提供商管理器,查看、添加和删除已配置的提供商
/model切换当前会话使用的 LLM 模型
/effort切换思考强度(关闭/低/高/最高)
/secondary-model配置子智能体模型池
/settings/config打开 TUI 内的设置面板
/experiments/experimental打开实验性功能面板
/permission选择权限模式
/editor配置由 Ctrl-G 启动的外部编辑器
/theme切换终端 UI 的颜色主题
/remote-control/rc远程访问本地 Web 会话

会话管理

命令别名用途
/new/clear开始新会话,丢弃当前上下文
/sessions/resume浏览历史会话并切换至其中一个
/tasks/task浏览后台任务列表
/fork创建当前会话的副本,并保留在此会话中
/title [...]/rename显示或设置当前会话标题
/compact [...]压缩对话上下文;可选文本用于提示需保留的内容
/undo [n]从当前上下文中撤销最近的提示
/reload重新加载会话,并应用最新的 config.tomltui.toml 设置
/reload-tui仅重新加载 tui.toml 中的 UI 偏好设置
/init分析代码库并生成 AGENTS.md
/export-md [...]/export将当前会话导出为 Markdown
/export-debug-zip将当前会话导出为调试 ZIP 压缩包

模式与运行控制

命令别名用途
/yolo/yes切换至“按需询问”模式:常规操作自动执行,风险操作仍会询问
/auto切换至“从不询问”模式:所有操作均自动执行
/plan [on\|off]切换计划模式;仅切换模式不会创建空的计划文件
/plan clear清除当前计划
/tower多智能体 worktree 编排(实验性功能;在 /experiments 中启用)
/swarm on\|off无需发送提示词即可开启或关闭集群模式
/swarm <task>开启集群模式,将任务作为提示词发送,然后在正常完成一轮交互后关闭集群模式
/goal [...]启动或管理自主目标

规划模式适用于范围广、风险高或不明确的工作。它会在修改文件前优先进行探索和规划。

在未审阅计划的情况下,立即开始编辑一个涉及 40 个文件的重构。
运行 /plan on,让 Kimi Code 检查项目,审阅提出的计划,并在进行修改前批准该计划。

目标模式子命令包括 /goal status/goal pause/goal resume/goal cancel/goal replace <objective>/goal next <objective>/goal next manage

信息与状态

命令别名用途
/help/h, /?显示键盘快捷键和可用命令
/btw [question]在分叉出的子智能体中开启侧边对话
/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.tomltui.toml
/import-from-cc-codex导入 Claude Code 和 Codex 指令、技能及 MCP 设置
/skill:name [extra text]调用已安装的外部技能
/name [extra text]当没有同名系统命令时,作为外部技能的快捷方式
/parent.child [extra text]调用以点式命令名公开的外部子技能

内置工具

内置工具由 Kimi Code CLI 自身提供。ReadGrepGlob 等只读工具默认自动获批;写入文件、执行命令、停止任务或创建计划的工具通常需要审批,除非你的权限模式允许使用它们。

文件、shell 与 Web

工具默认审批设置用途
Read自动允许读取文本文件
Write需要审批创建或覆盖文件
Edit需要审批替换文件中的精确内容
Grep自动允许使用 ripgrep 搜索文件内容
Glob自动允许按 glob 模式查找文件
ReadMediaFile自动允许读取图像或视频文件
Bash需要审批执行 shell 命令
WebSearch自动允许可用时搜索网络
FetchURL自动允许获取指定 URL 的内容

规划、状态与协作

工具默认审批用途
EnterPlanMode自动允许进入计划模式
ExitPlanMode自动允许;用户确认计划退出计划模式并提交计划
TodoList自动允许管理可见的任务待办列表
Agent自动允许为专注的子任务启动一个子智能体
AgentSwarm在集群模式下自动允许;否则可能需要审批启动基于条目的子智能体,或恢复已有子智能体
AskUserQuestion自动允许提出结构化的多项选择问题
Skill自动允许调用已注册的内联技能

后台任务与定时任务

工具默认审批用途
TaskList自动允许列出后台任务
TaskOutput自动允许查看后台任务的输出
WaitFor自动允许在当前轮次中等待后台任务
TaskStop需要审批停止正在运行的后台任务
CronCreate需要审批安排提示词在未来触发
CronList自动允许列出已安排的任务
CronDelete需要批准取消已安排的任务

键盘快捷键

在 TUI 中输入 /help,即可查看当前版本可用的快捷键列表。完整的上游列表请参阅官方键盘快捷键参考

常规输入

快捷键操作
Enter提交当前输入
Shift-Enter / Ctrl-J插入换行
/ 浏览输入历史记录
Esc关闭弹窗、取消补全,或中断流式输出 / 压缩
Ctrl-C中断流式输出或清空输入框
Ctrl-D输入框为空时退出

模式切换与编辑

快捷键操作
Shift-Tab切换规划模式
Ctrl-G在外部编辑器中编辑当前输入
Ctrl-V在 Unix / macOS 上从剪贴板粘贴图片或视频
Alt-V在 Windows 上从剪贴板粘贴图片或视频
Ctrl--撤销输入编辑

流式输出和工具输出期间

快捷键操作
Ctrl-S引导:将当前输入注入正在进行的轮次
Esc中断当前流式输出
Ctrl-C中断当前流式输出
Ctrl-O展开或收起工具输出
Ctrl-B将正在运行的 shell 命令转为后台任务

审批面板

快捷键操作
/ 在审批选项之间切换
Enter确认选中的审批选项
19按数字选择审批选项
Esc / Ctrl-C / Ctrl-D拒绝当前审批请求
Ctrl-E展开或收起待审核的 diff 或文件预览

弹窗与帮助

快捷键操作
PageUp / PageDown每次滚动弹窗 10 行
q / Q关闭弹窗
Enter关闭帮助弹窗

常见工作流

新建仓库

cd your-project kimi /init /status

编辑前先规划重构方案

/plan on 重构认证模块以使用新的 token 格式,并更新所有调用方。

运行后台任务

运行测试套件,完成后告知我。

然后打开 /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` 与普通模式有什么区别?
普通模式允许智能体直接执行任务。计划模式适用于范围广、风险高或需求不明确的工作:Kimi Code 会先进行探索,编写计划,并在计划获批后退出。
如何恢复之前的会话?
在同一项目目录中运行 kimi --continue,即可继续最近一次会话。可在 shell 中使用 kimi --session [id],或在 TUI 中使用 /sessions,以选择特定会话。
`--yolo` 安全吗?
--yolo 会跳过常规工具调用的审批。请仅在可信且受版本控制的工作区中使用。对于不熟悉的仓库或生产数据,请保留审批。
技能和 MCP 如何融入 Kimi Code?
技能可将可复用的工作流程打包,并以斜杠命令的形式出现。MCP 将 Kimi Code 连接到外部工具和数据源。使用 /skill:name/mcp/mcp-config 发现并配置它们。
Kimi Code CLI 快速参考:命令、快捷键与工作流