
OpenCode
开源 AI Coding Agent,Claude Code 免费平替,支持 75+ 模型
Claude Code 的最佳免费替代。完全开源、75+ 模型任意切换、终端原生 TUI,社区活跃度 GitHub 22.2 万 Star(2026-10-28 核对)。缺点是多模型配置门槛高、稳定性依赖 BYOK 的 API 质量。
基于 opencode.ai 文档与 GitHub 22.2 万 star(2026-10-28 核对)评估:开源 TUI Agent、75+ 模型 BYOK 自由切换
多模型路由需手填 opencode.json、配置门槛高
完全免费
接国产模型可行但第三方中转限流即断流
几乎每周发版、长会话上下文压缩不如 Claude Code
- 评分人
- AI 之家编辑部
- 最近复核
- 2026-11-08
- 下次复核
- 2027-05-07 (周期 180 天)
- 利益声明
- 本站不接软文、不卖排名
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/connectto 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 bareintegration.userule no longer applies to MCP servers, skills, or plugins"。失效方式是静默的——配置不报错、CLI 不警告,只是管控范围变了。 - TUI 插件要求 OpenTUI 0.8(Breaking,#60385):
@opencode/plugin现需@opentui/core与@opentui/solid0.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.schedulesopt-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
/updateto install OpenCode updates or upgrade to OpenCode 2; updates are no longer installed automatically.」——以前静默装更新的日子结束,跑长任务中途被换二进制的风险没了,但安全修复也不会自动到达。 - 跨大版本要显式命令:「Run
opencode upgrade --majorto upgrade to OpenCode 2.」。截至目前仓库最新 tag 仍是v1.19.0,尚无 2.x,所以这条命令现在主要是为即将到来的大版本做准备——把它记下来,别等 1.x 停更时才第一次尝试。 - 放行 OpenAI 的
ultrafastservice 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-ailatest 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_generatewithout 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 与同类怎么选
| 维度 | OpenCode | Claude Code | Codex CLI | Aider |
|---|---|---|---|---|
| 形态 | CLI(TUI) | CLI | CLI | CLI |
| 开源 | MIT | Apache | ||
| 模型自由 | 75+ | 仅 Claude | OpenAI 系 | |
| 长任务能力 | ||||
| TUI 体验 | ||||
| 多会话并行 | 子代理 | 有限 | ||
| MCP 支持 | ||||
| 价格 | 免费(BYOK) | $20-$200/月 | $20-$200/月 | 免费(BYOK) |
| 国内门槛 | 低(国产模型) | 高 | 高 | 低 |
| 稳定性 | 依赖 API |
选 OpenCode 如果你:
- 想用 Claude Code 的体验但不想付订阅
- 需要在多个模型间灵活切换(省钱 / 跑难活 / 隐私)
- 是 Vim / 终端重度用户,不想装 IDE
- 团队要自托管,数据不出墙
别选 OpenCode 如果你:
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 跑关键大活。
相关阅读
- 同类对比:Claude Code / Codex CLI / Aider / Gemini CLI
- 概念:AI Agent / MCP / BYOK / Context Engineering
- 动态:OpenCode v1.19.0 与 OpenCode 2 升级路径(2026-10-11)
- 模型:Claude Sonnet 4 / GPT-5 / DeepSeek-V3 / Qwen-Max
- 进阶:Vibe Coding / Prompt Engineering
Long-tail quick picks
长尾检索速查:下面三项对应「OpenCode 开源版 / 免费版 / 国内可用」等搜索意图,方便直接跳转。
Open-source alternatives
Free tier
China availability
相关替代品:
来源
- 官网:https://opencode.ai
- 官方文档:https://opencode.ai/docs
- GitHub:https://github.com/anomalyco/opencode(原 sst/opencode,2026-10-12 核对已 301 迁址)
- 模型支持:https://opencode.ai/docs/models
- 对比文档:https://opencode.ai/docs/comparisons/claude-code
- v1.19.0 Release Notes(2026-10-11):https://github.com/anomalyco/opencode/releases/tag/v1.19.0
- 版本复核(2026-10-17):当前 stable 为 v1.19.3,见 https://github.com/anomalyco/opencode/releases
本卡片由 AI 之家 编辑部根据官方公开资料与第三方评测整理。所有事实点均标注来源;如发现价格 / 命令 / 功能与最新官方信息不一致,请通过 反馈邮箱 反馈。
| 计划 | 价格 | 限制 | 国内支付 | 备注 |
|---|---|---|---|---|
| 开源版(BYOK) | 免费 | 仅承担 API token 成本 | 国产模型可用支付宝 | 自带 API key |
| 本地模型 | 免费 | Ollama / LM Studio 本地跑 | 无需支付 | 适合离线 / 隐私场景 |
| OpenRouter 中转 | 按用量 | 一个 key 调用 75+ 模型 | 支持支付宝 | 国内最省心的接入方式 |
- · 想用 Claude Code 体验但不想付费订阅的开发者
- · 需要在不同模型间灵活切换(省钱 / 跑难活 / 隐私)
- · JetBrains / Vim / Neovim 用户,不想换编辑器
- · 想自托管、私有部署 AI 编程 Agent 的团队
- · 本地模型爱好者(Ollama / LM Studio 接入)
- · 希望开箱即用、零配置的用户(多模型路由要折腾)
- · 要求企业级稳定性 SLA 的团队(开源项目无承诺)
- · 需要 IDE 内 inline 补全体验(用 Cursor / Copilot)
- · 完全不熟悉 API key / 终端操作的新手
不适合零配置开箱即用党和要企业级 SLA 的团队——前者卡在 opencode.json,后者开源项目没有稳定性承诺
- BYOK 模式下稳定性完全取决于你接的 API,第三方中转限流或国产模型断流时任务会中途报错重来
- 第一次配 opencode.json 要手填 provider、base_url、模型映射和工具白名单,想做按场景路由必须读文档
- 超长会话的上下文压缩不如 Claude Code 的 /compact 成熟,跑大改造得自己手动拆会话
- 纯 Windows 下 TUI 只在 Windows Terminal 里完整可用,部分功能官方建议绕道 WSL
可接入 / 兼容以下大模型 API(在设置中配置 key 即可切换底座):
Aider 深度评测:把 AI 编程当 git 工作流的极客派最爱
Aider 深度评测:git-native 心智的真实代价、Architect 双模型经济学、与 Claude Code 的决策边界、何时不该选 Aider。AI 之家 编辑部基于官方文档与社区公开反馈整合,非厂商付费内容。
Claude Code 深度评测:终端 AI Coding Agent 标杆
Anthropic 官方 CLI Agent 一个月真实使用报告:长任务能力、CLAUDE.md 配置、权限模型、成本控制、与 Cursor / Codex / Aider 的实操对比与选型建议。
Codex CLI 深度评测:OpenAI 的终端 AI Agent 好用吗
Codex CLI 深度评测:OpenAI 开源的终端 Coding Agent,Rust 实现、Windows 原生沙箱、Subagents + MCP + Hooks;含 2026-11 收购 Pierre 后的定位复核与未实测项。
同任务替代方案
相关横评
Aider vs OpenCode:两个开源终端 Agent,选哪个?2026 对比
Aider 与 OpenCode 2026 选型对比:同为开源终端 agent,Aider 以 Git-native 工作流与多语言支持见长,OpenCode 主打模型无关与 TUI 体验。从 6 个维度给出取舍建议。
2026-10-12
OpenCode vs Claude Code:终端 AI Coding Agent 怎么选?开源平替 vs 官方 CLI 对比
OpenCode vs Claude Code 2026 选型对比:开源 MIT CLI(75+ 模型 BYOK)对阵 Anthropic 官方 CLI,从形态、模型自由、长任务、TUI、多会话、MCP、价格与国内门槛判断。
2026-10-12
OpenCode 2.2.6:run 等后台任务,CI 会挂死
OpenCode v2.2.6 于 2026-11-06 发布:run 会等自己起的后台命令、子代理与图片任务跑完才退出,官方明说没有时间上限,CI 必须自带 timeout;MCP 支持连接池,本地 API 收紧。
Ripple-65B 开源:Apache 2.0 的 65B 稠密模型
AI 芯片公司 Ricursive 开源 Ripple-65B Preview:65B 稠密 Transformer、12 万亿 token、Apache 2.0,官方称 TerminalBench 2.1 得 80.52 分。
11-06 版本复核:Gemini CLI v0.67.0 第十一轮终于转正,新增 models 命令
2026-11-06 复核七条 CLI 版本线:Gemini CLI v0.67.0 终于转正并新增 models 命令;Claude Code、Codex、Ollama、OpenCode 均无新 stable。
OpenCode 一天两版到 v2.2.4:内置 Claude Agent 供应商,托管策略权限拆成三项
OpenCode 于 2026-10-30 连发 v2.2.3 与 v2.2.4:内置 Claude Agent 供应商可复用 Claude Code 登录,托管策略 integration.use 不再覆盖 MCP 与插件。