开始使用

Kimi Code CLI 是什么

Kimi Code CLI 是一个运行在终端中的 AI Agent，帮助你完成软件开发任务和终端操作。它可以阅读和编辑代码、执行 Shell 命令、搜索和抓取网页，并在执行过程中自主规划和调整行动。

Kimi Code CLI 适合以下场景：

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

Kimi Code CLI 支持以下几种使用方式：

• 交互式命令行（kimi）：在终端中以 Shell 方式与 AI 对话，支持自然语言描述任务或直接执行 Shell 命令
• 浏览器界面（kimi web）：在本地浏览器中打开图形界面，支持会话管理、文件引用、代码高亮等
• Agent 集成（kimi acp）：以服务方式运行，通过 Agent Client Protocol 集成到 IDE 和其他本地 Agent 客户端中

提示

如果你遇到问题或有建议，欢迎在 GitHub Issues 反馈。

安装

运行安装脚本即可完成安装。脚本会先安装 uv（Python 包管理工具），再通过 uv 安装 Kimi Code CLI：

# Linux / macOS
curl -LsSf https://code.kimi.com/install.sh | bash

# Windows (PowerShell)
Invoke-RestMethod https://code.kimi.com/install.ps1 | Invoke-Expression

验证安装是否成功：

kimi --version

提示

由于 macOS 的安全检查机制，首次运行 kimi 命令可能需要较长时间。可以在「系统设置 → 隐私与安全性 → 开发者工具」中添加你的终端应用来加速后续启动。

如果你已经安装了 uv，也可以直接运行：

uv tool install --python 3.13 kimi-cli

提示

Kimi Code CLI 支持 Python 3.12-3.14，但建议使用 3.13 以获得最佳兼容性。

升级与卸载

升级到最新版本：

uv tool upgrade kimi-cli --no-cache

卸载 Kimi Code CLI：

uv tool uninstall kimi-cli

第一次运行

在你想要工作的项目目录中运行 kimi 命令启动 Kimi Code CLI：

cd your-project
kimi

首次启动时，你需要配置 API 来源。输入 /login 命令开始配置：

/login

执行后首先选择平台。推荐选择 Kimi Code，会自动打开浏览器进行 OAuth 授权；选择其他平台则需要输入 API 密钥。配置完成后 Kimi Code CLI 会自动保存设置并重新加载。详见 平台与模型。

现在你可以直接用自然语言和 Kimi Code CLI 对话了。试着描述你想完成的任务，比如：

帮我看一下这个项目的目录结构

提示

如果项目中没有 AGENTS.md 文件，可以运行 /init 命令让 Kimi Code CLI 分析项目并生成该文件，帮助 AI 更好地理解项目结构和规范。

输入 /help 可以查看所有可用的 斜杠命令 和使用提示。