Kimi Code CLI

Kimi Code CLI 是一个运行在终端内的 AI Agent，专为软件开发任务设计。它能理解项目结构、编写/修改代码、执行 Shell 命令、抓取网页，并在执行过程中自主规划、调试与调整行动——就像一位随时待命的编程协作者。

目前处于技术预览阶段，支持自然语言交互与 Shell 混合操作，同时可通过 Agent Client Protocol 集成到 IDE 或其他本地 Agent 客户端。

适用场景

• 代码开发：实现新功能、修复 Bug、重构逻辑
• 项目理解：快速探索陌生代码库，解答架构与实现问题
• 自动化运维：批量处理文件、运行测试、执行构建脚本

✅ 无需离开终端，用自然语言描述需求即可触发完整工作流。

快速安装

Linux / macOS

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

Windows (PowerShell)

Invoke-RestMethod https://code.kimi.com/install.ps1 | Invoke-Expression

脚本会自动安装 uv（Python 包管理工具）并部署 kimi-cli。
支持 Python 3.12–3.14，推荐使用 3.13 以获得最佳兼容性。

验证安装

kimi --version

⚠️ macOS 用户注意：首次运行可能较慢，因系统需验证二进制文件。可在「系统设置 → 隐私与安全性 → 开发者工具」中授权终端应用以加速后续启动。

首次使用

1. 进入你的项目目录：

   cd your-project
   kimi
   

2. 配置 API 来源（二选一）：

   方式一：登录 Kimi 账号（推荐）

   /login
   

   自动打开浏览器完成授权，配置将自动生效。

   方式二：手动配置 API 密钥

   /setup
   

   按提示选择平台（如 Moonshot AI）、输入密钥、指定模型。

3. 开始对话：

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

提升体验的小技巧

• 初始化项目认知：
  若项目无 AGENTS.md，运行 /init 让 AI 分析代码库并生成规范文件，显著提升上下文理解能力。
• 查看帮助：
  输入 /help 获取所有斜杠命令（如 /shell 切换 Shell 模式、/undo 撤销操作等）。
• 混合操作：
  可随时在自然语言与 Shell 命令间切换，例如：

  先运行 npm test，如果失败就帮我定位报错文件
  

管理版本

• 升级：

  uv tool upgrade kimi-cli --no-cache
  

• 卸载：

  uv tool uninstall kimi-cli
  

技术说明

• 协议支持：兼容 Agent Client Protocol，可集成至 VSCode、Cursor、Zed 等编辑器
• 安全设计：所有代码操作均在本地执行，AI 仅生成建议，需用户确认后才写入文件
• 隐私保障：代码不上传云端，API 通信仅用于模型推理