开始使用 Kimi Code CLI
Kimi Code CLI 是一个运行在终端中的 AI Agent，帮助你完成软件开发任务和终端操作。它可以阅读和编辑代码、执行 Shell 命令、搜索和抓取网页，并在执行过程中自主规划和调整方案。
适合场景
- 编写和修改代码：描述需求，AI 自动完成代码编写与修改。
- 理解项目：快速了解项目架构、代码逻辑和文件作用。
- 自动化任务：批量修改代码、添加文档、生成测试用例等重复性工作。
三种使用方式
开始之前
- 操作系统：macOS、Linux 或 Windows（通过 PowerShell）
- Kimi 账号：需拥有 Kimi 会员订阅，或可调用的 API key
安装
运行安装脚本即可完成安装。脚本会先安装 uv（Python 包管理工具），再通过 uv 安装 Kimi Code CLI：
验证安装是否成功：
由于 macOS 的安全检查机制（Gatekeeper），首次运行
kimi命令可能需要较长时间。可以在「系统设置 → 隐私与安全性 → 开发者工具」中添加你的终端应用来加速后续启动。
如果你已经安装了 uv，也可以直接运行：
Kimi Code CLI 支持 Python 3.12-3.14，但建议使用 3.13 以获得最佳兼容性。
如果 kimi 命令未找到，请尝试重新打开终端或执行 source ~/.bashrc（或 ~/.zshrc）。
首次运行
- 进入你的项目目录：
- 启动 Kimi Code CLI：
- 执行
/login命令完成登录授权：
系统会提示你选择登录平台，按提示完成授权即可。
- 配置完成后，你就可以开始与 AI 对话了。
生成 AGENTS.md
在项目目录下执行 /init 命令，Kimi Code CLI 会自动扫描项目结构并生成 AGENTS.md 文件：
AGENTS.md 用于向 AI 提供项目的背景信息、构建步骤、代码规范等上下文，帮助 AI 更准确地理解你的项目。
第一步：问一个问题
用自然语言提问，快速了解项目：
Kimi Code CLI 会自动搜索和阅读相关文件，然后给出回答。
第二步：做一次代码修改
试试让 Kimi Code CLI 修改代码：
Kimi Code CLI 在修改文件前会展示 diff 并请求确认——你可以批准、拒绝，或直接输入反馈让它调整方向。它不会在未经允许的情况下改动你的代码。
第三步：执行一条命令
Kimi Code CLI 也可以运行 Shell 命令并分析结果：
到这里，你已经体验了三个核心能力：提问理解、修改代码、执行命令。
如果项目中没有 AGENTS.md 文件，可以运行 /init 命令让 Kimi Code CLI 分析项目并生成该文件，帮助 AI 更好地理解项目结构和规范。
常用命令速查
常见问题
我填了 API Key 怎么提示鉴权失败
先确认你用的 Key 和 Base URL 是不是同一个平台的。api.kimi.com 和 api.moonshot.cn 是两个完全独立的账号体系，API Key 互不通用：
安装后 kimi 命令找不到
安装脚本会将 kimi 添加到 PATH，但需要重启终端或执行 source ~/.bashrc（或 source ~/.zshrc）才能生效。如果仍然找不到，检查 ~/.local/bin 是否在你的 PATH 中。
/login 后浏览器没有弹出
如果在远程服务器或无图形界面的环境中，/login 会显示一个 URL，手动复制到浏览器打开即可完成授权。
更多问题请参考常见问题。
升级与卸载
升级到最新版本：
卸载 Kimi Code CLI：