Claude Code が Deepseek API に接続した後、Auto Mode でエラーが発生?3ステップで理解する課金メカニズムの互換性警告

Claude Code が Deepseek API に接続した後、Auto Mode でエラーが発生?3ステップで理解する課金メカニズムの互換性警告

著者注:Claude Code で Deepseek API を接続した後に Auto Mode に表示される「課金メカニズム互換性警告」を読み解き、その意味、一時的な対処法、API中継プラットフォームへの互換要件を説明します。

最近、多くの開発者が Claude Code に Deepseek API を接続した後、Auto Mode(自動権限モード)を有効にすると、分類器の課金メカニズムに関する互換性警告 が表示されることに気づきました。Anthropic は公式ドキュメントでこのメカニズム調整について専用の説明を掲載しているため、この表示は偶発的な障害ではなく、巷の噂でもありません。

これは Deepseek API のエラーではなく、アカウントに問題があるわけでもありません。 原因は、Claude Code の新バージョンが Auto Mode のセキュリティ審査方式を調整したことにあり、api.deepseek.com のようなサードパーティの上流APIは現在、新しいメカニズムに互換性がありません。本記事では、この警告の意味、現時点での対処方法、そして API中継プラットフォームにとって何を意味するのかをまとめます。

この記事のポイント:3分で Claude Code Auto Mode の課金互換性警告の経緯を理解し、すぐにコピーできる設定方法とゲートウェイ互換性チェックリストを手に入れられます。

claude-code-deepseek-auto-mode-billing-warning-ja-image-0


Claude Code Auto Mode 課金警告の重要ポイント一覧

まずは表で今回の変更点を整理し、自分が影響を受けるかどうかをすぐに判断できるようにしましょう。

項目 詳細
提供元 Anthropic(Claude Code 公式)
対象機能 Claude Code Auto Mode の安全分類器(Classifier)
核心的な変更 安全審査が「クライアントが個別に分類リクエストを送る」方式から、「サーバー側がメインリクエスト内で完了させる」方式へ
課金の変化 新メカニズムでは分類器リクエストが個別に課金されない
影響を受けるユーザー Deepseek などサードパーティ製の Anthropic 互換インターフェース経由で Claude Code を使う開発者
現在の状態 旧メカニズムへのフォールバックは可能だが、分類器リクエストは旧方式で Tokens を消費する
今後の予定 公式は将来のバージョンで旧方式へのフォールバックを削除すると述べている

Claude Code Auto Mode の分類器とは

Auto Mode の目的は、手動で確認をクリックする手間を減らすことです。Claude Code はシェルコマンドの実行やネットワークアクセスなど、リスクを伴う操作を行う前に、まず分類器を使ってその操作が安全かどうかを判断します。安全と判断されれば自動実行され、そうでなければあなたの確認を求めるか、そのまま拒否します。

旧メカニズムでは、この分類器の判断は Claude Code が単独で 1 回のリクエストを送ることで完了していました。このリクエスト自体が Tokens を消費します。つまり、Claude Code にコマンドを 1 つ自動実行させるたびに、メインの対話リクエストに加えて分類リクエストのコストが発生する可能性がありました。

Claude Code Auto Mode 新旧課金メカニズムの違い

Anthropic は今回、安全審査をサーバー側に移しました。メインリクエストに安全審査関連のフィールドを含め、サーバー側がメインリクエストを処理する際に審査結果もまとめて返すため、分類器リクエストが個別に課金されることはなくなります。これは公式 API ユーザーにとって実質的なコスト最適化です。

問題は、新メカニズムでは上流サーバーがこの安全審査プロトコルを実装している必要がある点です。Deepseek の Anthropic 互換インターフェースは現時点で実装されていないため、Claude Code は上流が非対応であることを検出すると互換性の警告を表示し、旧方式にフォールバックして動作を続けます。

比較項目 旧メカニズム 新メカニズム
安全審査の場所 Claude Code が個別に分類リクエストを送信 サーバー側がメインリクエスト内で完了
分類器の Tokens 個別に消費 個別課金なし
公式互換サービス 対応 対応
現在の Deepseek インターフェース 対応。旧方式で課金 現時点では非互換
今後のバージョン フォールバック方式として維持 旧方式へのフォールバックは削除予定

claude-code-deepseek-auto-mode-billing-warning-ja-image-1

特に注意したいのが「将来フォールバックが削除される」という点です。フォールバック方式が廃止され、かつ上流が安全審査結果を返せなくなると、Claude Code は該当する操作ごとに逐一あなたの許可を求めるか、実行を直接拒否するしかありません。その時点で Auto Mode の「自動」体験は大きく損なわれるでしょう。


Claude Code に Deepseek を接続した後の Auto Mode 警告の対処法

Deepseek で Claude Code を動かし続けたいだけなら、最も簡単な方法はサーバー側の分類器モードを自分で無効にし、Claude Code に従来の仕組みを直接使わせて、繰り返し検出・通知されないようにすることです。

方法1:ターミナルの環境変数

macOS または Linux のターミナルで次を実行します:

export CLAUDE_CODE_AUTO_MODE_SERVER=0
claude

この方法は現在のターミナルセッションでのみ有効で、一時的な検証に向いています。永続的に有効にしたい場合は、export の行を ~/.zshrc または ~/.bashrc に追加してください。

方法2:settings.json への書き込み

より推奨される方法は、Claude Code の設定ファイル ~/.claude/settings.json に記述することです:

{
  "env": {
    "CLAUDE_CODE_AUTO_MODE_SERVER": "0"
  }
}

設定ファイルにすでに他の内容(アップストリームアドレス、モデル名、権限ルールなど)が含まれている場合は、CLAUDE_CODE_AUTO_MODE_SERVER というフィールドだけを既存の env オブジェクトにマージしてください。決してファイル全体を上書きしないでください。そうしないと既存の設定が失われてしまいます。

サーバーサイドモードを無効化した後の実際の効果

無効化後の変化は、次の表でまとめられます:

項目 無効化前(デフォルト) 無効化後(=0)
互換性警告 アップストリームの非互換を検出するたびに通知 表示されなくなる
分類器メカニズム サーバーサイド審査を試み、失敗後にフォールバック 旧分類器を直接使用
分類器トークン フォールバック後も通常どおり消費 通常どおり消費
無料分類器 アップストリーム非互換時は利用できない 利用できない
長期的な可用性 フォールバック方式は削除予定 公式には一時的な措置と位置づけられ、将来的に削除される可能性あり

つまり、この環境変数はあくまで「サイレンサー」であり、Deepseek に新しい無料分類器の機能を獲得させるものではありません。解決するのは通知の煩わしさであって、課金の問題そのものではないのです。

/status で実際の状態を確認する

設定が完了したら、Claude Code で公式の確認コマンドを実行します:

/status

出力の Auto mode server の項目に注目してください。Enabled と表示されていれば現在サーバー側の審査を使用していることを示し、Disabled と表示されていればフォールバック済みで、サーバー側の審査を使用していないことを示します。先ほど CLAUDE_CODE_AUTO_MODE_SERVER=0 を設定した場合、ここは Disabled と表示されるはずです。

まず上流モデルの可用性を検証する

Auto Mode の問題を調査する前に、まず上流モデル自体が正常に呼び出せることを確認しておきましょう。ネットワークや認証の問題を、課金互換性の問題と誤認しないようにするためです。以下は OpenAI 互換インターフェースを使った最小限の疎通テストです:

import openai

client = openai.OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.apiyi.com/v1"  # APIYIの統一インターフェース、複数のモデルを切り替え可能
)

resp = client.chat.completions.create(
    model="deepseek-chat",
    messages=[{"role": "user", "content": "回复 OK 即可"}]
)
print(resp.choices[0].message.content)

マルチモデル接続性チェックの完全版スクリプトを見る
import time
import openai
from typing import List

client = openai.OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.apiyi.com/v1"
)

def check_models(models: List[str]) -> None:
    """複数のモデルが正常に呼び出せるかを順に検証し、所要時間を出力する"""
    for model in models:
        start = time.time()
        try:
            resp = client.chat.completions.create(
                model=model,
                messages=[{"role": "user", "content": "回复 OK 即可"}],
                max_tokens=10
            )
            cost = time.time() - start
            text = resp.choices[0].message.content.strip()
            print(f"[成功] {model}: {text}({cost:.2f}s)")
        except Exception as e:
            print(f"[失败] {model}: {e}")

if __name__ == "__main__":
    # モデル名はプラットフォームが実際に提供する一覧に従う
    check_models(["deepseek-chat", "claude-sonnet-4-5", "gpt-4o-mini"])

🚀 クイックスタートのヒント:Claude Code の互換性問題を調査する際は、まず1つのキーで Deepseek や Claude などの上流モデルを一通りテストしておくと、多くの時間を節約できます。APIYI apiyi.com は OpenAI 互換の統一インターフェースを提供しており、新規ユーザーには無料テスト枠もあるので、マルチモデルの接続性を素早く比較するのに適しています。


Claude Code Auto Mode の新メカニズムが API 中継プラットフォームに与える影響

一般ユーザーにとっては、環境変数を1つ設定するだけで問題を解決できます。しかし、API 中継プラットフォームや自前で構築したゲートウェイの運営者にとっては、今回の調整はより重視すべきものです。なぜなら、同種の互換性問題はいずれあなたのユーザーの身にも降りかかるからです。

ゲートウェイがパススルーすべき Auto Mode のセーフガード審査フィールド

Anthropic の公式ドキュメントによると、サーバーサイドのセーフガード審査をサポートするゲートウェイは、以下のフィールドを正しく処理する必要があります。

位置 フィールド 要件
リクエストヘッダー anthropic-beta そのままパススルー
リクエストボディ safeguards そのままパススルー
レスポンスボディ safeguard_results 保持して正しく返す
ストリーミング セーフガード審査結果関連フィールド 失ってはならない
ツール使用 Tool Use ID 勝手に変更しないこと

このうち最も問題が起きやすいのは、2種類のゲートウェイ実装です。1つは「フィールドホワイトリスト」によるフィルタリングを行うゲートウェイで、認識できない safeguards や safeguard_results をそのまま捨ててしまいます。もう1つはストリーミングレスポンスを再構築するゲートウェイで、SSE イベントの変換過程で審査結果関連のイベントを飲み込んでしまいます。また一部のゲートウェイは内部追跡のために Tool Use ID を書き換えており、これも同様にプロトコルを破壊します。

以下はゲートウェイのパススルーロジックを示すサンプル断片です。核となる考え方は「認識できないフィールドでも削除しない」ことです。

def forward_request(incoming_headers: dict, incoming_body: dict) -> tuple:
    """例:Anthropic のセーフガード審査関連フィールドをパススルーし、ホワイトリストによる切り取りを行わない"""
    headers = {k: v for k, v in incoming_headers.items()
               if k.lower() not in ("host", "content-length")}
    # anthropic-beta はそのまま保持し、マージも書き換えも行わない
    body = dict(incoming_body)  # safeguards など全フィールドを保持
    return headers, body

def forward_response(upstream_body: dict) -> dict:
    """例:レスポンスボディをそのまま返し、safeguard_results と tool_use id を保持する"""
    return upstream_body

パススルーフィールドは上流のサポートを意味しない

ここには非常に重要な前提があります。ゲートウェイがこれらのフィールドをパススルーするからといって、Deepseek モデルが Anthropic のサーバーサイド安全審査をサポートしているわけではありません。 上流自体がこのプロトコルを実装していなければ、API中継サービスをどれだけ改善しても safeguard_results を取得できず、当然ながら無料の分類器も利用できません。

そのため、API中継プラットフォームは上流の種類ごとに分けて評価する必要があります。

  1. Anthropic 公式 API を上流にする場合:パススルー経路が完全かどうかを優先的に確認します。フィールドが失われなければ、ユーザーが新しい仕組みを直接利用できる可能性があります。
  2. Deepseek などのサードパーティモデルを上流にする場合:Anthropic Messages API のフォーマットと互換性があっても、この専用の安全審査プロトコルをサポートしているわけではありません。上流ベンダー自身による実装を待つ必要があります。

claude-code-deepseek-auto-mode-billing-warning-ja-image-2

上流が異なる場合の Claude Code Auto Mode 対応戦略

上記の分析を具体的なシナリオに落とし込み、判断表として整理できます。

上流の種類 サーバーサイド安全審査 推奨される対応 利用可能なプラットフォーム
Anthropic 公式 Claude モデル サポート(経路の完全なパススルーが必要) デフォルトを維持し、/status が Enabled であることを確認 公式 API、APIYI apiyi.com などの集約プラットフォーム(実測のパススルー結果を基準)
Deepseek Anthropic 互換インターフェース 現時点では未サポート CLAUDE_CODE_AUTO_MODE_SERVER=0 を設定 Deepseek 公式インターフェースなど
その他のサードパーティ互換モデル 通常は非サポート 上記と同じ、かつ今後のバージョン変化に注目 各ベンダーの互換インターフェース
自前構築ゲートウェイによる公式 API 転送 ゲートウェイの実装次第 フィールド一覧に従ってパススルーを項目ごとに確認 自前構築ゲートウェイ

開発者への長期的な影響

  • コスト面:引き続き Deepseek で Auto Mode を実行する場合、分類器のトークンは依然として課金対象です。新しい仕組みに対応した上流を使用すれば、この部分のコストを削減できます。
  • 体験面:旧方式へのフォールバックが削除されると、互換性のない上流では Auto Mode が頻繁に許可を求めたり、実行を拒否したりして、自動化の度合いが低下する可能性があります。
  • 選定面:Claude Code のモデル上流を選ぶ際、「サーバー側の安全審査をサポートしているか」が、価格や速度と並ぶ検討項目になります。

💡 選択のヒント:Auto Mode によるコマンドの自動実行に大きく依存している場合は、Claude ネイティブモデルと Deepseek を同じワークフローに置いて比較テストすることをおすすめします。APIYI apiyi.com を使えば同じ Key で異なる上流を切り替えられるため、実際のタスクでトークン消費量や権限確認ポップアップの頻度の違いを観察しやすくなります。


Claude Code Auto Mode 課金警告に関するよくある質問 FAQ

Q1:Claude Code に Deepseek を接続した際に表示される課金警告とは何ですか?

これは Claude Code の Auto Mode 分類器の課金メカニズムに対する互換性の警告です。現在の上流(`api.deepseek.com` など)が新しいサーバー側安全審査をサポートしておらず、Claude Code が旧メカニズムにフォールバックしたため、分類器のリクエストが引き続き個別にトークンを消費することを示しています。Deepseek のエラーではなく、アカウントの状態とも関係ありません。

Q2:CLAUDE_CODE_AUTO_MODE_SERVER=0 を設定するとどのような副作用がありますか?

主な効果は警告が表示されなくなり、旧分類器を直接使用することです。副作用として、サーバー側審査を明確に放棄することになり、分類器のトークンは通常どおり課金されます。また、公式はこの環境変数を一時的な手段と位置づけており、将来のバージョンで削除される可能性があるため、その際は上流の選択を再評価する必要があります。

Q3:旧分類器へのフォールバック方式はいつ削除されますか?

公式は現在「将来のバージョンで旧方式へのフォールバックを削除する」としか説明しておらず、参考資料には具体的なバージョン番号や日付は示されていません。Claude Code をアップグレードする際は更新内容に注意し、アップグレード後に `/status` で `Auto mode server` の状態を確認することをおすすめします。

Q4:無料のサーバー側分類器を実際に使うにはどうすればよいですか?

前提として、上流が Anthropic のサーバー側安全審査プロトコルをサポートしている必要があります。現在は主に Anthropic 公式の Claude モデルが該当し、同時に中間経路が `anthropic-beta`、`safeguards`、`safeguard_results` を完全に透過転送しなければなりません。素早く検証したい場合は、APIYI apiyi.com でテスト用のクレジットを取得し、Claude ネイティブモデルで一度 Auto Mode を実行してから、`/status` で `Enabled` になっているかを確認できます。

Q5:中継ゲートウェイはすでにフィールドを透過転送していますが、なぜ Deepseek は互換性がないのですか?

透過転送はあくまで「フィールドが失われない」問題を解決するものであり、`safeguard_results` を返せるかどうかは上流モデルサービス自体に依存します。Deepseek のインターフェースは Anthropic Messages API の形式に互換性がありますが、それはこの安全審査プロトコルを実装していることと同じではありません。この場合、ゲートウェイ側はすでに対応済みであり、上流のサポートを待つしかありません。

Q6:ある聚合プラットフォームの Claude Code との互換性の程度を判断するには?

本記事のフィールド一覧に沿って項目ごとにテストできます。リクエストヘッダーで `anthropic-beta` が保持されているか、リクエストボディで `safeguards` が保持されているか、レスポンスおよびストリーミングイベントで審査結果が返されているか、Tool Use ID が書き換えられていないか、などを確認します。APIYI apiyi.com のようなマルチモデルプラットフォームでも、これらのチェックを Claude Code ネイティブ API 透過転送の互換性チェックリストの一部として検証することをおすすめします。


Claude Code Auto Mode 課金互換性の要点

  • 警告の本質:Auto Mode の分類器課金メカニズムが調整されたもので、Deepseek のアカウントや API 障害とは無関係です。
  • 新メカニズムの変化:セーフティレビューはサーバー側がメインリクエスト内で行うようになり、分類器は個別に課金されなくなりました。
  • 現状:Deepseek でも引き続き Auto Mode は使えますが、分類器リクエストは従来どおり Tokens を消費します。
  • 一時的な回避策:CLAUDE_CODE_AUTO_MODE_SERVER=0 を設定すれば警告は消えますが、無料の分類器は利用できません。
  • 状態確認:/status を実行して Auto mode server が Enabled か Disabled かを確認します。
  • ゲートウェイのポイント:safeguards と safeguard_results を完全にパススルーしますが、上流が対応していない場合はパススルーしても無効です。
  • 試し方:APIYI apiyi.com の 1 つの Key を使えば、Claude ネイティブと Deepseek の 2 つの経路を比較できます。

Claude Code Auto Mode 課金警告のまとめ

Claude Code で Deepseek API を接続した際の Auto Mode 警告は、本質的には課金とセーフティレビュー・アーキテクチャのアップグレードを通知するものです。

  1. 故障ではありません:Deepseek は現時点でも Auto Mode を正常に動作させられますが、分類器は引き続き従来の方法で課金されます。
  2. 短期的には回避策があります:環境変数または settings.json でサーバー側モードをオフにすれば、警告の表示を消せます。
  3. 長期的には選択肢の検討が必要です:旧フォールバック方式はやがて削除されるため、Auto Mode に強く依存するチームは、上流がサーバー側セーフティレビューに対応しているか事前に評価する必要があります。
  4. ゲートウェイも対応が必要です:中継プラットフォームは anthropic-beta、safeguards、safeguard_results、Tool Use ID をパススルー確認リストに加えるべきです。

日常的に Deepseek をメインで使う開発者は、まず CLAUDE_CODE_AUTO_MODE_SERVER=0 を設定するだけで済みます。無料の分類器を利用したい場合は、Claude ネイティブモデルで一度比較テストを行うことをおすすめします。APIYI apiyi.com を使えば、さまざまな上流が Claude Code で実際にどう動作するかをすばやく検証できます。同プラットフォームは無料テスト枠と複数モデルの統一インターフェースを提供しています。


📚 参考資料

  1. Anthropic 公式ドキュメント – Auto Mode 分類器の課金説明:Claude Code Auto Mode の新旧課金メカニズムとゲートウェイ互換要件

    • リンク: code.claude.com/docs/en/auto-mode-classifier-billing
    • 説明:CLAUDE_CODE_AUTO_MODE_SERVER 環境変数、/status による確認方法、フィールド透過要件を含む公式説明
  2. Deepseek API 公式インターフェース:Anthropic 互換インターフェースの上流アドレス

    • リンク: api.deepseek.com
    • 説明:本記事で扱うサードパーティ上流。現時点ではサーバー側のセキュリティ審査に非対応

作者:APIYI 技術チーム
技術交流:Claude Code の接続と上流互換性に関する問題については、docs.apiyi.com ドキュメントセンターでより多くの設定資料をご覧いただけます

関連記事

類似投稿