GitHub 趋势 · 第 25 期
206k star 的开源编码 Agent:模型自选,终端里干活
#开源编码Agent
#MIT
#模型自选
如果你在终端里用编码 Agent,先把结论放前面:OpenCode 值得装一次试。它不是又一个绑死模型的套壳——模型 provider 自选(自备 key,或走官方精选的 OpenCode Zen),形态自选(终端 TUI / 桌面 App / IDE 扩展),协议开源、MIT、可商用。代价是:它给你自由,也把「配哪个模型、花多少钱」的选择权原样还给你。
本期对象是 GitHub Trending 本周榜上的 anomalyco/opencode——README 自述一句话:「The open source AI coding agent.」,目前 206,336 star、26,970 fork,本周新增 3,133 star。在「编码 Agent」这个已经被 CLI 大厂占满的赛道里,它是少数把开源与模型中立同时做到位的一个。
痛点:你选的不是 Agent,是被绑定的模型和账单
大多数开发者真正的困扰不是「Agent 不够聪明」,而是三件事:① 我用惯的模型换不了,或者要等某个客户端支持;② 同一条 prompt 想 A/B 两个模型,只能在两个工具之间来回切;③ 想看一眼「它到底改了什么」,得自己翻 diff。OpenCode 的取舍是:把模型层完全解耦,把改动做成可回退的会话。
项目是什么:一个模型中立的开源编码 Agent
OpenCode 提供三种使用形态:终端界面(TUI)、桌面应用(BETA)、以及 IDE 扩展。官方文档第一句就是「一个开源的 AI 编码代理」。技术上它是一个 TypeScript 实现、以 npm 包 opencode-ai 分发的本地 CLI,配置驱动,不依赖任何单一厂商的云服务。
一个容易被忽略的事实:它的 README 覆盖了 23 种语言(含简体中文、繁體中文),社区入口同时给了 Discord 与飞书——这是个明显在认真做国际化维护的项目,而不是单人周末作品。
核心能力:四个真正区分点
| 能力 | README / 官方文档原文口径 |
|---|---|
| 模型自选 | 配置任意 LLM provider 的 API key;新手可用官方精选的 OpenCode Zen(团队测试过的模型集),在 TUI 里执行 /connect 后到 opencode.ai/auth 取 key |
| 三种内置 Agent | build(默认,全权限,干活用)、plan(只读,默认拒绝改文件、跑 bash 前先问权限,适合摸陌生代码库)、general 子 Agent(复杂搜索/多步任务,用 @general 调用) |
| 会话可回退 | /undo 会还原改动并把你上一条消息重新显示出来,可以连续多次撤销;/redo 重做 |
| 项目上下文落盘 | 首次进项目跑 /init,它会分析代码库并在根目录生成 AGENTS.md,官方建议提交进 Git |
另外还有 /share:把当前会话生成一个链接并复制到剪贴板(默认不分享,手动执行才会上传)。以及主题、快捷键、格式化工具、自定义命令等一整套配置项,都在官方文档里。顺带说一句,README 里专门写了一条:第三方项目如果名字里带 "opencode",必须注明与官方无关——这说明生态里已经出现蹭名项目了,看到带这个前缀的东西留意一下。
上手:README 原文的安装命令
# 直接安装(README 原文标注 YOLO) curl -fsSL https://opencode.ai/install | bash # 或者走包管理器 npm i -g opencode-ai@latest # 也支持 bun / pnpm / yarn brew install anomalyco/tap/opencode # macOS / Linux(推荐,更新最勤) brew install opencode # 官方 formula,更新频率较低 scoop install opencode # Windows choco install opencode # Windows sudo pacman -S opencode # Arch Linux (Stable) paru -S opencode-bin # Arch Linux (AUR 最新) mise use -g opencode # 任意系统 nix run nixpkgs#opencode # 或 github:anomalyco/opencode 拿 dev 分支 # README 明确提示:安装前请先移除 0.1.x 之前的旧版本 # 安装路径优先级(原文) # 1. $OPENCODE_INSTALL_DIR # 2. $XDG_BIN_DIR # 3. $HOME/bin # 4. $HOME/.opencode/bin (默认兜底)
装完之后的第一次使用,官方文档给的最短路径是:
cd /path/to/project opencode # 启动 TUI /connect # 配置 provider 的 API key /init # 生成 AGENTS.md,建议提交进 Git # 界面上 Tab 键在 build / plan 两个 Agent 之间切换 # 拖图片进终端就能把图作为参考一起发出去 /undo /redo # 回退 / 重做改动 /share # 生成会话链接(默认不分享)
我的判断:适合谁、不适合谁、坑在哪
适合:① 手上已经有一个或多个模型 API key、想统一在一个终端工作流里干活的人;② 需要在几个模型之间做 A/B、或按任务切模型(便宜模型写样板、贵模型啃难题)的人;③ 要审计 Agent 到底改了什么、且习惯用 git 管理一切的人;④ 团队要一个可自托管、不把代码上下文交给某个客户端厂商的选项。不适合:① 期望「装完即用、不想碰任何 API key」的人;② 只用一家模型并且已经很满意当下客户端的人;③ 想要云端托管、跨设备同步会话的人。
- ▪「开源免费」≠「用起来不花钱」——软件是 MIT,但模型 token 该付还是得付。官方反而明确推荐新手用 OpenCode Zen,而那一步需要登录并添加账单信息。这一点最容易被标题党带歪,先说清楚。
- ▪桌面 App 仍标 BETA——README 里桌面版那一节直接写着 (BETA),下载渠道是 releases 页与 opencode.ai/download,要稳定就别把生产流程押在它上面。
- ▪Windows 官方建议走 WSL——文档原文口径是「为了在 Windows 上获得最佳体验,推荐使用 WSL」,并称 WSL 能完整兼容所有功能。原生 Windows 虽有一条 docker run 的替代路径,但那是另一套体验。
- ▪/share 是「分享对话」不是「分享链接」——它会把你当前会话内容生成公开链接。默认状态是不分享,但这个命令很好按,涉及内部代码库时请先在项目层面谈好规则。
- ▪上下文要靠 AGENTS.md,不会自动读心——文档自己也在反复强调「把它当团队里的初级开发者沟通」:提示词要给足上下文与示例。不给上下文的 Agent,换哪个模型都救不回来。
- ▪MIT 可商用——LICENSE 文件为 MIT(Copyright (c) 2025 opencode),可修改、可分发、可商用,保留版权声明即可。这条在这个赛道里是加分项,因为不少同类是 source-available 或带商用门槛。
数据脚注
仓库地址:github.com/anomalyco/opencode(默认分支 dev)
一句话描述(README 原文):The open source AI coding agent.
许可证:MIT(LICENSE 文件:Copyright (c) 2025 opencode)
Star:206,336;Forks:26,970;本周新增:+3,133 star(GitHub Trending 周榜)
语言:TypeScript;分发:npm 包 opencode-ai
README 语言数:23 种(含简体中文 / 繁體中文)
抓取时间:2026-09-10 22:2x GMT+8(WebFetch 抓取 github.com/trending?since=weekly 与仓库 README / LICENSE 原文)
下期预告:anthropics/skills(官方 Agent Skills 公共仓库,175,572 star,本周 +2,316)或 AlexsJones/llmfit(Rust,一条命令算出哪些模型能跑在你的机器上)。想看哪个,评论区说一声。
你在用哪个编码 Agent?是绑模型派还是模型自选派?如果这篇帮你省下一次踩坑,转给正在挑工具的那位同事。
GitHub 趋势 · 第 25 期
#opencode
#MIT
#AI编码