ecomode について
Ecomodeは、Oh My ClaudeCodeのモデルルーティング用修飾機能で、低コストのモデル階層を優先し、必要に応じて上位へ切り替えます。実行モードと併用できますが、単独では継続実行や並列実行を行いません。
主な機能
- 01低いモデル階層を優先
- 02下位階層で失敗した場合に昇格
- 03実行モードとの併用
- 04階層に応じたエージェント選択
- 05状態管理と無効化に対応
活用シーン
- 01定型タスクを低い階層に割り当て
- 02コスト重視のルーティングとRalphの併用
- 03Ultraworkでタスクを並列処理
- 04設定による修飾機能の無効化
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ yeachan-heo/ oh-my-claudecode --skill ecomodeインストール後、Claude Code で/ecomodeを入力して読み込まれたか確認します。
詳細
Ecomode スキル
トークン効率を重視したモデルのルーティングです。これは修飾子であり、単独で実行するモードではありません。
Ecomode の機能
デフォルトのモデル選択を上書きし、より低コストのティアを優先します。
| デフォルトのティア | Ecomode による上書き |
|---|---|
| HIGH (opus) | MEDIUM (sonnet)。不可欠な場合に限り HIGH |
| MEDIUM (sonnet) | まず LOW (haiku) を使用し、失敗した場合は MEDIUM |
| LOW (haiku) | LOW (haiku) — 変更なし |
Ecomode で行わないこと
- 状態の維持:「完了するまで止めない」場合は
ralphを使用します - 並列実行:エージェントを並列実行する場合は
ultraworkを使用します - 委任の強制:コアオーケストレーションによって常に有効です
Ecomode とほかのモードの併用
Ecomode は実行モードと組み合わせて使う修飾子です。
| 組み合わせ | 効果 |
|---|---|
eco ralph | より低コストのエージェントを使用する Ralph ループ |
eco ultrawork | より低コストのエージェントを使用する並列実行 |
eco autopilot | コストを最適化した完全自律実行 |
Ecomode のルーティングルール
常に低いティアを優先してください。タスクで本当に必要な場合に限り、ティアを上げてください。
| 判断 | ルール |
|---|---|
| DEFAULT | ほとんどのタスクでは LOW ティア (Haiku) から開始します |
| UPGRADE | LOW ティアで失敗した場合、またはタスクで複数ファイルにわたる推論が必要な場合は、MEDIUM (Sonnet) に上げます |
| AVOID | HIGH ティア (Opus) は避け、不可欠な場合に限り計画や批評に使用します |
Ecomode でのエージェント選択
最初に行うこと: 作業を委任する前に、エージェントのリファレンスファイルを読みます。
Read file: docs/shared/agent-tiers.md
このファイルには、エージェントのティアをまとめた表、MCP ツールの割り当て、選択時のガイダンスが記載されています。
Ecomode での優先順位:
// PREFERRED - Use for most tasks
Task(subagent_type="oh-my-claudecode:executor-low", model="haiku", prompt="...")
Task(subagent_type="oh-my-claudecode:explore", model="haiku", prompt="...")
Task(subagent_type="oh-my-claudecode:architect-low", model="haiku", prompt="...")
// FALLBACK - Only if LOW fails
Task(subagent_type="oh-my-claudecode:executor", model="sonnet", prompt="...")
Task(subagent_type="oh-my-claudecode:architect-medium", model="sonnet", prompt="...")
// AVOID - Only for planning/critique if essential
Task(subagent_type="oh-my-claudecode:planner", model="opus", prompt="...")
委任の強制
Ecomode は、コアプロトコルのすべての委任ルールを維持しながら、コストを最適化したルーティングを行います。
| アクション | 委任先 | モデル |
|---|---|---|
| コードの変更 | executor-low / executor | haiku / sonnet |
| 分析 | architect-low | haiku |
| 検索 | explore | haiku |
| ドキュメント作成 | writer | haiku |
バックグラウンド実行
時間のかかるコマンド(インストール、ビルド、テスト)はバックグラウンドで実行します。同時実行は最大20件です。
トークン節約のヒント
- 類似するタスクはまとめて、多くのエージェントを起動するのではなく、1つのエージェントに任せます
- ファイルの探索には architect ではなく explore (haiku) を使用します
- 簡単な変更には executor-low を優先し、失敗した場合に限りティアを上げます
- すべてのドキュメント作成タスクに writer (haiku) を使用します
- タスクで本当に深い推論が必要な場合を除き、opus エージェントは避けます
Ecomode の無効化
Ecomode は設定で完全に無効化できます。無効化すると、Ecomode に関するすべてのキーワードが無視されます。
~/.claude/.omc-config.json に設定します:
{
"ecomode": {
"enabled": false
}
}
状態管理
Ecomode の状態は .omc/state/ecomode-state.json で追跡されます。
作業が完了したら、状態を適切にクリーンアップするために /oh-my-claudecode:cancel を実行します。