oh-my-claudecode 完全解析：用 tmux 实现 multi-agent 编排的工程哲学

type

Post

status

Published

date

Apr 29, 2026

slug

oh-my-claudecode-multi-agent-tmux-deep-dive

summary

从零理解 oh-my-claudecode：它解决了什么问题、tmux 如何成为进程总线、rate limit 检测的两层机制，以及多 agent 任务分配的评分系统。

📝 主旨内容

💡 一、OMC 是什么，解决了什么问题

oh-my-claudecode（简称 OMC）是一个架设在 Claude Code 上的 multi-agent 编排框架，口号是"零学习曲线的团队协作多 agent"。

GitHub 仓库：yeachan-heo/oh-my-claudecode，截至 2026 年 4 月已有 31.9k stars。

没有 OMC 的世界：

Claude Code 是单 agent、单 session 模型。遇到大任务时有三个核心痛点：

痛点	表现
Context 稀释	任务越长，Claude 越"忘事"，后期质量下降
Rate limit 中断	任务跑到一半触发限流，直接挂掉
全程人工干预	复杂任务需要手动拆解、逐步下命令

传统解法的问题：

手动分步下命令：效率低，需要全程盯着

写 shell 脚本串联：脆弱，context 不共享

自建 LangChain 流水线：学习成本高，维护重

OMC 的核心答案：把 Claude Code 从"单线程 REPL"变成"多线程 runtime"。

🔍 二、技术原理：tmux 是关键

为什么需要 tmux

tmux（Terminal Multiplexer）是 OMC team 模式的基础设施核心。一个终端窗口里，tmux 可以同时跑多个独立 shell session，每个 pane 是一个完全隔离的进程环境。

OMC orchestrator 通过两个 tmux 命令控制所有 worker：

tmux send-keys：向指定 pane 注入键盘输入

tmux capture-pane：抓取指定 pane 的屏幕输出

这是整个多 agent 系统的"进程总线"，零额外基础设施，不需要 Redis、消息队列、HTTP server。用一个终端工具解决了进程间通信问题，这是 OMC 最有意思的工程选择。

Rate limit 检测原理

OMC 用两层机制检测限流，而不是靠用户手动重启：

第一层：OAuth API 轮询

直接调用 Claude usage API，获取配额百分比：

拿到精确的 reset 时间，到点自动恢复，不需要猜测。

第二层：pane 文字扫描

用 tmux capture-pane 抓取每个 pane 的最后 15 行，对关键词做正则匹配：

检测到限流后，用 tmux send-keys 往 pane 里打 "1" + Enter，自动点"继续"按钮。

本质：检测 + 等待 + 自动续跑。不是绕过限制，而是把 rate limit 从"任务终止符"变成"调度信号"——没有 OMC 时任务会挂死，有了 OMC 它会等到额度恢复再自动继续。

多 agent 分工机制

OMC 的任务分配是一个硬编码评分系统，不是 LLM 实时决策：

第一步：Intent 推断

对任务文字做关键词匹配，推断任务类型：

关键词	Intent
fix build / tsc error	build-fix
debug / troubleshoot	debug
document / readme	docs
architecture / ui design	design
test / verify	verification

第二步：Worker 评分

第三步：Backend 能力预设

Worker 类型	擅长领域
Claude	code-edit, testing, general
Codex	code-review, security, architecture
Gemini	ui-design, docs, research

没有 Codex/Gemini？多个 Claude 实例互相就是不同 worker，按负载均衡分发。多 agent 不依赖异构 AI，只用 Claude 也能跑。

🔍 三、两种形态与安装方式

OMC 有两种存在形态：

1. Claude Code 插件（推荐）

通过 /plugin 命令安装，加载为 slash commands（/team、/autopilot 等），深度集成在 Claude Code 内。

2. 独立 CLI 工具

npm 全局安装，命令行直接跑 omc team ...，不依赖 Claude Code 插件系统。

安装步骤：

前置检查：

在 Claude Code 对话框里依次输入：

验证安装：

🔍 四、Skills 完整目录

OMC 内置 12 个核心 skill，覆盖开发全流程：

Skill	用途
`/autopilot`	全自动从想法到代码，单 agent 跑完整流程
`/team`	N 个 agent 协作，共享任务列表
`/ralph`	自我循环直到任务完成，内置验证审查
`/ultrawork`	高吞吐并行执行引擎
`/plan`	先访谈需求，再规划，再执行的完整流水线
`/deep-interview`	苏格拉底式需求澄清，歧义低于阈值才开始执行
`/debug`	诊断当前 session 状态、日志、traces
`/verify`	验证改动真的有效，防止假完成
`/autoresearch`	带状态的单任务改进循环，有最大运行时限制
`/ask`	路由给 Claude/Codex/Gemini 咨询，捕获结果
`/ai-slop-cleaner`	清理 AI 生成的烂代码，删除优先策略
`/skillify`	把当前 session 工作流提取成可复用 skill

三种触发方式

Skills 不只能通过 slash command 启动，还有两种隐式方式：

Slash Command（显式）

Magic Keywords（自然语言触发）

直接在对话里说关键词，OMC hook 拦截后自动激活对应 skill：

说这个	触发效果
`ultrawork` / `ulw`	ultrawork 并行模式
`ralph` / "don't stop" / "keep going"	ralph 持久循环
`think` / `ultrathink`	扩展思考模式
`analyze` / `debug` / `audit`	深度分析模式
`search` / `find` / `grep`	最大搜索力度