Pi Agent Studio 上架：把 coding agent 塞进 VS Code 原生终端

Pi Agent Studio 来了，这次不是套壳

今天，People of pi 把 Pi Agent Studio 正式推上了 VS Code Marketplace。听起来又是一个 coding agent 扩展？别急着划走——这玩意儿的做法跟市面上大多数 IDE 内嵌 agent 都不一样。

一句话总结：Pi 没有给自己套一层 webview UI，而是直接跑在 VS Code 的内置终端里，用的是原生 PTY，零中间层。

这在体验上的差别，写过 IDE 插件的人秒懂。绝大多数所谓"深度集成"的 AI 编程工具，本质上是在 VS Code 里开一个 iframe，把 Web 版的 chat 界面塞进来，再通过 message passing 跟编辑器通信。好处是 UI 漂亮、迭代快；代价是渲染、快捷键、剪贴板、ANSI 转义……处处别扭。Pi 这次走的是另一条路：你打开终端，输入 pi，agent 在 TUI 里跑起来，跟你平时用 tmux + Neovim + 一堆 CLI 工具的感觉一致。

为什么要把 agent 放回终端

这两年 AI 编程工具的演化路径基本是一条直线：从 Copilot 那种行内补全，到 Cursor/Windsurf 这种全 IDE 重写，再到 Claude Code、Aider、Pi 这一波 CLI agent 回潮。

回潮不是偶然。CLI 形态的 agent 有几个 GUI 怎么追都追不上的优势：

• 没有渲染开销，几百兆的 Electron 不用了
• 天然组合，可以 pipe，可以塞进 CI，可以 ssh 进服务器跑
• 状态透明，输出就是日志，不存在"我也不知道它现在在干嘛"的黑盒感
• shell 即环境，agent 拿到的就是你 shell 的一切——别名、环境变量、虚拟环境、当前目录

但 CLI agent 也有个明显短板：跟编辑器是割裂的。你在 Neovim 里改代码，agent 在另一个终端窗口跑，想把当前选中的代码块、当前文件的诊断信息喂给它，要么手动复制粘贴，要么写一堆胶水脚本。

Pi Agent Studio 想解决的就是这个 last mile：让 CLI agent 的本体不变，但让它能感知到编辑器在做什么。

几个值得说的设计点

真·原生终端

这是 Pi 反复强调的一点：terminal is the product。Pi 跑在 VS Code 内置终端里，用的是 node-pty 那一套，不是用 xterm.js 模拟个壳子再把命令转发出去。结果就是 ANSI 颜色、光标位置、键盘快捷键、bracketed paste mode 这些细节全都正常工作。

用过那种自己实现 terminal emulator 的 webview agent 的人应该有共鸣——光是处理一下 Ctrl+C 的转义就够折腾半天。Pi 直接绕过了这个问题。

编辑器桥接（Editor Bridge）

这是这次发布最有意思的部分。Pi 的 TUI 里有一个状态栏，会实时显示：

• 当前打开的是哪个文件
• 光标在第几行第几列
• 文件的语言（TypeScript、Rust 还是 Python）
• 当前文件有多少 diagnostics（错误/警告）

这些信息是从 VS Code Extension API 实时同步过来的。换句话说，Pi 这个 CLI 进程现在能"看到"你在编辑器里干什么。

配合两个内置斜杠命令，玩法就出来了：

• /vscode-selection：把你在编辑器里选中的代码块精准注入对话
• /vscode-diagnostics：把当前文件的所有报错和警告打包丢给 agent

这种交互的关键在于人始终握着方向盘。不像某些 agent 自动把整个 workspace 喂进去，Pi 默认什么都不知道，你 /vscode-selection 一下它才看到选中那段。上下文窗口怎么花、token 怎么烧，开发者自己控制。

会话持久化

关掉 VS Code 再打开，Pi 会自动恢复之前的对话。这个功能听起来不起眼，但用过几次就回不去了——大部分 IDE 内嵌 agent 关窗就清零，重启等于失忆。Pi 把会话状态序列化到本地，下次打开 sessions 列表直接续上。

侧边栏管理

Pi 在 Activity Bar 里加了一个面板，分三块：

• Sessions：历史会话列表，点开就能恢复
• Models：当前配置的模型，可以快速切换
• Settings：Providers、OAuth、API Keys 一站式配置

模型这一块挺关键。Pi 本身是 model-agnostic 的，你接什么模型它都能跑——Claude、GPT、Gemini、DeepSeek、本地的 Qwen，全看你配。对于已经在用 OpenAI Hub 这类聚合网关的开发者来说，把 base_url 一改、key 一填，所有主流模型立刻能在 Pi 里调起来，不用再为每个模型注册一遍账号。

跟现有方案比一下

这个生态目前的几个主流选择：

| 工具 | 形态 | 集成方式 | 模型 | |------|------|----------|------| | GitHub Copilot Chat | IDE 内嵌 | 原生 | 主要是 Copilot 自家 + 少数第三方 | | Cursor | Fork 整个 IDE | 原生 | 自家网关 | | Claude Code | CLI | 独立终端 | 只能 Claude | | Aider | CLI | 独立终端 | 多模型 | | Pi Agent Studio | CLI + VS Code 扩展 | 终端 + 编辑器桥接 | 多模型 |

Pi 找的是一个之前没人占住的位置：CLI agent 的灵魂，IDE 的肉身。它没有像 Cursor 那样重做一个 IDE，也没有像 Claude Code 那样停留在纯 CLI，而是把 CLI agent 嵌进 VS Code 的终端，再用 Extension API 反向喂上下文。

有人会问，那跟 GitHub Copilot 的 agent 模式比呢？Copilot 是闭源、绑模型、UI 重；Pi 是开源、模型自由、TUI。一个像 IDE 厂商的官方答案，一个像 hacker 的自留地。社区里有个评价挺到位："如果 Claude Code 是 VS Code，那 Pi 就是 Neovim。" 自由度、可定制性、不被产品经理限制——但同时也意味着你得自己折腾。

一些可能踩坑的地方

聊点不那么甜的。

终端 TUI 的视觉表达力有上限。 Pi 选择 TUI 路线就意味着放弃了图片、富文本预览、复杂图表这些东西。如果你做的是前端、写 UI 组件，希望 agent 直接渲染出效果预览，那 Pi 不适合你。它更对口的是写后端、写脚本、改基础设施、做代码迁移这类工作。

编辑器桥接目前只覆盖了基础信号。 当前文件、选中、诊断——这些都是低带宽的元信息。如果想让 Pi 感知到整个 workspace 的符号索引、调用图、跨文件引用，还得自己用 ripgrep + tree-sitter 这套老办法在 TUI 里跑。当然这也符合 Pi 的设计哲学：明确的、可控的上下文，比模糊的、自动注入的上下文更安全。

生态还在早期。 跟 Claude Code 那种官方 first-party 出品比，Pi 的插件、配置文件、命令体系都还在演进。Marketplace 上同时还能看到几个相关项目，比如 tintinweb/vscode-pi-model-chat-provider 把 Pi 暴露成 VS Code Language Model Provider，让 Copilot Chat 也能用 Pi 跑——生态在自发地长。

怎么上手

基本步骤：

# 1. 安装 Pi CLI
npm install -g @pi-agent/cli

# 2. 在 VS Code Marketplace 搜索 "Pi Agent Studio" 安装扩展

# 3. 配置 provider（侧边栏 Settings 里填 base_url 和 key）

# 4. 打开 VS Code 内置终端
pi

第一次跑会让你选模型和 provider。如果是用聚合网关，base_url 指过去就行，OpenAI 兼容格式 Pi 直接吃。

常用的几个命令记一下：

• /vscode-selection：注入当前选中代码
• /vscode-diagnostics：注入当前文件诊断
• /model：切换当前会话用的模型
• /sessions：列出历史会话

写在最后

Pi Agent Studio 的发布有点像给"CLI agent + IDE"这个组合找到了一个标准答案。它没有重新发明轮子，但把几个被业界长期忽略的细节做对了：原生终端而不是 webview、显式上下文注入而不是自动吸取、会话持久化而不是关窗即失忆。

如果你已经习惯了 Cursor 那种 all-in-one 的体验，Pi 可能会让你觉得朴素得有点反潮流。但如果你是那种宁可自己拼 Neovim + tmux + ripgrep 也不愿意被 IDE 框住的人，这个东西基本就是为你做的。

扩展和 CLI 都是开源免费的，Marketplace 上架了，macOS / Windows / Linux 全平台支持。值得花十分钟装上试试。

参考来源

• 在 VS Code 中深度集成 Pi Agent 经验分享 - linux.do — 社区里关于 Pi Agent Studio 集成体验的讨论帖
• Zetaphor/pi-vscode-extension - GitHub — Pi VS Code 扩展的另一个社区实现，可对照参考实现思路