oh-my-claudecode - Claude Code 多智能体编排框架

约 1664 字大约 6 分钟

Claude CodeAI多智能体开源

2026-03-27

简介

oh-my-claudecode（简称 OMC）是一个基于 Claude Code 的多智能体编排框架，由 Yeachan Heo 开发，采用 TypeScript 编写，MIT 协议开源。项目在 GitHub 上获得了超过 13,000 星标，社区活跃。

OMC 的核心定位是 "Multi-agent orchestration for Claude Code. Zero learning curve."——在 Claude Code 之上构建多智能体协作层，让开发者能够将复杂任务分配给多个专业化 Agent 并行执行，同时保持零学习成本的使用体验。

项目还有姐妹版本 oh-my-codex，为 OpenAI Codex CLI 提供相同的多智能体编排能力。

解决什么问题？

单 Agent 瓶颈：Claude Code 原生是单 Agent 模式，面对大型复杂任务时效率有限。OMC 引入多 Agent 编排，支持任务拆分与并行执行
Token 成本高昂：智能模型路由（简单任务用 Haiku，复杂推理用 Opus），节省 30-50% 的 Token 消耗
任务中途失败：复杂任务可能中途停止或静默失败。Ralph 持久模式提供验证/修复循环，确保任务完整执行
调试经验无法复用：OMC 的 Skills 系统能从历史会话中提取可复用的调试模式，当类似问题再次出现时自动注入
缺乏跨模型验证：可编排 Codex CLI 和 Gemini CLI 与 Claude 协同工作，进行架构验证和设计审查
缺少可观测性：HUD 状态栏提供实时指标，会话摘要和回放日志支持事后分析

核心概念

编排模式

OMC 提供 8 种编排模式，覆盖不同场景：

模式	说明	适用场景
Team	分阶段流水线：plan → prd → exec → verify → fix	多 Agent 协同执行共享任务列表
omc team (CLI)	tmux CLI workers，在分屏中运行真实的 claude/codex/gemini 进程	按需启动，完成后自动销毁
ccg	三模型协同：Codex + Gemini 提供意见，Claude 综合决策	后端 + UI 混合工作
Autopilot	自主执行的单主 Agent	端到端特性开发
Ultrawork	最大并行度（非 Team 模式）	批量修复/重构
Ralph	带验证/修复循环的持久模式	必须完整完成的任务
Pipeline	顺序分阶段处理	多步骤转换
Ultrapilot	旧版兼容别名	历史工作流

32 种专业化 Agent

OMC 内置 32 种专业化 Agent，涵盖架构设计、研究调研、UI 设计、测试、数据科学等领域。框架通过智能路由自动将任务分配给最合适的 Agent。

Magic Keywords

通过关键词快速触发不同模式：

关键词	效果
`team`	启动 Team 编排
`autopilot`	自主执行
`ralph`	持久模式
`ulw`	最大并行度
`ralplan`	迭代规划共识
`deep-interview`	苏格拉底式需求澄清
`deepsearch`	代码库深度搜索
`ultrathink`	深度推理模式
`cancelomc` / `stopomc`	停止当前模式

安装与配置

前置要求

Claude Code CLI
Claude Max/Pro 订阅或 Anthropic API Key
tmux（Team 模式和 CLI workers 需要）
Node.js

方式一：Claude Code Plugin（推荐）

# 安装
/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode
/plugin install oh-my-claudecode

# 初始化
/setup
/omc-setup

方式二：npm 全局安装

npm i -g oh-my-claude-sisyphus@latest

可选：多 AI 提供商支持

# Gemini CLI
npm install -g @google/gemini-cli

# Codex CLI
npm install -g @openai/codex

启用 Claude Code 原生 Teams 支持：

// ~/.claude/settings.json
{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

诊断与更新

# 更新
npm i -g oh-my-claude-sisyphus@latest

# 诊断问题
/omc-doctor

使用方式

基本用法

Autopilot 自主模式 —— 让 Agent 自主完成一个完整任务：

autopilot: build a REST API for managing tasks

Team 模式 —— 启动多个执行 Agent 协同工作：

/team 3:executor "fix all TypeScript errors"

Ralph 持久模式 —— 确保任务完整完成，自动验证和修复：

ralph: refactor auth

最大并行度：

ulw fix all errors

进阶用法

跨模型审查 —— 用不同 AI 模型分别审视不同维度：

/ccg Review this PR -- architecture (Codex) and UI components (Gemini)

Deep Interview —— 在编码前通过苏格拉底式提问澄清需求：

/deep-interview "I want to build a task management app"

tmux CLI Workers —— 在 tmux 分屏中启动真实 CLI 进程：

omc team 2:codex "review auth module for security issues"
omc team 2:gemini "redesign UI components for accessibility"
omc team 1:claude "implement the payment flow"
omc team status <task-name>
omc team shutdown <task-name>

多提供商咨询：

omc ask claude "review this migration plan"
omc ask codex --prompt "identify architecture risks"
omc ask gemini --prompt "propose UI polish ideas"

实际示例

以一个完整的功能开发流程为例，展示如何使用 OMC 的 Team 模式完成一个用户认证模块：

第一步：需求澄清

/deep-interview "I need a JWT-based auth system with refresh tokens"

OMC 会通过苏格拉底式提问帮你梳理需求细节：Token 过期策略、存储方式、角色权限等。

第二步：Team 编排执行

/team 3:executor "implement JWT auth with refresh tokens"

Team 模式自动执行流水线：

team-plan —— 制定实施计划
team-prd —— 生成产品需求文档
team-exec —— 3 个 Agent 并行编码
team-verify —— 验证代码质量
team-fix —— 自动修复问题（循环直到通过）

第三步：自定义 Skill 复用

如果在开发中发现了通用模式，可以用 /learner 自动提取为可复用 Skill：

# .omc/skills/jwt-refresh-pattern.md
---
name: JWT Refresh Token Pattern
description: Standard refresh token rotation implementation
triggers: ["jwt", "refresh token", "auth"]
source: extracted
---
实现 refresh token 轮换时，确保：
1. 旧 token 立即失效
2. 新 token 对绑定到同一设备/会话
3. 异常轮换触发全部 token 撤销

如何更好地利用

从 Autopilot 开始：对于独立的功能开发任务，autopilot 模式最简单高效，一句话描述即可
复杂任务用 Team 模式：涉及多模块、多文件的改动，Team 模式的 plan → exec → verify 流水线能显著减少遗漏
用 Deep Interview 先理清需求：在动手之前，让 OMC 帮你通过提问发现遗漏的需求细节
积累 Skills 库：通过 /learner 持续提取项目特有的调试模式和最佳实践，随着 Skills 积累，OMC 会越来越"懂"你的项目
利用智能路由省钱：OMC 自动将简单任务路由到 Haiku，复杂任务路由到 Opus，无需手动切换
配置通知回调：对于长时间运行的任务，配置 Telegram/Discord/Slack 通知，任务完成时自动提醒