OpenCode:在终端里运行的 AI 编程代理

OpenCode 是 SST(现 anomalyco)团队用 TypeScript 写的开源 AI 编程代理,GitHub 上 227,819 星、MIT 许可、11 月 18 日仍在提交,形态有终端界面、桌面版和网页版三种,用自然语言让它读代码、改文件、跑命令;模型可以接 ChatGPT Plus/Pro 订阅、GitHub Copilot、Claude、Gemini,也能接本机 Ollama,软件本身不收费。

闭源编程代理好用,但用起来总有几个别扭的地方:绑死一家模型,想换便宜的就没办法;按 token 计费,改一个中型项目账单不可预测;公司代码要过审计,数据往哪走说不清楚。OpenCode 把这几件事拆开了——外壳开源,模型由你自己接,会话和改动都留在本机。

参数一览

项目名称 OpenCode
维护者 / 语言 anomalyco(原 SST 团队)/ TypeScript
Star / 许可 227,819 星 / MIT
形态 终端界面、桌面应用(Win/mac/Linux)、网页版
模型接入 ChatGPT Plus/Pro、Copilot、Claude、Gemini、Azure、Bedrock、Vertex、本地 Ollama
内置代理 build(可写文件)、plan(只读分析),Tab 键切换
价格 软件免费,模型费用按你选的服务商算

用起来是什么感觉

  • 先看再动手:plan 代理默认不许改文件、跑命令要你点头,适合让它先把项目结构和调用链讲清楚;确认思路后再切到 build 代理动手。
  • 订阅额度能直接用:除了填各家 API Key,还能连接 ChatGPT Plus/Pro 账号或 GitHub Copilot,把已经在付的订阅用起来,不必再单独开一份按量账单。
  • 全本地也能跑:接本机 Ollama 时,代码和对话都不出这台机器,适合不能外传的项目。
  • 一套配置换模型:/connect 选服务商登录,/models 换模型,同一个项目里不同任务可以用不同档位的模型。
  • 能往外扩:文档里还有 MCP 服务、插件、技能、会话快照这些扩展项,接内部工具或加自定义流程都有入口。

适合人群

  • 长期在终端里干活、不想再开一个 IDE 面板的人。
  • 手里有 Copilot 或 ChatGPT 订阅,想把它接到自己项目目录里用的人。
  • 公司要求代码不出内网,只能接本地模型的团队。
  • 反例:完全没碰过命令行的用户,图形化的编辑器插件会更友好。

上手步骤

  1. 装 Node 环境,执行 npm i -g @opencode/cli;macOS 和 Linux 也可以用 Homebrew,或走官方的安装脚本。
  2. 进到项目目录,运行 opencode,界面会直接在当前目录打开。
  3. 输入 /connect 选服务商,按提示登录或粘贴 Key;用 Ollama 的话直接选本地那一项。
  4. 输入 /models 挑一个模型,拿不准就先选带代码能力的旗舰款。
  5. 先在 plan 模式里提要求,比如「讲清登录流程的实现和依赖」,看它的分析对不对。
  6. 按 Tab 切到 build,让它按刚才的方案改;每一步改动它都会列出来,跑命令前会问你要不要执行。重要项目先提交一次 git,出问题能回退。

问:一定要另外买 API 吗?

答:不一定。可以连已有的 ChatGPT Plus/Pro 或 Copilot 订阅,也可以接本机 Ollama 完全免费跑,只是本地小模型的改代码能力会明显弱一些。

问:和 Claude Code 比该选哪个?

答:要开源、要能换模型、要在内网跑,选 OpenCode;只在 Claude 模型上工作、想要最顺手的官方体验,Claude Code 仍然更成熟。

问:它会不会把我的代码改坏?

答:plan 代理是只读的,build 代理才会写文件,执行命令默认要确认。即便如此也建议在 git 仓库里用,改动不满意直接丢弃。

问:Windows 上能用吗?

答:能。npm 全局安装后在任何终端里跑,或者下桌面版 exe;终端体验最好的是 Windows Terminal,老式控制台对中文和颜色的支持差一些。

最后更新:2026-11-19

声明:本站所有文章,如无特殊说明或标注,均为本站原创发布。任何个人或组织,在未征得本站同意时,禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益,可联系我们进行处理。