在VS Code中集成多AI助手：ACP Client扩展配置与使用指南

近期，开发者们对于在集成开发环境（IDE）中直接调用不同人工智能模型进行代码辅助的需求日益增长。开源项目ACP UI因其对Agent Client Protocol（ACP）的支持，被正式列入ACP官网的推荐客户端列表。官网页面显示，ACP UI与Agent Studio、Agmente (iOS)、AionUi、aizen、DeepChat等一同被列为支持ACP协议的客户端。

对于开发者而言，ACP协议不仅支持通信，更推荐客户端实现终端（Terminals）与文件系统（File System）API，以解锁更强大的AI编程能力。考虑到VS Code原生就具备强大的终端管理和文件系统访问能力，并对外暴露了丰富的扩展API，基于此开发一个ACP Client扩展成为了一个高效的选择。

VS Code ACP Client 扩展

通过在VS Code中安装此扩展，开发者可以将多个AI助手直接集成到日常编码环境中。其核心特性包括：

• 多代理支持：可连接到8个预配置的ACP代理（如GitHub Copilot、Claude Code、Gemini CLI等），或根据需求添加自定义代理。
• 单代理焦点：一次仅激活一个代理，但可以在不同代理间无缝切换。
• 交互式聊天：内置聊天面板，支持Markdown渲染、内联工具调用显示以及可折叠的工具部分。
• 模式与模型选择器：可直接从聊天工具栏切换代理的工作模式和具体模型。
• 文件系统集成：代理被授权读取和写入工作区内的文件。
• 终端执行：代理可以在集成的终端中运行命令，并将输出实时显示在聊天中。
• 权限管理：可配置自动批准策略，以管理代理执行特定操作（如文件写入、终端命令执行）的权限。
• 协议流量日志：可以审查所有ACP JSON-RPC消息，并带有请求/响应/通知的标签。
• 代理注册中心：浏览和发现可用的ACP代理。
• 聊天持久化：切换编辑器面板时，对话内容会被保留。

安装与基础使用

该扩展已在Visual Studio Code市场中上架，可通过以下地址查找安装：marketplace.visualstudio.com/items?itemName=formulahendry.acp-client

安装完成后，侧边栏会新增“ACP”面板。开发者可以在此面板中选择并连接一个AI代理。连接成功后，扩展会激活一个内置的聊天视图。用户可以在此视图中直接与AI代理对话，请求代码生成、解释或调试等任务。

实际应用场景示例

假设开发者需要实现一个快速排序算法。可以在聊天面板中向已连接的AI代理（例如Claude Opus）发出指令：“please create a qsor.js”。AI代理会根据请求生成相应的代码文件。

以下是一个由AI生成的QuickSort实现示例：

/* QuickSort implementation in Javascript */
/**
 * Sorts an array using the QuickSort algorithm
 * @param {Array} arr - The array to sort
 * @returns {Array} - The sorted array
 */
function quickSort(arr) {
  if (arr.length <= 1) {
    return arr;
  }
  const pivot = arr[Math.floor(arr.length / 2)];
  const left = [];
  const middle = [];
  const right = [];
  for (const element of arr) {
    if (element < pivot) {
      left.push(...items: element);
    } else if (element > pivot) {
      right.push(...items: element);
    } else {
      middle.push(...items: element);
    }
  }
  return [...quickSort(arr: left), ...middle, ...quickSort(arr: right)];
}

在此过程中，扩展会作为客户端，通过ACP协议与AI代理进行JSON-RPC通信。开发者可以在“ACP Traffic”输出面板中看到详细的通信日志，例如：

[2026-02-08T09:27:14.973Z] <<< AGENT → CLIENT [RESPONSE] id=4
{"jsonrpc": "2.0", "id": 4, "result": { "stopReason": "end_turn" }}

这表明代理已经完成了一次回复并结束了本轮对话。整个交互过程，从请求发出到文件创建和代码生成，均在VS Code环境内部完成，无需切换应用。

总结

这款VS Code ACP Client扩展将多个主流AI编程助手的能力无缝整合到了开发者最熟悉的编辑器中。它充分利用了VS Code的终端和文件系统API，通过标准的ACP协议与AI后端通信，实现了真正意义上的IDE原生AI编程体验。无论是快速生成代码片段、解释复杂逻辑还是执行脚本测试，都能在一个集成的环境中高效完成。该项目的代码已在GitHub上开源，供社区研究和改进。

参考资料

[1] VS Code 的 ACP Client 扩展来啦！连上 Claude, Gemini, Codex, OpenCode, Qwen Code 等 AI Agent, 微信公众号：mp.weixin.qq.com/s/73LxMVw_xY6S6lUZf99rZw

版权声明：本文由 云栈社区 整理发布，版权归原作者所有。