moonshotai/kimi-code · 上手攻略

仓库：moonshotai/kimi-code
链接：https://github.com/MoonshotAI/kimi-code
分类：ai（agent）
作者：Jay
更新：2026-07-11

🎯 是什么

Kimi Code CLI 是月之暗面（Moonshot AI）开源的终端 AI 编程 Agent——在终端里运行的 AI 助手，能读代码、改代码、执行 Shell 命令、搜索文件、抓取网页，并根据反馈自主规划下一步操作。它开箱即用地支持 Kimi 模型，也可自行配置其他兼容 provider。

定位上，它介于 Cursor/Windsurf 这类 IDE Agent 和纯 CLI 脚本之间：既拥有 IDE 级工具调用能力，又保持终端的轻量与速度。最大的特色是视频输入（丢一个录屏进去 Agent 就能理解上下文）和 MCP 原生支持（在对话里用 /mcp-config 动态配置 MCP 服务器）。

🧩 解决什么问题

项目探索：面对陌生代码库，让 Agent 自己读目录结构、关键文件，解释架构
代码编写：实现功能、修复 Bug、重构，全流程 Agent 自己规划、执行、跑测试
批量自动化：批处理文件、跑构建脚本、串联多个脚本
跨编辑器集成：通过 ACP（Agent Client Protocol）接入 Zed、JetBrains，用 IDE 里的 Agent 面板驱动 Kimi Code

⚡ 快速安装

macOS / Linux（一键脚本，无需 Node.js）

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

Windows（PowerShell）

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

Windows 用户需先装 Git for Windows，Kimi Code CLI 依赖其内置的 Git Bash 作为 Shell 环境。

Homebrew

brew install kimi-code

npm 全局安装（需 Node.js ≥ 22.19.0）

npm install -g @moonshot-ai/kimi-code
# 或
pnpm add -g @moonshot-ai/kimi-code

安装后验证版本：

kimi --version

🔥 核心用法

启动交互会话

cd your-project
kimi

首次运行输入 /login，选择 Kimi Code OAuth（设备码登录）或填入 Moonshot AI 开放平台 API Key：

/login

非交互单次任务（`-p` 参数）

kimi -p "Take a look at this project's directory structure"

恢复上次会话（`-c` 参数）

kimi -c

常用会话命令

命令	说明
`/new`	新建会话，清除当前上下文
`/sessions`	浏览历史会话，选择一个继续
`/model`	切换当前模型
`/compact`	手动压缩上下文释放 token
`/fork`	分叉当前会话，保留历史独立继续
`/mcp-config`	动态配置 MCP 服务器（对话中操作，无需改 JSON）
`/logout`	登出，清除凭证

在 Zed 编辑器里使用（ACP 协议）

在 ~/.config/zed/settings.json 加入：

{
  "agent_servers": {
    "Kimi Code CLI": {
      "type": "custom",
      "command": "kimi",
      "args": ["acp"],
      "env": {}
    }
  }
}

然后在 Zed 的 Agent 面板新建对话即可。JetBrains 详见官方文档。

MCP 配置（对话式，无需手写 JSON）

/mcp-config

然后在对话中描述你要添加的 MCP 服务器，Agent 会引导你完成认证。

升级与卸载

# 升级
kimi upgrade

# 或通过 npm
npm install -g @moonshot-ai/kimi-code@latest

# 卸载（脚本安装）
# 删除 kimi 可执行文件即可

# 卸载（npm 安装）
npm uninstall -g @moonshot-ai/kimi-code

📂 数据存储

本地数据默认存在 ~/.kimi-code/，包含配置文件、会话记录、日志和更新缓存。自定义路径：

export KIMI_CODE_HOME=/path/to/your/data

💡 典型适用场景

快速了解新项目：输入 kimi -p "Explain the main directories of this project"，秒得项目概览
功能开发：直接描述需求，Agent 规划步骤、改代码、跑测试一条龙
视频辅助 debug：把录屏丢进对话，Agent 看视频理解你的操作意图再帮你写代码
跨平台开发环境：TUI 界面在 Server 端跑，通过 ACP 在本地 IDE 操作
MCP 动态配置：在对话里用自然语言管理 MCP 服务器，不需要找配置文件

⚠️ 坑与注意

Windows 依赖 Git Bash：未装 Git for Windows 的 Windows 用户必须先安装，否则 Shell 相关工具不可用
需要长连接：TUI 是流式输出，网络不稳定时体验较差，建议配合 tmux 或直接用 -p 单次模式
模型依赖：默认用 Kimi 模型，国内访问需科学上网；也可配置 OpenAI 兼容接口（需自行验证兼容性）
工具调用需确认：修改文件、执行 Shell 等操作默认要人工确认，不要在 YOLO 模式下无人值守跑不信任的代码
上下文压缩：/compact 可手动压缩，但复杂长对话仍可能触及上下文上限，长任务建议定期开新会话

🔄 与同类对比

工具	定位	特色	不足
Kimi Code CLI	终端 AI 编程 Agent	视频输入、MCP 原生、TUI 轻快、ACP 协议	生态比 Claude Code/Cursor 弱
Claude Code	终端 AI 编程 Agent	生态完善、工具丰富	国内访问受限
Cursor/Windsurf	IDE 级 Agent	界面友好、上下文长	重量级，非 TUI
GitHub Copilot Chat	IDE 插件	深度 IDE 集成	偏辅助，非独立 Agent
Goose	终端 AI Agent	开源可扩展	功能比 Kimi Code 少

一句话推荐：如果你在国内、需要快速终端级 AI 编程体验，视频辅助和 MCP 动态配置是 Kimi Code 的独特卖点。

🏁 推荐结论

Kimi Code CLI 是一款轻量、跨平台、功能全面的终端 AI 编程 Agent，特别适合国内开发者。视频输入和 MCP 对话式配置是亮点，ACP 协议让 Zed/JetBrains 用户也能享受 Kimi 的能力。唯一需要注意的是 Windows 必须装 Git for Windows，Shell 操作依赖它。

对于追求轻量 TUI 体验、快速上手、不想折腾 Node.js 环境的用户，Kimi Code CLI 的一键安装脚本是很大的优势，比 Claude Code 的安装体验更顺滑。