Kimi Code 从安装到实战：完整上手指南
无需复杂配置，跟着步骤用上 Kimi 的终端 AI 助手。
什么是 Kimi Code CLI？
Kimi Code CLI 是月之暗面推出的终端 AI 辅助工具，运行在命令行环境中，能帮你读代码、执行 Shell 命令、搜索网页，并自动拆解复杂任务。它适合有一定命令行基础的开发者或技术爱好者，但即便你只写过几行命令，也能按本指南一步步上手。
第1步：安装 Kimi Code CLI
安装方式因操作系统而异。截至2026年7月，官方推荐使用一键安装脚本或手动下载预编译二进制。
macOS / Linux 用户：打开终端，运行官方安装脚本（具体命令请参考官方安装指南）。脚本会自动下载最新版本、校验完整性，并将 kimi 命令添加到系统 PATH。
Windows 用户：首次使用前，请先安装 Git for Windows（Kimi Code CLI 会用到 Git Bash 作为 Shell 环境）。如果 Git 安装在非默认路径，需要设置环境变量 KIMI_SHELL_PATH 指向 bash.exe 的完整路径。安装 Git 后，同样运行安装脚本（PowerShell 下）或从 GitHub Releases 下载可执行文件。
安装完成后，在终端输入 kimi --version 确认版本号，如果能正确显示则安装成功。
第2步：获取 API Key
Kimi Code CLI 需要通过 API Key 连接 Kimi API 平台。
打开 Kimi API Platform，登录你的账户（若无账户请先注册）。
进入 API Keys 页面，点击创建新密钥。
复制生成的 API Key（注意：关闭页面后不再显示完整密钥，请妥善保存）。
第3步：启动并连接
进入你打算使用 Kimi Code CLI 的项目文件夹，然后在终端执行：
`
kimi`
首次启动时，Kimi Code CLI 会进入平台选择界面。使用键盘上下键选择 Kimi Platform (API key · platform.kimi.ai)，按回车确认。然后粘贴你刚才复制的 API Key，再次回车。工具会验证密钥，并加载该账户可用的模型列表。接着选择你想用的模型（例如 kimi-k3），确认后即完成配置。配置会保存，后续启动自动复用。
验证连接是否成功：在 Kimi Code CLI 的交互界面中输入 /help 并回车，如果返回帮助信息，说明连接正常。你也可以直接问一个简单问题，比如“当前目录是什么？”，看它能否正确回答。
第4步：发送第一条指令
现在你可以开始使用 Kimi Code CLI 完成实际任务了。例如，让它列出当前目录下的文件：
`
列出当前目录所有文件，以树形结构显示`
Kimi Code CLI 会分析你的意图，执行 tree 或 ls 命令并返回结果。如果你需要它编写一段代码，可以说：
`
用 Python 写一个斐波那契数列生成函数`
它会直接生成代码并输出到终端。如果任务涉及多个步骤（比如创建一个新项目并初始化 Git），它会自主规划执行，并在需要时询问你的确认。
附加技巧：切换 Shell 模式
在 Kimi Code CLI 界面中，按 Ctrl+X 可以切换至 Shell 命令模式。此时你可以直接运行系统命令（如 cd、git 等），而无需退出工具。再次按 Ctrl+X 返回 AI 对话模式。这个功能让终端操作与 AI 辅助无缝衔接。
总结
至此，你已经完成了 Kimi Code CLI 的安装、配置和首次使用。核心步骤可以概括为：安装工具 → 获取 API Key → 启动并输入 Key → 选择模型 → 发送指令。以后每次使用只需在项目目录下运行 kimi 即可。若想深入了解，可以查阅官方文档或探索 VS Code 扩展、Zsh 集成等高级功能。