在 Claude Code 生态中，oh-my-claudecode（以下简称 OMC）作为一款 Teams-first 的多智能体编排框架，通过明确的阶段化管道和专业化智能体分工，实现了复杂开发任务的高效协同。与传统的单智能体自主执行不同，OMC 将任务分解为规划（plan）、需求定义（prd）、执行（exec）、验证（verify）和修复（fix）五个阶段，每个阶段由不同的专业化智能体承担，形成类似人类软件开发团队的工作流。
团队模式的核心管道架构
OMC 的团队模式从 v4.1.7 起成为官方推荐的编排入口，取代了早期的 swarm 关键字。其完整执行管道为 team-plan → team-prd → team-exec → team-verify → team-fix 的循环结构。当用户在 Claude Code 中输入 /team 3:executor "fix all TypeScript errors" 时，系统会首先启动 plan 阶段的智能体进行任务拆解，随后由 prd 智能体生成详细的需求文档，接着由指定数量的 executor 智能体并行执行修复，最后由 verify 智能体验证结果是否满足预期，若不满足则进入 fix 阶段循环迭代。
启用 Claude Code 原生团队功能需要在 ~/.claude/settings.json 中配置 "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"。若未启用，OMC 会发出警告并尝试回退到非团队执行模式。团队规模的指定采用 N:role 语法，其中 N 表示并发智能体数量，role 指定角色类型（executor、reviewer、planner 等）。
专业化智能体生态与任务分发策略
OMC 内置了 32 个专业化智能体，涵盖架构设计（architect）、研究（researcher）、设计（designer）、测试（tester）、数据科学（data-scientist）等领域。每个智能体针对特定任务类型进行了系统提示优化，能够在对应阶段发挥最大效能。任务分发时，OMC 根据任务特征自动选择合适的智能体：简单的文件操作优先分配给轻量级 Haiku 模型，而复杂的架构决策则调用 Opus 模型进行深度推理。
这种智能路由机制是 OMC 实现成本优化的关键。官方数据显示，通过模型自动路由可以节省 30% 至 50% 的 Token 消耗。背后的逻辑在于：并非所有任务都需要最高水平的推理能力，将适合的任务分配给小型模型既能保证质量，又能显著降低运行成本。
tmux 多模型工作节点配置
从 v4.4.0 起，OMC 引入了基于 tmux 的 CLI Workers 机制，支持在真实的终端分屏中运行 Claude、Codex 和 Gemini 三个不同的 AI CLI 工具。这一设计突破了 MCP 服务器的局限，让多模型协作进入更高的灵活维度。具体使用时，通过 omc team N:codex "review auth module" 可以启动 N 个 Codex CLI 分屏执行代码审查，而 omc team N:gemini "redesign UI" 则调用 Gemini CLI 处理 UI 设计任务。混合模型场景下，/ccg 技能允许同时调用 Codex 和 Gemini，再由 Claude 进行结果综合。
需要注意的是，tmux Workers 采用按需启动、完成后即销毁的模式，不会产生空闲资源浪费。Windows 用户可使用 psmux 提供原生 tmux 兼容支持，无需 WSL 环境。
可观测性与运维配置
OMC 提供了多层次的可观测性功能。实时监控方面，HUD 状态行可以在终端底部实时显示编排进度、智能体状态和 Token 消耗统计，通过 /oh-my-claudecode:hud setup 激活。离线分析方面，每次会话的摘要保存于 .omc/sessions/*.json，完整执行日志保存于 .omc/state/agent-replay-*.jsonl，便于事后复盘和性能分析。
在通知集成方面，OMC 支持配置 Telegram、Discord、Slack 三大平台的回调通知。通过 omc config-stop-callback discord --enable --webhook <url> --tag-list "@here" 可以设置会话结束时的自动通报，Tag 机制支持平台特定的用户和角色引用格式。
技能自定义与知识复用
OMC 的技能系统允许开发者将从调试经验中提炼的解决方案固化为可复用技能文件。技能文件存放于项目级 .omc/skills/ 或用户级 ~/.omc/skills/，采用 Markdown 格式包含 name、description、triggers 和 source 字段。当用户输入触发技能关键词时，相关知识会自动注入上下文，无需手动回忆。技能管理命令包括 /skill list、/skill add、/skill remove、/skill edit 和 /skill search，而 /learner 命令则可以从会话历史中自动提取可复用的模式。
这种设计体现了 OMC 的核心理念：不只是执行任务，还要从每次执行中学习并积累组织的知识资产。随着技能库丰富，团队在面对重复问题时可以快速调用已有方案，形成良性循环。
快速启动参数参考
首次使用 OMC 时，安装仅需两步：先通过 plugin marketplace 添加仓库，再执行安装。安装完成后，在 Claude Code 中直接输入自然语言描述即可启动团队协作，例如 autopilot: build a REST API for managing tasks 会启动完全自主的执行模式，而 /team 3:executor "fix all TypeScript errors" 则启动三人团队进行并行修复。对于需求不明确的场景，/deep-interview 命令会启动苏格拉底式提问，帮助用户厘清真实需求后再进入执行阶段。
资料来源：oh-my-claudecode 官方 GitHub 仓库（https://github.com/Yeachan-Heo/oh-my-claudecode）