开始使用

Kimi Code CLI 是什么

Kimi Code CLI 是一个运行在终端中的 AI Agent，帮助你完成软件开发任务和日常的终端操作——阅读和修改代码、执行 Shell 命令、搜索文件、抓取网页，并在执行过程中根据反馈自主规划和调整下一步行动。

它适用于以下场景：

• 编写和修改代码：实现新功能、修复 bug、完成重构
• 理解项目：探索陌生的代码库，解答架构和实现层面的问题
• 自动化任务：批量处理文件、运行构建与测试、串联多个脚本

整套 CLI 以 TypeScript 编写，通过 npm 分发，运行在 Node.js 之上。

安装

提供两种安装方式：官方安装脚本（推荐，无需预装 Node.js）和 npm 全局安装。

脚本安装（推荐）

Bash

Powershell

Windows 用户首次启动前还需要安装 Git for Windows，Kimi Code CLI 会使用其中的 Git Bash 作为 Shell 环境。如果 Git Bash 安装在非标准路径，请把 KIMI_SHELL_PATH 设为 bash.exe 的绝对路径。

脚本会自动下载最新版本、校验 checksum，并把 kimi 可执行文件放到你的 PATH 中。

npm 安装

需要 Node.js 22.19.0 或更高版本：

Bash

Bash

Bash

第一次启动

进入项目目录后直接运行 kimi 启动交互界面：

Bash

只想执行一条指令而不进入交互界面时，使用 -p：

Bash

继续上一次会话加 -c：

Bash

首次启动时需要配置 API 来源。在交互界面中输入 /login 进入登录流程：

Text

/login 会弹出平台选择器，支持两种方式：

• Kimi Code（OAuth） — 验证码流程，在任意设备打开链接、登录并输入验证码即可授权
• Kimi Platform API 密钥 — 输入来自 platform.kimi.com 或 platform.kimi.ai 的 API 密钥

需要退出登录时，输入 /logout 清除当前凭证。

第一个对话

登录完成后，用自然语言描述任务即可。先让它熟悉当前项目：

Text

Kimi Code CLI 会自动调用文件读取、搜索等工具浏览相关内容后给出回答。只读操作默认自动执行无需确认；对于会修改文件或执行 Shell 命令的操作，默认会在执行前征求确认。

也可以直接描述更具体的任务：

Text

Kimi Code CLI 会规划步骤、修改代码、运行测试，并在每一步告诉你它做了什么。

常用命令与快捷键速查

第一次使用时，记住下面这些就够了：

会话相关命令

最常用快捷键

想看完整列表，输入 /help 或访问斜杠命令参考和键盘快捷键。

数据存放在哪里

Kimi Code CLI 的本地数据默认保存在 ~/.kimi-code/ 下，包含配置文件、会话记录、日志和更新缓存。如需迁移到别处，通过 KIMI_CODE_HOME 环境变量指定新路径。完整说明见数据路径和环境变量。

升级与卸载

安装完成后，验证可执行文件是否就绪：

Bash

升级：运行 kimi upgrade，CLI 会检查最新版本并展示更新选项。选择 Install update now 后根据当前安装来源执行升级；也可以直接用包管理器：

Bash

卸载：脚本安装的用户删除 kimi 可执行文件即可；npm 安装的用户：

Bash

常见问题

/login 时模型列表为空

如果在运行 /login 命令时看到 "No models available for the selected platform" 错误，可能是以下原因：

• API 密钥无效或过期：检查你输入的 API 密钥是否正确，以及是否仍有效。
• 网络连接问题：确认能正常访问 API 服务地址（如 api.kimi.com 或 api.moonshot.cn）。

注意区分平台

Kimi Code 会员权益与 Kimi 开放平台 有不同的 Base URL，配置时请注意 Base URL 与 API Key 的匹配是否正确。

API 密钥无效

API 密钥无效可能的原因：

• 密钥输入错误：检查是否有多余的空格或遗漏的字符。
• 密钥已过期或被撤销：在平台控制台确认密钥状态。

会员过期或配额用尽

如果你使用 Kimi Code 平台，可以通过 /usage 命令查看当前的配额和会员状态。如果配额用尽或会员过期，需要在 Kimi Code 续费或升级。

粘贴图片失败

使用 Ctrl-V 粘贴图片时，如果提示 "Current model does not support image input"，说明当前模型不支持图片输入。

解决方法：

• 切换到支持图片的模型：使用支持 image_in 能力的模型。
• 检查剪贴板内容：确保剪贴板中确实有图片数据，而非图片文件的路径。

macOS 首次运行缓慢

macOS 的 Gatekeeper 安全机制会在首次运行新程序时进行检查，导致启动变慢。解决方法：

• 等待检查完成：首次运行时耐心等待，后续启动会恢复正常。
• 添加到开发者工具：在「系统设置 → 隐私与安全性 → 开发者工具」中添加你的终端应用。

如何升级 Kimi Code CLI

在 CLI 内运行 kimi upgrade，会自动检查最新版本并引导升级。也可以直接用包管理器：

Bash

下一步

• 交互与输入 — 输入框操作、审批流程、Plan 模式和 "Ask When Needed" 模式详解
• 会话与上下文 — 恢复会话、上下文压缩、导出会话
• 常见使用案例 — 典型任务的 prompt 示例