关键要点
- OpenCode(opencode.ai)是一款免费开源的 AI 编码代理,根据官网介绍以终端为核心,并额外提供 IDE 模式和桌面模式
- 规范的 GitHub 仓库是 anomalyco/opencode;根据 PromptQuorum 自身目录调研,该项目在这次更名前最初发布于另一个 GitHub 组织下
- 根据当前 GitHub 仓库页面显示的许可证徽标,采用 MIT 许可证
- 根据 OpenCode 官网介绍,通过 Models.dev 连接超过 75 个模型提供方,包括 Claude、GPT 和 Gemini
- 通过 OpenAI 兼容的提供方配置,指向 Ollama 或 LM Studio 的本地端点,支持本地模型
- 截至本评测时已获得超过 20 万个 GitHub star;OpenCode 官网还给出了贡献者数量和月活用户数量,本评测未能独立核实这些数字(详见下方说明)
📍 简单一句话
OpenCode 是一款免费、开源、以终端为核心的 AI 编码代理,规范托管于 GitHub 上的 anomalyco/opencode(超过 20 万 star),通过 75 个以上的模型提供方连接,包括通过 OpenAI 兼容端点接入的 Ollama、LM Studio 等本地后端。
💬 简单来说
OpenCode 是一款免费的命令行工具,可以让 AI 模型读取你的代码库,并直接在项目文件中编写或编辑代码,就像一个住在你终端里的编码助手。与那些绑定单一 AI 供应商的工具不同,你可以将它指向 Claude、GPT、Gemini,或者通过 Ollama、LM Studio 在自己电脑上免费运行的模型。
📌注: 本评测基于 OpenCode 官网、其文档以及 GitHub 仓库。GitHub star 数量一直在变化,此处引用的是本评测撰写时的数字,而非实时数值。OpenCode 官网给出了贡献者数量和较高的月活用户数量;本评测将其作为 OpenCode 自身的说法予以报告,而非 PromptQuorum 独立核实的事实,因为撰写时没有第三方来源能够确认这些数字。
OpenCode 是什么?
OpenCode 是一款免费开源的 AI 编码代理,根据官网介绍以终端为原生构建对象,并额外提供 IDE 模式和桌面模式。 它会直接读取并编辑你项目中的代码,而不只是建议一些片段让你手动粘贴。
- 产品类型:一个终端原生的编码代理(是一个 CLI,而不是单一的可下载安装程序应用),根据 opencode.ai 介绍还提供 IDE 和桌面界面
- 仓库:目前规范托管于 GitHub 上的 anomalyco/opencode;PromptQuorum 自身的目录调研发现这是一个经过更名/迁移的仓库,并提醒存在一个名称相似但无关的小型项目——安装前请确认自己所在的是 anomalyco/opencode 这条路径
- 许可证:根据当前 GitHub 仓库页面上的许可证徽标,为 MIT
- 规模:截至本评测已获得超过 20 万个 GitHub star;OpenCode 官网还给出了相当高的贡献者数量以及数百万级别的月活用户数量——本评测将两者都视为 OpenCode 自身的说法,而非独立核实的数字
- 定价模式:核心代理免费开源;根据 opencode.ai 介绍,OpenCode Zen 是一个单独收费的托管模型市场,与核心代理并存
OpenCode 实际能做什么?
OpenCode 从你的终端出发作为代理运行:读取你的代码库,根据你的指令直接编辑文件,根据官网介绍也可以在 IDE 模式或桌面模式下运行。
- 以终端为核心的代理:主要界面是在你的项目目录内运行的命令行会话
- IDE 与桌面模式:OpenCode 官网描述了除终端之外的其他使用方式,方便希望将其嵌入图形化工作流的开发者
- 不绑定供应商的模型访问:根据 opencode.ai 介绍,通过 Models.dev 连接 75 个以上的模型提供方,而不是自带单一的内置模型
- 指定的供应商集成:OpenCode 官网列出了对 Claude、GPT、Gemini 的直接支持,以及与 GitHub Copilot、ChatGPT Plus/Pro 账户的集成
- 本地模型访问:通过 OpenAI 兼容的提供方配置,可以让 OpenCode 对接运行在你自己电脑上的模型——具体配置见下方本地模型部分
- 隐私方面的定位:OpenCode 官网描述了一种“隐私优先”的方式,声称不在其服务器上存储代码;本评测未对该说法进行独立审计,仅按 OpenCode 自身的表述予以报告
OpenCode 如何连接本地模型
OpenCode 通过让你在配置文件中定义一个指向 OpenAI 兼容 API 端点的自定义提供方来支持本地模型——这与连接本地运行的 Ollama 或 LM Studio 服务器所用的机制完全相同。 这并不是一个独立的“本地模式”开关,而是一种通用的提供方配置,恰好可以对接任何 OpenAI 兼容的服务器,无论是本地还是远程。
- 配置文件:OpenCode 读取一份引用
https://opencode.ai/config.json结构的 JSON 配置,你需要在其中声明一个自定义的provider条目 - Ollama:将
npm设为@ai-sdk/openai-compatible,将options.baseURL设为 Ollama 自身 OpenAI 兼容 API 端口http://localhost:11434/v1,然后在该提供方的models对象下列出你本地已拉取的模型名称 - LM Studio:适用相同的模式,将
options.baseURL设为 LM Studio 的本地服务器地址http://127.0.0.1:1234/v1,并列出 LM Studio 中已加载的模型标识符 - 根据 OpenCode 官方文档,如果工具调用在本地模型上无法可靠工作,推荐的解决方法是提高 Ollama 的上下文窗口设置
num_ctx(文档建议从大约 16k–32k 开始) - 由于这是一个通用的 OpenAI 兼容提供方接口,同样的配置模式理论上适用于任何暴露 OpenAI 兼容端点的其他后端,而不仅限于 Ollama 和 LM Studio
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"ollama": {
"npm": "@ai-sdk/openai-compatible",
"name": "Ollama (local)",
"options": {
"baseURL": "http://localhost:11434/v1"
},
"models": {
"llama2": { "name": "Llama 2" }
}
}
}
}平台、定价与许可证
平台
- OpenCode 官方说明:
- 以终端为核心,额外提供 IDE 模式和桌面模式;可在 macOS、Windows 和 Linux 上运行。
费用
- OpenCode 官方说明:
- 核心代理免费开源。OpenCode Zen 是一个单独收费的托管模型市场,与核心代理并存。
许可证
- OpenCode 官方说明:
- 根据当前 GitHub 仓库页面上的许可证徽标,为 MIT。
安装方式
- OpenCode 官方说明:
- 根据 opencode.ai:运行
curl -fsSL https://opencode.ai/install | bash,或使用 npm 安装npm i -g opencode-ai@latest。
在执行任一命令之前,请在 opencode.ai 上确认当前推荐的安装方式,因为安装说明可能会在不同版本间发生变化。
安装 OpenCode
OpenCode 可以通过 shell 脚本或 npm 免费安装,源代码托管在 GitHub 上。由于它是一个基于终端的 CLI 代理,而不是单一的可下载安装程序应用,因此没有按操作系统区分的下载按钮——以下命令就是实际的安装方式。
Source | Link |
|---|---|
| 官方网站(安装说明) | opencode.ai |
| 快速安装(shell) | curl -fsSL https://opencode.ai/install | bash |
| 快速安装(npm) | npm i -g opencode-ai@latest |
| GitHub 仓库(源代码,MIT) | github.com/anomalyco/opencode |
需要终端环境(如果通过 npm 安装,还需要 Node.js)——OpenCode 没有图形化安装程序。鉴于该项目仓库迁移的历史,安装前请务必确认你到达的是 opencode.ai 本身链接的 anomalyco/opencode 仓库。
OpenCode 适合谁使用?
OpenCode 适合那些希望使用不绑定单一模型提供方的终端编码代理的开发者,包括希望针对本地托管模型运行它的用户。
OpenCode 不适合哪些场景
如果你需要长期不变的单一组织身份,或者需要 PromptQuorum 独立核实的使用统计数据而不是 OpenCode 自己公布的数字,那么 OpenCode 并不合适。
- 对于云端提供方而言并非固定成本的工具——如果你通过 Models.dev 连接的是云端模型而非本地模型,成本会随该提供方自身的定价而变化
- 未经 PromptQuorum 独立进行基准测试——本评测基于 OpenCode 官网、文档和 GitHub 仓库,而非 PromptQuorum 的实际动手测试
- 并非没有需要核实的组织历史——规范仓库曾在不同 GitHub 组织之间迁移,因此请始终确认你跟随的是 opencode.ai 当前的链接,而不是旧书签或搜索结果
- 不是单一的可下载安装程序应用——如果你特别需要一键式图形安装程序而不是终端命令,这不是合适的工具类型
评估 OpenCode 时的常见误区
关于 OpenCode 的大多数困惑,源于用户到达了错误的仓库,或者把它自身的宣传数字当作独立核实过的事实。
竞品与替代方案
OpenCode 最常被拿来与 Aider、Cline、OpenHands 和 GPT Engineer 比较——其主要差异化在于将以终端为核心的代理,与通过 Models.dev 实现的广泛模型提供方访问(75 个以上)以及针对 Ollama 和 LM Studio 明确记录的本地模型配置结合在一起。
Tool | Best known for | Link |
|---|---|---|
| Aider | 终端原生、以 git 为核心、带自动提交功能的 AI 结对编程工具 | Aider 评测 |
| Cline | 面向 VS Code 和 JetBrains 的开源自主代理扩展 | Cline 评测 |
| OpenHands | 免费、开源、可自托管的自主编码代理平台 | OpenHands 评测 |
| GPT Engineer | 可根据自然语言需求生成整个代码库的 CLI 工具 | GPT Engineer 评测 |
该列表反映的是在编码代理这一细分领域中常被拿来与 OpenCode 比较的工具,并非 PromptQuorum 的独立排名——选择前请核实每款工具当前的定价和功能集。
常见问题
OpenCode 是什么?
OpenCode(opencode.ai)是一款免费、开源、以终端为核心的 AI 编码代理,规范托管于 GitHub 上的 anomalyco/opencode,根据官网介绍还提供 IDE 模式和桌面模式。
OpenCode 是免费的吗?
核心代理免费且开源(MIT 许可证)。OpenCode Zen 是一个单独收费的托管模型市场,与核心代理并存。如果你通过 Models.dev 连接云端模型提供方,将直接向该提供方付费。
OpenCode 支持本地模型吗?
支持。你需要在 OpenCode 的配置文件中设置一个指向 OpenAI 兼容端点的自定义提供方——例如 Ollama 的本地 API http://localhost:11434/v1,或 LM Studio 的 http://127.0.0.1:1234/v1。
如何安装 OpenCode?
根据 opencode.ai:运行 curl -fsSL https://opencode.ai/install | bash,或使用 npm 安装 npm i -g opencode-ai@latest。执行任一命令前,请先在 opencode.ai 上确认当前的安装说明。
OpenCode 使用什么许可证?
根据其当前 GitHub 仓库页面上显示的许可证徽标,为 MIT。
OpenCode 支持多少个模型提供方?
根据 opencode.ai 介绍,通过与 Models.dev 的集成,支持 75 个以上,其中包括对 Claude、GPT 和 Gemini 的明确支持。
为什么 OpenCode 的仓库显示的是 anomalyco/opencode 而不是其他组织名称?
该项目的规范 GitHub 仓库在其历史上曾在不同组织之间迁移。请始终从 opencode.ai 本身跟随 GitHub 链接以到达当前的规范仓库,而不要依赖旧链接。
OpenCode 有多少 GitHub star?
截至本评测时超过 20 万个。star 数量在持续变化,请直接在 GitHub 上的 anomalyco/opencode 仓库查看当前数字。
OpenCode 的贡献者和月活用户数量是否经过独立核实?
没有。本评测按照 OpenCode 官网自身的说法报告这些数字;PromptQuorum 在撰写时未能从第三方来源独立确认它们。
PromptQuorum 是否独立测试过 OpenCode 的说法?
本评测基于 OpenCode 官网、文档和 GitHub 仓库,而非 PromptQuorum 的实际动手测试。
