跳转到主要内容
PromptQuorum为人类设计。 为AI结构化。
主页/本地LLM进阶
Coding Assistants

OpenCode 评测:开源终端编码代理

·阅读约9分钟Hans Kuepper 作者 · PromptQuorum创始人 · 开放权重与开源AI发现引擎

OpenCode 是一款免费、开源、以终端为核心的 AI 编码代理,通过 Models.dev 连接 75 个以上的模型提供方,包括通过 OpenAI 兼容端点接入的 Ollama、LM Studio 等本地后端,而不是被绑定在单一厂商的云端 API 上。 根据其官网介绍,它还提供 IDE 模式和桌面模式,但主要界面仍是命令行,并且会直接在你的项目文件中编辑代码。

关键要点

  • 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)是一款免费、开源、以终端为核心的 AI 编码代理,同时也提供 IDE 模式和桌面模式。它通过 Models.dev 连接 75 个以上的模型提供方,包括通过 OpenAI 兼容端点接入的 Ollama、LM Studio 等本地后端,因此你可以让它对接完全运行在自己电脑上的模型,而不是云端 API。本评测是对 Local LLM Software Directory 中 OpenCode 目录条目的补充,介绍它的功能、本地模型支持的具体实现方式,以及适合哪些人使用。

OpenCode 评测:开源终端编码代理

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
json
{
  "$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 适合那些希望使用不绑定单一模型提供方的终端编码代理的开发者,包括希望针对本地托管模型运行它的用户。

以下情况适合使用 OpenCode

  • 习惯从命令行工作,并希望使用一个能直接编辑项目文件的代理
  • 希望自行选择模型提供方——无论是云端(通过 Models.dev 使用 Claude、GPT、Gemini 等)还是通过 Ollama 或 LM Studio 本地托管的模型
  • 希望避免被锁定在单一 AI 编码助手内置的模型上
  • 根据 opencode.ai 介绍,有兴趣在终端之外尝试其 IDE 或桌面模式

以下情况建议考虑其他方案

  • 想要单一的图形化一体式编辑器,而不是以终端为原生构建对象的工具
  • 刚接触 git 和命令行工具,希望获得尽可能平缓的上手曲线
  • 在大规模采用前需要独立核实 OpenCode 公布的贡献者数量或月活用户数量——本评测无法从外部来源确认这些数字
  • 期望长期且单一稳定的组织背景——根据 PromptQuorum 自身目录调研,该项目的仓库曾在不同 GitHub 组织间迁移

OpenCode 不适合哪些场景

如果你需要长期不变的单一组织身份,或者需要 PromptQuorum 独立核实的使用统计数据而不是 OpenCode 自己公布的数字,那么 OpenCode 并不合适。

  • 对于云端提供方而言并非固定成本的工具——如果你通过 Models.dev 连接的是云端模型而非本地模型,成本会随该提供方自身的定价而变化
  • 未经 PromptQuorum 独立进行基准测试——本评测基于 OpenCode 官网、文档和 GitHub 仓库,而非 PromptQuorum 的实际动手测试
  • 并非没有需要核实的组织历史——规范仓库曾在不同 GitHub 组织之间迁移,因此请始终确认你跟随的是 opencode.ai 当前的链接,而不是旧书签或搜索结果
  • 不是单一的可下载安装程序应用——如果你特别需要一键式图形安装程序而不是终端命令,这不是合适的工具类型

评估 OpenCode 时的常见误区

关于 OpenCode 的大多数困惑,源于用户到达了错误的仓库,或者把它自身的宣传数字当作独立核实过的事实。

误区一:从错误的 GitHub 仓库安装

在规范的 anomalyco/opencode 仓库之外,还存在一个名称相似但无关的小型项目。请始终从 opencode.ai 本身跟随 GitHub 链接,而不是使用搜索结果或旧书签。

误区二:把“本地模型支持”当作一键开关

本地模型是通过指向 OpenAI 兼容端点(Ollama 或 LM Studio 的本地 API)的手动提供方配置来实现的,而不是一个内置的开关。请参见上方的本地模型配置部分。

误区三:把 OpenCode 的贡献者或用户数量当作独立核实过的数字来引用

本评测将这些数字作为 OpenCode 官网自身的说法予以报告,因为撰写时没有第三方来源能够确认它们——请将它们视为 OpenCode 自己公布的数字,而不是已确认的事实。

误区四:假设工具调用在任何本地模型上都能开箱即用

根据 OpenCode 官方文档,某些本地模型在你提高 Ollama 的上下文窗口设置 num_ctx 之前,工具调用可能会失败——在认定本地配置存在问题之前,请先查看 opencode.ai 上关于本地模型的最新故障排查说明。

竞品与替代方案

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 的实际动手测试。

资料来源

← 返回 本地LLM进阶

MCP