如果你习惯在终端里工作,OpenCode 是 2026 年增长最快的开源 AI 编码智能体之一。截至 2026 年 8 月底,这个仓库在 GitHub 上已有 20.3 万 star、2.64 万 fork,最新版本 v1.18.25 于 2026 年 8 月 28 日发布。它由 SST 团队开发(组织现已迁移为 anomalyco),采用 MIT 协议开源,核心定位只有一个:把 AI 编码智能体直接跑进终端。本文介绍它是什么、关键数据如何、内置的 agent 体系,以及怎么开始用。

终端优先的编码智能体

OpenCode 的默认形态是一个命令行工具。与 Cursor、Copilot 这类以图形界面或编辑器插件形态出现的产品不同,OpenCode 把完整的编码智能体能力装进了 CLI:你在终端里启动它,它就能读取项目代码、执行命令、修改文件、提交代码。

项目 README 用一句话概括自己:The open source AI coding agent。它强调三点——开源、终端原生、多模型支持。开发者可以把它接入自己偏好的模型服务,也可以在 CI、脚本、远程服务器等没有图形界面的环境里使用。

内置双 agent:build 与 plan

OpenCode 内置两个可通过 Tab 键切换的 agent:

  • build:默认 agent,拥有完整的开发权限,负责实际的编码与修改工作;
  • plan:只读 agent,用于分析代码库与规划改动,默认禁止编辑文件,执行 bash 命令前会先请求许可。

plan 模式适合在动手前梳理陌生代码库、评估改动方案;build 模式负责落地执行。两者之外还有一个名为 @general 的子 agent,用于复杂搜索与多步任务,可在对话中直接调用。

这套「先规划、后执行」的双角色设计,与不少商业编码智能体的工作流一致,但完全开源、可自托管。

一组值得注意的数字

OpenCode 的增长规模在同类型开源项目里处于第一梯队:

  • 202.7k star、786 watchers、26.4k forks;
  • 15,605 次提交,994 名贡献者;
  • 1,597 个分支、1,097 个 tag;
  • 历史累计 867 个 release,最新版 v1.18.25(2026 年 8 月 28 日发布);
  • 代码构成以 TypeScript 为主,占比 75.5%,其次为 MDX(21.2%)。

从版本节奏看,v1 系列保持了高频迭代:仅 2026 年 8 月就有多次发布,最新的提交记录停在 8 月 31 日。项目还提供了桌面应用(BETA 阶段),覆盖 macOS(Apple Silicon 与 Intel)、Windows x64 与 Linux(.deb / .rpm / .AppImage)。

安装方式与上手路径

OpenCode 的安装方式覆盖了主流平台与包管理器,官方推荐一条 curl 命令:

curl -fsSL https://opencode.ai/install | bash

其他方式包括:npm(npm i -g opencode-ai@latest)、scoop、choco、Homebrew(brew install opencode)、Arch Linux 的 pacman、Nix(nix run nixpkgs#opencode)等,共 13 种。Windows 与 macOS 用户也可以直接安装桌面应用。安装脚本会按 $OPENCODE_INSTALL_DIR → $XDG_BIN_DIR → $HOME/bin → $HOME/.opencode/bin 的优先级决定安装目录,也可以通过 OPENCODE_INSTALL_DIR 环境变量自定义位置。

项目 README 已本地化为 24 种语言,包括简体中文、繁體中文、日、韩、德、法、意等,官方文档在 opencode.ai/docs,社区入口是 Discord。

什么情况下值得试

判断是否值得用 OpenCode,核心看两点:你习惯终端工作流,且愿意自己配置模型服务。如果两者都满足,它是目前少数把「开源、终端优先、多模型」同时做到 20 万 star 级别的项目,可以先用 plan agent 在陌生项目里做只读探索,再切换 build agent 落地改动。如果你更依赖图形界面与开箱即用的托管服务,桌面版仍在 BETA,主路径仍是 CLI。一句话带走:OpenCode = 终端里跑的开源编码智能体,20 万 star 验证了这条路,值不值得用取决于你是否愿意在命令行里和它配合。