Claude Code で Claude Haiku 5.5 を使用するには、claude update を実行して v2.1.293 以降に更新し、claude --model claude-haiku-5-5 でセッションを開始するか、セッション内で /model claude-haiku-5-5 を実行します。ほとんどの人にとってより大きな利点は、サブエージェントとして実行することです。サブエージェントファイルに model: haiku を記述し、Sonnet 5.5 または Opus 5.5 に検索、テスト実行、要約を任せます。APIキーを使用する場合、最大100Kトークンのプロンプトでは入力/出力トークン100万あたり$0.10/$0.50、それ以上では$0.50/$2.50の費用がかかります。
以下に、セットアップ、haiku エイリアスの落とし穴、エフォート、サブエージェントファイル、100Kの価格ステップ、およびSonnetまたはOpusが主導すべき場合について説明します。モデル自体については、「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 まで) |
| 思考 | 常時オン。オフにできない |
| API価格 | 最大 100K トークンのプロンプトで $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 以降が必要です。変更履歴エントリでは、「現在 Anthropic API のデフォルト Haiku モデル」と記載されています。
claude update
Claude Code は無料プランでは利用できません。無料ユーザーは Claude.ai アプリで Haiku 5.5 を選択できますが、Claude Code には Pro、Max、Team、Enterprise のいずれかのプラン、または Anthropic API キーが必要です。claude.com/pricing によると、Pro は年間請求で月額$17、月額請求で$20、Max は$100からとなっています。
ステップ2: Haiku 5.5 をメインモデルとして選択する
claude --model claude-haiku-5-5
実行中のセッション内で /model claude-haiku-5-5 も同じ効果があります。保存されている model 設定が haiku の場合、Haiku 4.5 で保存されたセッションは Haiku 5.5 で再開されます。
haiku エイリアスは Anthropic API の Haiku 5.5 のみを意味します
| プロバイダー | haiku が解決するもの |
|---|---|
| Anthropic API | Haiku 5.5 |
| AWS の Claude Platform | Haiku 4.5 |
| Amazon Bedrock、Google Cloud の Agent Platform | Haiku 4.5 |
| Microsoft Foundry | Haiku 4.5 |
どのクラウドプロバイダーでも、サブエージェントファイルで /model haiku と model: haiku を指定すると Haiku 4.5 が使用されます。代わりに、Google Cloud および AWS の Claude Platform では完全なID claude-haiku-5-5 を、Foundry ではデプロイメント名を、Amazon Bedrock では us.anthropic.claude-haiku-5-5 のような推論プロファイルIDを指定してください。または、ANTHROPIC_DEFAULT_HAIKU_MODEL (ステップ5) を使用してエイリアスをそこに向けます。
ステップ3: エフォートレベルを選択する
Haiku 5.5 は、エフォート制御（low、medium、high、xhigh、max）を備えた初めての Haiku で、Claude Code では medium から開始します。
claude --model claude-haiku-5-5 --effort high
セッション内で /effort low とすると、現在のモデルのレベルが保存されます。Anthropic のプロンプティングガイドでは、短いツールタスクや大量のリクエストには low、ほとんどの作業には medium、より長いエージェントタスクには high を推奨しています。xhigh と max は、評価で効果が確認できた場合にのみ使用してください。
思考は常時オンです。Claude Code の Haiku 5.5 ではオフにできません。alwaysThinkingEnabled: false と MAX_THINKING_TOKENS=0 は効果がありません。(生の Messages API では high 以下で無効にできます。) 思考トークンを減らしたい場合は、エフォートを下げてください。
ステップ4: Haiku 5.5 をサブエージェントとして実行する
Anthropic によると、Haiku 5.5 は「コーディング作業におけるサブエージェントとして Opus 5.5 および Sonnet 5.5 と相性が良い」とのことです。サブエージェントは、.claude/agents/ (プロジェクト) または ~/.claude/agents/ (すべてのプロジェクト) に YAML フロントマターを持つ Markdown ファイルです。name と description のみが必須で、サブエージェントドキュメントでは model に sonnet、opus、haiku、fable、完全なモデルID、または inherit が受け入れられます。当社のサブエージェントガイドではスコープとツールについて説明しています。
Explore を安価なエクスプローラーに置き換える
組み込みの Explore サブエージェントはメインの会話のモデルで実行され、Haiku では実行されません。Opus 5.5 セッションでは、すべての Explore 検索が Opus で実行されます。Explore という名前のユーザーまたはプロジェクトのサブエージェントは、組み込みのものをオーバーライドし、独自の model を保持します。
---
name: Explore
description: 高速な読み取り専用コードベース検索。ファイルを検索したり、シンボルや呼び出し箇所を見つけたりするのに使いますが、何も編集しません。
tools: Read, Grep, Glob
model: haiku
effort: low
---
コードベースを検索し、見つけたものを報告します。ファイルパスと行番号、各一致の簡単な要約を返します。ファイルを編集しないでください。
これを .claude/agents/Explore.md として保存します。動作中に /tasks を実行してモデルを確認してください。クラウドプロバイダーを使用している場合は、ステップ2の完全なIDに haiku を置き換えてください。
すべてのサブエージェントを Haiku に強制する
Explore を含むすべてのサブエージェントを Haiku で実行するには、設定ファイルの env ブロックで両方の変数を設定します。
{
"env": {
"CLAUDE_CODE_SUBAGENT_MODEL": "haiku",
"CLAUDE_CODE_SUBAGENT_MODEL_FORCE": "1"
}
}
CLAUDE_CODE_SUBAGENT_MODEL だけではデフォルトになり、サブエージェント自身の model フィールドが優先され、Explore は移動しません。
ステップ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
長いセッションにおける100Kの価格ステップ
Haiku 5.5 の価格はプロンプトの長さに依存し、Claude Code は各ターンで会話をプロンプトとして送信します。セッションのコンテキストが 100K トークンを超えると、各リクエストは $0.10/$0.50 ではなく $0.50/$2.50 で請求され、短いプロンプトの5倍の料金になります。ドキュメントにはキャッシュされたトークンがこのラインにカウントされるかどうかは記載されていないため、カウントされるものとして予算を組んでください。
自動圧縮では節約できません。Haiku 5.5 はデフォルトで約 967K トークンで圧縮されるため、セッションは価格ステップをはるかに超えて実行される可能性があります。トークンごとに支払う場合、2つの習慣が役立ちます。
- 早期に圧縮する。
/autocompact 100kは Claude Code が受け入れる最低ウィンドウを設定するため、セッションは1Mの近くではなく境界の近くで圧縮されます。 - 大量の作業をサブエージェントに押し込む。 サブエージェントは独自のコンテキストを持つため、テストログや検索結果はメインの会話の外に保たれます。
100K を超えても、$0.50/$2.50 は Sonnet 5.5 の $2/$10 の4分の1です。有料プランでは、セッションは使用量制限に基づいて実行され、Anthropic は Haiku 5.5 がそれらにどのようにカウントされるかを公開していません。当社のHaiku 5.5 の料金内訳は計算を詳しく説明しています。
Max および Team サブスクライバーの方へ：Anthropic のAPI クレジットに関するドキュメントによると、新しい月額 API クレジット（Max 5x で$100、Max 20x で$200、Team で最大$500のプール）は、インタラクティブな Claude Code をカバーしていません。
Sonnet 5.5 または Opus 5.5 を主導モデルとして維持すべき時
Anthropic によると、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 では、両者とも試行あたりのコストはほぼ同じですが、Sonnet のスコアがより高いです。Haiku のトークン価格は長時間のシェル作業に引き継がれないため、難しいコーディングセッションの主導モデルに Haiku を使わないでください。
コンピューターの使用では異なる結果が出ています。OSWorld 2.1 では、Haiku 5.5 (medium) は試行あたり $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 を使用し、Explore、テストランナー、ログリーダー、ドキュメント取得には Haiku 5.5 を使用します。
例: Apidog テストを実行する Haiku サブエージェント
テスト実行は冗長で反復的であり、Haiku に適しています。Apidog CLI は、保存された Apidog テストシナリオをターミナルから実行できるため、サブエージェントがそれらを実行し、簡単なレポートを返すことで、主導モデルのコンテキストをきれいに保つことができます。
---
name: api-test-runner
description: APIエンドポイントが変更された後、Apidog CLI を使用してプロジェクトの Apidog テストシナリオを実行し、合格数と失敗数、および失敗したリクエストを報告します。
tools: Bash, Read
model: haiku
effort: low
---
変更されたエンドポイントをカバーするシナリオについて、このリポジトリの README に記載されている Apidog CLI テストコマンドを実行します。合格数と失敗数を報告します。失敗ごとに、リクエスト名、期待される結果、実際の結果を示します。コードを編集しないでください。失敗した実行を複数回再試行しないでください。
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 では、手動の budget_tokens 思考、デフォルト以外の temperature または top_p、任意の top_k、およびアシスタントの事前入力はすべて 400 を返します。Haiku 5.5 vs Haiku 4.5 ガイドには各修正がリストされています。編集後、古いリクエストと新しいリクエストのペアを Apidog に保存し、ANTHROPIC_API_KEY を環境変数として保存し、stop_reason と usage についてアサートすることで、新しい refusal ストップやトークンの急増が本番環境に到達するのではなく、テストを失敗させます。
よくある質問
Haiku 5.5 は Claude Code のデフォルトモデルですか？ いいえ。Anthropic API のデフォルト Haiku モデルであり、haiku エイリアスがそれを指します。--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 のいずれかを使用しているか、v2.1.293 より前のバージョンを使用しているためです。完全な ID を指定するか、ANTHROPIC_DEFAULT_HAIKU_MODEL を設定してください。
トークンを節約するために思考をオフにできますか？ Claude Code ではできません。代わりにエフォートを下げてください。low が最も安価な設定です。
次のステップ
claude update を実行し、Haiku の Explore のオーバーライドを追加し、現在の主導モデルを1週間使用してみてください。その後、プロジェクトに API がある場合は、テストランナーサブエージェントを追加してください。独自のコードからモデルを呼び出すには、Haiku 5.5 API ガイドから始めてください。Apidog は無料で開始でき、そのサブエージェントに実行させる実際のテストを提供します。