テック技報最新号へ →
AIコーディング

Claude Code: 組み込みの Explore はセッションのモデルで動く。安くしたいなら同名の Explore を model: haiku で定義する

今の Claude Code では、組み込みの Explore サブエージェントは Haiku ではなく「いまのセッションのモデル」で動く。探索を安く済ませたいなら、.claude/agents/ に Explore という名前のサブエージェントを model: haiku で置く。

@oswrav · 2026-11-10
#ai-coding#claude-code#サブエージェント#モデル#コスト

どんな時に使う？

  • Opus や Fable でセッションを回していて、コード探索のサブエージェントまで同じ単価になっている
  • CLAUDE_CODE_SUBAGENT_MODEL=haiku を入れたのに、Explore が安くならない
  • ログ読み・テスト結果の確認など「間違えてもすぐ分かる」作業を小さいモデルに逃がしたい

手順

  1. 探索用: .claude/agents/Explore.md を作り、frontmatter に name: Explore と model: haiku を書く（組み込みと同じ名前で上書きする）
  2. ログ読み用の例（公式ガイドの例を要約）:
    markdown
    ---
name: log-reader
description: テスト出力とログを読み、失敗ケースを報告する。テスト実行の後に使う。
tools: Read, Grep, Glob, Bash
model: haiku
---
渡されたログを読み、失敗ごとにファイル・テスト名・最初のエラー行を報告する。ファイルは編集しない。
  3. モデル指定のないサブエージェントだけまとめて Haiku にするなら環境変数 CLAUDE_CODE_SUBAGENT_MODEL。定義の model: と起動時の指定のほうが優先される
  4. haiku エイリアスが指すモデルを固定したいときは ANTHROPIC_DEFAULT_HAIKU_MODEL
  5. 実行中に /tasks で、各サブエージェントが何のモデルで動いているか確かめる

どこまで小さいモデルに任せるか

  • 任せる: ファイル探し、テストの実行、ログ読み（間違いが安く見つかるもの）
  • 任せない: コードの編集と判断。小さいモデルが検索結果を読み違えると、メインのモデルが間違ったファイルを開いてトークンを使う
  • opusplan（計画は Opus、実行は Sonnet）はコード編集を Sonnet に回すので、上の考え方とは逆。既定にする前に自分のタスクで測る、とガイドは書いている

注意点

出典

X の元の投稿を開く