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 |
| 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 上,由于 Kimi Code CLI 使用随附的 Git Bash 作为 shell 环境,首次启动前请先安装 Git for Windows。安装完成后,打开新的终端并验证该二进制文件:
从这里开始
首次进入一个项目时,按以下最小流程操作:
仅在你信任的企业空间中使用 --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> | 从指定目录加载技能,替换本次启动时自动发现的用户和项目技能目录 |
非交互式示例
CLI 子命令
| 子命令 | 用途 |
|---|---|
kimi login | 无需进入 TUI,即可启动 Kimi Code OAuth 设备代码登录 |
kimi acp | 将 Kimi Code 作为 Agent Client Protocol 服务器运行,以集成 IDE |
kimi doctor | 验证 config.toml 和 tui.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 与远程访问:
斜杠命令
斜杠命令是内置的 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.toml 和 tui.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 [...] | — | 启动或管理自主目标 |
规划模式适用于范围广、风险高或不明确的工作。它会在修改文件前优先进行探索和规划。
/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.toml 和 tui.toml |
/import-from-cc-codex | 导入 Claude Code 和 Codex 指令、技能及 MCP 设置 |
/skill:name [extra text] | 调用已安装的外部技能 |
/name [extra text] | 当没有同名系统命令时,作为外部技能的快捷方式 |
/parent.child [extra text] | 调用以点式命令名公开的外部子技能 |
内置工具
内置工具由 Kimi Code CLI 自身提供。Read、Grep 和 Glob 等只读工具默认自动获批;写入文件、执行命令、停止任务或创建计划的工具通常需要审批,除非你的权限模式允许使用它们。
文件、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 | 确认选中的审批选项 |
1 – 9 | 按数字选择审批选项 |
Esc / Ctrl-C / Ctrl-D | 拒绝当前审批请求 |
Ctrl-E | 展开或收起待审核的 diff 或文件预览 |
弹窗与帮助
| 快捷键 | 操作 |
|---|---|
PageUp / PageDown | 每次滚动弹窗 10 行 |
q / Q | 关闭弹窗 |
Enter | 关闭帮助弹窗 |
常见工作流
新建仓库
编辑前先规划重构方案
运行后台任务
然后打开 /tasks 监控后台工作,或等待 Kimi Code 在任务完成时通知你。
继续昨天的工作
如果需要指定会话,请运行 kimi --session,或在 TUI 中使用 /sessions。
导出或调试会话
结语
将 Kimi Code CLI 视为一位拥有明确项目上下文的终端协作伙伴,才能发挥其最佳效果。先从 /init 开始;对于规模较大或不确定的变更,使用 /plan;通过 /tasks 关注长时间运行的工作;长会话时随时使用 /compact;并选择与仓库信任级别相符的权限模式。
常见问题
kimi --continue,即可继续最近一次会话。可在 shell 中使用 kimi --session [id],或在 TUI 中使用 /sessions,以选择特定会话。--yolo 会跳过常规工具调用的审批。请仅在可信且受版本控制的工作区中使用。对于不熟悉的仓库或生产数据,请保留审批。/skill:name、/mcp 和 /mcp-config 发现并配置它们。