OpenCode 是一个开源的终端 AI 编程智能体:在命令行里打开它,把要改的需求说给它,它自己读代码、改文件、跑命令。MIT 许可证,GitHub 实时 227,595 星(本站核对:2026-11-18),另有桌面版(BETA)。本站核对了它的 npm 包(@opencode/cli 最新版 2.3.1,MIT)与官方 README 的安装与智能体说明;未在本机实跑改代码,步骤以官方文档为准。
能干什么
- 在终端里结对编程:不用离开命令行,需求、代码、终端输出在同一个界面里流转。
- 两个内置智能体,Tab 键切换(README 口径):build 是默认的全权限干活模式;plan 是只读的分析模式——默认不改文件,跑命令前要先问你,适合先摸清陌生代码库或先定方案。
- 还有一个 general 子智能体:处理复杂搜索与多步任务,在消息里用 @general 唤起。
- 多端形态:终端版为主,也有桌面应用(BETA,macOS/Windows/Linux 都有安装包)。
优缺点
优点:开源 MIT、不绑单一模型厂商,模型可按自己的账号与预算换;plan 模式把「先看后改」做成了产品纪律,对不敢让 AI 直接动代码的人友好;安装方式齐全(脚本、npm、brew、包管理器都有)。
缺点与边界:第一次用要先完成模型接入配置(选提供商、填密钥),这一步是新手的主要卡点;界面与文档以英文为主(README 有简体中文版),指令本身可以用中文下——它理解什么语言取决于你接的模型;终端形态对完全没碰过命令行的人有门槛,这类读者可以先看桌面版。
下载与安装(官方 README 口径)
- 一键脚本:
curl -fsSL https://opencode.ai/v2/install | bash,装到 ~/.opencode/bin。 - 或用包管理器:
npm i -g @opencode/cli@latest(bun/pnpm/yarn 同理);macOS/Linux 还可以用 brew:brew install anomalyco/tap/opencode-v2(README 标注此源更新更及时)。 - 装过 0.1.x 之前的老版本,先卸载干净再装新版(README 明确提示)。
- 桌面版:去 opencode.ai/download 下载对应系统的安装包,macOS 也可
brew install --cask opencode-desktop。 - 装完在项目目录里启动它,按首次启动的引导完成模型接入:选提供商、填你自己的 API 密钥——密钥只填在本地配置里,不要写进代码仓库。
调用与使用
- 新项目先用 plan 模式:Tab 切到 plan,让它先读一遍代码库,给出结构说明和改动计划,你确认了再切 build 动手。
- 下指令说清三件事:改哪个文件(或哪个功能)、想要的结果、不能动的地方。说得越具体,返工越少。
- 复杂搜索交给 @general:例如「@general 找出所有调用这个接口的地方」,主智能体继续干正事。
- 每改一轮先验收:让它跑一遍项目已有的检查或测试命令,输出贴回界面里一起看,别攒到最后。
调教成自己的
- 把项目规矩写进项目里的说明文件(框架、目录约定、禁用写法),让它每次开工先读——规矩写一次,不用每次重复交代。
- 模型按活分档:日常小改用便宜快的模型,复杂重构再切强模型,成本花在刀刃上。
- plan/build 的分工固定下来:任何不熟悉的代码先 plan 后 build,养成习惯比任何提示词都管用。
玩法:半会代码的创业者,自己维护自己的小站
模拟一位自己搭了独立站的创业者:会改点皮毛代码,卡点是遇到要动结构的需求就发怵,请人改又慢又贵。他的打法:
- 需求先丢给 plan 模式:让它定位要改哪几个文件、风险在哪,输出一份改动清单。
- 清单看得懂、风险可控,才切 build 模式按清单执行;看不懂就先追问到懂——plan 模式不动文件,问多少遍都安全。
- 改完让它自己跑一遍构建或检查命令,再人工打开页面验一眼关键位置。
- 每次的改动清单和结果记进项目文档:下次再改时,先把这份记录喂给它,上下文不用从零交代。
避坑指南
- 密钥别进仓库:API 密钥只放本地配置或环境变量,提交代码前检查一遍。
- 老版本先清:0.1.x 之前的版本与新版不兼容,README 明确要求先移除。
- 别在陌生大仓库直接 build:先 plan 摸清结构,尤其是别人交接给你的项目。
- brew 两个源别混:官方公式(opencode)与厂商 tap(opencode-v2)更新节奏不同,装哪个记清楚,升级走同一个源。
档案
- 仓库:github.com/anomalyco/opencode;许可证 MIT;文档 opencode.ai/docs;官网 opencode.ai。
- 星数 227,595(2026-11-18 实时核对);npm 包 @opencode/cli 最新版 2.3.1(注册表核对)。
- 本站验证:README 安装与智能体章节、npm 包元数据已核;未实机运行改代码任务,步骤以官方文档为准。
常见问题
中文下指令行不行?行。界面是英文的,但你输入的指令语言由所接模型决定,主流模型都能直接用中文沟通与改代码。
它和 Cursor、Copilot 怎么选?Cursor 是编辑器形态、Copilot 是装进编辑器的助手,OpenCode 是终端形态且开源、模型自选。重度终端用户选它;想要图形界面先看它的桌面版或站内 AI编程栏目 的其他选择。
要花多少钱?软件本身开源免费;费用在你接的模型 API 上,按量计费、丰俭由人,先用小任务试出自己的单任务成本再放大。



