Oh My Claude Code – Claude Code 的多智能体编排系统

04715

oh_my_claudecode封面图

Oh My Claude Code – Claude Code 的多智能体编排系统

Oh My Claude Code Logo

Claude Code 的多智能体编排系统。零学习曲线。

无需学习 Claude Code，直接使用 OMC。

快速开始

第一步：安装

Marketplace/plugin 安装（推荐大多数 Claude Code 用户）：

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

如果您更喜欢 npm CLI/runtime 路径而不是 marketplace 流程：

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

第二步：配置

/setup
/omc-setup

第三步：开始构建

autopilot: build a REST API for managing tasks

就这么简单。其余都是自动的。

不确定从哪里开始？

如果你对需求不明确、有模糊的想法，或者想要精细控制设计：

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

深度访谈使用苏格拉底式提问在编写任何代码之前帮你理清思路。它揭示隐藏假设并通过加权维度衡量清晰度，确保你在执行前明确知道要构建什么。

Team 模式（推荐）

从 v4.1.7 开始，Team 是 OMC 的标准编排方式。旧的 swarm 关键词/技能已被移除；直接使用 team。

/team 3:executor "fix all TypeScript errors"

Team 按阶段化流水线运行：
team-plan → team-prd → team-exec → team-verify → team-fix (loop)

在 ~/.claude/settings.json 中启用 Claude Code 原生团队：

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

如果团队被禁用，OMC 会发出警告并在可能的情况下回退到非 Team 执行模式。

tmux CLI 工作者 — Codex & Gemini (v4.4.0+)

v4.4.0 移除了 Codex/Gemini MCP 服务器（x、g 提供商）。请使用 CLI 优先的 Team 运行时（omc team ...）来启动真实的 tmux 工作者窗格：

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

/omc-teams 作为旧版兼容性技能保留，现在路由到 omc team ...。

如需在一个命令中混合使用 Codex + Gemini，请使用 /ccg 技能（通过 /ask codex + /ask gemini 路由，然后 Claude 合成）：

/ccg Review this PR — architecture (Codex) and UI components (Gemini)
界面 工作者 最适合
omc team N:codex "..." N 个 Codex CLI 窗格 代码审查、安全分析、架构
omc team N:gemini "..." N 个 Gemini CLI 窗格 UI/UX 设计、文档、大上下文任务
omc team N:claude "..." N 个 Claude CLI 窗格 通过 tmux 中的 Claude CLI 处理通用任务
/ccg /ask codex + /ask gemini 三模型顾问合成

工作者按需生成，任务完成后自动退出 — 无空闲资源浪费。需要安装 codex / gemini CLI 并有活跃的 tmux 会话。

注意：包命名 — 项目品牌名为 oh-my-claudecode（仓库、插件、命令），但 npm 包以 oh-my-claude-sisyphus 发布。通过 npm/bun 安装 CLI 工具时，请使用 npm i -g oh-my-claude-sisyphus@latest。

更新

如果您通过 npm 安装了 OMC，使用发布的包名进行升级：

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

包命名说明： 仓库、插件和命令的品牌是 oh-my-claudecode，但发布的 npm 包名仍然是 oh-my-claude-sisyphus。

如果您通过 Claude Code marketplace/plugin 流程安装了 OMC，请使用以下方式更新：

# 1. 更新 marketplace 克隆
/plugin marketplace update omc

# 2. 重新运行设置以刷新配置
/setup

如果您正在从本地检出或 git 工作树进行开发，请先更新检出，然后从该工作树重新运行设置，以便活动运行时与您正在测试的代码匹配。

注意： 如果 marketplace 自动更新未启用，您需要在运行设置之前手动执行 /plugin marketplace update omc 来同步最新版本。

如果更新后遇到问题，清除旧的插件缓存：

/omc-doctor

为什么选择 oh-my-claudecode？

  • 无需配置 – 开箱即用，智能默认设置
  • Team 优先编排 – Team 是标准的多智能体界面
  • 自然语言交互 – 无需记忆命令，只需描述你的需求
  • 自动并行化 – 复杂任务自动分配给专业智能体
  • 持久执行 – 不会半途而废，直到任务验证完成
  • 成本优化 – 智能模型路由节省 30-50% 的 token
  • 从经验中学习 – 自动提取并复用问题解决模式
  • 实时可见性 – HUD 状态栏显示底层运行状态

功能特性

执行模式

针对不同场景的多种策略 – 从 Team 支持的编排到 token 高效重构。了解更多 →

模式 是什么 适用场景
Team（推荐） 标准阶段化流水线（team-plan → team-prd → team-exec → team-verify → team-fix） 在共享任务列表上协作的 Claude 智能体
omc team (CLI) tmux CLI 工作者 — 真实的 claude/codex/gemini 进程在分屏中 Codex/Gemini CLI 任务；按需生成，完成后退出
ccg 三模型顾问通过 /ask codex + /ask gemini，Claude 合成 需要 Codex 和 Gemini 的混合后端+UI 工作
Autopilot 自主执行（单个主导智能体） 最小化繁琐配置的端到端功能开发
Ultrawork 最大并行（非 Team） 不需要 Team 的突发并行修复/重构
Ralph 带有验证/修复循环的持久模式 必须完整完成的任务（无静默部分）
Pipeline 顺序化、阶段化处理 需要严格顺序的多阶段转换
Ultrapilot（旧版） 已弃用的兼容模式（autopilot pipeline 别名） 现有工作流和旧文档

智能编排

  • 19 个专业智能体（带有层级变体）涵盖架构、研究、设计、测试、数据科学
  • 智能模型路由 – 简单任务用 Haiku，复杂推理用 Opus
  • 自动委派 – 每次都选择最合适的智能体

开发者体验

  • 魔法关键词 – ralph、ulw、ralplan；Team 通过 /team 保持显式
  • HUD 状态栏 – 状态栏实时显示编排指标
  • 技能学习 – 从会话中提取可复用模式
  • 分析与成本追踪 – 了解所有会话的 token 使用情况

自定义技能

一次学习，永久复用。OMC 将调试过程中获得的实战知识提取为可移植的技能文件，并在相关场景中自动注入。

项目作用域 用户作用域
路径 .omc/skills/ ~/.omc/skills/
共享范围 团队（受版本控制） 所有项目通用
优先级 高（覆盖用户作用域） 低（回退） 
# .omc/skills/fix-proxy-crash.md
---
name: Fix Proxy Crash
description: aiohttp proxy crashes on ClientDisconnectedError
triggers: ["proxy", "aiohttp", "disconnected"]
source: extracted
---
在 server.py:42 的处理程序外包裹 try/except ClientDisconnectedError...

技能管理： /skill list | add | remove | edit | search
自动学习： /learner 以严格的质量标准提取可复用模式
自动注入： 匹配的技能自动加载到上下文中 — 无需手动调用

完整功能列表 →

魔法关键词

为高级用户提供的可选快捷方式。不用它们，自然语言也能很好地工作。Team 模式是显式的：使用 /team ... 或 omc team ... 而不是关键词触发。

关键词 效果 示例
team 标准 Team 编排 /team 3:executor "fix all TypeScript errors"
omc team tmux CLI 工作者 (codex/gemini/claude) omc team 2:codex "security review"
ccg /ask codex + /ask gemini 合成 /ccg review this PR
autopilot 全自动执行 autopilot: build a todo app
ralph 持久模式 ralph: refactor auth
ulw 最大并行化 ulw fix all errors
ralplan 迭代规划共识 ralplan this feature
deep-interview 苏格拉底式需求澄清 deep-interview "vague idea"
deepsearch 基于代码库的搜索路由 deepsearch for auth middleware
ultrathink 深度推理模式 ultrathink about this architecture
cancelomc, stopomc 停止活跃的 OMC 模式 stopomc

注意：

  • ralph 包含 ultrawork： 激活 ralph 模式时，会自动包含 ultrawork 的并行执行。无需组合关键词。
  • swarm 兼容性别名已被移除；将现有提示迁移到 /team 语法。
  • plan this / plan the 关键词触发器已被移除；使用 ralplan 或显式 /oh-my-claudecode:omc-plan。

实用工具

Provider Advisor (omc ask)

运行本地提供商 CLI 并在 .omc/artifacts/ask/ 下保存 Markdown 工件：

omc ask claude "review this migration plan"
omc ask codex --prompt "identify architecture risks"
omc ask gemini --prompt "propose UI polish ideas"
omc ask claude --agent-prompt executor --prompt "draft implementation steps"

标准环境变量：

  • OMC_ASK_ADVISOR_SCRIPT
  • OMC_ASK_ORIGINAL_TASK

阶段 1 别名 OMX_ASK_ADVISOR_SCRIPT 和 OMX_ASK_ORIGINAL_TASK 被接受，但带有弃用警告。

速率限制等待

当速率限制重置时自动恢复 Claude Code 会话。

omc wait          # 检查状态，获取指导
omc wait --start  # 启用自动恢复守护进程
omc wait --stop   # 禁用守护进程

需要： tmux（用于会话检测）

监控与可观测性

使用 HUD 进行实时可观测性，使用当前会话/重放工件进行会话后检查：

  • HUD 预设：/oh-my-claudecode:hud setup 然后使用支持的预设，例如 "omcHud": { "preset": "focused" }
  • 会话摘要：.omc/sessions/*.json
  • 重放日志：.omc/state/agent-replay-*.jsonl
  • 实时 HUD 渲染：omc hud

通知标签配置 (Telegram/Discord/Slack)

你可以配置 stop 回调发送会话摘要时要 @ 谁。

# 设置/替换标签列表
omc config-stop-callback telegram --enable --token <bot_token> --chat <chat_id> --tag-list "@alice,bob"
omc config-stop-callback discord --enable --webhook <url> --tag-list "@here,123456789012345678,role:987654321098765432"
omc config-stop-callback slack --enable --webhook <url> --tag-list "<!here>,<@U1234567890>"

# 增量更新
omc config-stop-callback telegram --add-tag charlie
omc config-stop-callback discord --remove-tag @here
omc config-stop-callback discord --clear-tags

标签规则：

  • Telegram：alice 会规范化为 @alice
  • Discord：支持 @here、@everyone、纯数字用户 ID、role:<id>
  • Slack：支持 <@MEMBER_ID>、<!channel>、<!here>、<!everyone>、<!subteam^GROUP_ID>
  • file 回调会忽略标签选项

OpenClaw 集成

将 Claude Code 会话事件转发到 OpenClaw 网关，通过您的 OpenClaw 代理实现自动化响应和工作流程。

快速设置（推荐）：

/oh-my-claudecode:configure-notifications
# → 提示时输入 "openclaw" → 选择 "OpenClaw Gateway"

手动设置： 创建 ~/.claude/omc_config.openclaw.json：

{
  "enabled": true,
  "gateways": {
    "my-gateway": {
      "url": "https://your-gateway.example.com/wake",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" },
      "method": "POST",
      "timeout": 10000
    }
  },
  "hooks": {
    "session-start": { "gateway": "my-gateway", "instruction": "Session started for {{projectName}}", "enabled": true },
    "stop":          { "gateway": "my-gateway", "instruction": "Session stopping for {{projectName}}", "enabled": true }
  }
}
环境变量： 变量 说明
OMC_OPENCLAW=1 启用 OpenClaw
OMC_OPENCLAW_DEBUG=1 启用调试日志
OMC_OPENCLAW_CONFIG=/path/to/config.json 覆盖配置文件路径
支持的钩子事件（bridge.ts 中 6 个活跃）： 事件 触发时机 主要模板变量
session-start 会话开始时 {{sessionId}}, {{projectName}}, {{projectPath}}
stop Claude 响应完成时 {{sessionId}}, {{projectName}}
keyword-detector 每次提交提示词时 {{prompt}}, {{sessionId}}
ask-user-question Claude 请求用户输入时 {{question}}, {{sessionId}}
pre-tool-use 工具调用前（高频） {{toolName}}, {{sessionId}}
post-tool-use 工具调用后（高频） {{toolName}}, {{sessionId}}
回复通道环境变量： 变量 说明
OPENCLAW_REPLY_CHANNEL 回复通道（例如 discord）
OPENCLAW_REPLY_TARGET 频道 ID
OPENCLAW_REPLY_THREAD 线程 ID

参见 scripts/openclaw-gateway-demo.mjs，这是一个通过 ClawdBot 将 OpenClaw 有效载荷转发到 Discord 的参考网关。

文档

环境要求

  • Claude Code CLI
  • Claude Max/Pro 订阅 或 Anthropic API 密钥

Platform & tmux

OMC 功能如 omc team 和速率限制检测需要 tmux：

平台 tmux 提供商 安装
macOS tmux brew install tmux
Ubuntu/Debian tmux sudo apt install tmux
Fedora tmux sudo dnf install tmux
Arch tmux sudo pacman -S tmux
Windows psmux (原生) winget install psmux
Windows (WSL2) tmux (inside WSL) sudo apt install tmux

Windows 用户： psmux 为 Windows 提供原生的 tmux 二进制文件，带有 76 个 tmux 兼容命令。无需 WSL。

可选：多 AI 编排

OMC 可以选择性地调用外部 AI 提供商进行交叉验证和设计一致性检查。非必需 — 没有它们 OMC 也能完整运行。

提供商 安装 功能
Gemini CLI npm install -g @google/gemini-cli 设计审查、UI 一致性（1M token 上下文）
Codex CLI npm install -g @openai/codex 架构验证、代码审查交叉检查

费用： 3 个 Pro 计划（Claude + Gemini + ChatGPT）每月约 $60 即可覆盖所有功能。

开源协议

MIT

灵感来源： oh-my-opencode • claude-hud • Superpowers • everything-claude-code • Ouroboros

零学习曲线。最强大能。

Star 历史

Star History Chart

💖 支持本项目

如果 Oh-My-ClaudeCode 帮助了你的工作流，请考虑赞助：

Sponsor on GitHub

为什么赞助？

  • 保持项目活跃开发
  • 赞助者获得优先支持
  • 影响路线图和功能
  • 帮助维护自由开源

其他帮助方式

  • ⭐ 为仓库加星
  • 🐛 报告问题
  • 💡 提出功能建议
  • 📝 贡献代码

原文来源：https://github.com/Yeachan-Heo/oh-my-claudecode/blob/main/README.zh.md

© 版权声明
文章版权归作者所有，未经允许请勿转载。
THE END
Ai开发团队
喜欢就支持一下吧
点赞15 分享
nicai_123@的头像-虾市广场
find-skills-虾市广场
find-skills
find-skills
34天前 86
baoyu-skills 技能集完整中文文档-虾市广场
baoyu-skills 技能集完整中文文档
baoyu-skills 技能集完整中文文档
33天前 61
gstack – Garry Tan 的 Claude Code 完全配置教程-虾市广场
gstack – Garry Tan 的 Claude Code 完全配置教程
gstack – Garry Tan 的 Claude Code 完全配置教程
29天前 59
AI智能体通信协议：MCP、ACP、A2A、ANP全面解析-虾市广场
AI智能体通信协议：MCP、ACP、A2A、ANP全面解析
AI智能体通信协议：MCP、ACP、A2A、ANP全面解析
22天前 53
LarkSuite CLI – 飞书命令行工具-虾市广场
LarkSuite CLI – 飞书命令行工具
LarkSuite CLI – 飞书命令行工具
13天前 49
Claw Code – 史上最快破 10 万星的项目-虾市广场
Claw Code – 史上最快破 10 万星的项目
Claw Code – 史上最快破 10 万星的项目
14天前 49
相关推荐
find-skills-虾市广场
find-skills
find-skills
34天前 86
baoyu-skills 技能集完整中文文档-虾市广场
baoyu-skills 技能集完整中文文档
baoyu-skills 技能集完整中文文档
33天前 61
gstack – Garry Tan 的 Claude Code 完全配置教程-虾市广场
gstack – Garry Tan 的 Claude Code 完全配置教程
gstack – Garry Tan 的 Claude Code 完全配置教程
29天前 59
AI智能体通信协议：MCP、ACP、A2A、ANP全面解析-虾市广场
AI智能体通信协议：MCP、ACP、A2A、ANP全面解析
AI智能体通信协议：MCP、ACP、A2A、ANP全面解析
22天前 53
Claw Code Parity – Rust 移植奇偶校验工作-虾市广场
Claw Code Parity – Rust 移植奇偶校验工作
Claw Code Parity – Rust 移植奇偶校验工作
14天前 49
Claw Code – 史上最快破 10 万星的项目-虾市广场
Claw Code – 史上最快破 10 万星的项目
Claw Code – 史上最快破 10 万星的项目
14天前 49
评论 抢沙发

请登录后发表评论

    暂无评论内容