给你的opencode开个挂🛠️OpenCode + OhMyOpenCode + CC-Switch 快速入门指南

OpenCode + OhMyOpenCode + CC-Switch 快速入门指南

打造终极 AI 编程工作流的完整配置手册

概述

工具链关系

┌─────────────────────────────────────────────────────────────┐
│                        CC-Switch                             │
│              (统一配置管理 / Provider 切换)                   │
│                           ↓                                  │
├─────────────────────────────────────────────────────────────┤
│                     OpenCode                                  │
│              (终端 AI 编程代理 / 核心引擎)                     │
│                           ↓                                  │
├─────────────────────────────────────────────────────────────┤
│                   OhMyOpenCode                                │
│           (多代理编排层 / Agent Harness / 技能扩展)            │
└─────────────────────────────────────────────────────────────┘

各工具定位

工具	定位	核心能力
OpenCode	核心引擎	终端 AI 代理、多模型支持、工具调用
OhMyOpenCode	编排增强	多代理并行、专家代理、MCP 集成
CC-Switch	配置管理	Provider 切换、API 密钥统一、MCP 同步

OpenCode 快速入门

什么是 OpenCode？

OpenCode 是一个开源的 AI 编程代理，专为终端优先的工作流设计。它支持：

终端界面 (TUI)：沉浸式命令行交互
桌面应用：跨平台 GUI 支持
IDE 扩展：VS Code、Cursor、Zed、Windsurf
多模型支持：Anthropic、OpenAI、Google、MiniMax 等

安装方式

方式一：官方安装脚本（推荐）

# Linux / macOS / WSL
curl -fsSL https://opencode.ai/install | bash

方式二：包管理器

# npm
npm i -g opencode-ai

# bun
bun add -g opencode-ai

# Homebrew (macOS)
brew install anomalyco/tap/opencode

# AUR (Arch Linux)
paru -S opencode

方式三：桌面应用

# Homebrew Cask (macOS)
brew install --cask opencode-desktop

或从 opencode.ai/download 下载对应平台的安装包。

核心命令

# 启动终端界面
opencode

# 运行单次任务（非交互模式）
opencode run "帮我重构这个组件"

# 启动 HTTP 服务（API 模式）
opencode serve

# 启动 Web UI
opencode web

# 查看版本
opencode --version

基础配置

OpenCode 的配置文件位于：

~/.config/opencode/
├── config.json      # 主配置
├── providers.json   # Provider 配置
└── mcp.json         # MCP 服务器配置

配置 API 密钥

# 方式一：环境变量
export ANTHROPIC_API_KEY="your-key"
export OPENAI_API_KEY="your-key"

# 方式二：配置文件
# 编辑 ~/.config/opencode/providers.json

支持的模型提供商

Provider	推荐模型	特点
Anthropic	Claude 4 Sonnet	编程能力强，上下文理解优秀
OpenAI	GPT-4o	综合能力强，生态完善
Google	Gemini 2.5 Pro	创意性强，多模态支持
MiniMax	MiniMax-M2.5	速度快，性价比高
DeepSeek	DeepSeek-V3	开源，成本低

OhMyOpenCode 核心理念与配置

什么是 OhMyOpenCode？

"OpenCode on Steroids" — 让 OpenCode 变成野兽级工具的插件层

OhMyOpenCode（简称 OMO）是构建在 OpenCode 之上的多代理编排层，它将 OpenCode 从一个单一的 AI 助手转变为一个多代理协作系统。

核心理念

1. 多模型编排（Multi-Model Orchestration）

单一模型 → 多模型协作

Claude/Kimi/GLM → 编排与规划
GPT → 深度推理
MiniMax → 快速响应
Gemini → 创意生成

核心理念：不绑定单一模型，而是让每个模型发挥其优势。

2. 专家代理系统（Specialist Agents）

通用代理 → 专家代理

├── Sisyphus   — 主编排代理（永不停止，直到任务完成）
├── Oracle     — 高智商顾问（架构决策、复杂调试）
├── Explore    — 代码库探索（上下文搜索）
├── Librarian  — 外部知识检索（文档、开源代码）
├── Metis      — 预规划顾问（需求分析、风险识别）
└── Momus      — 质量保证（计划审查、代码评审）

3. 异步并行执行

串行执行 → 并行执行

传统方式：
  任务1 → 任务2 → 任务3（耗时 = 1+2+3）

OhMyOpenCode：
  任务1 ─┐
  任务2 ─┼→ 汇总结果（耗时 = max(1,2,3)）
  任务3 ─┘

核心优势

优势	说明
🚀 效率提升	多代理并行，复杂任务 10x 加速
🎯 专业分工	每个代理专注擅长领域，输出质量更高
🔓 无锁定	支持所有主流模型，不被单一厂商绑定
🛠️ MCP 生态	内置多种 MCP 服务器，能力无限扩展
📝 技能系统	可复用的 Prompt 模板和工具链

安装配置

安装 OhMyOpenCode

# 克隆仓库
git clone https://github.com/code-yeongyu/oh-my-openagent.git
cd oh-my-openagent

# 安装依赖
pnpm install

# 构建并链接到 OpenCode
pnpm link:opencode

配置文件结构

~/.config/opencode/
├── skills/                    # 技能目录
│   └── omo/
│       ├── SKILL.md           # 技能定义
│       └── ...
├── agents/                    # 代理配置
│   └── ...
└── mcp/                       # MCP 服务器
    └── ...

核心 Skills

/omo - 多代理编排

最强大的 Skill，用于复杂任务的分解与编排：

/omo

触发场景：
- "分析这个 bug 并修复"
- "重构这个模块"
- "实现新功能"

/git-master - Git 专家

# 加载 Git 技能
/load-skills git-master

# 原子提交、rebase/squash、历史搜索

/playwright - 浏览器自动化

# 加载 Playwright 技能
/load-skills playwright

# 浏览器测试、截图、表单填写

/frontend-ui-ux - 前端开发专家

# 加载前端技能
/load-skills frontend-ui-ux

# UI/UX 设计、样式优化

使用示例

# 启动 OpenCode
opencode

# 在 OpenCode 中：

# 1. 加载技能
> /load-skills omo

# 2. 执行复杂任务
> 分析 src/auth 模块的安全问题并提出修复方案

# OMO 会自动：
# - 启动 Explore 代理搜索代码
# - 启动 Oracle 代理分析安全问题
# - 启动 Sisyphus 代理执行修复

CC-Switch 配置管理

什么是 CC-Switch？

CC-Switch 是一个跨平台的 AI CLI 工具配置管理器，解决了多工具配置碎片化的问题：

统一管理：一个面板管理所有 AI 工具配置
一键切换：Provider/Model 即时切换
配置同步：MCP、Skills、Prompts 自动同步

支持的工具

工具	配置文件	支持程度
Claude Code	`~/.claude/settings.json`	✅ 完全支持
OpenCode	`~/.config/opencode/`	✅ 完全支持
Gemini CLI	`~/.gemini/.env`	✅ 完全支持
OpenAI Codex	`~/.codex/auth.json`	✅ 完全支持

安装方式

方式一：下载安装包

从 GitHub Releases 下载对应平台：

macOS (Apple Silicon / Intel)
Windows (x64)
Linux (.deb / .rpm)

方式二：Homebrew (macOS)

brew install --cask cc-switch

核心功能

1. Provider 管理

# 添加 Provider
Providers:
  - 名称: Anthropic
    API Key: sk-ant-xxx
    Base URL: https://api.anthropic.com
    
  - 名称: OpenAI
    API Key: sk-xxx
    Base URL: https://api.openai.com
    
  - 名称: Custom
    API Key: your-key
    Base URL: https://your-proxy.com

2. 一键切换

┌─────────────────────────────────────┐
│  CC-Switch 系统托盘                  │
│                                     │
│  当前 Provider: Anthropic           │
│  ────────────────────────────────   │
│  ○ Anthropic (Claude 4)             │
│  ○ OpenAI (GPT-4o)                  │
│  ○ Google (Gemini 2.5 Pro)          │
│  ○ MiniMax (M2.5)                   │
│  ○ Custom Provider                  │
└─────────────────────────────────────┘

3. MCP 服务器管理

// CC-Switch 统一管理 MCP 配置
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-server-filesystem", "/path/to/project"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-server-github"]
    },
    "playwright": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-server-playwright"]
    }
  }
}

自动同步到：

~/.claude.json (Claude Code)
~/.config/opencode/mcp.json (OpenCode)
~/.gemini/settings.json (Gemini CLI)

配置文件位置

CC-Switch 采用 SSOT (Single Source of Truth) 设计：

~/.cc-switch/
├── config.json        # 主配置（Provider、API Keys）
├── mcp.json           # MCP 服务器配置
├── prompts/           # 自定义 Prompts
└── skills/            # Skills 管理

与 CrazyRouter / NewAPI 集成

如果你使用 API 代理服务：

{
  "provider": "custom",
  "name": "CrazyRouter",
  "baseUrl": "https://api.crazyrouter.com/v1",
  "apiKey": "your-key",
  "models": ["claude-4-sonnet", "gpt-4o", "gemini-2.5-pro"]
}

最佳实践与工作流

配置清单

必备配置

# 1. 安装工具
curl -fsSL https://opencode.ai/install | bash
# 下载 CC-Switch: https://github.com/farion1231/cc-switch/releases

# 2. 配置 API Keys（通过 CC-Switch 或环境变量）
export ANTHROPIC_API_KEY="sk-ant-xxx"

# 3. 安装 OhMyOpenCode
git clone https://github.com/code-yeongyu/oh-my-openagent.git
cd oh-my-openagent && pnpm install && pnpm link:opencode

常见场景

场景一：代码审查

opencode

> /load-skills omo
> 审查 src/utils 目录下的代码，找出潜在的性能问题

场景二：Bug 修复

opencode

> /load-skills omo
> 分析这个错误：[粘贴错误信息]，找到根本原因并修复

场景三：新功能开发

opencode

> /load-skills omo,frontend-ui-ux
> 实现一个用户头像上传组件，支持裁剪和预览

场景四：切换模型

# 通过 CC-Switch 一键切换
# 或命令行：

# 切换到 GPT-4o（适合推理任务）
cc-switch use openai

# 切换到 Claude（适合编程任务）
cc-switch use anthropic

# 切换到 MiniMax（快速响应）
cc-switch use minimax

成本优化建议

任务类型	推荐模型	原因
快速问答	MiniMax / DeepSeek	成本低，速度快
代码生成	Claude Sonnet	编程能力强
架构设计	Claude Opus / GPT-4o	推理深度好
批量处理	DeepSeek / MiniMax	性价比高

常见问题

Q: OpenCode 和 Claude Code 有什么区别？

特性	OpenCode	Claude Code
开源	✅ 完全开源	❌ 闭源
多模型支持	✅ 所有主流模型	❌ 仅 Claude
可扩展性	✅ Skills/MCP	❌ 有限
成本	灵活选择	固定定价

Q: 必须安装这三个工具吗？

不是必须的，但推荐：

最小配置：OpenCode（满足基本需求）
推荐配置：OpenCode + OhMyOpenCode（解锁多代理能力）
完整配置：三者都安装（最便捷的管理体验）

Q: 如何选择合适的模型？

复杂编程任务 → Claude 4 Sonnet / Opus
快速原型开发 → MiniMax M2.5
创意设计     → Gemini 2.5 Pro
预算有限     → DeepSeek-V3

参考链接

OpenCode: opencode.ai
OhMyOpenCode: github.com/code-yeongy…
CC-Switch: github.com/farion1231/…
OpenCode 文档: opencode.ai/docs
MCP 协议: modelcontextprotocol.io

📝 最后更新：2026-03-20

给你的opencode开个挂🛠️

OpenCode + OhMyOpenCode + CC-Switch 快速入门指南

目录

概述

工具链关系

各工具定位

OpenCode 快速入门

什么是 OpenCode？

安装方式

方式一：官方安装脚本（推荐）

方式二：包管理器

方式三：桌面应用

核心命令

基础配置

配置 API 密钥

支持的模型提供商

OhMyOpenCode 核心理念与配置

什么是 OhMyOpenCode？

核心理念

1. 多模型编排（Multi-Model Orchestration）

2. 专家代理系统（Specialist Agents）

3. 异步并行执行

核心优势

安装配置

安装 OhMyOpenCode

配置文件结构

核心 Skills

/omo - 多代理编排

/git-master - Git 专家

/playwright - 浏览器自动化

/frontend-ui-ux - 前端开发专家

使用示例

CC-Switch 配置管理

什么是 CC-Switch？

支持的工具

安装方式

方式一：下载安装包

方式二：Homebrew (macOS)

核心功能

1. Provider 管理

2. 一键切换

3. MCP 服务器管理

配置文件位置

与 CrazyRouter / NewAPI 集成

最佳实践与工作流

推荐工作流

配置清单

必备配置

推荐的 MCP 服务器

常见场景

场景一：代码审查

场景二：Bug 修复

场景三：新功能开发

场景四：切换模型

成本优化建议

常见问题

Q: OpenCode 和 Claude Code 有什么区别？

Q: 必须安装这三个工具吗？

Q: 如何选择合适的模型？

参考链接