Kimi CLI 是类似 Claude Code 的命令行 AI 助手，基于 Kimi 模型，通过 uv 包管理器安装。支持 shell 命令执行（Ctrl-K）、MCP 工具接入、zsh 快捷调用、Zed 编辑器集成，以及 Agent SDK 的 Go/Node/Python 三语言支持。

Kimi CLI：命令行智能体工具

什么是 Kimi CLI

Kimi CLI 是 Moonshot AI 推出的命令行 AI 编程和文件处理工具，相当于 Kimi 版的 Claude Code。它直接运行在终端中，可以执行 shell 命令、处理文件、调用 MCP 工具。

与 Claude Code 对比：Kimi CLI 和 Claude Code 功能定位类似——都是终端内的 AI 编程助手。主要差异在模型（Kimi vs Claude）和生态集成深度上。Claude Code 与 VS Code 等 IDE 集成更完善，Kimi CLI 在魔搭 MCP 生态上有优势。

---

安装

支持系统：macOS、Linux

# 1. 安装 uv 包管理器
curl -LsSf https://astral.sh/uv/install.sh | sh

# 2. 安装 Kimi CLI（使用 Python 3.13）
uv tool install --python 3.13 kimi-cli

# 3. 验证安装
kimi --help

升级到最新版本：

uv tool upgrade kimi-cli --no-cache

---

初始配置

首次运行后执行 /setup 命令进行配置：

kimi         # 启动 Kimi CLI
/setup       # 配置 API Key 和模型

按提示输入：

• API Key：在 platform.kimi.com 获取
• 模型：推荐选择 kimi-k2.6（大上下文，更强能力）

---

Shell 模式

按 Ctrl-K 切换到 shell 模式，可以直接执行系统命令：

> Ctrl-K
$ ls -la ~/projects/

Shell 模式下 AI 可以读取命令输出并结合上下文给出建议，适合调试和文件操作场景。

---

Zsh 快捷调用

安装 zsh-kimi-cli 插件后，可以在任何地方用快捷键唤起 Kimi：

# 在 .zshrc 中添加（根据插件文档配置）
# 配置完后 source .zshrc 或重开终端

适合快速查询、命令补全等日常工作流。

---

MCP 工具接入

通过 --mcp-config-file 参数接入自定义 MCP 工具：

kimi --mcp-config-file /path/to/mcp.json

mcp.json 格式示例：

{
  "servers": {
    "my-tool": {
      "command": "node",
      "args": ["/path/to/mcp-server.js"]
    }
  }
}

---

Zed 编辑器集成

在 Zed 的 settings.json 中配置：

{
  "agent_servers": {
    "kimi": {
      "command": "kimi",
      "args": []
    }
  }
}

---

Kimi Agent SDK

如需在代码中嵌入 Agent 能力，可使用 Kimi Agent SDK，支持三种语言：

语言	获取方式
Python	pip install kimi-agent-sdk
Node.js	npm install kimi-agent-sdk
Go	go get github.com/MoonshotAI/kimi-agent-sdk

SDK 封装了多轮工具调用、状态管理等 Agent 基础能力，适合构建自定义 AI 工作流。

---

常见问题

Q: kimi 命令安装后找不到，提示 command not found？

A: uv 安装的工具默认在 ~/.local/bin/ 目录。确保该目录在 PATH 中：export PATH="$HOME/.local/bin:$PATH"，加入 .zshrc 或 .bashrc 永久生效。

Q: Kimi CLI 支持 Windows 吗？

A: 目前官方支持 macOS 和 Linux。Windows 用户可以通过 WSL2 使用。

Q: Kimi CLI 和直接用 API 有什么区别？

A: Kimi CLI 提供了开箱即用的对话界面、文件读取、shell 执行等能力；直接用 API 则完全自定义，更灵活。对于快速原型验证，CLI 更方便；对于集成到应用中，API 更合适。