Theme / v5.3.0

Oh My ClaudeCode

Claude Code 多代理編排系統

指令詳解

omc config 指令詳解

掌握 omc config 參數設定,配置智能模型路由策略與預算警戒保護線

指令用途

雖然 OMC 具備強大的預設功能,但在實際的企業開發環境下,我們往往需要微調其內部策略。例如,當我們希望:

  • 「將簡單的檔案讀寫和常規建置交給便宜的 Claude 3.5 Haiku,而將複雜的核心算法重構與設計評審自動路由給 Claude 3.5 Sonnet / Opus」
  • 「將全域 Sisyphus 遞歸次數限制在 5 次以內,避免死循環」

這些底層策略必須透過設定檔進行微調。omc config 是專為 全域參數客製化 而設計的命令,它能在終端中直接配置並保存全域的 .omcconfig.json 檔案。


核心配置參數說明

執行 omc config show 可以查看當前配置:

{
  "version": "1.0",
  "routing": {
    "modelSelector": "smart-route",
    "cheapModel": "claude-3-5-haiku",
    "premiumModel": "claude-3-5-sonnet"
  },
  "autopilot": {
    "maxLoops": 8,
    "autoApproveTerminal": true,
    "fallbackToHuman": true
  },
  "budget": {
    "maxSessionCostUsd": 10.0,
    "warningThreshold": 0.85
  }
}

關鍵參數解讀:

  • routing.modelSelector:設為 smart-route(智慧路由)。OMC 會自動評估任務難度。若只是讀取檔案或執行終端命令,則路由至便宜的 Haiku(費用僅為 Sonnet 的 1/5);若涉及複雜的程式碼生成或衝突解決,則自動切換至 Sonnet。這能大幅降低 60% 以上的 API 開支。
  • autopilot.fallbackToHuman:當設為 true,若 Sisyphus 循環在達到 maxLoops 次後依然無法通過編譯,OMC 會安全暫停並退出自動駕駛,將主控權還給人類開發者,防止 AI 持續盲目重試造成 Token 浪費。

實戰對話範例

範例:配置智慧模型路由以節省費用

  • You:
    /opsx:explore "我們的 API 費用有點高。請幫我用 omc config 啟用智慧模型路由,把讀檔任務配給 Haiku。"
  • AI:

    好的,為了降低您的開發開支,我將調用 omc config 命令修改模型路由規則。

    OMC 呼叫: omc config set routing.modelSelector=smart-route
    OMC 回傳: [OMC] Configuration updated: routing.modelSelector set to 'smart-route'.

    效益評估
    配置已生效!現在,當我執行 view_file 或編譯驗證時,系統會自動在背景切換為 Haiku 進行處理;只有當您要求我編寫核心 C# 邏輯時,才會使用 Sonnet。這預計將為您節省 55% 的 Token 帳單費用。