0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Claude Code の auto モード分類器がサーバー実行に、課金対象外になった件を解説

0
Posted at

はじめに

2026年9月、Claude Code v2.1.278 がリリースされ、auto モードの内部動作に地味ながら見逃せない変更が入りました。それが auto モード分類器のサーバーサイド既定化 です。

auto モードは、ユーザーの入力内容に応じてどのモデル(例えば軽量タスクなら Haiku、複雑なタスクなら Sonnet/Opus)を使うかを自動判定する仕組みです。この判定を行う「分類器(classifier)」自体もトークンを消費する処理であり、従来はこのオーバーヘッド分も課金対象になっていました。

今回の変更により、Claude API / Enterprise ユーザーおよび Bedrock・Vertex・Foundry・各種 LLM ゲートウェイ経由の利用において、この分類器がデフォルトでサーバー側実行に切り替わり、分類器のオーバーヘッドに対する課金が発生しなくなります。地味に見えて、auto モードを日常的に使っているチームにとってはコスト構造に直結する変更です。

📌 影響を受ける人

  • Claude Code で auto モードを常用している Claude API / Enterprise ユーザー
  • Bedrock / Vertex / Foundry / LLM ゲートウェイ経由で Claude Code を運用している組織
  • コスト管理・請求監視を行っている SRE / プラットフォームチーム

変更の全体像

分類器の実行場所がクライアント側からサーバー側に移ったことで、課金の扱いが変わります。全体の流れを図にすると以下の通りです。

Bedrock・Vertex・Foundry・ゲートウェイ経由の利用では、環境変数でこの挙動を制御できます。

変更内容

今回のリリースで変わった点は大きく2つです。

項目 変更前 変更後(v2.1.278〜)
分類器の実行場所(既定) クライアント側 サーバー側
分類器オーバーヘッドの課金 課金対象 非課金
対象範囲 - Claude API / Enterprise、Bedrock / Vertex / Foundry / ゲートウェイ
オプトアウト手段 - CLAUDE_CODE_AUTO_MODE_SERVER=0(Bedrock/Vertex/Foundry/ゲートウェイのみ)
フォールバック時の挙動 - 課金対象の従来経路に切り替わり、警告を表示
/status の表示 なし Auto mode server 行が追加
  • 対象範囲: Claude API ユーザー、Enterprise ユーザーに加え、Amazon Bedrock / Google Vertex AI / Microsoft Foundry、および各種 LLM ゲートウェイ経由の利用も対象です。
  • オプトアウト: Bedrock・Vertex・Foundry・ゲートウェイ利用者は、従来通りのクライアント側分類器に戻したい場合、環境変数 CLAUDE_CODE_AUTO_MODE_SERVER=0 を設定できます。ただし Claude API / Enterprise 直接利用については個別のオプトアウト手段は明記されていません。
  • フォールバック時の警告: ネットワークの都合などでサーバー側分類器が使えず、課金が発生する経路にフォールバックした場合は、その旨が警告として表示されます。意図せずコストが増える事態を防ぐ仕組みです。
  • /status への追加: 現在のセッションで分類器がサーバー側で動いているかを /status コマンドから直接確認できるようになりました。

💡 Tips
コスト監視を重視するチームは、まず /statusAuto mode server の行を確認し、想定通りサーバー実行になっているかをチェックすると良いでしょう。

影響と対応

この変更はデフォルトで有効になるため、基本的にはユーザー側で何かを変更する必要はありません。ただし、以下のケースでは対応を検討してください。

  1. Bedrock / Vertex / Foundry / ゲートウェイ運用者
    組織のポリシーやコンプライアンス要件でクライアント側処理を維持したい場合は、CLAUDE_CODE_AUTO_MODE_SERVER=0 を環境変数として設定し、明示的にオプトアウトできます。

  2. コスト監視をしているチーム
    分類器オーバーヘッドの非課金化により、auto モードを多用しているワークロードでは請求額が僅かに下がる可能性があります。過去の課金傾向と比較する際は、このリリース日(v2.1.278 適用日)を境に見ておくと分析がぶれません。

  3. フォールバック警告への備え
    サーバー側分類器が利用できない環境(オフライン、ネットワーク制限が強い環境など)では課金対象のフォールバックが発生しうるため、警告ログを監視対象に含めておくと安心です。

設定例

# Bedrock / Vertex / Foundry / ゲートウェイ経由で、
# 従来のクライアント側分類器に戻したい場合
export CLAUDE_CODE_AUTO_MODE_SERVER=0
# 現在のセッションで分類器がサーバー実行かを確認
# Claude Code 内で以下を実行
/status
# → "Auto mode server" の行を確認

まとめ

  • Claude Code v2.1.278 で auto モードの分類器が既定でサーバーサイド実行になり、分類器オーバーヘッド分の課金がなくなりました。
  • 対象は Claude API / Enterprise ユーザー、および Bedrock / Vertex / Foundry / ゲートウェイ経由の利用です。
  • Bedrock 等の利用者は CLAUDE_CODE_AUTO_MODE_SERVER=0 でクライアント側分類器にオプトアウト可能ですが、課金対象のフォールバック経路に戻るため注意が必要です。
  • /status に追加された Auto mode server 行で、現在のセッションの分類器実行場所を確認できます。
  • 特別な対応は不要ですが、コスト監視をしているチームは請求額の変化と /status の表示を確認しておくと良いでしょう。

auto モードを積極的に使っているプロジェクトほど恩恵を受けやすい変更です。アップデート後は一度 /status で挙動を確認してみてください。

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?