系列前言
如果你正在使用 Claude Code，那么 oh-my-claudecode (OMC) 可能会彻底改变你的开发方式。这是一个由 @Yeachan-Heo 创建的开源项目，目前已有 11k+ stars，为 Claude Code 提供了强大的多代理编排能力。
为什么需要 oh-my-claudecode？
Claude Code 的局限
Claude Code 是一个强大的 AI 编程助手，但在处理复杂任务时存在一些挑战：
flowchart LR
A[复杂任务] --> B[单代理串行处理]
B --> C[上下文膨胀]
C --> D[效率下降]
D --> E[质量不稳定]
style B fill:#ffcccc
style C fill:#ffcccc
style D fill:#ffcccc
OMC 的解决方案
oh-my-claudecode 通过多代理编排解决了这些问题：
flowchart TD
A[复杂任务] --> M[OMC 编排层]
M --> S1[专业代理 1 - 架构分析]
M --> S2[专业代理 2 - 代码实现]
M --> S3[专业代理 3 - 测试验证]
S1 --> R[结果整合]
S2 --> R
S3 --> R
R --> F[高质量交付]
style M fill:#e1f5ff
style S1 fill:#e8f5e9
style S2 fill:#e8f5e9
style S3 fill:#e8f5e9
style F fill:#fff3e0
核心价值
| 特性 | 价值 |
|---|---|
| Team Mode | 多代理协作，任务自动分发与整合 |
| 32 个专业代理 | 架构师、设计师、测试工程师等各司其职 |
| 智能路由 | Haiku/Sonnet/Opus 按任务复杂度自动选择 |
| Magic Keywords | 自然语言触发复杂工作流 |
| 跨 AI 协作 | Codex/Gemini/Claude 三模型合成 |
| 自动学习 | 从会话中提取可复用技能 |
本系列教程结构
本系列共 10 篇 详细教程，涵盖从入门到高级的全部内容：
入门篇
- 入门与安装配置完全指南 - 安装、配置、验证、常见问题
- Team Mode：多代理协作的核心编排模式 - 流水线、任务列表、代理通信
- tmux CLI Workers：Codex/Gemini/Claude 多 AI 协作 - 跨 AI 编排实践
核心篇
- 编排模式详解：Autopilot/Ralph/Ultrawork/CCG - 四大执行模式场景与用法
- Magic Keywords 与 Deep-Interview：自然语言驱动 - 触发词、深度访谈、需求澄清
进阶篇
- 32 个专业代理与智能路由 - 代理类型、模型路由、委托规则
- Skills 系统：自定义技能与自动学习 - 技能创建、/learner 提取
- 验证与调试：Ralph 循环与 Trace 系统 - 持续验证、证据追踪
整合篇
- 通知集成与 HUD 状态栏 - Telegram/Discord/Slack/OpenClaw
- 实战案例：从需求到上线的完整工作流 - 端到端综合案例
核心概念速览
Team Mode 流水线
flowchart LR
A[team-plan] --> B[team-prd]
B --> C[team-exec]
C --> D[team-verify]
D --> E{通过？}
E -->|否| F[team-fix]
F --> C
E -->|是| G[完成]
style A fill:#e1f5ff
style B fill:#e3f2fd
style C fill:#e8f5e9
style D fill:#fff3e0
style F fill:#ffebee
编排模式对比
| 模式 | 特点 | 适用场景 |
|---|---|---|
| Team | 协调多代理，任务列表管理 | 复杂多步骤任务 |
| Autopilot | 单代理全自主执行 | 端到端功能开发 |
| Ralph | 持久验证循环 | 必须完成的任务 |
| Ultrawork | 最大并行度 | 批量修复/重构 |
| CCG | 三模型顾问合成 | 需要 Codex + Gemini 视角 |
Magic Keywords
| 关键词 | 效果 | 示例 |
|---|---|---|
team |
Team 模式编排 | /team 3:executor "fix all errors" |
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" |
谁适合学习 oh-my-claudecode？
- ✅ Claude Code 用户 - 提升复杂任务处理能力
- ✅ 团队技术负责人 - 规范化 AI 辅助开发流程
- ✅ AI 工程师 - 学习多代理编排最佳实践
- ✅ 追求效率的开发者 - 自动化繁琐开发工作
前置要求
- Claude Code CLI 安装和基本使用
- Claude Max/Pro 订阅 或 Anthropic API key
- 基本 Git 操作 知识
- tmux 安装（用于 Team 模式）
快速开始
# 步骤 1：安装插件
/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode
/plugin install oh-my-claudecode
# 步骤 2：初始化配置
/setup
/omc-setup
# 步骤 3：开始使用
autopilot: build a REST API for managing tasks
系列更新计划
- 第一周：教程 1-3（入门与核心）
- 第二周：教程 4-5（编排与关键词）
- 第三周：教程 6-8（进阶功能）
- 第四周：教程 9-10（整合与实战）
下一篇：教程 1：入门与安装配置完全指南
仓库地址：github.com/Yeachan-Heo/oh-my-claudecode
讨论区：欢迎在评论区分享你的 OMC 使用经验或提出问题！