Kimi Code CLI 命令速查表 - Moonshot 终端 AI 编程代理
Kimi Code CLI 是把模型接入做进发行版的代理：装好即用，不需要自己填 base_url、配 SDK 或折腾 PATH，也基本不与全局 npm 模块冲突。这种开箱状态适合两类人：已经在用 Kimi 能力的开发者，和只想零配置拿到一个可用终端代理的人。但它不是封闭的——需要换成其他厂商模型时，改用户级配置文件填入对应的 API Key 即可，不必迁移工作流。上手顺序建议：先确认安装后能跑通一次交互，再学 -p 单次执行用于脚本，最后才处理会话恢复与模型切换。有一条实践值得前置：大改动之前先生成一份项目约定文件，让代理在开工前就掌握仓库的命名与结构习惯，这比事后再纠正它的写法更省时间。
安装与启动 4
npm install -g @moonshot-ai/kimi-code用 npm 全局安装
curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash官方脚本安装（无需预装 Node.js）
kimi --version查看已安装版本
kimi进入项目目录启动交互式 UI
交互与单次指令 5
kimi -p "查看此项目的目录结构"不进交互 UI，只执行单次指令
kimi -C恢复上一个工作阶段
/loginKimi Code OAuth 或 Moonshot API Key 登录
/logout清除当前凭证
/init扫描项目并生成 AGENTS.md
会话与模型 5
/model切换当前模型
/compact手动压缩上下文释放 token
/forkFork 当前会话，保留历史独立继续
/sessions浏览会话历史并选择恢复
kimi acp以 Agent Client Protocol 驱动 Zed/JetBrains 等编辑器
子命令与运维 20
kimi --session <id> / -S恢复指定会话，不带 id 则进入选择器
kimi --model <model> / -m为本次启动指定模型别名
kimi --yolo / -y自动批准普通工具调用（仅可信目录）
kimi --auto以 auto 权限模式启动，Agent 不再提问
kimi --plan以 Plan 模式启动新会话
kimi --skills-dir <dir>从指定目录加载 Skills（可重复）
kimi --add-dir <dir>为会话追加额外工作目录（可重复）
kimi --work-dir <dir> / -w设置文件操作根目录
kimi --thinking / --no-thinking显式开启/关闭思考模式
kimi --agent <name>选择内置 Agent 规格（实验）
kimi login非交互 device-code 登录 OAuth
kimi server run启动或复用本地 Kimi 服务守护进程
kimi server status打印安装/运行状态与端口（--json 脚本用）
kimi web后台启动服务并打开浏览器 Web UI
kimi doctor校验 config.toml 与 tui.toml
kimi doctor config只校验 config.toml
kimi doctor tui只校验 tui.toml
kimi export [sessionId]把会话打包为 ZIP 分享/归档
kimi upgrade检查并升级到最新版本
kimi provider管理供应商配置
提示
- Kimi Code CLI 是二进制发行、零环境依赖：一行脚本装好即可用，不折腾 PATH，也不和全局模块冲突。
kimi -p跑单次指令、kimi -C恢复阶段，脚本与自动化里最常用；大任务前先/init生成 AGENTS.md 让 Agent 更懂项目。- 需要给其他厂商（Anthropic/OpenAI/Google）模型时，直接编辑
~/.kimi-code/config.toml填入对应 API Key 即可。 - 恢复阶段时确认当前工作目录一致：会话按项目目录划分，目录不对会命中不到你以为的那个上下文。
- 换厂商模型后先跑一个最小任务（如读一个文件并总结）验证鉴权与模型名，再投入真实改动，避免配置错误被误判为模型能力问题。
- 单次执行模式适合写进 Makefile 或 pre-commit 钩子做固定检查，把提示词固定下来比每次手敲更稳定也更省。
常见问题
kimi 命令和 kimi-cli 包是什么关系？
本表对应的是 Moonshot 官方的 Kimi Code CLI（npm 包 @moonshot-ai/kimi-code），安装后命令名就是 kimi。社区另有独立的 Python 包 kimi-cli，二者不是同一个项目。
Kimi Code CLI 能在 Windows 上用吗？
可以。Windows 用 PowerShell 跑安装脚本 irm https://code.kimi.com/kimi-code/install.ps1 | iex，首次启动前需装 Git for Windows，CLI 会用其中的 Git Bash 作 Shell 环境。
由 巧匠 维护
公开更新于 2026年8月26日，内容持续校对官方文档。