OpenCode V2 更新！架构重构、新增浏览器自动化，这几个改动要看懂

还在找能帮你干活的 AI 编程助手？最近开源 AI 编程智能体 OpenCode 出了 V2 大版本，架构、工具能力、安全权限全重做了一遍，业余玩家还是开发团队都值得花两分钟看看。

OpenCode V2 版本整体介绍

没接触过 OpenCode 的人简单了解一下：它就是个开源 AI 编程智能体，说白了能帮你写代码、改 bug、查项目、跑脚本。不局限网页对话框，终端命令行、本地桌面客户端、浏览器 Web 界面都能用。

V2 最大的改动是客户端‑服务器架构。不管你是终端、桌面软件还是网页，全部连到本地后台统一服务。会话记录、配置、插件、权限管控都集中后台管。跑完全本地私有服务没问题，连远程服务地址也行，灵活度挺高。

安装渠道挺全的，curl、Homebrew、npm 这些包管理器都有，各平台独立二进制包和 Docker 镜像也齐了。Windows 包管理器暂时还没适配，得等等。

不用敲复杂指令，AI 自己选工具干活

V2 的工具逻辑很接地气：你描述想要什么结果，AI 自动挑合适工具干。心里清楚要跑什么操作的话，也可以直接点名。

比如说，你跟它说：把项目里所有用到 DEFAULT_TIMEOUT 的代码位置找出来，再把对应文件读出来，剩下的交给工具链处理就行。

工具分了好几类，基本覆盖开发日常：

文件处理

读文件、搜代码、改代码、新建文件、批量打补丁都在这里。

• read 读文件，支持分页，图片、PDF 也能直接读；
• glob 批量匹配查找项目内文件；
• grep 用正则检索代码内容，直接返回行号；
• edit 对现有文件做局部修改；
• write 新建或完整覆盖整个文件；
• patch 比较厉害，一次性改多个文件。

小提示：修改工作文件夹以外的文件，会触发权限确认，防止误改动系统文件。

命令行 shell

直接在本机执行 shell 命令。不建议命令里写 cd 切目录，指定工作目录更好。普通命令默认两分钟超时，可以手动调。

像前端开发服务器这种长时间运行的程序，可以设后台模式，跑起来立刻返回，结束再通知你。

重要提醒：shell 工具拥有你本机账号同等的文件、进程、网络权限，使用的时候建议配置白名单，避免风险。

网络、交互、高级编排

• webfetch 抓网页内容，转 markdown、文本或 html，查文档方便；
• websearch 联网搜最新资料；question 拿不定主意的时候主动弹窗问你，支持多选也能手动输入；
• subagent 子代理，分出独立子任务会话，复杂任务拆成多个小任务并行处理；
• execute（Code Mode）在隔离 JS 环境编排工具调用，支持并行，也不会把海量中间数据塞满 AI 上下文，效率提升明显。

新版本加了浏览器操控工具，配合桌面客户端用。AI 帮你打开网页、点按钮、填表单、截图、看控制台报错，甚至直接跑 Lighthouse 性能审计。网页返回的内容不会被当成 AI 指令，提示注入风险也规避了。

还支持接外部 MCP 服务器拓展自定义工具，导入 Skills 技能包也行，加载一套预设流程拿来就能用。

权限管控大升级，不怕 AI 乱改文件

用过 V1 的朋友知道，旧版按工具分组管权限。V2 直接改成一套有序权限规则数组，哪个操作允许、拒绝还是每次问，写得明明白白。

每条规则包含操作类型、作用资源、执行效果三种状态：allow 直接放行，deny 直接拒绝，ask 每次弹框确认。

AI 发起操作时，弹窗给你三个选择：仅这次允许、永久允许（保存项目规则，但不会覆盖拒绝规则）、直接拒绝。

项目加了 policies 硬性管控策略，就算配置写了允许，也能强制转成拒绝。企业团队可以用这个封禁 sudo 之类的高危命令，做组织层面约束。

说个容易踩坑的：老用户迁移的时候，不少动作名字改了。bash 改成 shell，task 改叫 subagent，迁移配置一定留意。

系统自带基础安全策略，比如读 .env 环境配置文件默认询问，外部目录访问一律弹窗。不同工作模式的 Agent 也自带权限限制，探索模式只允许读取查询，不允许改文件。

OpenCode V2 新增核心功能一览

升级必看：3 处不兼容改动

V2 还是 opencode 这条命令，装 V2 直接替换 V1，两者不能共存。官方做了三处破坏性变更，升级前记牢：

1、插件全得重写：V1 写好的插件不能直接跑，不是改改配置文件名就行的事，得按迁移文档改写入口和钩子逻辑。

2、服务端 API 全更新了：之前对接旧版 API 的程序，得迁到新版客户端库 @opencode/client。

3、配置文件位置变了：原先分散的 tui 配置统一合并到 cli.json，第一次启动 V2 会自动把旧配置迁过来。

除了上面三点，Agent 角色定义、命令、Skills 技能大部分旧配置向下兼容，不用全部推倒重写，程序运行时自动兼容旧格式，不会动你的源配置文件。

配置文件格式做了优化，旧格式还能继续用，迁到 V2 原生格式是可选操作。几个细节也提一下：

• 旧的指令文件 CLAUDE.md 不再识别，项目自定义提示改成 AGENTS.md；
• 不再内置 LSP 语言服务器，代码语法检查、编译交给项目自身的 lint、编译命令去跑；
• 部分旧配置字段废弃了，出现告警属正常，不是 bug。

OpenCode V2全新权限规则模型

• 统一后台服务：可以查看、重启后台服务，直接调 HTTP 接口，附 OpenAPI 文档，二次开发集成方便。
• Code Mode 代码编排，并行跑多个任务，省上下文窗口。
• 完整浏览器自动化，网页调试、性能审计交给 AI。
• 多种运行模式：无界面模式适合 CI 脚本自动化，极简交互终端，本地 Web 配对协作。
• 权限策略更强，支持团队级硬限制。
• 调试工具完善，一键查程序存放路径，日志方便排查故障。

1、升级前务必备份原有全部配置，升级后别再用 V1 读这份配置。

2、卸旧版 OpenCode，装 V2 新版本。

3、启动程序，核对模型密钥、Agent 角色、权限、MCP 外部服务是否正常。

4、重写适配旧插件。

5、业务调用服务端 API 的话，迁到新版 SDK。

6、配置格式保持旧版就行，转 V2 原生格式可选。

V2 这次迭代把工具能力、安全权限、平台扩展当核心。工具链够完整，权限模型解决了 AI 乱操作本地文件的老大难问题，客户端‑服务器架构让二次开发、自动化集成变容易了。

普通开发者绝大多数工作流能平滑过渡，插件和 API 对接这两块需要投入时间改造。经常要处理大量项目代码的话，不妨试试这个开源工具。