跳到主内容

OpenCode 一天两版到 v2.2.4：内置 Claude Agent 供应商，托管策略权限拆成三项

OpenCode 于 2026-10-30 连发 v2.2.3 与 v2.2.4：内置 Claude Agent 供应商可复用 Claude Code 登录，托管策略 integration.use 不再覆盖 MCP 与插件。

2026-10-31 · anomalyco/opencode 官方 Release Notes（GitHub Releases API 一手，v2.2.3 2026-10-30T09:55:45Z / v2.2.4 2026-10-30T16:59:08Z，均 prerelease: false）

发布 2026-10-31核实 2026-10-31

要点

  • v2.2.3（2026-10-30T09:55:45Z）与 v2.2.4（2026-10-30T16:59:08Z）同日连发，均 prerelease: false，2.x 线推进到 v2.2.4；1.x 线仍为 v1.19.5（2026-10-28），两条线继续并存。
  • 内置 Claude Agent 供应商：官方原文 "Install Claude Code, run claude auth login, then select Claude Agent in /connect to use your Claude Code login and models."（#58782）。装了 Claude Code 并登录过的机器，可以在 OpenCode 里直接复用那份订阅与模型清单，OPENCODE_CLAUDE_PATH 可覆盖可执行文件位置。
  • 托管策略拆成三项（Breaking）：integration.use 现在只管 integration 账号；MCP 服务器、skills、plugins 改由新增的 mcp.use / skill.use / plugin.use 三个 action 控制。官方说明旧写法会被自动转换，但 "a bare integration.use rule no longer applies to MCP servers, skills, or plugins"（#60315）。
  • TUI 插件要求 OpenTUI 0.8（Breaking）：@opencode/plugin 现需 @opentui/core 与 @opentui/solid 0.8.0+；OpenTUI 0.8 里 ScrollBox 的 wrapper / viewport / content / 滚动条由 renderable 变为 facade 对象，自定义 RenderContext 必须实现 clock 与 onAnimationTick（#60385）。
  • 桌面端持久化终端（v2.2.4）：终端归属会话，服务重启后保留 scrollback，与 TUI 及其他窗口同步，重命名也跨重启保留（#60346）。
  • Artifacts 入场（opt-in）（v2.2.4）：opencode.json 里 "experimental": { "artifacts": true }，agent 即可发布、更新、托管 HTML 或静态产物，走内置本地 provider 或插件提供的存储（#60351）。
  • schedules 改为在 opencode serve 下运行，并协调多进程保证只触发一次；仍由 experimental.schedules opt-in（#60478）。
  • 两条易被忽略的修复：① 用户 / 项目 / remote 配置现在可以覆盖 Console 下发的 provider 名、限额、变体、设置与请求头（#60597）；② 本地 OpenCode 服务请求不再走环境里配置的代理（#60441）。
  • 顺带一句：官方把 Claude Code 里那条有误导性的 /login 提示换成了 claude auth login（#60592）——这条与上条新供应商是同一件事的两面。

背景与分析

「在 OpenCode 里用 Claude Code 的号」到底意味着什么

这不是模型接入层面的新闻——OpenCode 本来就支持 Anthropic API。它的特殊之处在于复用的是 Claude Code 的登录态与订阅，而不是一份新的 API key：先装 Claude Code、跑 claude auth login，再在 OpenCode 的 /connect 里选 Claude Agent。

对使用者的实际含义：① 订阅型用户多了一条不额外计费的调用路径；② 模型清单跟随 Claude Code 侧，OpenCode 自己不必再维护一份；③ 反过来，它依赖本机装有 Claude Code 且已登录——不是一条独立通道，卸载或登出 Claude Code 这条路就没了。

本站未做实测，以下均列为待核实：该供应商可用的具体模型清单、是否受 Claude Code 侧的速率与用量限制、企业托管配置下是否可用、OPENCODE_CLAUDE_PATH 对版本的要求。官方 Release Notes 只给了装法与开关位置，没有给适用范围。

托管策略那一条，是「规则没报错，但不再生效」

integration.use 的拆分值得单独拎出来讲，因为它的失效方式是静默的：

  • 旧规则里 mcp: / skill: / plugin: 前缀会被自动转换——这部分有迁移路径；
  • 但一条不带前缀的 integration.use 规则，此前覆盖 MCP 服务器、skills、plugins，现在不了。

也就是说，组织管理员可能在完全不知情的情况下失去（或缩小）了对这三类资源的管控范围，而配置文件不会报错、CLI 不会警告。这正好落在本站「复核优先看 Changed / Removed / stop」的判据上——它写在 Breaking changes 段，但真正危险的是它不在 Added 段，容易在读新功能时被跳过。

行动：凡是写了托管策略的组织，升级后逐条复核 integration.use，把 MCP / skill / plugin 三类显式改成新 action，不要依赖自动转换。

OpenTUI 0.8 那条 Breaking，是给插件作者看的

TUI 插件作者是这一版的直接受影响方，而且改动是底层对象模型级的：ScrollBox 的四个组成部分从 renderable 变成 facade，自定义 RenderContext 必须补两个成员。这不是可选迁移——官方写明 0.8.0 是最低要求。若插件里直接操作过这些对象，升级后不会优雅降级，会直接报错。

对照本站 10-28 记录的 OpenCode 2.x 首个带正文 Release 要求 OpenTUI 0.7，这次是两个月内第二次抬 TUI 运行时门槛。写插件的同学请把「OpenTUI 版本」当成和 OpenCode 版本同等重要的依赖钉住。

两个版本放一起看：桌面端在补课

v2.2.3 的 Desktop 段里有一句 "Fixes side-panel tabs, repeated 'Session not found' toasts, and Open file over HTTP"，并注明是 "fixing a 2.2.2 regression"——一天前的版本自己引入的回归，一天后修掉。加上 v2.2.4 的持久化终端与 artifacts，2.x 线的重心明显在桌面端与产物托管，而不是 CLI 本身。

选版建议因此要分开写：1.x 线仍是 v1.19.5（2026-10-28），2.x 线已是 v2.2.4（2026-10-30）——禁止只写「OpenCode 当前 stable 为 vX」。以 CLI 为主的老用户留在 1.x 完全合理；冲桌面端与 artifacts 的，才需要评估 2.x，且要接受「桌面端仍在密集修复」这个现状。

行动建议

  1. 想用 Claude Agent 的：装 Claude Code → claude auth login → OpenCode /connect 里选 Claude Agent；先确认这套组合在你所在的企业托管策略下是否被允许。
  2. 组织管理员：升级后逐条复核 integration.use 策略，把 MCP / skill / plugin 显式改为 mcp.use / skill.use / plugin.use。
  3. TUI 插件作者：把 @opentui/core 与 @opentui/solid 提到 0.8.0+，检查 ScrollBox 用法与自定义 RenderContext。
  4. 钉版本：写文档时必须写明钉的是 1.x 还是 2.x（v1.19.5 / v2.2.4），不要只写一个版本号。
  5. 受代理困扰的：v2.2.4 起本地服务请求不走环境代理，若你此前靠代理绕过过什么，升级后重新确认一次连通性。

待核实

  • Claude Agent 供应商的可用模型清单、速率与用量限制、企业托管下的可用性（官方 Release Notes 未给出适用范围，本站未实测）。
  • OPENCODE_CLAUDE_PATH 对 Claude Code 版本的要求。
  • integration.use 自动转换的具体映射规则（哪些前缀转成哪些 action，官方未枚举）。
  • artifacts 的内置本地 provider 的存储位置、生命周期与清理策略。
  • experimental.schedules 在 opencode serve 下「多进程只触发一次」的协调机制（是否依赖外部锁）。
  • DeepSeek V4.1 Flash 的「OpenCode Go limits」被抬到多少（官方只写 raised，未给数值）。
  • 2.x 线的官方推荐安装与升级通道（本站自 10-28 起多次核对未取得官方逐字说明，npm opencode-ai latest 仍为 1.19.4）。

相关

AI 之家 观点

「在一个 agent CLI 里复用另一个 agent CLI 的登录态」这件事，比它看起来重要。 过去两年各家 CLI 的竞争维度是模型、是上下文、是权限模型；现在多了一条——你手上已有的订阅能不能带过来。OpenCode 这次的做法是把 Claude Code 当成一个本地凭据提供者来接入，代价是依赖对方装且已登录。

对用户的直接好处是少一份账单；真正的风险在组织侧：这条路径绕过了 API key 的集中管控，IT 部门如果只盯着 key 发放，可能完全看不到有人在跑。建议企业用户把「本机是否装有其他 agent CLI 并已登录」也纳入资产排查。

另一条要提醒的是托管策略的静默失窄。本站这轮在 Claude Code 里读到「写入边界收紧」，在 OpenCode 里读到「integration.use 不再覆盖 MCP / skill / plugin」——两家同日的动作方向一致：把此前「一个开关管一片」的权限拆细。拆细本身是好事，但凡是拆细，必有一段过渡期里旧规则不报错却已经不覆盖原来的范围。这段过渡期不会有任何提示，只有复核策略的人才会发现。