oh-my-claudecode

oh-my-claudecode (OMC) 是一个专为 Claude Code 设计的增强型工作流编排层。它的核心理念是“零学习曲线”——用户无需记忆复杂的命令或理解底层架构，只需使用自然语言描述需求，OMC 即可自动调度多个专业智能体（Agents）协同工作，完成从需求澄清、架构设计到代码实现、测试验证的全流程。

从 v4.1.7 版本开始，Team 模式成为 OMC 的标准编排方式，取代了旧版的 Swarm/Ultrapilot，提供了更稳定、阶段化的流水线执行能力。同时，v4.4.0 引入了基于 tmux 的真实 CLI 工作者，支持 Codex、Gemini 与 Claude 的三模型混合编排。

极速开始：三步构建

OMC 的安装与启动极其简单，无需复杂配置：

1. 安装插件

在 Claude Code 中运行：

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

(注：NPM 包名为 oh-my-claude-sisyphus，若通过 npm 安装 CLI 工具请使用此名)

2. 初始化配置

/omc-setup

这将自动配置智能默认值、技能库和环境变量。

3. 开始构建

直接输入自然语言指令即可：

autopilot: build a REST API for managing tasks

OMC 会自动分析任务复杂度，选择合适的执行模式（如 Team 或 Autopilot），并调度智能体开始工作。

核心工作流模式

1. Team 模式 (标准推荐)

适用场景：大多数复杂开发任务，需要协作与验证。

• 机制：按 Plan → PRD → Exec → Verify → Fix 的阶段化流水线运行。
• 指令：

  /team 3:executor "fix all TypeScript errors"
  

• 优势：共享任务列表，多智能体在统一上下文中协作，自动处理依赖和冲突。
• 要求：需在 ~/.claude/settings.json 中启用 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1。

2. tmux CLI 工作者 (多模型混合)

适用场景：需要特定模型能力（如 Codex 的代码审查、Gemini 的大上下文）或真实并行隔离环境。

• 机制：在 tmux 分屏中启动真实的 CLI 进程，任务完成后自动退出，无资源浪费。
• 指令：

  # 启动 2 个 Codex 窗格进行安全审查
  /omc-teams 2:codex "review auth module for security issues"
  
  # 启动 2 个 Gemini 窗格进行 UI 重构
  /omc-teams 2:gemini "redesign UI components for accessibility"
  
  # 混合编排：Codex 分析架构 + Gemini 设计 UI
  /ccg Review this PR — architecture (Codex) and UI components (Gemini)
  

3. 其他执行模式

高级特性

1. 自定义技能与自动学习

OMC 能将调试过程中的实战经验提取为可复用的 Skill 文件，并在未来类似场景中自动注入。

• 项目级技能：存储在 .omc/skills/，优先级高，适合团队共享。
• 用户级技能：存储在 ~/.omc/skills/，全局通用。
• 管理命令：

  /skill list
  /learner extract "fix-proxy-crash"  # 手动提取当前会话模式为技能
  

2. 实时 HUD 与成本追踪

• HUD 状态栏：实时显示当前运行的智能体数量、阶段状态、Token 消耗估算。
• 智能路由：简单任务自动路由到便宜的 Haiku 模型，复杂推理使用 Opus，节省 30-50% 成本。

3. 通知与 OpenClaw 集成

• 停止回调通知：任务完成时自动发送摘要到 Telegram/Discord/Slack，并 @ 相关人员。

  omc config-stop-callback discord --enable --webhook <url> --tag-list "@here,dev-team"
  

• OpenClaw 网关：将会话事件（开始、结束、工具调用）转发到 OpenClaw，实现跨平台自动化响应。

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

4. 速率限制自动恢复

当遇到 API 速率限制时，OMC 可自动挂起会话并在限制重置后恢复，无需人工干预。

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

魔法关键词速查

对于高级用户，OMC 提供了一系列快捷指令（Magic Keywords）来显式控制行为：

(注：swarm 和 ultrapilot 已弃用，底层自动路由至 team)

维护与故障排除

• 更新插件：

  /plugin marketplace update omc
  /omc-setup  # 刷新配置
  

• 诊断工具：

  /omc-doctor  # 检查环境、缓存和配置问题
  

• 清除缓存：如果更新后出现异常，运行 /omc-doctor 并按提示清除旧插件缓存。