OpenCode + Oh-My-OpenCode：从单模型到多代理协作的 AI 编程革命

qq_38170076

692人浏览 · 2026-03-24 10:21:13

qq_38170076 · 2026-03-24 10:21:13 发布

这两天试用了一下OpenCode, 体验超越预期, 推荐一下.

一、OpenCode：开源 AI 编程助手

1.1 核心定位

OpenCode 是一款完全开源的 AI 编程助手，提供三种使用方式：

终端界面（TUI）：专为终端用户设计，支持 Vim 风格快捷键
桌面应用：独立图形界面，从 GitHub Releases 下载
IDE 扩展：VSCode 等编辑器中的 AI 助手

这个使用方法见仁见智, 我个人是喜欢VS code中使用, 这时候需要在VS Code中安装一个同名插件.

1.2 核心特性

特性	说明
开源免费	完全开源，可自由使用和定制
多模型支持	支持 Claude、GPT、DeepSeek 等 75+ 种模型
终端原生	精心设计的 TUI 界面，操作流畅
项目感知	通过 AGENTS.md 理解项目结构和编码规范

1.3 快速安装
一键安装（推荐）：

curl -fsSL https://opencode.ai/install | bash

包管理器安装：

# macOS/Linux - Homebrew
brew install opencode
# Node.js - npm
npm install -g opencode-ai
# Node.js - pnpm
pnpm install -g opencode-ai
# Windows - Chocolatey
choco install opencode
# Windows - Scoop
scoop bucket add extras
scoop install extras/opencode

1.4 配置 LLM 提供商

OpenCode 支持多种模型配置方式：

OpenCode Zen（官方服务，最简单）, 有四个免费模型, 均可用, 就是速度有点慢. 官方推荐用M2.1.
Anthropic Claude
OpenAI
DeepSeek（国内推荐）
自定义提供商（如智谱 GLM、本地 Ollama 等）配置命令：/connect 选择提供商，然后输入 API Key。

1.5 核心使用技巧

Plan 模式 vs Build 模式

Plan 模式：AI 只提供建议和计划，不修改代码
Build 模式：AI 可以直接修改代码文件通过 Tab 键 切换模式，最佳实践是：先用 Plan 模式讨论方案，确认后再切换到 Build 模式执行。
常用命令

/init          初始化项目，生成 AGENTS.md
/connect       配置 LLM 提供商
/models        选择使用的模型
/undo          撤销上一次修改
/redo          重做撤销的修改
/share         分享当前对话

项目感知：AGENTS.md

首次运行 /init 后，OpenCode 会在项目根目录生成 AGENTS.md 文件，帮助 AI 理解：

项目的技术栈和框架
代码风格和命名规范
目录结构和模块划分
建议将此文件提交到版本控制，确保团队成员获得一致的 AI 辅助体验。

二、Oh-My-OpenCode：多代理协作插件

2.1 核心理念

很多人使用 AI 编程工具会经历从”惊艳”到”冷静”的过程：写小功能很快，但一到重构、迁移、补测试、清 ESLint 警告等大型任务就容易卡壳。Claude-code中这个问题也是存在的, 在Cladue上面有Ralph插件来做这个事儿, 但OpenCode则有更强的 Oh-My-OpenCode 插件：

不是简单叠加 UI，而是将”单模型”升级为多代理协作系统
通过主控代理 Sisyphus 负责任务拆分、委派、推进
把不同类型的工作分派给不同角色的代理，模拟真实开发团队的协作方式

2.2 代理角色

角色	职责
Sisyphus（主控）	Tech Lead + 项目经理组合，负责拆解 TODO、分配任务、推动进度
Oracle	架构设计、深度调试、复杂问题分析
Librarian	文档检索、API 查阅、资料收集
Explore	代码库探索、依赖分析、边界定位
Frontend Engineer	UI/UX 设计、前端组件开发

2.3 工作模式：

ultrawork / ulw
ultrawork（或简写 ulw）是核心的工作模式开关：

小任务：正常使用即可
大任务（跨文件/跨模块/需要查资料/需要持续推进）：开启 ultrawork 更稳

当开启 ultrawork 时，系统会：

并行探索代码库
启动后台任务
强力推进直到完成

2.4 安装配置

安装 OpenCode 后：

bunx oh-my-opencode install
# 或
npx oh-my-opencode install

安装器会自动将插件配置写入 ~/.config/opencode/opencode.json。

配置示例（模型分工+并发控制）：

{
  "$schema": "https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/master/assets/oh-my-opencode.schema.json",
  "google_auth": false,
  "agents": {
    "oracle": {
      "model": "openai/gpt-5.2"
    },
    "explore": {
      "model": "google/antigravity-gemini-3-flash"
    }
  },
  "background_task": {
    "defaultConcurrency": 5,
    "modelConcurrency": {
      "anthropic/claude-opus-4.5": 2
    }
  },
  "ralph_loop": {
    "enabled": true,
    "default_max_iterations": 100
  }
}

配置思路： 用便宜快速的模型做探索，用强力模型做关键决策，整体成本更可控、质量更稳定。

2.5 Ralph Loop：自动闭环

/ralph-loop 命令让 AI 持续迭代推进，直到检测到完成标记或达到迭代上限：

opencode
/ralph-loop "创建一个完整的用户管理 REST API：CRUD、认证、权限控制、单元测试"

适合”从零搭骨架”或需要连续推进的任务，但要写清楚验收标准。

三、典型使用场景

场景1：大型代码重构/迁移

cd your-project
opencode
ulw 将这个 Tauri 应用转换为 SaaS Web 应用，保持现有核心功能不变。先输出迁移计划与阶段拆分（每阶段验收标准），我确认后再开始写代码。

执行流程：

Sisyphus 产出 TODO / 里程碑
Explore 并行扫代码库定位入口与模块边界
Oracle 给迁移架构（替代方案、服务拆分、数据迁移）
Frontend 角色处理 UI / 页面结构
Librarian 查框架文档和迁移注意事项
场景二：批量清理代码质量问题

opencode
ulw 修复所有 ESLint 警告，遵循现有代码风格。先按模块分批处理，每批处理完都要跑 lint 并给出结果。

场景2：复杂 Debug

opencode
ultrathink 调查认证系统的间歇性失败问题：某些情况下用户被意外登出。
1) 先列出可能原因假设清单
2) 定位相关代码路径与日志点
3) 提出最小复现步骤（如果能）
4) 给出修复方案与回归测试建议

场景3：前端 UI 开发

opencode
ulw 创建一个现代化的分析仪表板：包含图表、实时更新、深色模式。UI/交互请优先交给视觉工程角色处理，主控只负责数据与集成。

配置示例：

{
  "categories": {
    "visual-engineering": {
      "model": "google/gemini-3-pro-high",
      "temperature": 0.7
    }
  }
}

场景4：研究开源实现

opencode
@librarian 研究 React Query 的缓存失效机制是如何实现的：
先给一份机制概览（失效触发条件、缓存 key、staleTime/cacheTime 等）
再找几个真实项目的使用片段与常见模式
最后总结"踩坑点"和推荐配置

四、适用人群

✅ 更适合：

遗留系统改造、大型重构、跨模块迁移
要求”别半途而废”，希望有明显推进节奏的人
愿意花点时间做配置/分工的 power user
❌ 不太适合：
只做单文件小改动、追求极简的人
不想折腾配置、只想”开箱即用自动补全”的场景

五、快速上手指南

# 1. 安装 OpenCode
curl -fsSL https://opencode.ai/install.sh | bash
# 2. 安装 Bun（用于运行插件）
curl -fsSL https://bun.sh/install | bash
# 3. 安装 Oh-My-OpenCode 插件
bunx oh-my-opencode install
# 4. 认证模型
opencode auth login  # 登录 Anthropic/OpenAI/Google
# 5. 启动测试
cd /your/project
opencode
# 输入指令测试

六、总结

维度	OpenCode	OpenCode + Oh-My-OpenCode
工作模式	单轮对话	多代理协作
任务处理	适合小任务	适合大型任务
角色分工	无	Sisyphus、Oracle、Librarian、Explore、Frontend 等
推进方式	手动推进	ultrawork 自动推进
适用场景	单文件改动、日常补全	重构、迁移、批量清理、复杂调试