VSCode Multi-Agent指南：适合IDE选手的AI开发团队搭建
公众号名称：AI编程实验室
作者名称：鲁工
发布时间：2026-02-26 10:43
大家好，我是鲁工。
自从习惯使用CLI之后，很久都没有用过VSCode写代码了。VSCode作为我这么多年的主力IDE工具，现在我只拿来看md文档用。
最近把VSCode做了大升级，主打Multi-Agent开发。打开Chat面板的时候发现Agent选项突然多了不少东西。
除了之前熟悉的Agent、Plan、Ask这几个模式，还冒出了Background、Cloud，甚至连Claude和Codex都出现在了选项里。
作为一个喜欢折腾AI编程工具的博主，看到VSCode这次推出的Multi-Agent开发模式，第一反应是：这是要把所有AI编程Agent都收编到一起？
感觉有点意思，我顺手翻了一下VSCode官方文档，又实际动手摸索了下，也算是把这套架构基本搞明白了。这篇就聊聊VSCode这个Multi-Agent到底是咋玩的。
年前我就写了一篇在Claude Code中调用Codex做开发执行的文章：终极效率方案：使用Claude Code + Opus 4.6与Codex + GPT-5.3-Codex组合开发，现在算是把VSCode的Multi-Agent方案补上。
VSCode Multi-Agent
先说核心概念。VSCode目前把Agent分成了三大类：Local、Background和Cloud。
Local Agent就是之前大家最熟悉的模式，直接在VSCode里交互对话。它细分了三个子模式。Agent模式负责自主完成复杂编码任务，会自己决定读哪些文件、改哪些代码。Plan模式专门做规划，先问清楚需求再动手。Ask模式是只读的，帮你搜索代码库回答问题，但不会直接改文件。
Background Agent是这次比较有意思的一个角色。简单来说就是Copilot CLI跑在后台，它会自动创建一个Git worktree（简单理解就是你项目的一个独立工作副本），在里面悄悄干活，不会影响你当前正在编辑的代码。你可以同时开好几个Background Agent，各干各的，互不干扰。
Cloud Agent则是跑在GitHub远程服务器上的，最终产出是一个Pull Request。适合那种不需要你盯着看、可以放手让AI去跑的大任务，比如大规模重构或者按照现成方案实现一个完整功能。
VSCode的三个Agent可以用一张表进行总结：
| 维度 | Local | Background | Cloud |
|---|---|---|---|
| 运行位置 | 本机VSCode内 | 本机后台CLI | GitHub远程服务器 |
| 交互方式 | 实时对话 | 无人值守 | 无人值守 |
| 工作空间 | 本地当前目录 | Git worktree | 远程沙箱 |
| 编辑器感知 | 有 | 无 | 无 |
| 产出形式 | 直接改代码 | worktree变更需手动Apply | Pull Request |
模型选择方面，Local Agent最灵活，Chat面板里的Model Picker可以选Copilot提供的所有模型，GPT-5.2、Claude Opus 4.6这些都能选。Background Agent受限一些，只能用CLI支持的模型，不过也都支持大部分前沿模型。Cloud Agent创建会话时也有模型选择，但取决于云端的可用配置。
Handoff实操：Agent任务转交
聊完了三种Agent，再说说它们之间怎么协作。
VSCode这套多Agent架构最核心的设计，其实是会话转交（Handoff）机制。官方Tutorial里演示了一个很典型的工作流：先用Plan Agent规划一个”深色/浅色主题切换”功能，讨论清楚需求和方案后，一键转交给Background Agent去执行。
官方Tutorial：
https://code.visualstudio.com/docs/copilot/agents/agents-tutorial
操作也不复杂。在Chat面板输入框左下角有个Session Type下拉，选择你想转交的目标类型就行。VSCode会创建一个新会话，把之前的对话历史和上下文完整带过去，原来的会话自动归档。
比如，我这里将Local Agent下完全的PRD文档，转交给Background Agent在后台做开发执行。
但是将Local Agent转交给Cloud Agent的话，有一个注意事项：
就是要先关联远程仓库。Cloud Agent跑在GitHub远程服务器上，最终要创建PR，所以它需要你的项目有一个关联好的GitHub远程仓库。如果你的项目只是本地Git仓库、没push到GitHub，Cloud Agent压根用不了。
转交给Background Agent就顺畅多了。它会自动创建一个Git worktree在里面独立工作，你可以在Sessions视图里看进度。完成后review变更，觉得没问题就Apply到主工作区。整个体验也会比较丝滑。
这里补充一下，目前Handoff的路径是有方向性的。Local可以转Background和Cloud，Background可以通过/delegate命令转给Cloud，Plan Agent有专门的Continue in Cloud按钮。但反过来不行，Cloud和Background转不回Local。
聊完了GitHub Copilot自家的三种Agent协作，再看看第三方外援。
VSCode这次更新的另一个亮点是把Claude和Codex作为第三方Agent集成了进来。新建会话的时候，下拉列表里直接能看到Claude和Codex的选项，可以当作Local Agent启动，Claude Agent基于Anthropic的Agent SDK，Codex Agent基于OpenAI的引擎。
但这里有个容易混淆的地方。以Claude Code为例，它在VSCode里其实有两套存在形式：一套是VSCode统一接口集成的Agent（走Copilot订阅计费），另一套是Anthropic官方的Claude Code独立插件（走Claude自己的计费）。如果在Chat面板里直接对话，那是走VSCode统一接口，如果使用Claude Code for VSCode插件，那是Claude官方的入口。
我还试了个操作：在Local Agent会话中转交给Cloud Agent后，想选Claude或Codex来执行。按文档，Cloud会话创建后应该有一个Partner Agent下拉框来选择Provider。但我实际操作的时候，没找到这个下拉框。
查了一圈文档后发现，这个功能的门槛其实不低。你的Copilot订阅得是Pro+或Enterprise级别，普通Pro不行。然后还得去GitHub设置页面手动开启Claude和Codex的支持。因为Copilot不是我的主力工具，所以我也就没继续升级订阅了。
开启第三方Agent设置入口：
https://github.com/settings/copilot/coding\_agent
自定义Agent才是大杀器
前面说的都是VSCode内置的Agent和第三方集成。但我觉得这套多Agent架构里最有想象力的部分，其实是自定义Agent。
做法很简单：在项目的 .github/agents/ 目录下创建 .agent.md 文件，每个文件就是一个Agent。文件由YAML frontmatter和Markdown正文两部分组成，frontmatter定义工具权限、模型选择和Handoff目标，正文是具体的行为指令。
举个例子，一个规划Agent可以这样写：
---
description: Generate an implementation plan
tools: ['search', 'fetch']
handoffs:
- label: Start Implementation
agent: implementation
prompt: Now implement the plan outlined above.
send: false
model: GPT-5.2 (copilot)
---这个Agent只有search和fetch权限（只读），生成计划后会出现一个Start Implementation按钮，点击后自动跳转到implementation Agent，把计划内容带过去继续执行。
我们完全可以搭建一套Plan、Implement、Review三段式工作流。规划Agent负责需求分析和方案设计，实现Agent拿到计划后动手编码，审查Agent对实现结果做Code Review。每一步之间通过Handoff衔接，开发者在每个节点都可以review和干预。
另外一个比较有意思的能力是并行子Agent（Parallel Subagents）。每个子Agent运行在独立的上下文窗口里，不会占用主Agent的token额度。你可以同时派出一个Agent搜索相关代码，另一个Agent查阅文档，还有一个Agent分析依赖关系，三线并进。
还有个细节，.claude/agents/目录下的Agent文件也能被VSCode识别，Claude特定的工具名会自动映射到VSCode对应的工具。这意味着你写的Agent定义可以同时在VSCode和Claude Code两个环境下使用，不用维护两套。
到此为止，VSCode这套Multi-Agent架构的核心内容基本聊完了。
VSCode做的事情，本质上是把自己从代码编辑器变成了一个Agent编排平台，这也符合现在Agent Coding的趋势。Local、Background、Cloud三层架构覆盖了从交互式开发到异步执行到团队协作的完整链路，自定义Agent和Handoff机制提供了可编程的工作流能力。
但目前还处于比较早期的阶段。Cloud Agent需要GitHub远程仓库这个硬前提，第三方Agent集成需要Pro+订阅，Partner Agent的UI交互也不够直观。Background Agent的Git worktree机制虽然思路不错，但根据公开信息也出过一天创建上千个worktree的bug。
如果VSCode + Copilot是你的主力工具，甚至说你已经在用Copilot Pro+或Enterprise，我觉得这套Multi-Agent架构花点时间上手，特别是自定义Agent和Handoff工作流，对有你现有开发效率和产出会有质的提升。
感谢您阅读我的文章。我是鲁工，九年AI算法老兵，AI全栈开发者，深耕AI编程赛道。感兴趣的朋友也可以加我微信（louwill_）交个朋友。
>/ 作者：鲁工
Original 鲁工 AI编程实验室
修改于
内容效果不满意？点此反馈