這篇指南適合誰
如果你剛聽說 Oh My ClaudeCode (OMC)，想知道「灌完之後到底要點什麼」，這篇就是寫給你的。我們會從安裝指令開始，走過環境健康檢查、基礎配置，最後跑通一次最簡單的 Autopilot 任務。
OMC 的核心價值是把 Claude Code 從「問一句做一步」的半手動模式，升級成「給目標，自己跑到完成」的自主代理。要享受這個價值，第一步是把環境與防線設好，否則第一次跑 Sisyphus 就會卡在 tmux 找不到或 Token 暴走。
功能導覽
OMC 不是單一工具，而是一組互相搭配的執行模式與指令。下表把主要功能映射到對應的指令，新手可以先認識表格前五個：
| 功能 | 對應指令 | 一句話定位 | 適合場景 |
|---|---|---|---|
| Autopilot 自主循環 | omc sisyphus |
反覆「修改、編譯、修錯」直到測試通過 | 升級依賴、修編譯錯誤 |
| Team Mode 並行編排 | omc team |
在多個隔離 worktree 同時跑多個 Sisyphus | 跨模組重構、多服務調查 |
| HUD 狀態列 | omc hud |
終端機底部即時顯示 Loop、Token、進度 | 任何長任務監控 |
| 全域配置 | omc config |
設定模型路由、預算上限、Autopilot 上限 | 上線前一次性調整 |
| 環境健康檢查 | omc doctor |
掃描 CLI、tmux、worktree、plugin 連線 | 出錯時的第一道防線 |
| Deep Interview | （互動技能） | 蘇格拉底式追問，釐清模糊需求 | 規格提案前 |
| Ralph 持久模式 | （執行模式） | 驗證、修復、再驗證的長循環 | 大型修復任務 |
/execute 正規執行工作流 |
/execute |
v5 取代 Ultrawork 等舊入口的 canonical execution workflow | 一般自主執行；需要平行協調時搭配 /team |
| 多 AI 協調 | （CLI skill） | 路由到 Codex、Gemini、Antigravity 等外部 AI | 架構審查、設計驗證 |
第一次用只要記得三個關鍵字：Sisyphus 跑自主修復、Team 並行、HUD 監控。其他功能會在進階範例中陸續登場。
快速上手：5 步上線流程
步驟 1：安裝 plugin 與 npm CLI
OMC 有兩條獨立的安裝管道，建議兩者都裝。在 Claude Code 工作階段中執行 marketplace 安裝：
/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode && /plugin install oh-my-claudecode在終端機安裝 npm CLI（部分技能如 ask、CLI-backed team 需要它；ccg 已於 v5.0.0 移除）：
npm i -g oh-my-claude-sisyphus@latest步驟 2：跑一次 omc doctor
omc doctoromc doctor 會用紅綠色彩列出 Claude Code CLI、tmux、npm CLI、marketplace plugin、git worktree 與 tmux session 的健康狀態。看到任何 [FAIL]，補上 --fix 讓 OMC 嘗試自動修復：
omc doctor --fix步驟 3：啟用智慧模型路由
預設配置會把所有任務都丟給 premium 模型，對新手的小任務太浪費。改成 smart-route：
omc config set routing.modelSelector=smart-route啟用後，讀檔與編譯驗證會自動路由到 Haiku（約 Sonnet 的 1/5 費用），只有真正生成程式碼才會切回 Sonnet。
步驟 4：設定會話預算上限
這是新手最重要的安全網。第一次用建議設 3 到 5 美元：
omc config set budget.maxSessionCostUsd=5.0
omc config set budget.warningThreshold=0.80達 80% 會先警告，達 100% 會強制暫停 Autopilot 並封存進度，避免背景死循環把額度吃光。
步驟 5：跑通第一次 Autopilot
挑一個小而明確的任務，例如「修好單一檔案的編譯錯誤」：
omc sisyphus --build-cmd="pnpm run build" --max-loops=5盯著 HUD 列觀察 Loop 進度與 Token 累積。第一次跑通後，你就擁有了 OMC 的核心使用模式；接著可學習 /execute、/verify、/review、/research 四個 v5 canonical workflows，以及需要平行工作時才使用的 /team。Ultrawork 已於 v5.0.0 移除，不應再作為新專案入口。
下一步
- 想理解 Sisyphus 為什麼能「不死心地修到好」，看 Sisyphus 自主循環代理與 HUD 面板。
- 想知道怎麼拆解跨模組任務，看實戰範例 003：使用 OMC Team Mode 進行跨工作區多模組重構 與 010：用 omc team 並行收集多微服務的 API 清單。
- 環境噴錯時，先回頭跑一次
omc doctor --fix，9 成的啟動問題都能在這一步解決。