Varro：OpenCode AI 编程工作台

30 秒速读：本篇讲的是这款扩展：一个 VS Code / VSCodium 扩展，把 OpenCode 的 AI 编程能力搬进编辑器——项目感知聊天、并行代理会话、计划与变更审查、权限控制、用量统计，都在侧边栏里完成。结论先行：已经在用 OpenCode 的人，装它等于给终端 TUI 配了个图形工作台；没用过 OpenCode 的人，先装 OpenCode 再谈它，它自己不带模型、不提供后端能力。

软件信息一览

版本选择：扩展市场安装还是源码构建

结论先行：绝大多数人直接在扩展市场装 Varro 就行，一点即装、自动更新；只有想改代码或尝鲜 main 分支的人才需要源码构建。注意”等稳定版”没有意义，项目本身就是滚动更新，商店里的就是当前版。

安装步骤

1. 在 VS Code 扩展市场搜索 Varro 安装（VSCodium 用户去 Open VSX 装同名扩展）。这是最不容易出错的一步。
2. 安装 OpenCode CLI：macOS、Linux 或 WSL 下执行 npm install -g @opencode/cli；原生 Windows 下载独立 CLI（据项目说明）。注意 Varro 依赖本地可用的 OpenCode v1 或 v2，它自己不带代理和模型。
3. 连接模型提供商：终端跑 opencode auth login，或直接在 Varro 里用 /connect 命令完成。
4. 关键卡点：OpenCode 可执行文件必须在 PATH 里。原生 Windows、WSL、容器里跑的 CLI 路径各不相同，配错这里工作台就永远连不上；找不到就去设置里搜 varro.server.command，填可执行文件的绝对路径。
5. 在 VS Code 里打开项目文件夹，点活动栏的 Varro 图标开始第一个会话，状态栏会显示当前连接的 OpenCode 版本（v1 还是 v2，一目了然）。

装完必改的 4 处设置

都在 VS Code 设置里搜 varro 前缀，改完体感差别明显：

1. varro.server.command：CLI 不在 PATH 时的救命项。体感差别：配错=工作台永远连不上转圈圈，配对=秒连。混用原生 Windows 和 WSL 的人最容易栽在这里，两边要分开配。
2. varro.chat.defaultPermissionMode：默认 Auto（用本地规则加可选模型自动判定，拿不准的交人工确认）。体感差别：日常用 Auto 最省心；跑 Ralph 循环这类长任务前切到 Full access，否则每一步操作都弹确认框，能把人点烦。
3. varro.notifications.native / .sound：桌面通知默认全关。体感差别：打开后，长任务跑完、需要审批、计划待评审时会有系统级提醒，不用一直盯着编辑器；macOS 11+ 还要在”系统设置 → 通知”里放行 Varro helper，Linux 需要装 notify-send。
4. varro.chat.promptCompletionModel：行内 AI 补全默认关闭，且需要 OpenCode v2。体感差别：开了之后打字停顿一下按 Tab 就能接受 AI 续写，写样板代码很爽；但它会直连模型产生 token 消耗，介意用量的人别开。

注意事项与常见问题

• Varro 和 OpenCode 是什么关系？OpenCode 负责代理、模型、MCP 服务器、技能等一切”后端”，Varro 只是 VS Code 里的”前端工作台”，读的是同一份 OpenCode 配置。卸载 Varro 不影响你的 OpenCode 配置和历史会话，两边配置零分裂，在 TUI 里配好的东西编辑器里原样可用。
• 切换 OpenCode v1/v2 后连不上？先等活动任务跑完，再执行命令 Varro: Restart Server（它只重启 Varro 自己管理的服务，手动起的服务要自己去终端重启）；然后看状态栏确认版本号。注意 varro.server.autoUpdate 只在同系列内更新，不会自动把 v1 迁移到 v2。
• 移动端伴侣 PWA 能用吗？据项目说明，那是受邀制的实验功能，不要把它当成正式能力来规划工作流。
• 其他 VS Code 分支能用吗？官方说法是”有限支持”，只有 VS Code 和 VSCodium 是完整支持。先按正常流程装，遇到异常再去看官方的分支兼容性文档，不要默认它和 VS Code 行为一致。
• 远程/容器场景：README 明确给了 Docker 沙箱和远程服务器的进阶方案，但也直说不建议一般用户这么玩——部分能力（如桌面通知、语音听写）在 SSH/WSL/容器里不可用，先确认自己的工作流在不在受限清单里。

适合谁：选型判断与替代方案

适合已经在用 OpenCode 做 AI 编程、又不想在终端和编辑器之间来回切换的人：并行开多个会话、排队任务、把编辑器选区/报错/终端输出一键丢进上下文、评审计划和 diff、按会话粒度管权限，一套下来比纯 TUI 顺手。/stats 还能看跨项目的 token 和配额，管成本的人会喜欢。

不适合三类人：一是还没用过 OpenCode 的人，先装好 OpenCode 再谈它；二是重度依赖 SSH 远程开发的人，部分能力在远程场景受限；三是只想要”AI 补全”的人，装个补全类扩展更直接，Varro 是完整的 agent 工作台，杀鸡不用牛刀。

深度补充（独家整理）：本文把安装链路上的三个真实卡点（PATH、原生 Windows 独立 CLI、WSL 路径）拎出来单独强调，并给出了”Auto 日常 / Full access 长任务”的权限模式选型结论；同时明确了 Varro 只是 OpenCode 的前端、不带后端能力的定位判断，源稿没有这层取舍，可直接照着决策。

开源地址

前往 GitHub 查看 Varro

GitHub 国内访问较慢，如打不开可多刷新几次

版本对比与推荐

推荐结论：绝大多数人直接在扩展市场安装；VSCodium 用户走 Open VSX；只有想改代码或尝鲜最新 main 分支的人才需要源码构建。搭配的 OpenCode 版本也有讲究：优先用 v2 系列，老项目仍在 v1 时确认版本号达到要求再接入。

补充设置与排错指南

补充设置：路径、权限模式与通知三处复核

第一，命令行不在默认路径时把可执行文件绝对路径填进对应设置项，混用原生系统与子系统环境的人要两边分开配，这是工作台连不上的最常见原因。第二，权限模式按任务切：日常用自动判定最省心，跑长循环任务前切到完全放行，否则每一步操作都弹确认框。第三，长任务提醒要打开通知开关，同时确认操作系统层面已放行该扩展的通知，否则长任务跑完也不会提醒。

常见问题补充

第一，切换 OpenCode 大版本后连不上：先等活动任务跑完，再执行重启服务命令，然后看状态栏确认版本号，注意同系列内更新不会自动跨大版本迁移。第二，移动端伴侣功能目前是受邀制的实验功能，不要把它当成正式能力来规划工作流。第三，远程与容器场景部分能力受限：桌面通知、语音听写等能力在远程场景不可用，先确认自己的工作流在不在受限清单里。

报错排错

第一，工作台一直转圈连不上：先查命令行是否在系统路径里，再查设置项里的绝对路径是否填对，原生系统、子系统、容器里的路径各不相同。第二，长任务总弹确认框：把权限模式切到完全放行，长任务跑完再切回自动判定。第三，行内补全没反应：先确认该功能默认关闭且需要 OpenCode v2，再确认是否已开启对应开关并留意 token 消耗。

推广

关注「软件教程管家」

回复软件名即取即下：网盘下载链接 + 提取码，一步直达，不用再跳转。

相关推荐

开源项目WallpaperMachine 免费下载开发node-rs 免费下载｜Rust 原生绑定包集合开发Roundhouse 免费下载｜Ruby 静态分析开发Flatcar Container Linux 免费下载开发Nature Skills 免费下载开发bddisasm 免费下载｜轻量级 C 指令解码库