跳到主内容
#08/14AI CLI
OpenCode

OpenCode

开源 AI Coding Agent,Claude Code 免费平替,支持 75+ 模型

cliagentterminalopensourcebyokmulti-model
访问官网 GitHub 关注此工具更新
能力
4
易用
4
性价比
5
中文
3
稳定
3

编辑结论

评分方法 综合3.8/ 5

Claude Code 的最佳免费替代。完全开源、75+ 模型任意切换、终端原生 TUI,社区活跃度 GitHub 22.2 万 Star(2026-10-28 核对)。缺点是多模型配置门槛高、稳定性依赖 BYOK 的 API 质量。

发布 2026-07-04更新 2026-11-08核实 2026-11-08
能力4.0

基于 opencode.ai 文档与 GitHub 22.2 万 star(2026-10-28 核对)评估:开源 TUI Agent、75+ 模型 BYOK 自由切换

易用4.0

多模型路由需手填 opencode.json、配置门槛高

性价比5.0

完全免费

中文支持3.0

接国产模型可行但第三方中转限流即断流

稳定性3.0

几乎每周发版、长会话上下文压缩不如 Claude Code

评分人
AI 之家编辑部
最近复核
2026-11-08
下次复核
2027-05-07 (周期 180 天)
01 / 06深度解读

TL;DR

一句话: OpenCode 是一款完全开源的终端 AI Coding Agent,由 SST 团队用 TypeScript 打造,GitHub 22.2 万 Star 量级(2026-10-28 核对)。它把"终端原生 Agent"这件事做到了极致——TUI 界面、多会话并行、75+ 模型任意切换、BYOK 完全免费,是 Claude Code 在开源侧最像样的免费平替。

最大价值是 模型自由——同一个 Agent 内核,今天用 Claude Sonnet 4 跑难活,明天切 GPT-5 跑审查,后天切 DeepSeek-V3 省钱,全靠 API key 切换,不绑定任何订阅。代价是 配置门槛:多模型路由、provider 配置、本地模型接入都需要手动折腾,稳定性也强依赖你接的 API 质量。

2026-10-29 更新(v1.19.5 转正 + process-daemon-v0.3.2,官方仓库 Releases API 逐 tag 一手核对 + Release Notes 原文):一次只修一件事的补丁版,但修的是「卡死」。

  • v1.19.5 已于 2026-10-28T06:17:49Z 发布,prerelease: false,是当前 1.x 线最新 stable。
  • 官方 Release Notes 全文极短,Core / Bugfixes 下只有一条:"Failed TUI worker requests now return an error instead of leaving the caller hanging."(由社区贡献者 @Nowaker 提交,PR #54936:fix(opencode): answer a failed TUI worker request instead of hanging)。
  • 「hanging」这个词要按字面理解:此前 TUI worker 请求失败时调用方会一直等,表现出来就是界面卡住而不是报错。升级后这类情况会变成一条明确的错误。如果你的自动化脚本此前靠「超时」兜底这类卡死,升级后可以改为捕获错误。
  • 同日另一个 tag:process-daemon-v0.3.2(2026-10-28T16:05:14Z,prerelease: false)——属于 daemon 进程线,与 1.x / 2.x CLI 主版本线并行发布,本站未取得其 Release Notes 正文,不作改动断言。

两条线并存,别只写「最新 stable」:截至 2026-10-30 复核,OpenCode 的 1.x 线最新为 v1.19.5(2026-10-28),2.x 线最新为 v2.2.2(2026-10-29T18:43:03Z)——上一轮写的「2.x 线最新为 v2.2.0」已过期。升级文档里必须写明钉的是哪条线。详见 10-29 版本复核资讯。 2026-10-31 更新(v2.2.3 + v2.2.4 同日连发,官方 Release Notes 原文一手核对):内置 Claude Agent 供应商,托管策略权限拆成三项。

  • 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 供应商(#58782):官方原文 "Install Claude Code, run claude auth login, then select Claude Agent in /connect to use your Claude Code login and models." ——装了 Claude Code 并登录过的机器,可以在 OpenCode 里直接复用那份订阅与模型清单,OPENCODE_CLAUDE_PATH 可覆盖可执行文件位置。这不是一条独立通道:卸载或登出 Claude Code,这条路就没有了。官方未给出可用模型清单、速率与用量限制、企业托管下的可用性,本站未做实测,均列为待核实。
  • 托管策略拆成三项(Breaking,#60315):integration.use 现在只管 integration 账号;MCP 服务器、skills、plugins 改由新增的 mcp.use / skill.use / plugin.use 控制。旧写法(mcp: / skill: / plugin: 前缀)会被自动转换,但官方明确 "a bare integration.use rule no longer applies to MCP servers, skills, or plugins"。失效方式是静默的——配置不报错、CLI 不警告,只是管控范围变了。
  • TUI 插件要求 OpenTUI 0.8(Breaking,#60385):@opencode/plugin 现需 @opentui/core 与 @opentui/solid 0.8.0+;OpenTUI 0.8 里 ScrollBox 的 wrapper / viewport / content / 滚动条由 renderable 变为 facade 对象,自定义 RenderContext 必须实现 clock 与 onAnimationTick。这是本站记录的两个月内第二次抬 TUI 运行时门槛(10-28 那次要求 0.7)。
  • 桌面端持久化终端(v2.2.4,#60346):终端归属会话,服务重启后保留 scrollback,与 TUI 及其他窗口同步,重命名跨重启保留。
  • Artifacts 入场(opt-in)(v2.2.4,#60351):opencode.json 里 "experimental": { "artifacts": true },agent 即可发布、更新、托管 HTML 或静态产物,走内置本地 provider 或插件提供的存储;SDK 侧对应 client.experimental.artifacts 的 providers / list / create / get / update / delete / view。
  • schedules 改为在 opencode serve 下运行(#60478),并协调多进程保证只触发一次;仍由 experimental.schedules opt-in。
  • 两条易被忽略的修复:① 用户 / 项目 / remote 配置现在可以覆盖 Console 下发的 provider 名、限额、变体、设置与请求头(#60597);② 本地 OpenCode 服务请求不再走环境里配置的代理(#60441)——靠代理绕过过什么的人,升级后请重新确认连通性。
  • v2.2.3 还在修自己的回归:Desktop 段注明 "fixing a 2.2.2 regression"(侧边栏 tab 关不掉、反复弹 "Session not found"、HTTP 下侧栏「Open file」失效)。2.x 线的重心明显在桌面端与产物托管,而不是 CLI 本身。

双线写法再次强调:截至 2026-10-31 复核,1.x 线最新为 v1.19.5,2.x 线最新为 v2.2.4——禁止只写「OpenCode 当前 stable 为 vX」。以 CLI 为主的老用户留在 1.x 完全合理;冲桌面端与 artifacts 的才需要评估 2.x,且要接受「桌面端仍在密集修复」这个现状。 行动建议:① 想用 Claude Agent 的,先确认这套组合在你所在的企业托管策略下是否被允许;② 组织管理员升级后逐条复核 integration.use 策略,把 MCP / skill / plugin 显式改成新 action,不要依赖自动转换;③ TUI 插件作者把 OpenTUI 提到 0.8.0+ 并检查 ScrollBox 用法。详见 v2.2.4 资讯。 2026-11-01 更新(v2.2.5,官方 Release Notes 原文一手核对):桌面端快捷键与压缩缓冲区,2.x 线一天三版。

  • v2.2.5 于 2026-10-30T23:17:23Z 发布,prerelease: false。 双线写法继续强调:截至 2026-11-01 复核,1.x 线最新仍为 v1.19.5(2026-10-28),2.x 线最新为 v2.2.5(2026-10-30)。2.x 线在 10-30 当天连发 v2.2.3 / v2.2.4 / v2.2.5 三个 stable。
  • 桌面端快捷键(#60713 / #60640):⌘⌥O(Windows / Linux 为 Ctrl+Alt+O)选择 worktree,⌘⌥B(Ctrl+Alt+B)选择其 base branch,⌘⇧X(Ctrl+Shift+X)在 composer 中切换 shell mode;引用弹窗里按住 ⌘ / Ctrl(或按 ⌘Enter / Ctrl+Enter)可只发送该条引用与评论,composer 里其余内容保持不变。
  • 🔧 压缩缓冲区支持百分比(#60647):opencode.json 里 "compaction": { "buffer": "20%" } 表示为模型上下文窗口留出 20% 余量,同一份配置因此能同时适配大窗口与小窗口模型;token 计数的写法仍然有效。
  • 🔧 bash 工具名不再冲突(#60687):调用名为 bash 的工具现在按 shell 执行且沿用相同权限;插件里真的叫 bash 的工具仍优先。
  • 🔧 MCP stdio 消息超过 10 MiB 不再被断开,且大消息读取明显加快(#60694);空闲位置关闭 MCP 服务器后不再立刻重启(#60668)。
  • 🔧 错误信息更具体:read 因目录缺失而失败时会报出该目录名与最近的存在目录(#60688);edit 找不到 oldString 时会显示文件里最接近的几行,或提示改动已存在(#60689)。
  • 🔧 压缩更稳:prompt 按模型上下文窗口封顶(输入上限更大时不再溢出,#60660);LiteLLM 上下文窗口错误改为触发压缩而不是中断会话(#60692)。
  • 🔧 切换模型或恢复被中断的响应时,reasoning 不再被转成纯文本(#60498)——此前该行为会导致部分 provider 直接请求报错。
  • 连接菜单不再列出 MCP 服务器(#60675,TUI 与桌面端同改),MCP 改在它自己的管理位置——找 MCP 开关的请去新入口。

行动建议:① 用百分比写 compaction.buffer,比写死 token 数更耐模型换代;② 插件作者检查是否有工具名叫 bash(会走 shell 而非你的实现);③ 依赖 MCP 的确认新的管理入口;④ 切过模型或 resume 过中断响应却遇到请求报错的,升级后复测;⑤ 仍在 1.x 的按自己的线走,1.x 最新仍是 v1.19.5。2.x 的官方推荐安装与升级命令仍未取得官方页面逐字确认,继续列入待核实。

来源说明:本文基于 opencode.ai 官方文档、GitHub anomalyco/opencode 仓库(原 sst/opencode,2026-10 起 301 迁址)、社区评测与第三方对比整理。OpenCode 迭代极快(几乎每周发版,2.x 线 10-27 ~ 10-30 四天四版),命令和模型支持列表请以最新官方文档为准。

2026-11-08 更新(v2.2.6,官方 Release Notes 原文一手核对):run 开始等后台任务且没有时间上限,CI 必须自带 timeout。

  • v2.2.6 于 2026-11-06T23:37:20Z 发布,prerelease: false。 截至 2026-11-08 复核,1.x 线最新仍为 v1.19.5(2026-10-28),2.x 线最新为 v2.2.6(2026-11-06)。
  • opencode run 改为等待自己起的后台 job:后台 shell 命令、子代理、图片任务全部跑完、让模型对结果作答后才退出;等待时打印 waiting for N background job(s)(--format json 下是 background_wait 事件)。
  • 官方原文明确 "There is no time limit":永不退出的任务(npm run dev、文件 watcher)会让 run 一直挂着,官方建议 CI 任务自己设 timeout。这条写在 Bug fixes 里,实为行为变更——之前是「可能提前退出(假成功)」,现在是「可能永不退出」。
  • 🔧 SIGTERM 语义明确:取消会话及其后台任务,退出码 143。监控侧应把 143 当「被取消」而不是「失败」。
  • 🆕 opencode run --worktree(-w):在新 git worktree 里起会话,--worktree=<name> 可命名;不能与 --continue / --session 同用。
  • 🆕 opencode run --archived:会话创建即归档,不进 inbox / 首页 / TUI 会话列表,也会被 --continue 跳过——专为脚本与 CI 运行设计。
  • 🆕 MCP 连接池:pool: true 让同配置的 MCP server 跨项目共享一条连接,进程更少、启动更快(参见 v2.2.3 的托管策略已拆成 mcp.use / skill.use / plugin.use,池化后策略作用域要重新确认)。
  • 本地 API 安全收紧三处:① 文件读取与媒体改走沙箱化下载,/api/* 拒绝跨站浏览器导航与非许可来源请求(官方威胁模型:项目里的文件不能对 server 的 origin 执行脚本);② webfetch 与 Code Mode 的 fetch 拒绝带凭据的 URL,权限规则匹配时忽略 #fragment;③ Code Mode 的 fetch 逐个校验重定向(防一次跳转绕过规则)。
  • 🔧 MCP 连接等待 2 秒:模型调用前等仍在连接的 server 最多 2 秒,让「启动快但没连上」的 server 也能赶上第一次提问;同时支持本地 MCP 工作目录展开 ~、兼容 legacy stdio server、动态注册时发送 logo_uri。
  • 🆕 session_move 离开当前项目前要求 external_directory 权限;新增 websearch.use 策略动作、OPENCODE_FLAGS=all / experimental.all_flags 一键开全部特性开关。
  • 🧪 实验性 Code Mode 字节码 VM:默认关闭,experimental.codemode_vm: true 或 OPENCODE_FLAGS=codemode_vm 开启。
  • 🔧 其余:按 provider / model 配置会话预热(interval: "auto" 按缓存 TTL 推算);Console 配置请求 5 秒超时(此前连上不返回会让启动挂住);只写了部分 limit 的 legacy 自定义 provider 不再被整体丢弃;opencode acp 清理客户端创建后未提问的空会话;npm 升级安装脚本恢复执行。TUI 新增「Scroll on send」设置(session.submit_scroll: "keep"),桌面端补移动端 composer dock(44px 触控目标)、提示历史保留 200 条。

行动建议:① CI 里的 opencode run 全部加外层 timeout,并把 143 当「取消」;② 脚本化运行改用 run --archived,别再让自动化刷满会话列表;③ opencode serve 暴露在内网 / 容器的,升级后复测 /api/* 访问路径(跨来源请求被拒是行为变更);④ 用 MCP 的评估 pool: true 的隔离代价;⑤ 容器外环境复核「npm 升级装脚本恢复」的影响。详见 v2.2.6 资讯。

2026-09-25 补记(v1.18.32,2026-09-21):本卡正文所依据的版本快照已明显滞后,先补上这次值得注意的一版。

  • 新增 Grok 4.7 与 DeepSeek V4.1-Flash——两个模型都在 9 月下旬才进 OpenCode 的模型列表,且 Grok 4.7 的接入早于 xAI 官方 API 文档补齐(其官方 model card 至今缺位),走 OpenCode / GitHub Copilot 这类订阅制通道反而是目前更省事的用法。
  • Bedrock 图片附件收窄到 Claude / Nova / Llama 4 三类模型:此前对不支持图片的 Bedrock 模型也会尝试附图,导致请求失败;现在按模型能力做了白名单。用 Bedrock 做多模态的人请确认自己选的模型在名单内。
  • 修复 Together AI 的 streaming usage 上报:走 Together 的用量统计此前不准,涉及成本核算与限流判断的团队建议升级后重新对账。

本条依据 GitHub Release 记录整理,AI 之家 未做一手安装实测;OpenCode 发版极频繁,具体版本号请以 anomalyco/opencode Releases 为准。

2026-10-12 更新(v1.19.0,2026-10-11 发布,当前 stable):自动更新已关停,跨到 OpenCode 2 必须手动执行。

  • 自动更新关停:官方 Release Notes 原文 「Use /update to install OpenCode updates or upgrade to OpenCode 2; updates are no longer installed automatically.」——以前静默装更新的日子结束,跑长任务中途被换二进制的风险没了,但安全修复也不会自动到达。
  • 跨大版本要显式命令:「Run opencode upgrade --major to upgrade to OpenCode 2.」。截至目前仓库最新 tag 仍是 v1.19.0,尚无 2.x,所以这条命令现在主要是为即将到来的大版本做准备——把它记下来,别等 1.x 停更时才第一次尝试。
  • 放行 OpenAI 的 ultrafast service tier:对应 OpenAI 官方 Release Notes 2026-10-08 GA 的 Ultrafast mode for GPT-6.1 Sol(service_tier: "ultrafast")。它压的是输出 token 之间的间隔,不是吞吐——瓶颈在「等模型吐字」的长任务值得单独测一轮。
  • PTY 校验顺序修复:「Validate PTY connection origins and tickets before checking whether a PTY exists.」——官方未说明此前是否存在可利用路径,本站不推断。
  • 仓库已更名:github.com/sst/opencode 现 301 跳转至 github.com/anomalyco/opencode,opencode.ai 首页也已指向新地址。更名的官方公告与确切日期本站未查到(列待核实)。CI / Dockerfile / 文档里硬编码旧地址的,建议直接改掉。

本条依据 OpenCode 官方 GitHub Release(tag v1.19.0,published_at = 2026-10-11T01:39:22Z)与官网核对,AI 之家 未做一手安装实测;--major 的精确语义(是否只允许跨一个大版本)官方未说明,本站不推测。

2026-10-17 更新(v1.19.1 / v1.19.2 / v1.19.3,官方仓库 Releases API 逐 tag 一手核对):五天三个 stable,sst/opencode 已确认 301 至 anomalyco/opencode。

  • v1.19.3 为当前 stable,published_at = 2026-10-16T12:31:52Z;同日更早还有 v1.19.2(2026-10-16T02:30:38Z),前一日为 v1.19.1(2026-10-15T19:19:45Z)。五天里连发三个 stable,与本站此前「几乎每周发版」的判断一致,节奏没有放缓。
  • 仓库更名已由 API 侧确认:api.github.com/repos/sst/opencode 返回 301 Moved Permanently 并指向 repositories/975734319(即 anomalyco/opencode)。此前「301 迁址」的观察至此得到一手确认;但官方公告与确切更名日期仍未查到,继续列入待核实。
  • star 数更新需谨慎:2026-10-17 经 API 实测 anomalyco/opencode 为 214,328 star(前次 10-12 记录为「21.2 万」);2026-10-28 复测为 222,314 star。star 数不是单调递增,引用时必须带核对日期,不能把「曾经到过多少」当成「现在有多少」。
  • 本站未取得 v1.19.1 / v1.19.2 / v1.19.3 的官方 Release Notes 正文(Releases API 仅返回 tag 与时间戳),不对这三个版本的改动内容作断言,列入待核实。仓库中另有一个 pr-56106-video 的 prerelease tag(2026-10-16T14:39:45Z),性质为 PR 预览构建,不是正式版本。

2026-10-21 更新(v1.19.1 / v1.19.2 / v1.19.3 官方 Release Notes 正文已取得,上轮「未取得正文」的待核实项结案):其中 v1.19.1 下线了一个功能。

先结案:上轮称「未取得 v1.19.1 / v1.19.2 / v1.19.3 的官方 Release Notes 正文」。本次重取 Releases API 时取到了三条正文(此前为空是本站读取方式的问题,不是官方没写)。以下三条均为官方原文一手核对。

  • v1.19.1(2026-10-15):会话分享(session sharing)已下线。 官方原文:"Session sharing has been discontinued. Existing share links and session-sharing commands are no longer available, and importing sessions from share URLs is unsupported."——已有分享链接失效、分享命令不再可用、从分享 URL 导入会话也不再支持。这是一次功能下线,不是改名或迁移:官方未给替代方案,也未给数据导出路径。还留着分享链接的,请立刻导出你需要的内容。
  • v1.19.2(2026-10-16):1.x 与 2.x 的更新通道彻底分开。 官方原文:"OpenCode 1 now stays on the 1.x release line: update checks use only the npm opencode-ai latest version, so 1.x installs are never offered a 2.x build as a regular update."——1.x 永远不会再被推 2.x 的常规更新;升 2.x 只能走 /update 里的 2.0 选项或 opencode upgrade --major。同版还修了 yarn 管理的安装、以及 Homebrew Core 安装的更新检查(官方注明 Homebrew Core 现在跟的是 OpenCode 2,因此对 1.x 跳过更新检查),安装脚本拒绝安装 2.x 版本。
  • v1.19.3(2026-10-16,当前 stable):模型推理选项取代 catalog variants。 官方原文:"Configure model reasoning options to generate reasoning variants, replacing catalog variants while preserving your configured variant overrides."——catalog variants 被取代,但你自己配置的 variant 覆盖仍然保留。

行动建议:① 用过会话分享的,现在就导出——官方明确说导入已不支持,等链接失效就没有补救路径;② Homebrew Core 用户注意自己装的是 2.x 通道,想留在 1.x 要换安装方式;③ 在 model config 里显式配过 variant 的不用改(官方明确保留覆盖),但依赖 catalog variants 默认值的升级后要复查实际生效的 variant。官方公告与确切更名日期仍未查到,继续列入待核实。

2026-10-23 更新(v1.19.4,官方仓库 Releases API 一手核对):一次纯运行时安全升级。

  • v1.19.4 为当前 stable,published_at = 2026-10-22T13:03:41Z,prerelease: false,接替 10-16 的 v1.19.3。
  • 官方 Release Notes 全文只有一条,归类在 Core / Improvements:"Upgraded the bundled Bun runtime to 1.4.4, which includes security fixes for Brotli, TLS, HTTP/1.1, HTTP/2, HTTP/3, WebSocket, and fetch, and updates root certificates to NSS 3.131.1."
  • 这条看似「只是升了个依赖」,实际覆盖面很广:Brotli、TLS、HTTP/1.1、HTTP/2、HTTP/3、WebSocket 与 fetch 七处安全修复,外加根证书更新到 NSS 3.131.1。OpenCode 的 TUI 与本地服务都跑在这个内嵌 Bun 上,所以这不是「升不升都行」的版本。

行动建议:① 所有 1.x 用户都应升级——本版是安全修复,且自 v1.19.0 起自动更新已关停、安全修复不会自动到达(见上文 v1.19.0 一节),只能靠你主动跑一次 /update;② 不要因为「只有一条改动」就跳过——本站对「官方只写一句的版本」的一贯结论是:变更面从公开渠道不可枚举时,变更面不等于零;③ Homebrew Core 用户注意自己装的是 2.x 通道,想留在 1.x 要换安装方式。官方未列出对应 CVE 编号与影响面,本站不推测;Bun 1.4.4 的上游公告未逐条读取,列入待核实。 2026-10-28 更新(v2.2.0,官方 Release Notes 一手核对):2.x 终于来了,而且一次给了三处破坏性变更。

先纠正本站上一条已被推翻的陈述:上文「2026-10-12 更新」写的是「截至目前仓库最新 tag 仍是 v1.19.0,尚无 2.x」。该陈述已于本次核对被证伪——v2.2.0 已于 2026-10-27T09:04:44Z 发布,且 prerelease: false。同时补一条本站此前的认知盲区:v2.0.32 至 v2.1.4 等 2.x tag 早已存在于仓库,但这些 tag 没有对应的 GitHub Release 条目(逐个按 tag 取 release 返回 404),所以本站此前只扫 Releases 列表时看不到 2.x 线。判据补充:光看 Releases 列表会漏掉「只有 tag 没有 Release」的版本线;判断某条大版本线是否存在,必须同时看 tags 端点。

  • 当前两个「最新 stable」并存,取决于你在哪条线上:1.x 线最新为 v1.19.4(2026-10-22T13:03:41Z);2.x 线最新为 v2.2.0(2026-10-27T09:04:44Z)。生产请先明确自己钉的是哪条线,再谈「升级到最新」。
  • v2.2.0 的三处破坏性变更:① @opencode/ai 根导出改为 Promise API,Effect API 迁至 @opencode/ai/effect,@opencode/ai/promise 子路径被删除,通配子路径导出改为显式清单;② 官方 OpenCode GitHub Action 已停止发布,官方要求从工作流中移除;③ TUI 插件要求 OpenTUI 0.7(原 0.6.8+),defineNativeIntegration() 改为 static nativeIntegration 声明,依赖 OpenTUI 0.6 的插件在安装阶段就会失败。
  • 功能侧三条值得记:桌面应用插件(可创建 / 安装 / 分享,官方标注 experimental)、插件与 SDK 新增实验性图像生成与决策生成 API、插件可用 ctx.session.instructions.entry.put/list/remove 写带 key 的会话指令(小步增量进下一步、不清 prompt 缓存、能活过压缩与回滚、且不额外起一轮模型)。另有桌面版 Todo 以 opt-in 方式回归、可按 provider / model 配置 prompt 缓存 TTL。
  • 发布通道仍未完全核实:本站 2026-10-28 核对 npm,主包 opencode-ai 的 latest 仍为 1.19.4;2.x 另有通道(观察到 @opencode/cli 包同时提供 opencode 与 opencode2 两个 bin)。2.x 的官方推荐安装与升级命令本站未取得官方页面逐字确认,列入待核实——不要拿 1.x 的 opencode upgrade --major 去推断 2.x 的升级方式。

行动建议:① CI 里引用了 OpenCode Action 的,现在就改成自装 CLI 调用——Action 已停止发布,环境重建时会直接取不到;② 用 @opencode/ai 写过集成的,按官方示例把 Effect 侧改到 @opencode/ai/effect,并全面排查写死的子路径导入;③ 写 TUI 插件的,先把 OpenTUI 升到 0.7 再动;④ 还没准备迁移的 1.x 用户,至少主动跑一次 /update 拿到 v1.19.4 的安全修复(自动更新已关停,安全修复不会自动到达)。详见 OpenCode 2.2.0 资讯。

2026-10-30 更新(v2.2.1 / v2.2.2,官方 Release Notes 一手核对):2.x 线三天两版,图像生成从实验开关变成默认能力。

先更新「最新版本」口径:截至 2026-10-30 复核,1.x 线最新仍为 v1.19.5(2026-10-28T06:17:49Z);2.x 线最新为 v2.2.2(2026-10-29T18:43:03Z,prerelease: false),接替 v2.2.1(2026-10-29T05:16:55Z)与 v2.2.0(2026-10-27T09:04:44Z)。2.x 线三天内发了两个 stable,节奏比 1.x 更快。

v2.2.1(2026-10-29)四条主线:

  • /goal <objective>:官方原文 "Run /goal <objective> in the TUI or Desktop to let the session continue until a reviewer confirms the objective is met.",配套 /goal pause / /goal resume / /goal clear。这是把「目标是否达成」的判定交给了 reviewer,长任务不必靠人一直盯。
  • 图像生成入场:开启 experimental.image_generate 后,agent 可用新的 image_generate 工具创建或编辑图片,可用 experimental.image_generate.model 指定默认模型(#59939、#60096)。
  • 新模型选择器成为桌面端默认:可搜索 favorites / recent / providers / variants(#59997);桌面端活动条里点运行中的 shell 可直接看实时输出并停掉(#59496)。
  • 破坏性变更仍在继续:本版又删了一批 @opencode/ai 的 provider——fal、Black Forest Labs、Replicate、Stability 及其对应 ./providers/* 入口被移除(#59977),另有五个旧入口点被删(如 ./providers/amazon-bedrock-mantle → ./providers/amazon-bedrock/mantle)。官方注明这只影响直接 import @opencode/ai 的代码,不改 CLI / Desktop / HTTP API。

v2.2.2(2026-10-29,当前 2.x 最新):

  • 图像生成默认开启:官方原文 "When a connected provider supports image models, agents can now use experimental_image_generate without additional configuration."(#60258)——接了支持图像模型的 provider 之后,agent 无需额外配置即可调用。这是一次默认行为变更:v2.2.1 里还需要显式开 experimental 开关。
  • 更快的 worktree 选择:新会话界面点当前 Git 分支即可直接打开该项目的 worktree 选择器(#60263)。
  • 统一引号与批注编辑:时间线引用、终端引用、浏览器批注共用一套紧凑的可选评论编辑器(#60164)。
  • 若干边界修复:拒绝工作目录已不存在的持久终端请求;fork / 导入会话时保留媒体;窄终端宽度下的路径截断不再溢出;Go 用量上限提示补上重置时间与账户页链接。

行动建议:① 用 @opencode/ai 写过 provider 集成的,按 v2.2.1 的移除清单再排查一轮——2.2.0 / 2.2.1 连着两版在删 provider 入口;② 不希望 agent 自动调用图像生成的,显式配置 experimental.image_generate.model 或断开图像 provider,v2.2.2 起它默认就开;③ 仍在 1.x 的按自己的线走,1.x 最新仍是 v1.19.5。2.x 的官方推荐安装与升级命令仍未取得官方页面逐字确认,继续列入待核实。

OpenCode 核心能力

终端原生 TUI,多会话并行

OpenCode 不是又一个"AI IDE 插件",而是独立的终端程序。装好后在任何项目根目录跑 opencode,就进入一个全屏的 TUI(终端用户界面):左侧文件树、中间对话、右侧 diff 预览,所有操作用键盘完成。这套交互对 Vim / Neovim / tmux 用户极度友好——不抢编辑器焦点,开个分屏就能用。

cd your-project
opencode                       # 进入 TUI 交互模式
> 把这个 Express 项目迁移到 Fastify,跑通测试再提交

它会自动:扫描相关文件 → 给出迁移计划 → 等你确认 → 多文件改写 → 跑测试 → 生成 commit message。整个过程你可以在另一个窗口继续写代码,互不干扰。

TUI 之外,OpenCode 还支持 多会话并行——一个终端里同时挂多个独立 agent 会话,每个有自己的 context 和模型配置。典型用法:一个会话用 Claude Sonnet 跑主开发,另一个用 GPT-5 跑代码审查,第三个用 DeepSeek 跑文档生成,互不污染上下文。这是 Claude Code(单会话为主,子代理是隔离派发)之外另一种"并行"思路。

75+ 模型 BYOK,一个 Agent 全通吃

OpenCode 最硬的能力是 模型中立。它不绑死任何厂商,通过 provider 配置接入 75+ 模型,包括:

  • Anthropic:Claude Opus 4 / Sonnet 4 / Haiku 4 全系
  • OpenAI:GPT-5 / GPT-4.1 / o 系列推理模型
  • Google:Gemini 2.5 Pro / Flash
  • 国产:DeepSeek-V3、Qwen-Max、GLM-5、Kimi K2
  • 本地:Ollama、LM Studio 任何 GGUF 模型
  • 中转:OpenRouter / 火山引擎 / 硅基流动 一个 key 调全部

配置写在 opencode.json 里,按模型 / 按场景 / 按成本分配:

{
  "models": {
    "hard": { "provider": "anthropic", "model": "claude-sonnet-4" },
    "cheap": { "provider": "deepseek", "model": "deepseek-v3" },
    "local": { "provider": "ollama", "model": "qwen2.5-coder:32b" }
  }
}

之后在 TUI 里用 /model hard 一键切换。这种"模型即配置"的设计,让省钱和跑难活不再冲突——难的活上 Sonnet,简单的活(注释、文档、测试用例)下放给 DeepSeek,单月成本能压到订阅制的零头。

Agent 工具链:文件操作、终端执行、MCP

作为 Agent,OpenCode 内置了完整的工具链:读写文件、执行 shell 命令、跑测试、grep 搜索、git 操作。所有工具调用都在 TUI 里可见可审批,你可以随时打断、回滚。

它同样支持 MCP 协议——配置 .mcp.json 后就能在对话里调数据库、调浏览器、调任意 MCP server。这一点和 Claude Code 是同一套生态,迁移成本低。

开源 + 自托管

OpenCode 是 MIT 协议开源,TypeScript 全栈,可读可改可自托管。企业担心数据出墙的,可以自建一套:本地 Ollama 模型 + 本地 MCP server + 内网 git,全程不出公司网络。这是闭源的 Claude Code / Cursor 拿不到的优势。

社区活跃度是它的隐形护城河——GitHub 22.2 万 Star(2026-10-28 经 API 核对)、issue 响应快、第三方插件(LSP 集成、自定义工具、模型 adapter)持续涌现。一个开源 Agent 能跑到这个量级,意味着生态可持续。

OpenCode 使用体验

上手 5 分钟

# macOS / Linux
curl -fsSL https://opencode.ai/install.sh | bash

# Windows PowerShell
irm https://opencode.ai/install.ps1 | iex

# 或 npm 全局安装(需 Node 18+)
npm install -g opencode

# 验证
opencode --version

# 配置 API key(任选其一)
export ANTHROPIC_API_KEY=sk-ant-...
export OPENAI_API_KEY=sk-...
export OPENROUTER_API_KEY=sk-or-...      # 一个 key 调 75+ 模型

# 进项目启动
cd your-project
opencode                          # 进入 TUI

日常体感

实际用下来,OpenCode 的 TUI 体验是开源侧最接近 Claude Code 的。键盘流操作丝滑,diff 实时预览,会话切换比 Claude Code 的 /resume 更直观(直接在侧栏点)。多模型切换是杀手锏:跑一个大 refactor 前先 /model hard 上 Sonnet,跑完切 /model cheap 让 DeepSeek 补文档,成本可控。

但 稳定性是短板。BYOK 模式下,体验强依赖你接的 API 质量:第三方中转偶尔限流、国产模型长任务容易断、本地模型质量参差。同样一个任务,Claude Code 用官方 API 能稳跑完,OpenCode 接中转可能中途报错重来。社区也承认这一点,正在做重试、断点续跑等加固。

配置门槛

第一次配 opencode.json 会有学习成本——provider 字段、base_url、模型映射、工具白名单都要手填。社区有模板可抄,但想用好(比如按场景自动路由模型)还是得读文档。相比之下 Claude Code 的 claude 一键启动确实更省心。

OpenCode 价格与运行成本

OpenCode 本身 完全免费——开源、无订阅、无增值版。你只为你调用的模型 API 付费(BYOK)。这意味着成本完全可控:

接入方式单月成本估算适用场景
DeepSeek-V3(国产)¥20-100日常编码,性价比之王
Claude Sonnet 4(直连)$50-300跑难活,最接近 Claude Code 体验
OpenRouter 中转$10-100一个 key 切多模型
本地 Ollama¥0(电费)隐私 / 离线 / 实验
GPT-5(直连)$30-200代码审查、推理任务

对比 Claude Code Max $200/月:用 OpenCode + DeepSeek,同样强度的编码量,单月可能只要 ¥50。这就是开源 + BYOK 的红利——你为用量付费,不为订阅定额买单。

但要注意 隐性成本:多模型配置的时间、调试中转稳定性的精力、偶尔重跑任务的 token 浪费。对这些"折腾税"敏感的,订阅制反而更省心。

OpenCode 适用场景

  • 预算敏感的个人开发者:想用 Agent 但不想每月 $20+,OpenCode + DeepSeek 是最经济解
  • 模型自由爱好者:想同时对比 Claude / GPT / DeepSeek / 本地模型在同一个 Agent 里的表现
  • Vim / Neovim / tmux 重度用户:终端原生 TUI,不破坏既有工作流
  • 需要自托管 / 隐私的团队:MIT 开源 + 本地模型,数据不出内网
  • Claude Code 想找平替:交互逻辑接近,迁移成本低,省下订阅费

OpenCode 不适用场景

  • 零配置开箱即用:多模型路由要折腾 opencode.json,新手劝退
  • 企业级稳定性 SLA:开源项目无承诺,中转 / 国产模型偶发抖动
  • IDE 内 inline 补全:OpenCode 是 Agent 不是补全器,要 Tab 补全去 Cursor / Copilot
  • 纯 Windows 原生:TUI 在 Windows Terminal 可用,但部分功能建议 WSL
  • 不碰终端的用户:这是 CLI 工具,全程命令行交互

OpenCode 与同类怎么选

维度OpenCodeClaude CodeCodex CLIAider
形态CLI(TUI)CLICLICLI
开源MITApache
模型自由75+仅 ClaudeOpenAI 系
长任务能力
TUI 体验
多会话并行子代理有限
MCP 支持
价格免费(BYOK)$20-$200/月$20-$200/月免费(BYOK)
国内门槛低(国产模型)高高低
稳定性依赖 API

选 OpenCode 如果你:

  • 想用 Claude Code 的体验但不想付订阅
  • 需要在多个模型间灵活切换(省钱 / 跑难活 / 隐私)
  • 是 Vim / 终端重度用户,不想装 IDE
  • 团队要自托管,数据不出墙

别选 OpenCode 如果你:

  • 要开箱即用、零配置(去 Claude Code / Cursor)
  • 要 IDE 内 inline 补全(去 Cursor / Copilot)
  • 企业要求稳定 SLA(开源 + BYOK 抖动难避免)

FAQ

Q:OpenCode 真的完全免费吗? A:工具本身免费开源(MIT)。但调模型 API 要花钱——除非你只用本地 Ollama 模型。所谓"免费"指的是不收订阅费,BYOK 模式下你为 token 买单。

Q:和 Claude Code 比,差在哪? A:长任务稳定性、上下文管理(Claude Code 的 /compact 更成熟)、官方模型深度调优。OpenCode 胜在模型自由和免费。简单说:要稳选 Claude Code,要省和自由选 OpenCode。

Q:国内怎么用最省心? A:用 OpenRouter 一个 key 调全部模型(支持支付宝),或直接接 DeepSeek / Qwen 国产模型。网络压力小,成本最低。

Q:能接本地模型吗? A:能。Ollama / LM Studio 跑 GGUF 模型,OpenCode 通过 OpenAI 兼容接口接入。完全离线可用,适合隐私场景。

Q:OpenCode 和 Aider 都是开源 CLI,区别? A:Aider 更老牌、更轻量,专注"每改即 commit"的 git 流;OpenCode 更现代,TUI 体验和多会话并行更强,模型生态更广。要轻量选 Aider,要体验选 OpenCode。

Q:会取代 Claude Code 吗? A:对预算敏感、爱折腾的用户,是的。对要稳定 + 长任务 + 不差钱的,Claude Code 仍是最优解。两者更像互补——OpenCode 日常省钱,Claude Code 跑关键大活。

相关阅读

Long-tail quick picks

长尾检索速查:下面三项对应「OpenCode 开源版 / 免费版 / 国内可用」等搜索意图,方便直接跳转。

Open-source alternatives

  • 是否开源:是(支持自托管)
  • 想找开源替代?看这几个:Trae · Cline · Aider

Free tier

  • 是否有免费档:是
  • 价格概要:完全免费(BYOK)
  • 预算敏感用户可先用免费档;进阶需求参考 通义灵码 / CodeGeex(国内免费额度更友好)。

China availability

  • 是否国内可用:否
  • 中文友好度评分:3 / 5
  • 国内访问需稳定代理;高频切 IP 可能触发风控。中文场景可考虑 Trae / 通义灵码 / Comate。

相关替代品:

来源

本卡片由 AI 之家 编辑部根据官方公开资料与第三方评测整理。所有事实点均标注来源;如发现价格 / 命令 / 功能与最新官方信息不一致,请通过 反馈邮箱 反馈。

02 / 06价格速查
计划价格限制国内支付备注
开源版(BYOK)免费仅承担 API token 成本 国产模型可用支付宝 自带 API key
本地模型免费Ollama / LM Studio 本地跑 无需支付 适合离线 / 隐私场景
OpenRouter 中转按用量一个 key 调用 75+ 模型 支持支付宝 国内最省心的接入方式
03 / 06适合 / 不适合
适合谁
  • · 想用 Claude Code 体验但不想付费订阅的开发者
  • · 需要在不同模型间灵活切换(省钱 / 跑难活 / 隐私)
  • · JetBrains / Vim / Neovim 用户,不想换编辑器
  • · 想自托管、私有部署 AI 编程 Agent 的团队
  • · 本地模型爱好者(Ollama / LM Studio 接入)
不适合谁
  • · 希望开箱即用、零配置的用户(多模型路由要折腾)
  • · 要求企业级稳定性 SLA 的团队(开源项目无承诺)
  • · 需要 IDE 内 inline 补全体验(用 Cursor / Copilot)
  • · 完全不熟悉 API key / 终端操作的新手
04 / 06避坑提醒
NOT FOR · 什么情况下不要选它

不适合零配置开箱即用党和要企业级 SLA 的团队——前者卡在 opencode.json,后者开源项目没有稳定性承诺

PITFALLS · 避坑提醒
  • BYOK 模式下稳定性完全取决于你接的 API,第三方中转限流或国产模型断流时任务会中途报错重来
  • 第一次配 opencode.json 要手填 provider、base_url、模型映射和工具白名单,想做按场景路由必须读文档
  • 超长会话的上下文压缩不如 Claude Code 的 /compact 成熟,跑大改造得自己手动拆会话
  • 纯 Windows 下 TUI 只在 Windows Terminal 里完整可用,部分功能官方建议绕道 WSL
兼容模型

可接入 / 兼容以下大模型 API(在设置中配置 key 即可切换底座):

Anthropic / Claude OpenAI Google / Gemini OpenRouter Ollama (本地)
05 / 06深度评测
06 / 06类似工具推荐
查看 OpenCode 的全部替代品
相关资讯