试试看 94.4k 的 OpenCode 到底火在哪里

没错，OpenCode 现在已经 94.4k 了，刚出来的时候，铺天盖地都是它的资讯，标题更是一个比一个吸人眼球，主打一个秒天秒地秒空气，拳打 Claude Code，脚踢 Codex。

那为什么 OpenCode 这么牛呢？到底是哪些亮点让众多开发者如此追捧？

今天来跟三金一起探索一下。

安装

OpenCode 是一款跨端产品，支持在 MacOS、Linux 和 Windows 上使用，且同时支持 Claude、GPT 以及 Gemini 等 75+ 的 AI 大模型。

在安装方式上，它也支持两种形式安装，分别是：

• 命令行安装
• 客户端软件

另外，它还贴心地提供了编辑器插件，接下来让我们一个一个来进行演示。

首先是命令行安装

最简单的方式就是通过以下命令来进行一键安装：

curl -fsSL  | bash

也可以使用其他包管理工具：

npm i -g opencode-ai@latest # or bun/pnpm/yarn
scoop install opencode # Windows
choco install opencode # Windows
brew install anomalyco/tap/opencode # macOS and Linux (recommended, always up to date)
brew install opencode # macOS and Linux (official brew formula, updated less)
paru -S opencode-bin # Arch Linux
mise use -g opencode # Any OS
nix run nixpkgs#opencode # or github:anomalyco/opencode for latest dev branch

使用 opencode -v 来测试是否安装成功。

输出版本之后，就表示我们已经安装成功了。

其次是客户端

桌面客户端现在还处于 BETA 期，我们可以在 opencode.ai/download 页面进行下载：

下载打开以后的页面如下图所示：

打开一个项目之后发现，它的界面其实类似于 VSCode 编辑器，区别在于它很“轻”，没有 VSCode 那么多功能：

编辑器插件

打开 VSCode 插件市场，并搜索 opencode，选下载数最多的那个：

下载好之后，右上角会展示一个 opencode 的图标，点击该图标就可以打开 opencode 的对话框了：

配置

在正式使用 OpenCode 之前，我们还需要了解一下它的配置都有哪些，比如：

• 如何接入第三方 API；
• 如何配置 MCP、Agent、Plugin；
• 以及其他高阶配置。

首先，OpenCode 的配置和其他 CLI 工具一样，也分全局和项目级。另外它还支持自定义配置文件路径和目录。

配置文件的优先级从高到低依次是：自定义配置->项目级配置->全局配置。

• OPENCODE_CONFIG：自定义配置文件路径，优先级最高。
• OPENCODE_CONFIG_DIR：自定义配置目录。
• <your_project>/opencode.json：项目级配置，优先级高。
• ~/.config/opencode/opencode.json：全局配置，优先级低。

其次，是比较常用的几个配置项介绍，比如：

• 模型配置：用来设置主模型和小模型。

{
  "$schema": "https://opencode.ai/config.json",
  "model": "minimax/minimax-m2.1", // 主模型
  "small_model": "zhipu/glm-6" // 小模型
}

• Provider 配置（接入中转 API）：比如接入 iflow 的 API Key（iflow：你礼貌吗？)。

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "iflow": {
        "npm": "@ai-sdk/openai-compatible",
        "name": "iflow",
        "options": {
          "baseURL": "https://apis.iflow.cn/v1",
          "apiKey": "sk-xxxx" // 填入自己的 key
        },
        "models": {
          "glm-4.6": {
          "name": "glm-4.6"
        }
      }
    }
  }
}

• 自动更新：默认会在启动时自动下载更新，我们也可以使用 autoupdate 配置进行关闭。
• TUI 配置：可以用来设置窗口滚动速度和差异样式，三金刚开始用 opencode 的时候发现，在 opencode 内滚动非常灵敏，还专门查了下这个配置，非常有用！

{
  "tui": {
    "scroll_speed": 3, // 滚动速度倍数
    "scroll_acceleration": { // 启动 macOS 风格加速滚动
      "enabled": true
    },
    "diff_style": "auto" // 差异显示样式
  }
}

还有一些其他配置，大家感兴趣可以查阅官方文档：opencode.ai/docs

使用

OpenCode 启动！

我们进入到一个项目中，并启动 opencod：

在 OpenCode 中，支持 75+ 的 LLM 提供商，也支持本地模型，有时还会提供一些免费模型。在三金写这篇文章的时间，OpenCode 提供了以下几个免费模型：

当然，我们也可以配置其他的 AI 模型，之前买了智谱的季卡，让我们一起通过 /connect 来配置一下：

直接搜索 zhipu 然后选择对应的选项回车：

填入你的 API key，在 submit 之后再选择一个你要使用的模型就 OK 了：

配置好之后，左下角就会展示目前正在使用的模型：

如果要接入一些第三方中转站的模型，可以按照「配置」章节中的例子进行配置。保存然后重启 opencode 即可。

初始化项目

这里说的初始化，并不是我们初始化项目代码，而是通过 opencode 内置的 /init 命令来初始化这个项目的规则文件。

其实像 Claude Code、Codex 等 CLI 工具中都具备这个能力，但 opencode 还做到了：兼容 Claude Code 的规则文件，也就是说它还会去读 CLAUDE.md。

内置 Agent

OpenCode 内置了两个 Primary Agent：Plan 和 Build。

Primary Agent 也就是主 Agent，可以和用户直接进行对话交互，想要切换 Agent 时只需要按下 tab 键即可。

让我们大概了解一下 Plan Agent 和 Build Agent：

• Build Agent：OpenCode 的默认 Agent，它有点像 iflow 中的 YOLO 模式，权限比较高。
• Plan Agent：顾名思义，计划模式。它适合进行分析和规划，像在进行修改文件以及执行一些 bash 命令时，会和用户进行确认。

给大家简单地演示一下：

• 我有一个 demo 项目，需要 AI 给我一个 TypeScript 重构方案

• 在 Plan 模式下，AI 会跟我来回沟通，确认重构方案。比如使用 ESM 还是使用 CommonJS？是升级依赖还是保持原有依赖版本。

• 切换到 Build 模式之后，告诉 AI 开始执行重构

接下来让我们 check 一下重构后的项目是否可用，以及代码质量如何。

• 在项目根目录下运行 dist/bin/aicr.js --version 来查看工具版本

dist/bin/aicr.js --version

1.0.0

• 再看看代码实现，整体来说还 OK。不过可能是受原来代码的影响，在代码架构上还不是很合理（后面借助其他工具进行强化）。

• 是否能进行 AI CR

效果是可以的！

那有主 Agent，也肯定有 SubAgent，OpenCode 内置了**两个 SubAgent，可以通过 **@ 来唤起：

• Explore Agent：算是一个本地代码仓库 RAG，可以快速进行文件、代码段的搜索以及回答代码库问题。

通过点击上图中 Explore Task 进入 SubAgent 子会话：

再通过点击上方的 ctrl+x up 回到主会话。需要注意的是，这个子会话的能力三金在 opencode 客户端并没找到，不知道是能力没对齐还是啥，我先提个 issue 先。

• General SubAgent：擅长复杂任务和多步骤任务。比如我想要继续优化迭代这个工具，给它一个方向，让它来进行任务分解

基本上到这里我们就可以使用 OpenCode 来进行编码了，因为其强大的兼容能力，我们几乎可以使用任意一种 AI 模型来进行日常开发，不用在多个 CLI 工具之间切来切去，也不用头疼这些工具的配置。我认为这是它最大的亮点。

此外，配合 oh-my-opencode，更让其如虎添翼！但由于篇幅原因，后面再跟大家分享。

火在哪里？

三金以为有以下几点：

• 完全开源：OpenCode 不似 Claude Code 那样，它是完全开源的；
• 基于开源这一点，OpenCode 的生态非常活跃，这也意味着它的迭代更新非常迅速，以后能提供更多强大便捷的功能；
• 针对不同人群支持不同形态，既有 CLI，又有编辑器插件，又有客户端；
• 如前面的章节所言，OpenCode 最大的亮点就是不锁定厂商，支持 75+ 的模型供应商，且支持本地模型，还时不时提供一波免费模型。