實戰範例 009：第一次執行 omc doctor 健康檢查與 omc config 基礎設定 · Oh My ClaudeCode

實戰背景

第一次接觸 Oh My ClaudeCode (OMC) 時，最常見的挫折不是功能不夠強，而是「灌完套件卻不知道下一步」。許多新手反映：裝好了 plugin，下了 omc sisyphus 卻噴出 tmux 找不到、API key 未讀到、或 git worktree 殘留等錯誤，還沒體驗到 Autopilot 就先打退堂鼓。

痛點與問題描述：我剛把 OMC 裝起來，準備用它來跑一個小型的 Autopilot 重構。但我用的是 Windows 加 WSL，環境變數與 tmux 路徑常常跟官方文件假設的不一致。我需要一個可靠的方式，在正式啟動 Sisyphus 之前，先確認 Claude Code CLI、tmux、marketplace plugin 與 npm CLI 都在同一個頻率上，同時把模型路由與預算限制一次設好，避免第一個會話就燒掉太多額度。

本範例示範一個新手友善的上線流程：先用 omc doctor 做完整的環境健康檢查，再用 omc config 啟用智慧模型路由（smart-route）與 5 美元的會話預算上限。全程只動到設定檔，不會碰任何專案程式碼。

端到端 6 輪上線紀錄

── 第 1 輪：安裝 plugin 與 npm CLI ──

You:

我要開始用 OMC。請告訴我完整的安裝指令。

AI:
OMC 同時提供 Claude Code marketplace plugin 與 npm CLI 兩條安裝管道，兩者用途不同但可以並存。

在 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
```
安裝完成後，建議立刻跑 omc doctor 確認兩條管道都正確連線。

── 第 2 輪：執行 omc doctor 健康檢查 ──

You:
```
omc doctor
```

AI:

omc doctor 會掃描 Claude Code CLI、tmux、git worktree 與 marketplace plugin 的連線狀態，並用紅綠色彩標示問題。

OMC 回傳:
[Doctor] Claude Code CLI ............. OK (v1.34.0)
[Doctor] tmux binary ................ OK (3.4)
[Doctor] npm CLI (oh-my-claude-sisyphus) ... OK (v4.15.10)
[Doctor] marketplace plugin ......... OK ([email protected])
[Doctor] Git worktrees .............. OK (no orphans)
[Doctor] tmux sessions .............. OK (no stale 'omc-team')
[Doctor] All checks passed. Workspace healthy.
若任何一項顯示 [FAIL]，補上 --fix 讓 OMC 嘗試自動修復常見的孤兒 worktree 與死掉的 tmux session：
omc doctor --fix

── 第 3 輪：檢視目前配置 ──

You:
```
omc config show
```

AI:

預設配置如下，新手通常會想調整 routing 與 budget 兩段：
{
  "routing": {
    "modelSelector": "default",
    "cheapModel": "claude-3-5-haiku",
    "premiumModel": "claude-3-5-sonnet"
  },
  "autopilot": {
    "maxLoops": 8,
    "fallbackToHuman": true
  },
  "budget": {
    "maxSessionCostUsd": 10.0,
    "warningThreshold": 0.85
  }
}
預設 modelSelector: default 表示所有任務都走 premium 模型，對新手的小型任務來說較浪費額度。

── 第 4 輪：啟用智慧模型路由 ──

You:

omc config set routing.modelSelector=smart-route

AI:

OMC 回傳: [OMC] Configuration updated: routing.modelSelector set to 'smart-route'.

啟用後，讀檔、執行終端命令等簡單任務會自動路由到 Haiku（費用約 Sonnet 的 1/5），只有真正涉及程式碼生成或衝突解決才會切回 Sonnet。對初次嘗試 OMC 的工作流來說，這個設定通常能省下一半以上的 Token 開銷。

── 第 5 輪：設定會話預算上限 ──

You:

omc config set budget.maxSessionCostUsd=5.0
omc config set budget.warningThreshold=0.80

AI:

OMC 回傳: [OMC] Configuration updated: budget.maxSessionCostUsd set to 5.0.

預算上限是新手最重要的安全網。當會話累計花費達 4.00 美元（80%）會先跳出黃色警告，達 5.00 美元時 Autopilot 會強制暫停並封存當前進度，避免 Sisyphus 在背景陷入死循環時把額度吃光。設定值會寫入專案根目錄的 .omcconfig.json。

── 第 6 輪：啟用 HUD 面板 ──

You:
```
omc hud --enable
```
AI:
OMC 回傳:
```
[OMC] HUD panel enabled. Budget set to $5.00 USD.
[OMC] Launching background monitor...
```
終端機底部此時已渲染出動態 HUD 列： [OMC HUD] Active Workers: 0 | Total Spent: $0.00 / $5.00 (0%) | Status: Idle

這條 HUD 列會在後續每次啟動 Sisyphus 或 Team Mode 時即時更新 Loop 進度、Token 花費與剩餘預算。到這裡，環境、模型路由、預算、監控面板四層防線都就位，可以放心開始第一個 Autopilot 任務了。

關鍵學習點

先 doctor 再上工：omc doctor 是新手的第一道防線，能在 1 秒內抓出 tmux 缺失、marketplace plugin 版本不一致、孤兒 worktree 等常見啟動錯誤，建議每次開新專案都先跑一次。
smart-route 是預設省錢選項：把 routing.modelSelector 設成 smart-route，讀檔與編譯驗證交給 Haiku，能省下約 55% 的 Token 帳單，又不會影響真正需要推理的任務品質。
預算上限是新手必設：budget.maxSessionCostUsd 不是限制能力，而是防止 AI 在死循環中默默燒錢。第一次用建議設在 3 到 5 美元，熟悉後再放寬。
兩條安裝管道要對齊版本：npm CLI 與 marketplace plugin 是獨立更新，但兩邊版本差太多會出現技能找不到的報錯，可隨時用 omc doctor 檢查是否一致。