命令列工具
Yeachan-Heo/oh-my-claudecode avatar
Yeachan-Heo/oh-my-claudecode

Oh My ClaudeCode:從 README 讀懂能力與限制

克勞德代碼的團隊優先多代理編排。使用上面的 Claude Code 插件或終端 CLI 介面; IDE 整合只是存取 Claude Code 本身的一種可選方式。

39,185 個 Star3,503 個 ForkTypeScriptMIT

秒懂

它是什麼?
Teams-first Multi-agent orchestration for Claude Code. Use the Claude Code plugin or terminal CLI surfaces above; IDE integrations are only an optional way to access Claude Code itself. 本文以 README 可核對的介面、部署條件與維護訊號整理採用判斷。
適合誰用?
Oh My ClaudeCode 適合已能明確對應其 README 所列工作流、平台條件與介面的人;不適合把倉庫描述當成完整相容性或效能保證的人。採用前請先以專案自己的入口檢查版本、設定與輸出,例如閱讀 README、BUILD.md、安裝指南或指定的巨集與命令,確認它們在你的環境中能完成預期任務。
可以商用嗎?
可以。MIT 是寬鬆授權:你可以使用、修改並販售以它為基礎的軟體,只需保留著作權與授權聲明。
還在維護嗎?
有在維護。儲存庫在最近一天內有新的提交。
用什麼語言寫的?
主要是 TypeScript(依據 GitHub 的語言統計)。

以上回答依據專案的 GitHub 資料(最近同步於 2026年9月15日)與我們的分析,不構成法律意見。

開源專案深度解析

團隊優先的 Claude Code 編排

在 Oh My ClaudeCode 的 README 中,第 1 節的專案焦點:oh-my-claudecode 是一個 TypeScript 專案,在 Claude Code 之上新增了多智能體編排層。README 將其描述為「多智能體編排,零學習曲線」。實際上,它提供了用於 Claude Code 會話的斜線指令,以及一個獨立的 `omc` 命令列介面,用於從 shell 執行工作流程。該倉庫元資料顯示有 38,345 顆星、3,454 個分支和 3 個開放問題。它不是 Claude Code 的分支或重實作,而是透過編排技能、狀態檔案與工作程序管理來包裝並擴充它。。這一點直接關係到 團隊優先的 Claude Code 編排:它不是抽象的產品口號,而是使用者在 yeachan-heo-oh-my-claudecode-deep-analysis 中需要對照的實作邊界。若要把 Oh My ClaudeCode 放進現有流程,應先確認相關命令、檔案或設定鍵是否與目前版本一致,再觀察輸出是否符合這個專案所描述的行為。 從工程角度看,Oh My ClaudeCode 的價值在於它把 團隊優先的 Claude Code 編排 放在明確的責任範圍內。README 沒有寫出的平台條件、相容性承諾或效能數字,本文不替它補成保證;相反地,這些空白應與專案名稱、版本標籤和實際部署拓撲一起記錄。對 yeachan-heo-oh-my-claudecode-deep-analysis 而言,這種讀法能區分已公開的能力與仍需由團隊承擔的整合工作。 實際核對時,先從 Oh My ClaudeCode README 點名的入口開始,將命令列參數、設定檔位置、輸出格式與錯誤訊息分開記錄。若專案使用 package.json、.claude/omc.jsonc、BUILD.md、httplib.h、html! 巨集或 nodeLinker 等具名介面,就以該介面作為測試分界:確認檔案能被找到,確認版本能被辨識,再確認一次成功路徑與一次失敗路徑的結果。這個步驟對 yeachan-heo-oh-my-claudecode-deep-analysis 特別有用,因為它能把安裝成功、功能可用和適合長期維護三件事分開。

Plugin 與 CLI 的安裝分工

在 Oh My ClaudeCode 的 README 中,第 2 節的專案焦點:README 記錄了兩種安裝途徑。第一種是 Claude Code 市集外掛流程,使用兩條斜線指令(一次輸入一條):`/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode`,然後執行 `/plugin install oh-my-claudecode`。第二種是使用已發佈的套件名稱 `oh-my-claude-sisyphus` 進行 npm 全域安裝,該套件會同時安裝 `oh-my-claudecode` 與 `omc` 指令別名。兩種安裝後,透過 `/setup`、`/omc-setup` 或 `omc setup` 執行設定。README 提到了來自上游 `better-sqlite3` 相依套件的 `prebuild-install@7.1.3` 已知 npm 警告,該警告在 issue #2913 中追蹤。。這一點直接關係到 Plugin 與 CLI 的安裝分工:它不是抽象的產品口號,而是使用者在 yeachan-heo-oh-my-claudecode-deep-analysis 中需要對照的實作邊界。若要把 Oh My ClaudeCode 放進現有流程,應先確認相關命令、檔案或設定鍵是否與目前版本一致,再觀察輸出是否符合這個專案所描述的行為。 從工程角度看,Oh My ClaudeCode 的價值在於它把 Plugin 與 CLI 的安裝分工 放在明確的責任範圍內。README 沒有寫出的平台條件、相容性承諾或效能數字,本文不替它補成保證;相反地,這些空白應與專案名稱、版本標籤和實際部署拓撲一起記錄。對 yeachan-heo-oh-my-claudecode-deep-analysis 而言,這種讀法能區分已公開的能力與仍需由團隊承擔的整合工作。 實際核對時,先從 Oh My ClaudeCode README 點名的入口開始,將命令列參數、設定檔位置、輸出格式與錯誤訊息分開記錄。若專案使用 package.json、.claude/omc.jsonc、BUILD.md、httplib.h、html! 巨集或 nodeLinker 等具名介面,就以該介面作為測試分界:確認檔案能被找到,確認版本能被辨識,再確認一次成功路徑與一次失敗路徑的結果。這個步驟對 yeachan-heo-oh-my-claudecode-deep-analysis 特別有用,因為它能把安裝成功、功能可用和適合長期維護三件事分開。

tmux 工作程序如何承載代理

在 Oh My ClaudeCode 的 README 中,第 3 節的專案焦點:從 v4.1.7 開始,Team 成為規範的編排介面,取代了舊的 `swarm` 關鍵字。在會話中,你呼叫 `/team 3:executor "修復所有 TypeScript 錯誤"`;在終端中,你使用 `omc team N:provider "任務"`。管線按 `team-plan → team-prd → team-exec → team-verify → team-fix` 迴圈執行。CLI 變體會為 Claude、Codex、Gemini、Antigravity、Grok 與 Cursor 代理啟動真實的 tmux 工作程序面板。這些工作程序按需產生,並在任務完成時終止。團隊執行需要活動 tmux 會話,且相關 CLI 已安裝並認證。README 也記錄了一個 `/ccg` 技能,用於結合 Codex 與 Antigravity 顧問進行混合架構與 UI 審查。。這一點直接關係到 tmux 工作程序如何承載代理:它不是抽象的產品口號,而是使用者在 yeachan-heo-oh-my-claudecode-deep-analysis 中需要對照的實作邊界。若要把 Oh My ClaudeCode 放進現有流程,應先確認相關命令、檔案或設定鍵是否與目前版本一致,再觀察輸出是否符合這個專案所描述的行為。 從工程角度看,Oh My ClaudeCode 的價值在於它把 tmux 工作程序如何承載代理 放在明確的責任範圍內。README 沒有寫出的平台條件、相容性承諾或效能數字,本文不替它補成保證;相反地,這些空白應與專案名稱、版本標籤和實際部署拓撲一起記錄。對 yeachan-heo-oh-my-claudecode-deep-analysis 而言,這種讀法能區分已公開的能力與仍需由團隊承擔的整合工作。 實際核對時,先從 Oh My ClaudeCode README 點名的入口開始,將命令列參數、設定檔位置、輸出格式與錯誤訊息分開記錄。若專案使用 package.json、.claude/omc.jsonc、BUILD.md、httplib.h、html! 巨集或 nodeLinker 等具名介面,就以該介面作為測試分界:確認檔案能被找到,確認版本能被辨識,再確認一次成功路徑與一次失敗路徑的結果。這個步驟對 yeachan-heo-oh-my-claudecode-deep-analysis 特別有用,因為它能把安裝成功、功能可用和適合長期維護三件事分開。

autopilot 與 ralph 的使用邊界

在 Oh My ClaudeCode 的 README 中,第 4 節的專案焦點:除團隊模式外,README 還列出了多種執行模式。Autopilot 以單一主導代理自主執行端對端功能工作。Ralph 設有持久化的驗證/修復迴圈,Ultrawork 提供最大並行度而不使用團隊的分階段。UltraQA 迴圈直至測試、建置、lint 與型別檢查通過。表中還包括用於順序處理的 Pipeline 與遺留的 Ultrapilot 別名。v1 中引入的命名 autopilot 階段設定檔可讓你在 `.claude/omc.jsonc` 或使用者設定中定義如 `plan-build-qa` 的階段,允許四種階段序列。這些設定檔需要 Linux 與 `flock` 工具,因為其轉錄證據邊界與可復原的變更鎖。。這一點直接關係到 autopilot 與 ralph 的使用邊界:它不是抽象的產品口號,而是使用者在 yeachan-heo-oh-my-claudecode-deep-analysis 中需要對照的實作邊界。若要把 Oh My ClaudeCode 放進現有流程,應先確認相關命令、檔案或設定鍵是否與目前版本一致,再觀察輸出是否符合這個專案所描述的行為。 從工程角度看,Oh My ClaudeCode 的價值在於它把 autopilot 與 ralph 的使用邊界 放在明確的責任範圍內。README 沒有寫出的平台條件、相容性承諾或效能數字,本文不替它補成保證;相反地,這些空白應與專案名稱、版本標籤和實際部署拓撲一起記錄。對 yeachan-heo-oh-my-claudecode-deep-analysis 而言,這種讀法能區分已公開的能力與仍需由團隊承擔的整合工作。 實際核對時,先從 Oh My ClaudeCode README 點名的入口開始,將命令列參數、設定檔位置、輸出格式與錯誤訊息分開記錄。若專案使用 package.json、.claude/omc.jsonc、BUILD.md、httplib.h、html! 巨集或 nodeLinker 等具名介面,就以該介面作為測試分界:確認檔案能被找到,確認版本能被辨識,再確認一次成功路徑與一次失敗路徑的結果。這個步驟對 yeachan-heo-oh-my-claudecode-deep-analysis 特別有用,因為它能把安裝成功、功能可用和適合長期維護三件事分開。

技能、狀態與多倉庫工作區

在 Oh My ClaudeCode 的 README 中,第 5 節的專案焦點:OMC 刻意保持兩個不同的介面。終端指令從 shell 執行 `omc ...`,而會話內技能在 Claude Code 會話內執行 `/...`。README 包含一個比較表。設定是 `omc setup` 對應 `/setup` 或 `/omc-setup`。提供者查詢是 `omc ask codex "..."` 對應 `/ask codex "..."`。團隊編排是 `omc team 2:codex "..."` 對應 `/team 3:executor "..."`,但它們是不同的執行時期:CLI 啟動 tmux 工作程序,而會話內技能執行原生團隊工作流程。Autopilot、Ralph、Ultrawork 與 Deep Interview 僅作為會話內技能存在;沒有 `omc autopilot` 或 `omc ralph` 子指令。。這一點直接關係到 技能、狀態與多倉庫工作區:它不是抽象的產品口號,而是使用者在 yeachan-heo-oh-my-claudecode-deep-analysis 中需要對照的實作邊界。若要把 Oh My ClaudeCode 放進現有流程,應先確認相關命令、檔案或設定鍵是否與目前版本一致,再觀察輸出是否符合這個專案所描述的行為。 從工程角度看,Oh My ClaudeCode 的價值在於它把 技能、狀態與多倉庫工作區 放在明確的責任範圍內。README 沒有寫出的平台條件、相容性承諾或效能數字,本文不替它補成保證;相反地,這些空白應與專案名稱、版本標籤和實際部署拓撲一起記錄。對 yeachan-heo-oh-my-claudecode-deep-analysis 而言,這種讀法能區分已公開的能力與仍需由團隊承擔的整合工作。 實際核對時,先從 Oh My ClaudeCode README 點名的入口開始,將命令列參數、設定檔位置、輸出格式與錯誤訊息分開記錄。若專案使用 package.json、.claude/omc.jsonc、BUILD.md、httplib.h、html! 巨集或 nodeLinker 等具名介面,就以該介面作為測試分界:確認檔案能被找到,確認版本能被辨識,再確認一次成功路徑與一次失敗路徑的結果。這個步驟對 yeachan-heo-oh-my-claudecode-deep-analysis 特別有用,因為它能把安裝成功、功能可用和適合長期維護三件事分開。

提供者設定與授權責任

在 Oh My ClaudeCode 的 README 中,第 6 節的專案焦點:OMC 預設在 `.omc/` 下寫入執行時期狀態、會話資料、計畫、日誌與工件。倉庫的 `.gitignore` 將大部分資料保留在本地,但有一個例外:`.omc/skills/**` 保持可提交,以便專案範圍的技能與團隊共用。自訂技能儲存在 `.omc/skills/`(專案)或 `~/.omc/skills/`(使用者)中,相符的技能會自動注入上下文。對於連結的 git 工作樹,`.omc/` 位於工作樹內,因此刪除工作樹會刪除本地狀態,除非設定 `OMC_STATE_DIR`。`.omc-workspace` 標記允許幾個獨立倉庫共用一個父級狀態根。。這一點直接關係到 提供者設定與授權責任:它不是抽象的產品口號,而是使用者在 yeachan-heo-oh-my-claudecode-deep-analysis 中需要對照的實作邊界。若要把 Oh My ClaudeCode 放進現有流程,應先確認相關命令、檔案或設定鍵是否與目前版本一致,再觀察輸出是否符合這個專案所描述的行為。 從工程角度看,Oh My ClaudeCode 的價值在於它把 提供者設定與授權責任 放在明確的責任範圍內。README 沒有寫出的平台條件、相容性承諾或效能數字,本文不替它補成保證;相反地,這些空白應與專案名稱、版本標籤和實際部署拓撲一起記錄。對 yeachan-heo-oh-my-claudecode-deep-analysis 而言,這種讀法能區分已公開的能力與仍需由團隊承擔的整合工作。 實際核對時,先從 Oh My ClaudeCode README 點名的入口開始,將命令列參數、設定檔位置、輸出格式與錯誤訊息分開記錄。若專案使用 package.json、.claude/omc.jsonc、BUILD.md、httplib.h、html! 巨集或 nodeLinker 等具名介面,就以該介面作為測試分界:確認檔案能被找到,確認版本能被辨識,再確認一次成功路徑與一次失敗路徑的結果。這個步驟對 yeachan-heo-oh-my-claudecode-deep-analysis 特別有用,因為它能把安裝成功、功能可用和適合長期維護三件事分開。

編輯結論

Oh My ClaudeCode 適合已能明確對應其 README 所列工作流、平台條件與介面的人;不適合把倉庫描述當成完整相容性或效能保證的人。採用前請先以專案自己的入口檢查版本、設定與輸出,例如閱讀 README、BUILD.md、安裝指南或指定的巨集與命令,確認它們在你的環境中能完成預期任務。

官方來源

  1. Official documentation
  2. Official README
  3. Project repository
  4. Release notes
社群筆記

社群筆記