Kimi Code CLI 快速上手：安装、登录与第一个任务

Kimi Code CLI 是一个运行在终端中的 AI Agent，用来协助完成软件开发任务和日常终端操作。它可以阅读和修改代码、执行 Shell 命令、搜索文件、抓取网页，并在执行过程中根据反馈自主规划和调整下一步行动。它主要面向三类场景：编写与修改代码（实现新功能、修复 bug、完成重构）、理解项目（探索陌生的代码库，解答架构与实现层面的问题）、自动化任务（批量处理文件、运行构建与测试、串联多个脚本）。整套 CLI 以 TypeScript 编写，通过 npm 分发，运行在 Node.js 之上。如果你更习惯图形界面，也可以先了解本站收录的 Kimi 相关工具形态，再决定是否使用命令行版本。

准备工作

终端环境

Kimi Code CLI 是全交互式 TUI 应用，推荐在支持真彩色与连字的现代终端中运行，以获得最佳显示效果，例如 Kitty 或 Ghostty。终端不支持真彩色时功能仍可运行，但界面渲染效果会打折扣。

安装方式的选择

提供两种安装方式：官方安装脚本（推荐，无需预装 Node.js）和 npm 全局安装。如果本机没有 Node.js 环境，或者不想管理 Node 版本，用脚本安装更省事；如果本机已经在用 Node.js 做开发，用 npm 安装便于和其他全局包一起管理。

Windows 的额外前置条件

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

npm 安装的版本要求

走 npm 路线需要 Node.js 22.19.0 或更高版本。安装前先确认版本：

node --version

版本低于要求时，先升级 Node.js 再继续。

操作步骤

第一步：安装 CLI

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

macOS / Linux：

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

Windows（PowerShell）：

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

如果选择 npm 全局安装，二选一即可：

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

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

第二步：验证安装

安装完成后，先确认可执行文件已经就绪：

kimi --version

能正常输出版本号，说明 PATH 配置没有问题。如果提示找不到命令，检查安装脚本输出的路径是否已加入当前 Shell 的 PATH，必要时重开一个终端窗口。

第三步：启动交互界面

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

cd your-project
kimi

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

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

想继续上一次会话，加上 -c：

kimi -c

第四步：配置 API 来源

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

/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 密钥。配置项的完整说明涉及配置文件、环境变量和配置覆盖三部分，建议按需查阅对应章节后再动手改。

第六步：发起第一个对话

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

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

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

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

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

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

第七步：查看帮助与退出

不知道能做什么时，随时在输入框输入 /help，可以打开内置的命令和快捷键面板，按 ↑ / ↓ 翻看，按 Esc 关闭。

退出时输入 /exit，或按 Ctrl-C 两次，或在输入框为空时按 Ctrl-D。

常用命令与快捷键速查

会话相关命令

命令	说明
`/new`	开启新会话，清空当前上下文
`/sessions`	浏览历史会话，选择恢复
`/model`	切换当前使用的模型
`/compact`	手动压缩上下文，释放 token
`/fork`	派生当前会话为保留完整历史的独立副本（仍停留在当前会话）

最常用快捷键

快捷键	说明
Esc	中断流式输出 / 关闭弹窗
Ctrl-C	中断输出；空闲时连按两次退出
Shift-Tab	切换 Plan 模式
Ctrl-S	输出中途插入消息，无需等待结束
Ctrl-O	折叠 / 展开工具输出和压缩摘要

想看完整列表，输入 /help 即可。

一个完整示例

下面从零开始走一遍最小可用流程，假设你已经装好 CLI 并完成了 /login。

先进入一个已有项目：

cd ~/projects/demo-app
kimi

启动后先让它熟悉项目结构：

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

这一步只涉及读取和搜索，属于只读操作，默认自动执行，不需要逐条确认。看完回答后，接着提出一个会改动代码的任务：

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

此时 Kimi Code CLI 会规划步骤、修改文件、运行测试。因为涉及写文件和执行 Shell 命令，默认会在执行前征求确认，你可以在每一步看到它打算做什么再决定是否放行。如果中途发现方向不对，按 Esc 中断流式输出，或按 Ctrl-C 中断当前输出。

任务完成后，如果上下文变得很长，用 /compact 手动压缩上下文释放 token；想换个话题，用 /new 开启新会话；想回到之前的某次工作，用 /sessions 浏览并恢复。想在不影响当前会话的前提下另开一条探索路径，用 /fork 派生一个保留完整历史的独立副本。

最后退出：输入 /exit，或按 Ctrl-C 两次，或在输入框为空时按 Ctrl-D。

数据存放位置

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

升级与卸载

升级时运行：

kimi upgrade

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

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

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

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

注意事项

/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 的匹配是否正确。

两个平台的差异可以简单对照：Kimi Code 使用 Anthropic 兼容的 Base URL，计费方式为 Kimi 会员订阅（含额度），Key 创建入口在 Kimi Code 控制台；Kimi 开放平台按量付费，Key 创建入口在 Kimi 开放平台官网。

API 密钥无效

可能的原因包括：密钥输入错误，检查是否有多余的空格或遗漏的字符；密钥已过期或被撤销，需要在平台控制台确认密钥状态。

会员过期或配额用尽

如果使用 Kimi Code 平台，可以通过 /usage 命令查看当前的配额和会员状态。如果配额用尽或会员过期，需要在 Kimi Code 续费或升级。具体的套餐内容、额度与价格请以官网当前信息为准。

粘贴图片失败

使用 Ctrl-V 粘贴图片时，如果提示 "Current model does not support image input"，说明当前模型不支持图片输入。解决方法有两个：切换到支持图片的模型，即使用具备 image_in 能力的模型；或者检查剪贴板内容，确保剪贴板中确实有图片数据，而非图片文件的路径。

macOS 首次运行缓慢

macOS 的 Gatekeeper 安全机制会在首次运行新程序时进行检查，导致启动变慢。可以等待检查完成，首次运行后后续启动会恢复正常；也可以在「系统设置 → 隐私与安全性 → 开发者工具」中添加你的终端应用。

版本与配额信息

本文涉及的版本号、配额、计费方式等信息可能随产品迭代变化，实际以官网当前信息为准。