oh‑my‑claudecode

它是什么

• 一个多智能体编排工具，位于Claude Code（Anthropic 的代码聚焦 LLM 助手）之上——它允许你通过自然语言命令运行诸如构建 REST API、审查代码或重构等任务。
• 它提供两个界面：
  1. 会话内斜杠命令（/omc-setup … / /autopilot … / /team … …），你在 Claude Code 聊天窗口中输入。
  2. 基于终端的 CLI（omc …），与同一编排引擎通信，可用于脚本或 CI 流水线。
• 该项目以 oh-my-claude-sisyphus 发布在 npm 上，同时也作为 Claude Code 市场插件提供。

---

快速开始（README 展示的 3 步流程）

1. 安装
   • Claude Code 用户首选：从市场添加插件并运行 /plugin install oh-my-claudecode。
   • 或全局安装 CLI：npm i -g oh-my-claude-sisyphus@latest。
2. 设置

   /omc-setup          # 在 Claude Code 聊天中
   # 或从 shell
   omc setup
   

   这会创建配置文件（.claude/omc.jsonc 或 ~/.config/claude-omc/config.jsonc）并注册内置技能。
3. 运行任务

   /autopilot "构建一个用于管理任务的 REST API"
   

   命令被解析，生成一个 团队 的 Claude 智能体，他们规划、实现、测试并验证该功能，你会看到类似 HUD 的实时状态行。

---

核心概念与术语

术语	含义
Autopilot	默认的自主工作流，通过 规划 → 执行 → 验证 阶段运行单个主导智能体（可选 QA 步骤）。这是让 Claude “直接做”的最简单方式。
Team	一个分阶段流水线（team-plan → team-prd → team-exec → team-verify → team-fix），可以使用 tmux 窗格并行运行多个智能体。每个窗格运行提供者（Claude、Codex、Gemini、Antigravity、Grok、Cursor）的真实 CLI 版本。
/ask	查询特定提供者（例如 codex 或 antigravity）并让 Claude 综合答案的快捷方式。
Workflow / profile	一个 JSON-C 配置（.claude/omc.jsonc），定义要运行的阶段（ralplan、execution、qa，…）以及可选的模型路由。
HUD	Claude Code UI 中显示的小状态行，报告当前阶段、活动智能体、令牌使用情况和任何错误。
插件目录标志	选项（--plugin-dir、--plugin-dir-mode），告诉安装程序插件的位置，以便在运行时已提供技能时不重复技能。

---

主要特性

• 零配置启动 – 安装并运行 /omc-setup；默认设置适用于大多数项目。
• 团队优先编排 – 推荐模式；在多个 LLM 智能体之间并行化工作。
• 自然语言界面 – 你只需描述目标；无需记忆 CLI 语法。
• 成本感知路由 – 引擎可以为某些阶段选择更便宜的模型，节省 30-50% 的令牌支出。
• 持久执行 – 系统持续尝试，直到验证检查（测试、lint、类型检查）通过。
• 模式复用 – 完成的任务存储为“工件”，可在未来运行中重用。
• 实时 HUD – 智能体工作时显示进度、令牌使用情况和任何失败。

---

适用人群

• 希望自动化重复编码任务（脚手架、重构、代码审查）而无需编写自定义脚本的开发人员。
• 已经使用 Claude Code 并希望更高层编排层来运行多智能体流水线的团队。
• 需要 无头、确定性 CLI（omc …）来调用 Claude 驱动操作的 CI/CD 流水线。

---

限制与注意事项

• 高级 Team 模式需要 Linux（flock 工具）和正在运行的 tmux 会话。
• 某些命令仅存在于 Claude Code 聊天中（/autopilot、/team），不作为 CLI 子命令提供。
• npm 安装会引入原生 better-sqlite3 依赖，打印弃用警告（prebuild-install@7.1.3）；不影响功能。
• 要使用 CLI 工作器，你必须安装并认证提供者特定的 CLI（例如 codex、gemini、cursor-agent）。

---

如何保持最新

• npm 安装：npm i -g oh-my-claude-suffix…（README 称之为 sisyphus）。
• 市场：/plugin marketplace update omc 然后 /omc-setup。
• 如果插件缓存过期，运行 /omc-doctor。

---

底线

oh-my-claudecode 是一个真正的、积极维护的开源项目，在 Anthropic 的 Claude Code 之上添加了多智能体编排层。对于希望发出高级自然语言命令并让一组协调的 LLM 智能体规划、编写、测试和验证代码的开发人员来说，它很有用，无论是在 Claude Code 内部还是从终端/CI 环境。