zhaoweiguo 的知识库

oh-my-claudecode

4分钟阅读

一句话定位： Claude Code 的零学习曲线多 Agent 编排层——用自然语言驱动 Team 流水线、并行执行、持久化任务，无需记忆任何命令。

GitHub: yeachan-heo/oh-my-claudecode Stars: 30,069 | License: MIT | Language: TypeScript npm: oh-my-claude-sisyphus | Docs: https://yeachan-heo.github.io/oh-my-claudecode-website/

为什么值得关注

  • 3 万+ stars，Claude Code 生态中最流行的编排插件
  • 零配置：/plugin install oh-my-claudecode 即用，无需学习 Claude Code 内部机制
  • Team 优先：v4.1.7 起 Team 成为规范编排面，staged pipeline 自动处理计划→PRD→执行→验证→修复
  • 跨模型编排：可同时调度 Claude / Codex / Gemini CLI 进程（tmux panes）
  • 兼容 OpenClaw 生态，提供 OpenClaw 网关集成

安装

# 推荐：Claude Code 插件市场（两条命令分开执行）
/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode
/plugin install oh-my-claudecode
 
# 或 npm 全局安装
npm i -g oh-my-claude-sisyphus@latest

核心编排模式

模式触发方式适用场景
Team（推荐）/team 3:executor "..."多 Claude Agent 协作，staged pipeline
omc team（CLI）omc team 2:codex "..."tmux 启动真实 claude/codex/gemini 进程
ccg/ccg review this PRCodex + Gemini 双模型顾问，Claude 综合
Autopilot/autopilot "build a REST API"端到端自主执行，最少干预
Ultrawork/ultrawork "fix all errors"最大并行度，非 Team 场景
Ralph/ralph "refactor auth"持久执行 + verify/fix 循环，不允许静默失败
Pipeline/pipeline ...严格顺序的多步变换
Deep Interview/deep-interview "vague idea"苏格拉底式需求澄清，写代码前先搞清楚要什么

Team Pipeline 流程

team-plan → team-prd → team-exec → team-verify → team-fix（循环）

启用 Claude Code 原生 Teams：

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

tmux CLI Workers（v4.4.0+）

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 auth-review
omc team shutdown auth-review

Worker 按需启动，任务完成后自动销毁，无空闲资源占用。

智能特性

19 个专业 Agent

架构、研究、设计、测试、数据科学等领域，含 tier 变体

智能模型路由

  • 简单任务 → Haiku（省钱）
  • 复杂推理 → Opus
  • 声称节省 30-50% token 成本

Skill 学习系统

# .omc/skills/fix-proxy-crash.md
---
name: Fix Proxy Crash
triggers: ["proxy", "aiohttp", "disconnected"]
source: extracted
---
Wrap handler at server.py:42 in try/except ClientDisconnectedError...
  • /learner 自动从会话中提取可复用模式
  • 匹配的 Skill 自动注入上下文，无需手动召回
  • 项目级（.omc/skills/）和用户级（~/.omc/skills/）两个作用域

HUD 状态栏

实时显示编排指标（当前 Agent、token 用量、任务进度）

速率限制自动恢复

omc wait --start  # 启用自动恢复守护进程

常用快捷方式（会话内）

触发效果
ralph持久执行模式（含 ultrawork）
ulwultrawork 并行模式
ralplan迭代规划共识
ultrathink深度推理模式
deepsearch代码库聚焦搜索
stopomc / cancelomc停止当前 OMC 模式

OpenClaw 集成

/oh-my-claudecode:configure-notifications
# 选择 "openclaw" → "OpenClaw Gateway"

支持 6 种 hook 事件：session-start、stop、keyword-detector、ask-user-question、pre-tool-use、post-tool-use

通知推送

支持 Telegram、Discord、Slack、Webhook，任务完成后自动推送摘要并 @ 指定成员。

依赖要求

  • Claude Code CLI + Claude Max/Pro 或 API Key
  • tmux（omc team 和速率限制检测需要）
  • 可选：Gemini CLI、Codex CLI（跨模型编排）

生态系统

关系图谱

反向链接