kimichat 中文文档 下载 App

Kimi Code 在 Cursor、Zed、JetBrains 里的集成——ACP 协议

ACP 协议简介

ACP（Agent Client Protocol）是 Kimi 推出的开放协议，让任何 IDE 可以无缝接入 Kimi Code（或任何支持 ACP 的 Agent）。

核心理念：IDE 负责"编辑器 + 用户界面"，Agent 负责"推理 + 工具调用"，ACP 是两者之间的桥梁。

为什么需要 ACP

传统 AI 编程助手的做法是"每个 IDE 单独写一个扩展"：

ACP 统一了协议：IDE 实现 ACP 客户端 → Agent 实现 ACP 服务 → 一次实现、到处可用。

Cursor 集成

前置条件

配置步骤

  1. 在终端启动 Kimi Code ACP 服务：
   kimi acp

终端会输出 ACP 服务的连接信息（通常是 stdio 模式）

  1. 打开 Cursor 设置 → Features → ACP
  2. 点击"Add ACP Server"：
  1. 保存后 Cursor 会自动连接 Kimi Code ACP 服务

在 Cursor 里使用

配置好后，Cursor 的 AI Chat / Agent 面板里可以选择 Kimi Code 作为后端。用法和 Cursor 原生 AI 类似，但背后是 Kimi Code 在推理和执行。

Zed 集成

前置条件

配置步骤

Zed 原生支持 ACP，配置在 settings.json 里：

{
  "ai": {
    "agents": [
      {
        "name": "Kimi Code",
        "command": "kimi",
        "args": ["acp"]
      }
    ]
  }
}

保存后 Zed 会自动连接 Kimi Code。

在 Zed 里使用

Zed 的 AI Assistant 面板可以选择 Kimi Code。交互方式和 VS Code 扩展类似——快速引用文件、斜杠命令、diff 审查。

JetBrains IDE 集成（IntelliJ / PyCharm / WebStorm）

前置条件

配置步骤

  1. 在终端启动 Kimi Code ACP：
   kimi acp
  1. JetBrains IDE → 设置 → AI → ACP Servers → 添加
  2. 填写 Kimi Code ACP 服务的连接信息

在 JetBrains 里使用

AI Chat 插件面板里选择 Kimi Code，即可使用。支持：

Paseo 集成

Paseo 是 ACP 协议最早的实践者之一，原生支持 Kimi Code 集成。配置方式与 Zed 类似——在 settings.json 里添加 ACP server。

各 IDE 功能对比

功能VS Code 扩展CursorZedJetBrainsPaseo
快速引用文件（Alt+K）✅⚠️ 通过斜杠命令⚠️⚠️⚠️
斜杠命令✅✅✅✅✅
diff 审查✅ 原生集成✅⚠️⚠️⚠️
自动上下文✅ 自动✅✅✅✅
终端集成⚠️✅✅✅✅
自动 ACP 启动✅ 扩展管理❌ 需手动✅ 配置即自动❌ 需手动✅

推荐：

ACP 连接问题排查

问题：IDE 连不上 Kimi Code ACP

排查步骤：

  1. 终端手动跑 kimi acp → 看有没有报错
  2. 检查端口是否被占用（如果用 TCP 模式）
  3. 检查 Kimi Code CLI 版本（kimi upgrade 到最新）
  4. 检查登录状态（kimi login 重新登录）

问题：IDE 里看不到 Kimi Code 选项

排查步骤：

  1. ACP server 有没有正确添加
  2. ACP server 状态是 "Connected" 还是 "Disconnected"
  3. 重载 IDE 窗口 / 重启 IDE
  4. 看 IDE 日志有没有 ACP 相关错误

问题：部分功能不可用（比如 diff 审查）

这是正常的——不同 IDE 的 ACP 支持程度不同。VS Code 扩展功能最全，其他 IDE 通过 ACP 集成的功能会少一些。如果某个功能对你很重要，优先用 VS Code 官方扩展。

继续阅读