ultracost 是做什麼的?
降低 Claude Code 動態工作流程成本:為每個子代理階段固定正確的模型與努力程度,在啟動前估計花費,並阻止指令碼在 Opus 上靜默執行每個階段。
功能概述
- 模型固定:為每個子代理階段指定模型(如
haiku、sonnet、opus),避免動態選擇導致的昂貴模型使用。 - 努力程度控制:設定每個階段的 effort 級別(如
low、medium、high),以平衡回應品質與成本。 - 花費預估:在執行指令碼前提供 API 花費估計,讓你能在啟動前調整配置。
- 阻擋機制:主動檢查並阻止那些未指定模型或努力程度、可能以 Opus 靜默執行的指令碼,預防預算超支。
使用方式
- 在你的 Claude Code 專案中引入此技能。
- 在子代理定義中設定
model與effort參數,例如:
agents:
- name: code-reviewer
model: sonnet
effort: medium
- 執行前查看花費估計:
claude cost-estimate
- 若指令碼未明確指定模型,Ultracost 會發出警告或直接阻擋執行。
最佳實踐
- 對簡單任務(如文件格式化)使用
haiku+low effort。 - 對中等複雜度工作(如重構)使用
sonnet+medium effort。 - 僅在需要高推理能力時(如架構設計)使用
opus+high effort。
支援平台
- Claude Code (CLI / Agent 模式)
- 與任何基於 YAML 的子代理工作流程相容。
安裝
請參考 原始儲存庫 進行安裝與設定。