字节笔记本

2026年2月22日

Kimi Code CLI:Moonshot AI 开源的终端 AI 智能体工具

本文介绍 Kimi Code CLI,一个由 Moonshot AI 开发的终端 AI 智能体工具,帮助开发者在命令行中完成软件开发任务和终端操作。

项目简介

Kimi Code CLI(简称 kimi-cli)是一个运行在终端中的 AI 智能体,能够读取和编辑代码、执行 shell 命令、搜索和获取网页内容,并在执行过程中自主规划和调整操作。该项目在 GitHub 上已获得 6.6k+ stars,是一个活跃的开源项目。

该项目采用 Python 开发,支持多种集成方式,包括 VS Code 扩展、IDE 通过 ACP 协议集成、Zsh 集成以及 MCP(Model Context Protocol)支持。

核心特性

  • 代码编辑与阅读:智能读取和修改代码文件,支持多种编程语言
  • Shell 命令执行:直接在终端中执行命令,无需离开 CLI 环境
  • 网页搜索与获取:自动搜索网络资源并获取网页内容
  • 自主规划执行:AI 自主规划任务步骤并根据执行结果调整策略
  • 多代理协作:支持创建子代理处理特定任务
  • 工具扩展:通过 MCP 协议扩展功能,支持多种第三方工具

安装指南

前置要求

  • Python >= 3.10
  • pip 或 uv 包管理器

安装步骤

bash
# 使用 pip 安装
pip install kimi-cli

# 或使用 uv(推荐)
uv tool install kimi-cli

配置 API 密钥

bash
export KIMI_API_KEY="your-api-key"

快速开始

启动 Kimi Code CLI:

bash
kimi

常用命令

bash
# 启动交互式会话
kimi

# 执行单条命令
kimi "分析当前目录的代码结构"

# 使用特定模型
kimi --model kimi-k2-0711-preview

# 查看帮助
kimi --help

Shell 命令模式

Ctrl-X 切换到 shell 模式,直接运行命令而无需退出 Kimi Code CLI。

Agent 配置详解

Kimi Code CLI 的 Agent 配置位于 src/kimi_cli/agents/default/agent.yaml,定义了默认代理的行为和能力:

yaml
version: 1
agent:
  name: ""
  system_prompt_path: ./system.md
  system_prompt_args:
    ROLE_ADDITIONAL: ""
  tools:
    - "kimi_cli.tools.multiagent:Task"
    - "kimi_cli.tools.todo:SetTodoList"
    - "kimi_cli.tools.shell:Shell"
    - "kimi_cli.tools.file:ReadFile"
    - "kimi_cli.tools.file:ReadMediaFile"
    - "kimi_cli.tools.file:Glob"
    - "kimi_cli.tools.file:Grep"
    - "kimi_cli.tools.file:WriteFile"
    - "kimi_cli.tools.file:StrReplaceFile"
    - "kimi_cli.tools.web:SearchWeb"
    - "kimi_cli.tools.web:FetchURL"
  subagents:
    coder:
      path: ./sub.yaml
      description: "Good at general software engineering tasks."

工具说明

工具功能
Task多代理任务管理
SetTodoList设置待办事项列表
Shell执行 shell 命令
ReadFile读取文件内容
ReadMediaFile读取图片/视频文件
Glob文件模式匹配
Grep文件内容搜索
WriteFile写入文件
StrReplaceFile字符串替换
SearchWeb网络搜索
FetchURL获取网页内容

IDE 集成

VS Code 扩展

安装 Kimi Code VS Code Extension 即可在编辑器中使用。

ACP 协议集成

支持 Agent Client Protocol,可与 Zed、JetBrains 等编辑器集成:

bash
kimi acp

配置示例:

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

MCP 支持

Kimi Code CLI 支持 Model Context Protocol,可扩展功能:

bash
# 添加 HTTP MCP 服务器
kimi mcp add --transport http context7 https://mcp.context7.com/mcp \
  --header "CONTEXT7_API_KEY: ctx7sk-your-key"

# 添加 stdio MCP 服务器
kimi mcp add --transport stdio chrome-devtools -- \
  npx chrome-devtools-mcp@latest

# 列出已添加的服务器
kimi mcp list

# 移除服务器
kimi mcp remove chrome-devtools

开发指南

bash
# 克隆仓库
git clone https://github.com/MoonshotAI/kimi-cli.git
cd kimi-cli

# 准备开发环境
make prepare

# 运行 CLI
uv run kimi

# 代码格式化
make format

# 运行检查
make check

# 运行测试
make test

项目链接

分享: