OpenCode：终端优先的开源编码 Agent

终端优先、双 agent 切换的开源编码代理，仓库已迁到 anomalyco 名下。

OpenCode 的定位很简单：把 agent 放在终端里，用键盘把活干完，不管 IDE。它的仓库原在 sst/opencode，现在地址已转到 anomalyco/opencode，MIT 许可，TypeScript 写的，星标约 22.6 万（以 GitHub 为准），是所有开源编码 agent 里体量最大的。默认带两个 agent：build 有完整写权限，plan 只读、执行命令前会先问你，按 Tab 就能切。

核心能力

1. build / plan 双 agent，Tab 一下切换
build 是可写文件、可跑命令的默认 agent；plan 则是只读的，禁改文件、跑 bash 前先征得同意。实际用法很明确：进一个陌生仓库先切 plan，让它把目录结构、入口、依赖关系说清楚，方案确认了再切 build 动手。这一步能防住大多数“它没看懂就开始改”的事故。

2. @general 子代理分掉搜索类杂活
遇到“找出所有用到这个函数的地方”这类任务，在主对话里叫 @general，它开一个子会话去挖，只把结果带回来。好处是主对话的上下文不被几十个文件原文污染。大型重构时这一点很关键：主会话要保持“干净”，才能持续做正确判断。

3. 终端 UI，不依赖图形界面
它自带 TUI，在 SSH 连的服务器上也能直接用。对经常在远程机器上改代码的人，这是硬需求：不用开远程桌面，也不用装图形化 IDE 插件。

4. 十八种语言文档，中文开箱可读
仓库 README 提供简体中文、繁体中文等十多种翻译，官方文档在 opencode.ai/docs。国内用户少一个翻译环节，配置项的语义不容易误解。

5. 安装方式极多，Windows 也能一行搞定
官方提供 shell 脚本、npm / bun / pnpm / yarn、Homebrew（两个 tap，一个更新更快）、Arch 的 pacman 与 AUR、mise、Nix。Windows 原生用户装桌面版或用 npm 全局装都行，不用先凑 WSL。

使用上手

1. 装。macOS / Linux 推荐 brew install anomalyco/tap/opencode-v2；通用方式是 curl -fsSL https://opencode.ai/v2/install | bash；已有 Node 环境可 npm i -g @opencode/cli@latest。
2. 清旧版。官方提示：先卸掉 0.1.x 之前的旧版本，否则可能出现命令冲突。
3. 进项目目录再启动。在仓库根目录跑，不要在用户主目录启动。
4. 先 plan 后 build。按 Tab 切到 plan，让它输出改动方案，确认后切回 build。
5. 把项目约定写进配置。测试命令、代码风格、禁用工具提前写好，后续会话自动生效。
6. 需要图形界面时用桌面版。从 opencode.ai/download 下对应安装包，macOS 也可 brew install --cask opencode-desktop。

优点与不足

优点：

• MIT 开源，能改、能自建、能审计行为。
• 双 agent 设计实用，plan 模式真的拦住了写操作。
• 终端优先，远程服务器与容器里都能用。
• 安装渠道多，各平台都有顺手的路子。

不足：

• 仓库刚迁到新组织名下，旧链接与旧教程里的地址会对不上。
• 星标基数大，issue 数量也多，遇到坑要自己翻讨论。
• 桌面版仍标 Beta，稳定性不如终端版。
• 本身不带模型，费用取决于你接哪家 API。

适合谁

• 习惯终端、不想为写代码开重 IDE 的开发者。
• 需要在远程服务器 / 容器里跑 agent 的运维与后端。
• 想审计 agent 行为、甚至自己改逻辑的团队。

下载与访问

• 官网：https://opencode.ai/
• 文档：https://opencode.ai/docs
• 桌面版：https://opencode.ai/download
• 仓库：https://github.com/anomalyco/opencode

价格与授权

本文属于「编程」分类的 AI 资源专栏，更多评测见分类页。