在 AI 编程工具飞速发展的今天，各种 AI 助手和编辑器层出不穷。为了解决“N 款编辑器 × M 款 AI 智能体”带来的繁琐适配问题，ACP 协议应运而生。

🌉 什么是 ACP 协议？智能体与 IDE 之间的桥梁

ACP（Agent Client Protocol，智能体客户端协议）是一套开放的标准化协议（基于 JSON-RPC），它的核心作用是将编辑器（Client）与 AI 智能体（Agent）解耦。

在 ACP 出现之前，如果你想用 Cursor 的 AI 能力，就必须使用 Cursor 编辑器；想用 JetBrains 的 AI，就得留在 IDEA 里。而 ACP 协议打破了这种封闭绑定：

• 对编辑器（如 IntelliJ IDEA）：它变成了一个“AI 代理编排中心”，只需支持 ACP 协议，就能接入市面上任何兼容该协议的 AI 智能体。
• 对 AI 智能体（如 OpenCode、Cursor Agent）：它们变成了独立的服务，专注于 LLM 推理与任务编排，不再需要为每个编辑器单独开发插件。

简单来说，ACP 就像 USB 接口一样，让开发者可以自由选择“编辑器 + AI”的组合，无需在多个工具间来回切换。

🛠️ IntelliJ IDEA 对接 OpenCode 完整示例

下面是在 IntelliJ IDEA 中通过 ACP 协议配置并对接 OpenCode（以连接本地大模型为例）的完整实战步骤：

1. 准备工作：安装 OpenCode 本地服务

首先，确保你的电脑上已经安装了 OpenCode 的本地服务（CLI 版本）。安装完成后，你可以在终端通过 where opencode (Windows) 或 which opencode (Mac/Linux) 查看其安装路径，后续配置会用到。

2. 在 IDEA 中配置 ACP 智能体

IntelliJ IDEA（2026.1 及更新版本）内置了对 ACP 协议的支持。

• 打开 IDEA，进入 AI Chat 或 AI Assistant 的设置界面。
• 找到并点击 Add custom agent（添加自定义智能体）。
• 此时系统会打开一个名为 acp.json 的配置文件。

3. 编辑 acp.json 配置文件

在 acp.json 中，我们需要告诉 IDEA 如何启动 OpenCode 并以 ACP 模式运行。请将以下配置填入文件中（注意替换为你实际的 OpenCode 路径）：

{
  "default_mcp_settings": {
    "use_idea_mcp": true,     // 启用 IDEA 内置 MCP，让 AI 能访问 IDE 功能
    "use_custom_mcp": true    // 允许使用自定义的 MCP 服务配置
  },
  "agent_servers": {
    "OpenCode": {             // 自定义的代理名称
      "command": "E:\\install\\npm\\opencode.cmd",  // 替换为你的 opencode 实际路径
      "args": ["acp"]         // 关键参数：表示以 ACP 模式运行
    }
  }
}

注：*command** 字段需填写你第一步中查到的 OpenCode 可执行文件的绝对路径。*

4. 配置 OpenCode 对接本地大模型（可选）

如果你希望 OpenCode 调用本地运行的大模型（例如通过 vLLM 或 Ollama 部署的 Qwen 模型），需要在 OpenCode 的项目根目录或全局配置中创建/编辑 opencode.json 文件：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "my_local_provider": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "qwen-local",
      "options": {
        "baseURL": "http://localhost:8000/v1" // 指向你本地大模型的服务端点
      },
      "models": {
        "Qwen3-4B-Instruct": {
          "name": "Qwen3-4B-Instruct" // 需与本地加载的模型名称一致
        }
      }
    }
  }
}

配置完成后，在项目目录下运行 opencode serve 启动服务，确保本地模型接口通畅。

5. 验证与使用

完成上述配置后，重启 IntelliJ IDEA。

• 在 AI 聊天窗口中，你应该能看到刚刚添加的 “OpenCode” 智能体。
• 选中它，输入一段代码指令（例如“帮我生成一个计算阶乘的 Java 方法”）。
• IDEA 会通过 ACP 协议将指令发送给 OpenCode，OpenCode 调用大模型处理后将结果返回给 IDEA 渲染。

通过以上步骤，你就成功利用 ACP 协议打通了 IDEA 与 OpenCode，享受高度自由且强大的 AI 辅助编程体验。