OpenCode + Oh My OpenCode 开源 AI 编程平台技术分析

一、概述

1. 背景介绍

OpenCode 是一个开源的 AI 编程助手平台，可作为 Claude Code 的开源替代方案。Oh My OpenCode 是构建在 OpenCode 之上的插件集合，定位类似于 Oh My Zsh 之于 Zsh，在实际使用中几乎成为默认搭配。

2. 核心价值

A. 开源免费

• 完全开源，无需付费即可使用核心功能
• 支持多种免费模型，降低使用门槛
• 社区驱动，持续迭代优化

B. 多模型兼容

支持 75+ LLM 提供商，包括：

• Anthropic（Claude）
• OpenAI（ChatGPT）
• Google（Gemini）
• 阿里云、智谱 AI 等

C. 灵活部署

提供三种使用方式：

• 终端界面（TUI）：原生响应式终端 UI
• 桌面应用：独立图形化界面程序
• IDE 扩展：可与 VS Code、JetBrains 等集成

二、系统架构

1. 整体架构

graph TB
    subgraph 用户界面
        A[TUI 界面]
        B[桌面应用]
        C[IDE 扩展]
    end

    subgraph OpenCode 核心
        D[会话管理]
        E[LSP 加载器]
        F[模型适配器]
    end

    subgraph Oh My OpenCode
        G[Sisyphus 协调器]
        H[Oracle 架构师]
        I[Librarian 研究员]
        J[Explore 探索者]
        K[Frontend 工程师]
        L[Document Writer]
        M[Multimodal 分析师]
    end

    subgraph LLM 提供商
        N[Anthropic]
        O[OpenAI]
        P[Google]
        Q[本地模型]
    end

    A --> D
    B --> D
    C --> D
    D --> E
    D --> F
    F --> N
    F --> O
    F --> P
    F --> Q
    G --> H
    G --> I
    G --> J
    G --> K
    G --> L
    G --> M

2. 核心组件

A. OpenCode 核心

• 会话管理：支持多会话并行、分享链接
• LSP 自动加载：为 LLM 自动加载语言服务器协议
• 模型适配器：统一接口对接多种 LLM 提供商

B. Oh My OpenCode 智能体

• Sisyphus：主协调器，负责任务规划和结果整合
• Oracle：架构师，负责架构设计和代码审查
• Librarian：研究员，负责文档检索和代码研究
• Explore：探索者，负责快速代码库探索
• Frontend Engineer：前端工程师，负责 UI/UX 开发
• Document Writer：文档撰写者，负责生成文档
• Multimodal Looker：多模态分析师，负责 PDF 和图像分析

三、AI 智能体范式

1. 传统方式 vs 新方式

2. 工作流程

sequenceDiagram
    participant U as 用户
    participant S as Sisyphus 协调器
    participant O as Oracle 架构师
    participant L as Librarian 研究员
    participant E as Explore 探索者
    participant F as Frontend 工程师

    U->>S: 输入任务（ultrawork）
    S->>S: 解析任务并制定计划
    S->>O: 分派架构设计任务
    S->>L: 分派文档研究任务
    S->>E: 分派代码探索任务
    O-->>S: 返回架构方案
    L-->>S: 返回研究结果
    E-->>S: 返回探索结果
    S->>F: 自动调用前端开发
    F-->>S: 返回前端代码
    S->>S: 汇总所有输出
    S-->>U: 生成最终结果

四、安装与配置

1. OpenCode 安装

A. macOS / Linux

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

B. Windows

# 使用 Chocolatey
choco install opencode

# 或使用 Scoop
scoop bucket add extras
scoop install extras/opencode

C. 通用 npm 方式

npm install -g opencode-ai

# 也支持 pnpm、yarn、bun
pnpm install -g opencode-ai
bun install -g opencode-ai
yarn global add opencode-ai

2. Oh My OpenCode 安装

# 使用 npx 安装
npx oh-my-opencode install

# 或使用 bunx（推荐，更快）
bunx oh-my-opencode install

3. LLM 提供商认证

opencode auth login

系统会列出支持的提供商，选择所需提供商并完成认证。

五、核心功能

1. ultrawork 关键字

ultrawork（简写为 ulw）是 Oh My OpenCode 的核心关键字，用于启用完整功能集。

使用方法：

# 激活完整功能
"帮我分析这个项目的架构，ultrawork"

# 使用简写
"重构这个模块，ulw"

2. 专业子智能体调用

A. 直接调用

使用 @ 符号直接调用指定子智能体：

# 调用架构师
"@oracle 审核这个设计并提出架构方案"

# 调用研究员
"@librarian 说明这是如何实现的——为什么行为总在变化？"

# 调用探索者
"@explore 查询这个功能的策略"

B. 自动调用

某些子智能体会根据任务类型自动调用：

• Frontend UI/UX Engineer：检测到前端开发相关任务
• Document Writer：检测到文档撰写相关任务
• Multimodal Looker：检测到 PDF、图像或图表分析任务

3. 自动模型切换机制

系统会根据调用的子智能体，自动使用其对应配置的模型。

工作流程示例：

1. 用户输入任务，例如"帮我分析架构，ultrawork"
2. Sisyphus 解析任务并制定执行计划
3. Sisyphus 调用 @oracle
4. 系统自动切换至 @oracle 配置的模型（如 grok-code）
5. @oracle 执行任务并返回结果
6. Sisyphus 汇总各子智能体的输出，生成最终结果

配置示例：

{
  "agents": {
    "Sisyphus": {
      "model": "opencode/glm-4.7-free"
    },
    "oracle": {
      "model": "opencode/glm-4.7-free"
    },
    "explore": {
      "model": "google/gemini-3-flash"
    }
  }
}

4. Ralph Loop（持续工作模式）

Ralph Loop 是 Oh My OpenCode 的持续工作模式。启用后，系统会自动循环执行任务，直到完成为止。

使用方法：

# 启动 Ralph Loop
/ralph-loop "实现用户认证功能"

# 取消 Ralph Loop
/cancel-ralph

配置选项：

{
  "ralph_loop": {
    "enabled": true,
    "default_max_iterations": 100
  }
}

六、常用命令

1. 斜杠命令

2. /init 命令详解

/init 命令用于初始化项目上下文：

1. 扫描项目结构
2. 分析技术栈
3. 识别关键文件
4. 生成 AGENTS.md 文件

生成的 AGENTS.md 文件可以帮助 AI 更好地理解项目，提高任务执行质量。

3. 其他快捷操作

• 更新：opencode upgrade
• 执行命令：! ls
• 退出终端：Ctrl + Z
• 切换最近使用过的模型：F2
• 切换 Plan/Build 模式：tab

七、高级配置与优化

1. 模型分配策略

不同子智能体可配置不同模型，以充分发挥各模型的优势。

推荐免费模型配置：

模型性能对比：

2. 自定义子智能体配置

修改 ~/.config/opencode/oh-my-opencode.json 文件可自定义配置：

{
  "agents": {
    "Sisyphus": {
      "model": "opencode/grok-code"
    },
    "oracle": {
      "model": "opencode/grok-code"
    },
    "librarian": {
      "model": "opencode/grok-code"
    },
    "explore": {
      "model": "opencode/minimax-m2.1-free"
    },
    "frontend": {
      "model": "opencode/glm-4.7-free"
    },
    "document_writer": {
      "model": "opencode/glm-4.7-free"
    },
    "multimodal": {
      "model": "opencode/grok-code"
    }
  }
}

3. 后台并发控制

可根据不同 LLM 提供商和模型的限制，动态调整任务的并行执行策略。

配置示例：

{
  "background_task": {
    "defaultConcurrency": 5,
    "providerConcurrency": {
      "anthropic": 3,
      "google": 5,
      "opencode": 5,
      "iflowcn": 8
    },
    "modelConcurrency": {
      "opencode/glm-4.7-free": 8,
      "google/gemini-3-flash": 5,
      "iflowcn/glm-4.6": 10
    }
  }
}

八、兼容性与迁移

1. Claude Code 兼容性

OpenCode 支持 Claude Code 的以下机制：

• 命令系统
• 子智能体
• 技能（Skills）
• MCP（Model Context Protocol）
• Hooks

便于开发者快速迁移现有工作流。

2. 迁移建议

对于从 Claude Code 迁移的用户：

1. 保持相同的命令习惯
2. 利用兼容的技能和 Hooks
3. 根据任务类型选择合适的免费模型
4. 逐步熟悉多智能体协作模式

九、总结与展望

1. 核心优势

• 开源免费：降低使用门槛
• 多模型支持：灵活选择适合的模型
• 多智能体协作：提高任务完成效率
• 兼容性好：支持从 Claude Code 迁移

2. 适用场景

• 需要多轮迭代的复杂功能开发
• 需要架构设计和代码审查的项目
• 需要并行处理多个任务的开发场景
• 希望降低 AI 编程成本的开发者

3. 发展方向

作为活跃的开源项目，OpenCode 持续迭代：

• 功能不断完善
• 支持更多 LLM 提供商
• 智能体能力持续增强
• 社区生态不断壮大

对于喜欢自定义和实验的开发者来说，OpenCode 提供了较高的可玩性和可定制性，值得尝试。

参考资料

1. 开源 AI 编程宝藏组合 OpenCode + Oh My OpenCode 完整上手攻略