> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude CodeをOpusに設定しているのにログにHaikuが表示されるのはなぜですか？

> Claude Codeはコストを削減するために、バックグラウンドのヘルパータスクや一部のサブエージェントを軽量なHaikuモデルに委任します。これはクライアントの正常な動作であり、環境変数を使用してすべてをOpusに強制することも可能です。

## 簡潔な回答

**これは Claude Code 自身のコスト削減メカニズムであり、ゲートウェイがモデルをすり替えているわけではありません。** Claude Code で設定した `claude-opus-5` はメインの会話のみを処理します。セッションタイトルの生成やトピックの検出などの小規模なバックグラウンドタスクに加え、Explore などの組み込みサブエージェントは、デフォルトでより低コストな Haiku モデル（例：`claude-haiku-4-5-20251001`）で実行されるため、ログに両方のモデルが表示されます。

すべてのリクエストで Opus を使用したい場合は、環境変数を使用して強制設定してください。詳細は後述の[すべてを Opus に強制する](#force-everything-onto-opus)を参照してください。

## ログ内での識別方法

コンソールの使用状況ログにおいて、これらの Haiku リクエストには通常、以下の3つの特徴があります：

* **Opus リクエストと同じ token およびグループ**: 同じキー、同じ `ClaudeCode` グループであり、同一の Claude Code クライアントから送信されたことを示します
* **非常に少ない tokens と1回あたりの極めてわずかなコスト**: 多くの場合わずか数十〜数百 tokens 程度であり、数千から数万 tokens に達するメイン会話の Opus リクエストとは明らかに異なります
* **ユーザーのアクションに合わせてバースト的に発生**: 新しいセッションの開始、Claude Code によるコードベースの検索、またはサブタスクの割り当てなどに連動して届きます

<Info>
  **モデル名はクライアントが送信したものと完全に一致します。** APIYI はリクエスト内の `model` フィールドに基づいてルーティングおよび課金を行います。ログに Haiku が記録されている場合、Claude Code が Haiku を要求したことを意味し、それらの呼び出しには Haiku の料金が課金され、Opus の料金が課金されることは決してありません。
</Info>

## Claude Codeがこれを行う理由

Claude Codeには、大規模モデルと小規模モデルを使い分ける2層構造が組み込まれています。

| タスクの種類 | デフォルトモデル | 環境変数 |
| - | - | - |
| メインの会話、コード作成、ファイル編集 | 選択したメインモデル（例：Opus） | `ANTHROPIC_MODEL` |
| セッションタイトル、トピック検出、その他のバックグラウンドヘルパー | Haikuクラスのモデル | `ANTHROPIC_DEFAULT_HAIKU_MODEL` |
| サブエージェント（例：コードベース検索用の組み込みExplore） | 各サブエージェントによって設定（一部はデフォルトでHaiku） | `CLAUDE_CODE_SUBAGENT_MODEL` |

バックグラウンドタスクやコード検索は高いモデル性能を必要としませんが頻繁に実行されるため、Haikuを使用することで全体の課金額を大幅に抑えられ、処理速度も向上します。**ほとんどのユーザーにとって、デフォルトの設定が最適な選択肢です。**

## すべてを Opus に強制する

すべてのリクエストで Opus を使用したい場合（例えば、サブエージェントによる検索の品質を高めたい場合など）、`~/.claude/settings.json` の `env` ブロック内ですべてのティアが同じ Opus モデルを参照するように設定します。

```json theme={null}
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-your-apiyi-key",
    "ANTHROPIC_BASE_URL": "https://api.apiyi.com",
    "ANTHROPIC_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-opus-5-5",
    "CLAUDE_CODE_SUBAGENT_MODEL": "claude-opus-5-5"
  }
}
```

保存後に**Claude Code を再起動**してください。これにより、使用ログには `claude-opus-5-5` のみが表示されるようになります。

<Tip>
  **メインモデルには `claude-opus-5-5` を使用してください。** `claude-opus-5` よりも新しく性能が優れており、`ClaudeCode` グループでも利用可能です。上記の設定からモデル名をコピーするだけで利用できます。
</Tip>

<Warning>
  **すべてを Opus で実行すると、コストが大幅に増加します。** バックグラウンドタスクやサブエージェントは頻繁に実行されるため、これまで Haiku の価格で課金されていた呼び出しもすべて Opus の価格で課金されることになります。より賢い小型モデルのみを導入したい場合は、折衷案として `ANTHROPIC_DEFAULT_HAIKU_MODEL` を新しい `claude-haiku-5-5` に設定し、それ以外はデフォルトのままにしておくのがおすすめです。
</Warning>

## よくある質問

<AccordionGroup>
  <Accordion title="Haiku のリクエストがある場合、キーが漏洩して第三者に利用されている可能性はありますか？">
    token、IP、タイムラインを確認してください。Haiku のリクエストが Opus のリクエストと同じ token を使用し、同じ IP から送信され、ご自身のアクティビティと一致している場合は、ご自身の Claude Code から送信されたものです。見覚えのない IP や、作業していなかった時間帯に大量の使用が見られる場合は、キーの漏洩として対処してください。詳細は[token 管理](/ja/faq/token-management)を参照してください。
  </Accordion>

  <Accordion title="/model で Opus に切り替えたのに、なぜまだ Haiku が使われているのですか？">
    `/model` はメインの会話モデルのみを切り替えます。バックグラウンドヘルパーやサブエージェントで使用されるモデルは変更されません。これらも変更するには、上記のように `ANTHROPIC_DEFAULT_HAIKU_MODEL` および `CLAUDE_CODE_SUBAGENT_MODEL` を設定してください。
  </Accordion>

  <Accordion title="CC Switch などのツールでこれを変更するにはどうすればよいですか？">
    CC Switch などのツールも、単に Claude Code の環境変数を書き込んでいるだけです。該当するプロバイダープロファイルで上記の変数を `claude-opus-5-5` に設定してください。詳細は [CC Switch の設定](/ja/scenarios/programming/cc-switch) を参照してください。
  </Accordion>
</AccordionGroup>

## 関連ドキュメント

<CardGroup cols={2}>
  <Card title="Claude Code セットアップガイド" icon="terminal" href="/ja/scenarios/programming/claude-code">
    インストール、APIYI の設定、よくある問題
  </Card>

  <Card title="Codex、ClaudeCode、デフォルトグループ" icon="layers" href="/ja/faq/codex-claudecode-default-groups">
    Claude Code で使用する token グループ
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.