阅读时长：8 分钟2026-08-12
Kimi Code CLI 是月之暗面（Moonshot AI）推出的开源终端 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 | 进入规划模式以应对范围广或风险高的更改 |
/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 | 以计划模式启动新会话 |
kimi --yolo、kimi -y | 自动批准常规工具调用；仅在可信目录中使用 |
kimi --auto | 以自动权限模式启动；批准操作将自动处理，Agent 不会提出询问 |
--skills-dir <dir> | 从指定目录加载技能，替代此次启动时自动发现的用户和项目技能目录 |
非交互式示例
kimi -p "Summarize the current repository status"
kimi -m kimi-code/kimi-for-coding -p "Explain the latest diff"
kimi -p "List changed files" --output-format stream-json
CLI 子命令
| 子命令 | 用途 |
|---|---|
kimi login | 无需进入 TUI，即可启动 Kimi Code OAuth 设备码登录 |
kimi acp | 将 Kimi Code 作为 Agent Client Protocol 服务器运行，用于 IDE 集成 |
kimi server | 运行、安装并管理本地 REST/WebSocket/网页服务 |
kimi web | 打开 Kimi 的浏览器界面；等同于 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 | 在终端中管理提供方 |
常用服务器命令：
kimi server run # start or reuse a local background server
kimi server run --foreground # run attached to the terminal
kimi server install # register an OS-managed service
kimi server status # show installed / running / pid / port state
kimi web # open the browser UI
斜杠命令
斜杠命令是内置的 TUI 控件。在输入框中输入 / 即可打开命令补全，别名也可以匹配。如果以 / 开头的输入未匹配到内置命令或 Skill 命令，它会作为普通消息发送给 Agent。
账户与配置
| 命令 | 别名 | 用途 |
|---|---|---|
/login | — | 选择账号或平台并登录 |
/logout | — | 清除当前账号的凭证 |
/provider | — | 打开提供方管理器，查看、添加和移除已配置的提供方 |
/model | — | 切换当前会话使用的 LLM 模型 |
/settings | /config | 在 TUI 中打开设置面板 |
/experiments | /experimental | 打开实验性功能面板 |
/permission | — | 选择权限模式 |
/editor | — | 配置由 Ctrl-G 启动的外部编辑器 |
/theme | — | 切换终端界面的配色主题 |
会话管理
| 命令 | 别名 | 用途 |
|---|---|---|
/new | /clear | 开始一个全新会话，丢弃当前上下文 |
/sessions | /resume | 浏览历史会话并切换到其中一个 |
/tasks | /task | 浏览后台任务列表 |
/fork | — | 从当前对话派生出一个新会话 |
/title [...] | /rename | 显示或设置当前会话标题 |
/compact [...] | — | 压缩对话上下文；可附加文本提示需要保留的内容 |
/undo [n] | — | 撤销当前上下文中的最近提示词 |
/reload | — | 重新加载会话并应用最新的 config.toml 和 tui.toml 设置 |
/reload-tui | — | 仅重新加载 tui.toml 的界面偏好设置 |
/init | — | 分析代码库并生成 AGENTS.md |
/export-md [...] | /export | 将当前会话导出为 Markdown |
/export-debug-zip | — | 将当前会话导出为调试用的 ZIP 压缩包 |
模式与运行控制
| 命令 | 别名 | 用途 |
|---|---|---|
/yolo [on\|off] | /yes | 切换 YOLO 模式；开启后常规工具调用将跳过审批 |
/auto [on\|off] | — | 切换自动权限模式；审批会自动处理，相关询问也会被跳过 |
/plan [on\|off] | — | 切换计划模式；单纯切换不会创建空的计划文件 |
/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] | — | 在分叉的子 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 | 自动允许 | 进入计划模式 |
ExitPlanMode | 自动允许；用户确认计划 | 退出计划模式并提交计划 |
TodoList | 自动允许 | 管理可见的任务待办列表 |
Agent | 自动允许 | 生成子智能体以处理专注的子任务 |
AgentSwarm | 在集群模式下自动允许；否则可能需要审批 | 启动基于条目的子智能体，或恢复已有的子智能体 |
AskUserQuestion | 自动允许 | 提出结构化的多选问题 |
Skill | 自动允许 | 调用已注册的内联技能 |
后台任务与计划任务
| 工具 | 默认审批设置 | 用途 |
|---|---|---|
TaskList | 自动允许 | 列出后台任务 |
TaskOutput | 自动允许 | 查看后台任务的输出 |
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 | 展开或收起工具输出 |
审批面板与弹窗
| 快捷键 | 操作 |
|---|---|
↑ / ↓ | 在审批选项间移动，或滚动弹窗内容 |
Enter | 确认所选的批准选项；也用于关闭帮助弹窗 |
1 – 9 | 按数字选择批准选项 |
Esc / Ctrl-C / Ctrl-D | 拒绝当前的批准请求 |
Ctrl-E | 在批准面板中展开或收起完整差异或文件预览内容 |
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.
运行一个后台任务
Run the test suite and report back when it finishes.
然后打开 /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 定价。
为什么这个页面叫快速参考，而不只是速查表？
Quick reference（快速参考）是更正式的文档式说法。该页面依然覆盖同样的速查表用途：把命令、斜杠命令、快捷键、工具和工作流集中放在一处，方便复制粘贴使用。
安装 Kimi Code CLI 需要 Node.js 吗？
官方安装脚本不需要 Node.js。npm 和 pnpm 安装方式因为使用 JavaScript 包管理器，所以需要 Node.js 环境。
`/plan` 和普通模式有什么区别？
普通模式让智能体直接开展工作。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 来发现和配置它们。