README

English | 한국어 | 中文 | 日本語 | Español | Tiếng Việt | Português

 oh-my-claudecode








 Codex 用户： 查看 oh-my-codex — 为 OpenAI Codex CLI 提供同样的编排体验。

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

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

快速开始 • 文档 • CLI 参考 • 工作流 • 迁移指南 • Discord

---

 快速开始

第一步：安装
bash
/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode
/plugin install oh-my-claudecode


第二步：配置
bash
/omc-setup


如果你通过 omc --plugin-dir  或 claude --plugin-dir  运行 OMC，请在 omc setup 中添加 --plugin-dir-mode（或提前导出 OMC_PLUGIN_ROOT），以避免复制插件在运行时已经提供的技能/代理。有关完整的决策矩阵和所有可用标志，请参阅 REFERENCE.md 中的 Plugin directory flags 部分。



第三步：开始构建

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 和 ultrapilot 等旧版入口仍受支持，但现在在底层路由到 Team。

bash
/team 3:executor "fix all TypeScript errors"


Team 按阶段化流水线运行：

team-plan → team-prd → team-exec → team-verify → team-fix (loop)

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

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


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

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

v4.4.0 移除了 Codex/Gemini MCP 服务器（x、g 提供商）。请改用 /omc-teams 在 tmux 分屏中启动真实的 CLI 进程：

bash
/omc-teams 2:codex   "review auth module for security issues"
/omc-teams 2:gemini  "redesign UI components for accessibility"
/omc-teams 1:claude  "implement the payment flow"


如需同时参考 Codex 和 Gemini 的建议，请使用 /ask codex 和 /ask gemini，再由 Claude 汇总结果：

bash
/ask codex "Review this PR — architecture"
/ask gemini "Review this PR — UI components"


| 技能 | 工作者 | 最适合 |
|-------|---------|----------|
| /omc-teams N:codex | N 个 Codex CLI 窗格 | 代码审查、安全分析、架构 |
| /omc-teams N:gemini | N 个 Gemini CLI 窗格 | UI/UX 设计、文档、大上下文任务 |
| /omc-teams N:claude | N 个 Claude CLI 窗格 | 通过 tmux 中的 Claude CLI 处理通用任务 |

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

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

 更新

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

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


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

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

bash
/omc-doctor


你的 Claude 已被注入超能力。


  


---

 为什么选择 oh-my-claudecode？

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

---

 功能特性

 执行模式
针对不同场景的多种策略 - 从全自动构建到 token 高效重构。了解更多 →

| 模式 | 特点 | 适用场景 |
|------|---------|---------|
| Team（推荐） | 阶段化流水线 | 在共享任务列表上协作的 Claude 智能体 |
| omc-teams | tmux CLI 工作者 | Codex/Gemini CLI 任务；按需生成，完成后退出 |
| Autopilot | 自主执行 | 最小化繁琐配置的端到端功能开发 |
| Ralph | 持久模式 | 必须完整完成的任务 |
| Pipeline | 顺序处理 | 需要严格顺序的多阶段转换

Top issues

Discussions

Latest release

oh-my-claudecode v5.8.0: Jev effort routing, pstack skill suites, team bridge removal

 Release Notes

v5.8.0 is the first release of the 5.8 series. It removes the unused oh-my-claude-sisyphus/team MCP bridge, which is a breaking change. It also adds calibrated Jev effort routing and brings in the pstack skill suites, along with a set of ralph, hook, session-end and Windows fixes. Note: v5.7.31 was tagged but never published, so this release follows v5.7.30.

 ⚠️ Breaking Changes

- Removed the team MCP bridge (4788). The oh-my-claude-sisyphus/team package export and its MCP server bridge are