OpenCode

Name: OpenCode
Author: AIX Cove

AIX Cove 评测 · 2026-04-05

OpenCode 是什么

OpenCode 是 Anomaly 做的开源 AI 编程代理。它最早把终端当成主场，现在还有桌面应用和 IDE 扩展。项目代码放在 GitHub 仓库，使用 MIT 许可证。开源让人能检查代码、换模型服务商，也能自己接本地端点。不过代码是否离开电脑，取决于你最后选了谁来跑模型。

它的日常用法并不复杂。进到项目目录，接入一个模型服务商，或者使用 OpenCode Zen，然后让代理读代码、列计划、改文件、跑测试。执行 /init 能生成或更新 AGENTS.md。把安装命令、测试命令、代码规范和不能碰的目录写进去，下次开新会话也不用从头交代。

我把官方文档、Zen 说明和公开问题追踪页对了一遍，觉得 OpenCode 的价值落在控制权上。你能决定从哪里调用模型，能把命令和路径权限收紧，也能换掉不合适的模型。相应地，密钥、费用、数据去向和最终 diff 也都得有人负责。

它怎样参与一次开发任务

默认的 Build 代理有完整开发工具权限。内置的 Plan 代理用于分析和看代码，默认不许编辑文件，运行 shell 命令时也会询问。还有用于搜索和多步任务的子代理。第一次进陌生仓库时，先让 Plan 交出相关文件、已有约定、风险点和测试命令，确定范围后再切到 Build，通常比上来就让它改代码省事。

模型接入是它的一大特点。官方文档列出 75 家以上服务商，也支持 Ollama、LM Studio、llama.cpp 等本地模型和自定义端点。用 /connect 加入的密钥保存在 ~/.local/share/opencode/auth.json。本地模型能少走一段外发路径，却不等于没有安全工作。密钥文件、插件、代理服务器和项目里的敏感文件，仍要自己看住。

不想分别开服务商账号，可以选 Zen。它是 OpenCode 提供的可选模型网关，按请求计费，模型名单和单价会变。官方 Zen 页面按每百万 token 列价，团队预算该从这里算，别把免费客户端当成模型调用也免费。

四个更稳的用法

先做只读检查 让 Plan 列出会碰到的文件、现有写法、可能失败的地方和验证命令，并要求它停在计划处。代码还没被改动，很多错误理解已经能看出来。
把 AGENTS.md 写短 放进项目真正需要的安装命令、测试命令、格式化规则、生成文件政策和禁区。它是给代理的上下文，也该是审阅者一眼能读懂的项目说明。
按动作收紧权限 OpenCode 可把动作设为允许、询问或拒绝。删除命令如 rm * 应继续拒绝，范围大的 shell 命令先问，文件路径只放开这次任务需要的部分。刚接触一个仓库时，不要为了少点几次确认就开 --auto。
用同一道题选模型 给两个服务商同一个 issue、同一份代码快照、同一条测试命令和同一张审阅清单。记下 token 花费、重试次数、diff 质量和返工时间。演示里看着快的模型，放到真实审阅环节未必划算。

费用、隐私和分享各有坑

OpenCode 客户端免费，模型账单另算。直连服务商时，价格和数据保留规则跟着那家服务商走。走 Zen 时，费用按请求累积。Zen 支持按工作区和成员设置月度上限，但自动充值会在余额低于设定阈值时补充信用额。团队先设一个小上限，用几天看实际用量，再决定是否放开。

Zen 文档写明，列出的模型托管在美国，服务商遵循零保留政策，同时也列出了几种免费或贡献者模型的例外。有些临时免费模型会收集数据用于改进模型，NVIDIA 的试用端点明确提醒不要提交个人或机密数据。看到 Free 标记时，先读这一项模型的条款，再考虑省下的费用。

会话分享也该单独检查。默认要手动执行 /share 才会生成链接，生成后，拿到链接的人都能访问该会话。发出去前看一遍 prompt、粘贴过的日志、仓库路径和输出内容。终端记录里露出来的东西，常常比一个 diff 多得多。

限制与公开反馈

开源不会消掉编程代理的老问题。它会误解需求，会编不存在的 API，会顺手改到不该改的文件，也可能在错误的环境里跑出错误的命令。多服务商支持还带来另一份管理工作。每家都有自己的密钥、模型、配额、故障和数据条款。个人试用时够用的设置，进生产仓库往往太松。

想看真实摩擦，直接翻公开 GitHub 问题追踪页比看发布截图有用。里面能看到服务商接入、配置、不同平台和代理工作流的报告，也能看到维护者后续的回复和版本变化。这些报告不能代替你的测试，却很适合在上线前逐项排查。

OpenCode 适合熟悉终端、能管理模型账号、合并前会认真读 diff 的开发者和小团队。若团队需要一家公司包办模型采购与支持，或者敏感仓库还没确定服务商和权限政策，先别急着把它接进主流程。