Claude Codeのfast modeが使えない原因 — 使用クレジットとゲートウェイ

/fastが使えないときは、まず表示された文言を見ます。「Fast mode requires usage credits」なら使用クレジットがオフなので、/usage-creditsで設定ページへ進んでオンにします(詳細はゲートウェイと無関係な「使えない」メッセージの節)。「disabled by your organization」はゲートウェイの有無にかかわらず出る文言で、原因は複数あります。以降はゲートウェイ越しで起きるケースから説明します。

LLMゲートウェイ越しでClaude Codeを使っていて、推論は動くのに/fastだけが「Fast mode unavailable due to network connectivity issues」と返す。組織でfast modeを有効にしていても、リクエストは標準速度のままです。原因は、fast modeの可用性チェックがゲートウェイを通らないことにあります。

回避に使う変数は2つあります。CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORSとCLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECKです。どちらを入れるかは、/fastが返すメッセージと、チェックがどこで失敗しているかで決まります。

fast modeの可用性チェックはどこへ向かうのか

Claude Codeは、fast modeを提示する前に、組織のfast mode可用性をapi.anthropic.comへ直接問い合わせます。この問い合わせはANTHROPIC_BASE_URLに従いません。

そのため、Claudeの通信をLLMゲートウェイに集約し、api.anthropic.comへの直接の外向き通信を塞いでいるネットワークでは、推論が通ってもチェックだけが失敗します。

一方、チェックは設定済みのHTTPプロキシには従います。失敗するのは、プロキシ経由でもapi.anthropic.comに届かない場合だけです。過去に成功したチェックはキャッシュされて有効なままなので、影響が目立つのは新規インストールです。

ゲートウェイ全体の設計はClaude Code LLM gatewayとは、接続手順はLLMゲートウェイへの接続方法にあります。ここではfast modeのチェックだけを扱います。

表示されるメッセージから原因を切り分ける

/fastの表示は、原因によって2種類に分かれます。同じ接続不良メッセージでも、ネットワークが塞がれているとは限りません。

2行目の落とし穴は、鍵の出どころです。ANTHROPIC_API_KEYやapiKeyHelperが返すのがゲートウェイ発行の鍵だと、チェックはその鍵でapi.anthropic.comに届きます。Anthropicは知らない鍵を拒否し、その拒否が接続不良として表示されます。何も塞がれていないので、許可リストを足しても直りません。

3行目も同じくらい紛らわしい点です。ANTHROPIC_AUTH_TOKENだけで動かしていると、claude.aiのログインもAnthropicのAPIキーもありません。この状態でキャッシュもなければ、Claude Codeはリクエストを送らずに「組織が無効にしている」と扱います。

2つの変数の使い分け

分かれ目は、チェックの結果が「失敗」か「無効という応答」かです。

片方ずつ入れて/fastを再実行すれば、どちらの型だったかが分かります。

設定例

環境変数として渡すなら、シェルで次のようにします。

export CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS=1
claude

チーム全体に配るなら、設定ファイルのenvブロックに書く形が使えます。ゲートウェイの設定ページが~/.claude/settings.jsonで示す書き方と同じです。管理者はmanaged settingsでも設定を配布できます。

{
  "env": {
    "CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK": "1"
  }
}

一般的なゲートウェイの配布手順と、この2変数が環境変数の一覧でどう位置づけられるかは、Claude CodeのLLMゲートウェイをロールアウトする手順が扱っています。プロキシ側の許可ドメインはClaude Codeプロキシ設定にあります。

変数を入れても直らないケース

skip変数が消すのはクライアント側のチェックだけです。組織でfast modeが無効なら、APIがfast modeのリクエストを拒否します。変数を設定していても、この拒否は覆りません。

拒否されると、Claude Codeはそのリクエストを標準速度で再送し、fast modeをオフにします。/fastは組織が無効にしていると報告します。

次の状態は、そもそもこの2変数の守備範囲外です。

• 組織でfast modeが有効化されていない(Team・Enterpriseは既定で無効。Ownerが有効化する)
• managed settingsでfastMode: falseが設定されている
• fastModePerSessionOptIn: trueが設定され、対話的な端末セッション以外で/fast onを実行している
• availableModelsの許可リストが、fast mode対応のOpusモデルを除外している
• 選択中のモデルがfast mode非対応(対応はOpus 5.5・Opus 5・Opus 4.8だけ。次の節で扱う)
• Amazon Bedrock・Google Cloud・Microsoft Foundry・Claude Platform on AWS経由の利用(モデル通信と認証が各プロバイダーに向かい、fast modeは非対応)
• Consoleの組織で、fast modeのアクセスが未プロビジョニング(APIが各リクエストを429で拒否し、Claude Codeはレート制限として扱う)

最後の項目は、クールダウンで解ける通常のレート制限と違い、アクセスが付与されるまで拒否が続く点が特徴です。制限の仕組みはfast modeのレート制限で解説しています。

切り分けの手順

NONESSENTIAL_TRAFFICを入れた環境で止まるもの

ゲートウェイ運用では、外部への余計な通信を減らす目的でCLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFICを入れる組織があります。この変数は自動更新、テレメトリ、エラー報告、/feedback、リリースノート、PRステータスバッジの確認に加えて、fast modeの可用性チェックも止めます。症状と復旧の変数は、前掲の表の最終行のとおりです。

同じ変数の副作用は、fast mode以外にも及びます。

• 自動更新が止まるので、パッケージマネージャーや配布基盤など別の更新経路が要る
• フィーチャーフラグの取得も止まり、Remote Controlなど取得に依存する機能が使えなくなる
• ゲートウェイのモデル探索は影響を受けない(問い合わせ先がゲートウェイだけのため)
• WebFetchのドメイン安全チェックは止まらず、api.anthropic.comを呼び続ける。ネットワークで塞いでいるなら、settingsでskipWebFetchPreflight: trueを別に設定する

なお、この変数に0やfalseを入れても通信は止まったままです。多くのオン・オフ変数と違い、値が空でなければ有効になります。戻すときは変数そのものを外します。

モデルが原因で使えない場合の見分け方

fast modeはOpusの設定の1つで、対応するのはOpus 5.5・Opus 5・Opus 4.8です。SonnetやHaikuには効かず、これらを選ぶとfast modeはオフになります。

Opus 4.7はfast modeの対象外です。2026年6月25日に非推奨となり、同年7月24日に削除されました。Opus 4.7に切り替えるとfast modeはオフになり、Fast mode OFFと表示されます。v2.1.221より前は、切り替え後もオンのまま残り、APIがリクエストを拒否していました。

対応モデルから外れたあと、対応モデルへ戻した場合の挙動は設定で決まります。保存済みの好みがオンなら、戻した時点で自動的にオンへ戻ります。好みがオフ、またはfastModePerSessionOptInが有効なら、/fastで入れ直します。

fast modeの既定モデルは、版によって変わってきました。古いClaude Codeを使い続けている環境では、既定の指す先が今と違います。

ゲートウェイと無関係な「使えない」メッセージ

/fastが返す別のメッセージは、ゲートウェイではなくプランや課金の条件が原因です。ここで2変数を試しても状況は変わりません。

使用クレジットが尽きると、Claude Codeは拒否されたリクエストを標準速度と標準料金で再送します。クールダウンは無く、保存済みの好みも変わりません。対話セッションでは通知が出てfast modeがオフになります。stream-jsonの非対話モードやAgent SDK経由では、同じ文言がsystemメッセージ(subtypeはnotification)としてターンごとに流れ、fast modeはオンのままです(v2.1.221以降)。

料金の出どころも異なります。サブスクリプションのプランでは、fast modeの利用は残りの含有分があっても使用クレジットから引かれます。Consoleの組織は、他のAPI利用と同じくトークン単位で支払います。

非対話モードとVS Codeで「組織が無効」と出るとき

「Fast mode has been disabled by your organization」は、ゲートウェイの外でも出ます。managed settingsでfastModePerSessionOptIn: trueを配っている組織では、/fast onが動くのは対話的な端末セッションだけです。非対話モード、VS Code拡張、クラウドセッションでは、同じ「無効」のメッセージで拒否されます。

この設定は、複数セッションを並行して回す組織でコストを抑える目的で使われます。各セッションはfast modeオフで始まり、ユーザーが/fastで明示的にオンにします。本人のfast modeの好みは保存されたままなので、設定を外せば通常の持続的な挙動に戻ります。ゲートウェイの環境でCIやスクリプトから/fast onを呼んで拒否された場合は、skip変数ではなくこの設定を先に疑う場面です。

-pで動かす非対話モードには、別の条件もあります。fast modeを指定した--settingsで起動したセッションでだけ、/fastが働きます。v2.1.205以降の挙動で、このトグルはそのセッション限りです。

v2.1.289のclaude --helpでは、--settingsは次のように説明されています。

claude --help | grep -A1 -e "--settings"

  --settings <file-or-json>             Path to a settings JSON file or a JSON
                                        string to load additional settings from

JSON文字列を渡せるので、スクリプトからは次の形で起動できます。

claude -p --settings '{"fastMode": true}' "..."

クラウドセッションでは、セッション内で/fast onと入力します。セルフホストランナーでも使え、環境側のClaude Codeがv2.1.271以降であることが条件です。

fast mode自体の料金や速度はfast modeの概要にまとまっています。

まとめ

変数を選ぶ前に見るのは、/fastの文言と認証方式の2点です。