VS Code 多 Agent 工作台
把 Claude Code、Codex、Pi Agent 装进同一个 VS Code，三个 Agent 共享同一份项目文件和工单 —— 这是目前 Vibe Coding 最舒服的多 Agent 协作方式。
简介
VS Code 多 Agent 工作台是小普在实测多种工具后总结的五步搭建方案。核心理念：VS Code 本质是一个容器，其 Extension 市场里有几万个插件，Claude Code、Codex、Pi Agent 等都有对应插件。把它们装进同一个编辑器，三个 Agent 共享同一份项目文件和工单，不需要在多个窗口之间来回切换。
五步搭建流程
第一步：安装 VS Code
去 code.visualstudio.com 下载对应系统的安装包。装好之后打开扩展市场（快捷键 Ctrl+Shift+X，Mac 上是 Cmd+Shift+X），搜索 Chinese (Simplified) (简体中文) Language Pack for Visual Studio Code，安装之后重启，界面切换为中文。
第二步：接入 Claude Code
在扩展市场搜索 Claude Code for VS Code，点安装。安装完成后按引导用 claude.ai 账号登录授权。左侧边栏会出现 Claude Code 的入口，点进去是聊天面板，可以直接对话，也可以在编辑器里选中代码后唤起它。
第三步：接入 Codex
在扩展市场搜索 Codex – OpenAI's coding agent，点安装。用 ChatGPT Plus 及以上账号登录，侧边栏有对应入口。
第四步：接入 Pi Agent
Pi Agent 原本是终端工具，VS Code 市场中没有官方插件，但有两个独立开发者做的插件。实测推荐 Pendant（Pendant – Pi Agent for VS Code）。
- 如果未在终端安装 Pi Agent 框架：选择插件的”内置 Pi Agent”选项
- 如果已在终端安装：选择”外部”即可
- 模型配置：首次使用点击对话框里的登录，弹出模型厂商配置选项，可搭配 Kimi 3 等模型
第五步：打通上下文 —— 最高指令软链接法
三个 Agent 各读各的配置：Claude Code 读 CLAUDE.md，Codex 读 AGENTS.md，Pi Agent 两个都能读。如果不做统一，三个 Agent 对项目的理解是割裂的。
解决方案：
- 在项目根目录新建
COLLABORATION.md，写入所有 Agent 都必须遵守的共识 —— 技术栈约定、文件命名规范、哪些文件不能动、管理方式 - 在 CLAUDE.md 首句加入
@COLLABORATION.md引用 - 在 AGENTS.md 首句同样引入 COLLABORATION.md
- Claude Code 支持在 CLAUDE.md 中用
@文件路径引用其他文件，Codex 对 AGENTS.md 有类似机制
效果：三个 Agent 启动时都先读一遍最高指令 COLLABORATION.md，再读各自的专属项目文件，变相实现跨 Agent 上下文共享。只需维护一份 COLLABORATION.md，即可让多个 AI 工具无缝衔接。
实际工作流
- 新项目用 Claude Code 搭架构，同时落好 COLLABORATION.md 和 CLAUDE.md
- 项目有了基础后，精细微调切 Codex
- 自定义工作流走 Pi Agent
至此，整个项目空间的协作链路和框架搭建完成。
与 Agent 选型四步法的关系
VS Code 多 Agent 工作台是 Agent 选型四步法 落地的物理载体。四步法解决了”选什么工具、按什么分工”，工作台解决了”多个工具怎么在同一空间里共存、怎么共享上下文”。