BAIZE AI RESOURCE

VS Code 中的 Agent Client Protocol 客户端,连接多种 AI 编程智能体

vscode-acp

在 VS Code 内统一连接和使用多种 ACP 编程智能体的客户端扩展

vscode-acp

资源介绍

ACP Client 是一个 Visual Studio Code 扩展,为编辑器提供 Agent Client Protocol(ACP)客户端能力。它把原本分散在不同 CLI 工具中的 AI 编程智能体统一接入 VS Code:内置 GitHub Copilot、Claude Code、Gemini CLI、Qwen Code、Auggie CLI、Qoder CLI、Codex CLI、OpenCode、OpenClaw、Kiro CLI、Hermes Agent 共 11 种预配置智能体,也可在设置中自定义 command、args 和 env。扩展采用单智能体激活模式,同一时间只连接一个智能体,切换时自动断开。Agents 视图按智能体展开历史会话,支持 session/list 或本地按工作区缓存;聊天面板支持 Markdown 渲染、内联工具调用展示、可折叠的思考过程、斜杠命令自动补全,以及由智能体动态声明的会话配置选项(模式、模型、推理等级等)。智能体可读写工作区文件、执行终端命令,权限请求可通过 acp.autoApprovePermissions 配置为 ask 或 allowAll。协议流量可记录到 ACP Traffic 输出通道,便于调试。适合希望在 VS Code 内统一使用多种 ACP 兼容编程智能体的开发者。

插件能力

按智能体的会话列表

Agents 视图中每个智能体可展开显示历史会话,点击会话在聊天中恢复历史;智能体支持 session/list 时使用其分页结果,否则回退到按工作区的本地缓存,打开会话使用 session/load 或 session/resume。

会话配置选项动态渲染

智能体声明的每会话选择器(模式、模型、推理等级等)会自动渲染在聊天输入工具栏中;对尚未迁移的智能体保留旧版 Mode / Model 选择器作为回退。

交互式聊天与思考展示

内置聊天面板支持 Markdown 渲染、每轮可折叠的内联工具调用展示,以及带流式动画和耗时统计的可折叠思考过程块。

文件系统与终端集成

智能体可读写工作区文件,并可执行终端命令并在界面中显示输出;权限请求由 acp.autoApprovePermissions 控制为 ask 或 allowAll。

协议流量日志

通过 acp.logTraffic 设置(默认开启)把全部 ACP JSON-RPC 消息写入 ACP Traffic 输出通道,并按 request、response、notification 标注消息类型,方便在 VS Code 中排查与 ACP 兼容 AI 编码代理之间的通信问题。

资源配置

插件类型

IDE插件

支持平台

VS Code

插件格式

Source Code

安装方式

应用商店安装源码安装

使用要求 / 配置要求

需安装 Node.js 18+(用于启动 agent 进程),并安装或通过 npx 提供 ACP 兼容的 agent。可在设置中配置 acp.agents 等选项。

安装与配置

  1. 在 VS Code 中安装 ACP Client,并从 Agents 视图选择一个内置智能体,或在设置中填写自定义 command、args 和 env。

  2. 确认对应 CLI 已安装且能正常登录,再设置权限请求为逐次确认或按需自动允许。

  3. 新建或恢复会话,在聊天面板中说明代码任务;智能体可按授权读取文件和执行终端命令。

  4. 检查内联工具调用和代码改动;连接异常时打开 ACP Traffic 输出查看协议消息。

使用案例

在 VS Code 内使用 Claude Code

使用场景开发者希望在编辑器内直接调用 Claude Code 智能体

使用默认配置 npx @agentclientprotocol/claude-agent-acp@latest 连接 Claude Code,在聊天面板中发送提示,智能体可读写工作区文件并执行终端命令。

恢复历史会话

使用场景需要继续之前与某个智能体的对话

在 Agents 视图中展开对应智能体,点击历史会话即可通过 session/load 或 session/resume 将历史回放到聊天面板中继续对话。

调试 ACP 通信

使用场景智能体连接或响应异常,需要查看底层协议消息

执行 ACP: Show Protocol Traffic 打开 ACP Traffic 输出通道,查看带 request / response / notification 标签的 JSON-RPC 消息。

包含内容

vscode-acp-source.zip
README-中文安装说明.md
LICENSE-MIT.txt
SHA256.txt