没错，OpenCode 已经飙升至 94.4k Stars。刚发布时，满屏都是它的消息，标题一个比一个吸睛——什么秒天秒地秒空气，拳打 Claude Code，脚踢 Codex，看得人直呼过瘾。
那么，OpenCode 究竟凭什么让开发者们如此追捧？今天我们就来从头详细拆解一下这款 AI 代码助手。
安装指南
OpenCode 是一款跨平台工具，全面覆盖 macOS、Linux 和 Windows，同时兼容 Claude、GPT、Gemini 等 75+ 个 AI 大模型。安装方式提供了两种主流途径：
- 命令行安装
- 桌面客户端
此外还贴心地准备了编辑器插件。下面逐一介绍。
首先是命令行安装
最简单的方式就是一条命令搞定：
curl -fsSL https://opencode.ai/install | 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 图标，点击即可打开对话框：
配置详解
正式使用之前，必须先了解它的配置项，比如：
- 如何接入第三方 API；
- MCP、Agent、Plugin 如何配置；
- 还有一些高级设置。
与大多数 CLI 工具一样，OpenCode 的配置也分全局和项目级，并支持自定义路径。优先级从高到低为：自定义配置 → 项目级配置 → 全局配置。
OPENCODE_CONFIG：自定义配置文件路径，优先级最高。OPENCODE_CONFIG_DIR：自定义配置目录。/opencode.json ~/.config/opencode/opencode.json：全局配置。
几个常用的配置项：
- 模型配置：设置主模型和小模型。
{
"$schema": "https://opencode.ai/config.json",
"model": "minimax/minimax-m2.1", // 主模型
"small_model": "zhipu/glm-6" // 小模型
}- Provider 配置：例如接入 iflow 的中转 API。
{
"$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 时，在 TUI 里滚动特别灵敏，后来才知道有专门的配置项可以调节，非常实用。
{
"tui": {
"scroll_speed": 3, // 滚动速度倍数
"scroll_acceleration": { // 启动 macOS 风格加速滚动
"enabled": true
},
"diff_style": "auto" // 差异显示样式
}
}其他配置项可以查阅官方文档：opencode.ai/docs
使用实战
启动 OpenCode！
进入一个项目，启动 opencode：
OpenCode 支持 75+ 个 LLM 提供商，也能使用本地模型，偶尔还会赠送一些免费模型。写这篇文章时，OpenCode 提供了以下几个免费模型：
当然，也可以配置其他 AI 模型。比如之前购买了智谱的季卡，通过 /connect 来配置：
搜索 zhipu，选择对应选项回车：
填入 API key，提交后再选一个要用的模型即可：
配置好后，左下角会显示当前正在使用的模型。
如果需要接入第三方中转站的模型，可以参考「配置」章节的示例进行设置，保存后重启 opencode 即可生效。
初始化项目
这里的初始化不是指项目代码初始化，而是通过 opencode 内置的 /init 命令生成项目规则文件。
其实 Claude Code、Codex 等 CLI 工具也具备类似功能，但 OpenCode 多了一个优势：兼容 Claude Code 的规则文件，也就是说它也会读取 CLAUDE.md。
内置 Agent
OpenCode 内置了两个 Primary Agent：Plan 和 Build。
Primary Agent 即主 Agent，可以直接与用户对话。想切换 Agent 时按 tab 键即可。
快速了解这两个 Agent：
- Build Agent：默认 Agent，权限较高，类似于 iflow 中的 YOLO 模式。
- Plan Agent：计划模式，适合分析和规划。需要修改文件或执行 bash 命令时，它会先与用户确认。
简单演示一下：
- 有一个 demo 项目，想让 AI 给出一个 TypeScript 重构方案。
在 Plan 模式下，AI 会来回沟通确认重构细节——比如用 ESM 还是 CommonJS？依赖升级还是保留原版？
切换到 Build 模式后，告诉 AI 开始执行重构。
接下来检查一下重构后的项目能否运行，代码质量如何：
- 在项目根目录运行
dist/bin/aicr.js --version查看版本。
dist/bin/aicr.js --version
1.0.0- 再看看代码实现，整体还行。不过受原代码影响，架构上还有优化空间（可以借助其他工具进一步强化）。
能否做 AI Code Review？尝试了一下，效果不错。
有主 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，又有编辑器插件，还有桌面客户端，覆盖了不同人群的使用场景。
- 模型自由：支持 75+ 个模型供应商，还能使用本地模型，时不时还提供免费模型，这一点确实让开发者爱不释手。
