开始使用

Kimi Code CLI 是什么​

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

​

🔔

它适用于以下场景：​

•

编写和修改代码：实现新功能、修复 bug、完成重构​

•

理解项目：探索陌生的代码库，解答架构和实现层面的问题​

•

自动化任务：批量处理文件、运行构建与测试、串联多个脚本​

​

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

安装​

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

安装之前​

Kimi Code CLI 为全交互式 TUI 应用，推荐在支持真彩色与连字的现代终端中运行以获得最佳体验，例如 Kitty 或 Ghostty。​

脚本安装（推荐）​

•

macOS / Linux：​

​

代码块​

Plain Text

curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash​

​

•

Windows（PowerShell）：​

​

代码块​

Plain Text

irm https://code.kimi.com/kimi-code/install.ps1 | iex​

​

​

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 或更高版本：​

​

代码块​

Plain Text

node --versionnpm install -g @moonshot-ai/kimi-code​

​

或用 pnpm：​

​

代码块​

Plain Text

pnpm add -g @moonshot-ai/kimi-code​

​

升级与卸载​

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

​

代码块​

Plain Text

kimi --version​

​

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

​

代码块​

Plain Text

npm install -g @moonshot-ai/kimi-code@latest​

​

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

​

代码块​

Plain Text

npm uninstall -g @moonshot-ai/kimi-code​

​

第一次启动​

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

​

代码块​

Plain Text

cd your-projectkimi​

​

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

​

代码块​

Plain Text

kimi -p "帮我看一下这个项目的目录结构"​

​

继续上一次会话加 -c：​

​

代码块​

Plain Text

kimi -c​

​

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

​

代码块​

Plain Text

/login​

​

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

•

Kimi Code（OAuth） — 验证码流程，在任意设备打开链接、登录并输入验证码即可授权​

•

Kimi Platform API 密钥 — 输入来自 platform.kimi.com 或 platform.kimi.ai 的 API 密钥​

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

使用其他 AI 供应商​

如果你想接入 Anthropic、OpenAI、Google 等其他供应商，需要直接编辑 ~/.kimi-code/config.toml 配置 API 密钥，详见平台与模型。配置项完整说明见配置文件、环境变量和配置覆盖。​

第一个对话​

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

​

代码块​

Plain Text

帮我看一下这个项目的目录结构，简单介绍一下每个目录是做什么的​

​

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

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

​

代码块​

Plain Text

在 src/utils 里新增一个函数，用来把任意字符串转成 kebab-case，并补一个单元测试​

​

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

不知道能做什么？输入 /help​

随时在输入框输入 /help，可以打开内置的命令和快捷键面板，按 ↑/↓ 翻看，Esc 关闭。退出时输入 /exit，或按 Ctrl-C 两次，或在输入框为空时按 Ctrl-D。​

常用命令与快捷键速查​

​

​

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

会话相关命令​

最常用快捷键​

​

​

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

数据存放在哪里​

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