OpenCode 安装 oh-my-opencode 插件完整教程

一、背景介绍

oh-my-opencode（简称 omo）是一个强大的 OpenCode 插件，提供了：

🤖 多代理编排：Sisyphus、Oracle、Librarian、Explore 等专业代理
⚡ ultrawork 模式：一个词激活所有功能
🛠️ 内置工具：LSP、AST-Grep、MCP 集成
🔗 Claude Code 兼容：完全兼容 Claude Code 的配置

二、环境准备

项目	版本/配置
机型	MacBook Pro 2019 16寸
系统	macOS (Darwin)
CPU	Intel x86_64 架构

1. 检查 OpenCode 是否已安装

opencode --version

如果未安装，运行：

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

2. 确保 Node.js 环境

node --version  # 需要 v20+npm --version

三、安装 oh-my-opencode

方法一：交互式安装（推荐）

npx oh-my-opencode install

方法二：命令行安装（无订阅用户）

# 创建临时目录mkdir -p /tmp/omo-install && cd /tmp/omo-installnpm init -ynpm install oh-my-opencode# 运行安装（无订阅选项）node node_modules/oh-my-opencode/bin/oh-my-opencode.js install \  --no-tui \  --claude=no \  --openai=no \  --gemini=no \  --copilot=no \  --opencode-zen=no \  --zai-coding-plan=no \  --opencode-go=no \  --kimi-for-coding=no

验证安装

# 检查配置cat ~/.config/opencode/opencode.jsoncat ~/.config/opencode/oh-my-openagent.json

四、配置国内模型服务

1. 配置阿里云百炼

获取 API Key：登录阿里云百炼控制台获取

配置 opencode.json：

{  "schema": "https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/dev/assets/oh-my-opencode.schema.json",  "agents": {    "hephaestus": { "model": "alibaba/qwen-coder-plus" },    "oracle": { "model": "alibaba/qwen-max" },    "librarian": { "model": "alibaba/qwen-plus" },    "explore": { "model": "alibaba/qwen-turbo" },    "prometheus": { "model": "alibaba/qwen-max" },    "metis": { "model": "alibaba/qwen-max" },    "momus": { "model": "alibaba/qwen-max" },    "atlas": { "model": "alibaba/qwen-plus" },    "sisyphus-junior": { "model": "alibaba/qwen-plus" }  },  "categories": {    "visual-engineering": { "model": "alibaba/qwen-max" },    "ultrabrain": { "model": "alibaba/qwen-max" },    "deep": { "model": "alibaba/qwen-coder-plus" },    "artistry": { "model": "alibaba/qwen-max" },    "quick": { "model": "alibaba/qwen-turbo" },    "unspecified-low": { "model": "alibaba/qwen-turbo" },    "unspecified-high": { "model": "alibaba/qwen-max" },    "writing": { "model": "alibaba/qwen-plus" }  }}

模型选择建议：

任务类型	推荐模型	说明
复杂推理、架构设计	qwen-max	最强能力
代码生成、编程	qwen-coder-plus	代码专家
日常任务、平衡	qwen-plus	性价比高
快速搜索、简单任务	qwen-turbo	速度最快

六、验证安装

# 运行诊断npx oh-my-opencode doctor# 或使用已安装的版本node /tmp/omo-install/node_modules/oh-my-opencode/bin/oh-my-opencode.js doctor

常见警告（可忽略）：

AST-Grep unavailable - 可选的代码搜索工具
Comment checker unavailable - 可选的注释检查工具
GitHub CLI missing - 可选的 GitHub 自动化工具

七、使用方法

启动 OpenCode

opencode

核心功能

ultrawork 模式：在提示词中加入 ultrawork 或 ulw
```
ultrawork 帮我重构这个模块
```

Plan 模式：按 Tab 键切换到规划模式，先制定计划再执行
多代理协作：自动分配任务给 Oracle、Librarian、Explore 等专业代理

八、配置文件位置汇总

文件	路径	用途
主配置	`~/.config/opencode/opencode.json`	Provider 和模型配置
插件配置	`~/.config/opencode/oh-my-openagent.json`	代理模型映射
API Keys	`~/.local/share/opencode/auth.json`	认证信息存储

九、注意事项

Sisyphus 代理
最佳搭配 Claude Opus，使用其他模型可能效果下降
API Key 安全
：不要将 auth.json 提交到版本控制
模型费用
：使用国内模型服务需要注意计费，建议设置预算提醒
兼容性
：oh-my-opencode 完全兼容 Claude Code 的 hooks、commands、skills

十、参考链接

OpenCode 官网：https://opencode.ai
oh-my-opencode GitHub：https://github.com/code-yeongyu/oh-my-openagent
阿里云百炼：https://bailian.console.aliyun.com/
百度千帆：https://console.bce.baidu.com/qianfan/

。