クロードコードでのクロード俳句5.5活用術 (サブエージェントモデルへの応用)

Claude Code で Claude Haiku 5.5 を使うには、まず claude update で v2.1.293 以降へ更新します。続いて claude --model claude-haiku-5-5 で開始するか、既存セッションで /model claude-haiku-5-5 を実行してください。実運用では、Haiku 5.5 をメインモデルにするより、検索・テスト実行・ログ要約を担当するサブエージェントとして Sonnet 5.5 や Opus 5.5 と組み合わせる方法が有効です。

今すぐApidogを試す

Haiku 5.5 のモデル仕様については、「Claude Haiku 5.5とは」を参照してください。API を呼び出すプロジェクトでは、Apidog にテストシナリオを保存し、Haiku サブエージェントから実行すると、メインセッションのコンテキストを節約できます。

Claude Code での Claude Haiku 5.5 の概要

設定	Haiku 5.5
最小バージョン	v2.1.293（claude update）
モデル ID	claude-haiku-5-5
haiku エイリアス	Anthropic API では Haiku 5.5
コンテキスト	すべてのプランでネイティブ 1M、[1m] サフィックス不要
自動圧縮	デフォルトで約 967K トークン
デフォルトエフォート	medium（low〜max）
思考	常時オン、Claude Code では無効化不可
API 価格	プロンプトが最大 100K トークンなら入力/出力 100 万トークンあたり $0.10/$0.50。100K 超では $0.50/$2.50
利用条件	Pro、Max、Team、Enterprise、または API キー。無料プランでは利用不可

ステップ1: Claude Code を更新する

Haiku 5.5 を使うには Claude Code v2.1.293 以降が必要です。まず更新します。

claude update

更新後、バージョンを確認してください。

claude --version

変更履歴では、Haiku 5.5 は Anthropic API におけるデフォルトの Haiku モデルとして記載されています。

Claude Code 自体は無料プランでは利用できません。利用には Pro、Max、Team、Enterprise のいずれか、または Anthropic API キーが必要です。無料ユーザーは Claude.ai で Haiku 5.5 を選択できます。料金は claude.com/pricing を確認してください。

ステップ2: Haiku 5.5 をメインモデルとして選択する

新しいセッションを Haiku 5.5 で開始するには、モデル ID を明示します。

claude --model claude-haiku-5-5

実行中のセッションでは、次のコマンドで切り替えられます。

/model claude-haiku-5-5

保存済み設定の model が haiku の場合、Haiku 4.5 で保存されたセッションも Haiku 5.5 として再開されます。ただし、これは Anthropic API を使う場合に限られます。

haiku エイリアスはプロバイダーごとに異なる

プロバイダー	haiku が解決するモデル
Anthropic API	Haiku 5.5
AWS の Claude Platform	Haiku 4.5
Amazon Bedrock	Haiku 4.5
Google Cloud の Agent Platform	Haiku 4.5
Microsoft Foundry	Haiku 4.5

Bedrock、Google Cloud、Foundry、AWS の Claude Platform を使う場合、/model haiku や model: haiku は Haiku 4.5 を選ぶ可能性があります。Haiku 5.5 を使うには、プロバイダーに応じて完全なモデル ID を指定してください。

• Google Cloud / AWS Claude Platform: claude-haiku-5-5
• Amazon Bedrock: us.anthropic.claude-haiku-5-5 などの推論プロファイル ID
• Microsoft Foundry: 対応するデプロイメント名

また、後述する ANTHROPIC_DEFAULT_HAIKU_MODEL で haiku の参照先を設定できます。

ステップ3: エフォートレベルを選択する

Haiku 5.5 は、low、medium、high、xhigh、max のエフォート制御を備えた最初の Haiku モデルです。Claude Code ではデフォルトで medium が使われます。

より長いエージェント作業に使う場合は、起動時に high を指定します。

claude --model claude-haiku-5-5 --effort high

セッション内では次のように変更できます。

/effort low

実装時の目安は次のとおりです。

• low: 短い検索、単発のツール実行、大量の反復処理
• medium: 通常の開発作業
• high: 複数ステップの調査、長めのエージェントタスク
• xhigh / max: 評価で効果を確認できたタスクだけに限定

Claude Code では思考を無効化できません。alwaysThinkingEnabled: false や MAX_THINKING_TOKENS=0 を指定しても Haiku 5.5 では効果がありません。トークン使用量を下げるには、エフォートを low または medium に下げてください。

ステップ4: Haiku 5.5 をサブエージェントとして実行する

Haiku 5.5 は、検索、テスト、ログ確認、ドキュメント収集など、反復的でコンテキスト消費が大きい作業に向いています。主導モデルを Sonnet 5.5 または Opus 5.5 にし、Haiku をサブエージェントとして使う構成が実用的です。

サブエージェントは、次の場所に Markdown ファイルとして保存します。

• プロジェクト単位: .claude/agents/
• 全プロジェクト共通: ~/.claude/agents/

YAML フロントマターでは name と description が必須です。model には sonnet、opus、haiku、fable、完全なモデル ID、または inherit を設定できます。詳細は サブエージェントドキュメント と Claude Code サブエージェントガイド を参照してください。

Explore を Haiku ベースの検索エージェントで置き換える

組み込みの Explore サブエージェントは、メイン会話と同じモデルで実行されます。たとえば Opus 5.5 のセッションで Explore を使うと、検索も Opus 5.5 で実行されます。

プロジェクト側で Explore という名前のサブエージェントを定義すると、組み込み Explore をオーバーライドできます。.claude/agents/Explore.md を作成してください。

---
name: Explore
description: 高速な読み取り専用コードベース検索。ファイルを検索したり、シンボルや呼び出し箇所を見つけたりするのに使いますが、何も編集しません。
tools: Read, Grep, Glob
model: haiku
effort: low
---

コードベースを検索し、見つけたものを報告します。ファイルパスと行番号、各一致の簡単な要約を返します。ファイルを編集しないでください。

実行中に次のコマンドを使い、実際に選ばれたモデルを確認してください。

/tasks

クラウドプロバイダー経由の場合は、model: haiku を完全なモデル ID に置き換えてください。

すべてのサブエージェントを Haiku に固定する

すべてのサブエージェントを Haiku で動かしたい場合は、設定ファイルの env ブロックに次を追加します。

{
  "env": {
    "CLAUDE_CODE_SUBAGENT_MODEL": "haiku",
    "CLAUDE_CODE_SUBAGENT_MODEL_FORCE": "1"
  }
}

CLAUDE_CODE_SUBAGENT_MODEL だけではデフォルトを設定するだけです。サブエージェント個別の model フィールドが優先され、組み込み Explore も切り替わりません。全サブエージェントを強制する場合は CLAUDE_CODE_SUBAGENT_MODEL_FORCE も設定してください。

ステップ5: バックグラウンド作業を Haiku 5.5 に向ける

ANTHROPIC_DEFAULT_HAIKU_MODEL は、haiku や claude --resume などのバックグラウンド機能で使うモデルを指定します。

古い ANTHROPIC_SMALL_FAST_MODEL は非推奨です。シェルプロファイルに残っている場合は、環境変数リファレンスを確認して置き換えてください。

Anthropic API を直接使う場合、通常は追加設定不要です。Google Cloud ではバックグラウンドタスクがデフォルトで Sonnet、Foundry ではプライマリモデル、Bedrock では Sonnet またはプライマリモデルを使うため、Haiku 5.5 を明示的に指定します。

# Google Cloud の Agent Platform
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-5-5

# Amazon Bedrock（推論プロファイル ID）
export ANTHROPIC_DEFAULT_HAIKU_MODEL=us.anthropic.claude-haiku-5-5

設定を永続化する場合は、利用中のシェルに応じて ~/.zshrc や ~/.bashrc に追加します。

長いセッションにおける 100K の価格ステップ

Haiku 5.5 の API 価格はプロンプト長に依存します。Claude Code は各ターンで会話履歴をプロンプトとして送るため、長いセッションではコンテキスト長を意識する必要があります。

コンテキストが 100K トークンを超えると、価格は次のように変わります。

プロンプト長	入力 100 万トークンあたり	出力 100 万トークンあたり
最大 100K トークン	$0.10	$0.50
100K トークン超	$0.50	$2.50

100K を超えると短いプロンプト時の 5 倍です。キャッシュ済みトークンがこの境界に含まれるかは明記されていないため、コスト見積もりでは含まれる前提で扱うのが安全です。

自動圧縮はデフォルトで約 967K トークンまで実行されないため、コスト制御には不十分な場合があります。API 課金で使う場合は、次の 2 つを実施してください。

1. 早めに圧縮する
   
   /autocompact 100k を設定すると、1M トークン付近まで待たず、100K 境界付近で圧縮できます。

2. 大量出力をサブエージェントへ移す
   
   テストログ、grep 結果、調査メモをサブエージェント側のコンテキストに閉じ込めます。メイン会話に必要なのは要約だけです。

100K 超でも Haiku 5.5 は $0.50/$2.50 であり、Sonnet 5.5 の $2/$10 の 4 分の 1です。料金計算の詳細は Haiku 5.5 の料金内訳 を参照してください。

Max および Team の契約者は、API クレジットに関するドキュメントも確認してください。新しい月額 API クレジットは、インタラクティブな Claude Code を対象としていません。

Sonnet 5.5 または Opus 5.5 を主導モデルにすべきケース

複雑なエージェント的コーディングでは、Sonnet 5.5 や Opus 5.5 を主導モデルに残してください。Anthropic が Claude Code で最大エフォートを使って実行した Terminal-Bench 4.0 では、Haiku 5.5 は 39.2%、Sonnet 5.5 は 70.6% でした。

エフォート	Haiku 5.5	Sonnet 5.5
medium	20.3%（$0.68）	28.8%（$0.68）
high	24.8%（$1.04）	43%（$1.46）
max	39.2%（$2.64）	70.6%（$10.44）

medium では 1 試行あたりのコストがほぼ同じである一方、Sonnet のスコアが高くなっています。難しい実装、複数ファイルにまたがる設計変更、長時間のシェル作業では、Haiku を主導モデルにしないほうが安全です。

一方で、コンピューター操作では異なる傾向があります。OSWorld 2.1 では、Haiku 5.5 の medium は 1 試行あたり $0.13 で 53.3%、Sonnet 5.5 の low は $0.68 で 57.9% でした。詳細は Haiku 5.5 ベンチマーク分析 と Sonnet 5.5 Claude Code ガイド を確認してください。

実用的な役割分担は次のとおりです。

• Sonnet 5.5 / Opus 5.5: 設計、実装、複雑なデバッグ、最終判断
• Haiku 5.5: Explore、テストランナー、ログ要約、ドキュメント取得、読み取り専用調査

例: Apidog テストを実行する Haiku サブエージェント

テスト実行は、反復的で出力が大きくなりやすい作業です。Haiku サブエージェントに任せると、主導モデルのコンテキストをテストログで埋めずに済みます。

以下を .claude/agents/api-test-runner.md として保存してください。

---
name: api-test-runner
description: APIエンドポイントが変更された後、Apidog CLI を使用してプロジェクトの Apidog テストシナリオを実行し、合格数と失敗数、および失敗したリクエストを報告します。
tools: Bash, Read
model: haiku
effort: low
---

変更されたエンドポイントをカバーするシナリオについて、このリポジトリの README に記載されている Apidog CLI テストコマンドを実行します。合格数と失敗数を報告します。失敗ごとに、リクエスト名、期待される結果、実際の結果を示します。コードを編集しないでください。失敗した実行を複数回再試行しないでください。

Apidog CLI の認証と実行コマンドは、「Claude Code での Apidog CLI」を参照してください。サブエージェントが実行するテストシナリオを作成するには、Apidog をダウンロードしてください。

Haiku 4.5 からのアプリ移行

API 経由で Haiku 4.5 を使っているプロジェクトは、Claude Code から移行作業を始められます。

/claude-api migrate this project to claude-haiku-5-5

移行時は、互換性のないリクエストパラメータに注意してください。Haiku 5.5 では、以下を指定すると 400 エラーになります。

• 手動の budget_tokens 思考設定
• デフォルト以外の temperature
• デフォルト以外の top_p
• 任意の top_k
• アシスタントメッセージの事前入力

修正内容は Haiku 5.5 vs Haiku 4.5 ガイド を確認してください。

移行後は、旧リクエストと新リクエストを Apidog に保存して比較可能にします。ANTHROPIC_API_KEY は環境変数として管理し、テストでは少なくとも次を検証してください。

• stop_reason
• usage
• 想定外の refusal
• トークン使用量の急増

これにより、本番環境で停止理由や料金が変わる前に、テストで検出できます。

よくある質問

Haiku 5.5 は Claude Code のデフォルトモデルですか？

いいえ。Haiku 5.5 は Anthropic API のデフォルト Haiku モデルです。Claude Code のメインモデルとして使うには、--model または /model で明示的に選択してください。

Claude Code の無料プランで Haiku 5.5 を使えますか？

使えません。Claude Code には有料プランまたは API キーが必要です。無料ユーザーは Claude.ai で Haiku 5.5 を選択できます。詳しくは Claude Haiku 5.5 を無料で使う方法 を参照してください。

model: haiku を指定すると Haiku 4.5 になるのはなぜですか？

Bedrock、Google Cloud、Foundry、AWS の Claude Platform を利用しているか、Claude Code が v2.1.293 より前である可能性があります。完全なモデル ID を指定するか、ANTHROPIC_DEFAULT_HAIKU_MODEL を設定してください。

トークンを節約するために思考をオフにできますか？

Claude Code ではできません。代わりにエフォートを下げてください。最も低コストなのは low です。

次のステップ

まず claude update を実行し、Haiku を使う Explore オーバーライドを追加してください。そのまま Sonnet 5.5 または Opus 5.5 を主導モデルとして 1 週間使い、検索・ログ確認・テスト実行を Haiku に移します。

API を含むプロジェクトなら、次にテストランナーサブエージェントを追加してください。アプリケーションコードから Haiku 5.5 を呼び出す場合は、Haiku 5.5 API ガイドから始めましょう。Apidog を使うと、サブエージェントに実行させる API テストを管理できます。