Blank white background with no objects or features visible.

EMEAの皆様へ。TrueFoundryは、ヨーロッパ、中東、アフリカ全域で事業を拡大しています。詳細はこちら →

Claude Code Proxy: TrueFoundry AI Gateway経由でClaude、GPT-5、Geminiをルーティング

By サハジミート・カウル

Updated: November 3, 2026

Published: July 2, 2026

はじめに

Claude Codeは、現在利用可能な中で最も強力なAIコーディングアシスタントです。 一度導入したエンジニアが元のツールに戻ることは滅多にありません。しかし、数十人あるいは数百人のエンジニアが同時に使い始めると、新しい問題が発生します。デフォルトのClaude Codeは、AnthropicのAPIと直接通信します。各開発者が個人のキーで認証し、Anthropicのモデルのみを使用し、毎月の請求書が届くまでプラットフォームチームからは完全に不可視なAPIコストを発生させます。

その解決策がClaude Codeプロキシです。 Claude Codeの接続先をAnthropicへ直接向ける代わりにプロキシエンドポイントに設定することで、エンジニアリング組織全体でのすべてのモデル呼び出しに対して中央集権的な制御ポイントを獲得できます。誰がどれだけコストを消費しているかの可視性、予算上限を超過する前に強制適用する機能、Claude Codeが既に理解している同じインターフェースを通じて任意のプロバイダーのモデル(GPT-5、Gemini 2.5 Pro、Bedrock経由のLlamaなど)にアクセスする機能、そして個々のマシンを触ることなく一括でゲートウェイ設定をデプロイしてすべての開発者に適用する機能が得られます。

TrueFoundry AI Gatewayは、エンタープライズグレードのClaude Codeプロキシです。 単一の環境変数を変更するだけでClaude Codeが接続できる、ドロップイン可能なAnthropic互換エンドポイントです。一度接続すると、すべてのClaude Codeリクエストがゲートウェイを通過するようになり、設定を忘れがちな一部の開発者だけでなく、組織全体に適用されるオブザーバビリティ、コストコントロール、マルチモデルルーティング、およびエンタープライズセキュリティポリシーが提供されます。

本ガイドでは、Claude Codeプロキシの正確な機能、エンタープライズエンジニアリングチームにとってTrueFoundry AI Gatewayが最適な理由、および標準のAPIキーとClaude Maxサブスクリプションフローの両方を含む設定方法について詳しく解説します。

Claude Codeプロキシとは?

Claude Codeには、バックエンドを変更するための単一の設定ノブであるANTHROPIC_BASE_URL環境変数が用意されています。これが設定されると、Claude CodeはすべてのAPIリクエスト(メッセージ、モデル呼び出し、ストリーミングレスポンス)をhttps://api.anthropic.comではなく指定したURLに送信します。

この1つの変数が、すべてのClaude Codeプロキシの基礎となります。 プロキシとは、以下の処理を行うサーバーを指します。

  1. Claude CodeからAnthropic形式のAPIリクエストを受け取る
  2. プロキシ層で制御、ルーティング、またはオブザーバビリティを追加する
  3. リクエストを実際のモデルプロバイダー(Anthropic、OpenAI、Google、Bedrock、オンプレミスなど)に転送する
  4. Claude Codeが期待するフォーマットでレスポンスを返す

最もシンプルなプロキシは、ログ機能を備えたリバースプロキシです。最も洗練されたプロキシは、認証、予算設定の強制、複数プロバイダーにわたるモデルルーティング、セマンティックキャッシュ、ガードレール、完全な監査ログを処理するエンタープライズAIゲートウェイであり、これらすべてを透明性の高い方法で実行し、開発者側でのClaude Codeの動作を変更することはありません。

プラットフォームの推奨

多くのチームはプロキシだけでは満足しません。

プロキシは中央集中型の認証を解決しますが、本番環境のAIシステムでは通常、プロバイダーのルーティング、監査ログ、レート制限、予算コントロール、プロンプトキャッシュ、詳細なオブザーバビリティなど、さらに多くの機能が必要になります。これらの機能は、プロキシが内部プラットフォームに成長するにつれて、機能を1つずつ追加されがちです。

TrueFoundryのAI Gateway は、これらの機能をClaude互換のエンドポイントの背後で提供するため、開発者はClaude Codeを使い続けながら、プラットフォームチームは初日からガバナンス、可視性、およびマルチプロバイダールーティングを獲得できます。 AI Gatewayの詳細を見る →

なぜチームはClaude Codeプロキシを構築または導入するのか?

  • コストコントロール:複数の開発者が個別のAnthropicキーでClaude Codeを使用すると、月末まで見えないコストが発生します。プロキシはすべてのリクエストをインターセプトし、コストが予算を超過する前に開発者ごとの日次制限を強制適用します。
  • マルチモデルへのアクセス:Claude Codeのインターフェースは強力ですが、Claudeモデルがすべてのタスクに対して常に最適または最もコスト効率が良いとは限りません。プロキシを使用すれば、haikuティアのタスクをGPT-4o-miniやGemini Flashに、opusティアのタスクを利用可能な最適なモデルに、クライアント側の変更なしでルーティングできます。
  • エンタープライズセキュリティ:開発者のラップトップ上にある直接のAPIキーはセキュリティ上のリスクです。プロキシは資格情報を一元管理します。開発者はプロキシに対して認証を行い、プロキシがプロバイダーのキーを保持します。開発者のマシンにAnthropicのキーを保存する必要はありません。
  • チーム全体のガバナンス:個々の開発者が自身のANTHROPIC_BASE_URLを設定できます。しかし、チーム全体にわたってそれを強制適用するには、MDM、サーバー管理の設定、またはバージョン管理にチェックインされた共有プロジェクト.claude/settings.jsonなどの中央集中型デプロイメカニズムが必要です。

TrueFoundry AI Gatewayが最適なClaude Codeプロキシである理由

Claude Codeをプロキシ処理する方法は3つあります。自作する、シンプルなリバースプロキシを使用する、または専用に作られたAIゲートウェイを使用するのいずれかです。自作するということは、本番環境のAPIゲートウェイのメンテナンス、セキュリティ、信頼性を自社で責任を持つことを意味します。 シンプルなリバースプロキシはログを追加しますが、制御機能は何も追加しません。TrueFoundry AI Gatewayは、構築やメンテナンスを行うことなく、エンタープライズエンジニアリングチームが実際に必要とするすべての機能を提供します。

TrueFoundry AI Gatewayは、Claude Codeとモデルプロバイダーの間にある統合プロキシ層です。Claude Codeが既に理解している同じAnthropic APIフォーマットを受け入れるため、Claude CodeはAnthropicに直接接続しているかゲートウェイと通信しているかを意識する必要がありません。ゲートウェイの背後では、Anthropic直接、AWS Bedrock、Google Vertex AI、Azure OpenAI、OpenAI、または自社のオンプレミスモデルなど、あらゆるプロバイダーを接続できます。

以下は、Claude Codeが実際に認識する構造です:

TrueFoundryを通過するすべてのClaude Codeリクエストは、自動的に以下のメリットを獲得します:

機能Claude CodeユーザーにとってのメリットTrueFoundry機能
マルチプロバイダーモデルアクセス同じClaude Codeインターフェースを通じてGPT-5、Gemini 2.5 Pro、Llama、またはオンプレミスモデルを使用バーチャルモデル
開発者ごとの予算制限日次または月次の消費上限に達した際にリクエストをブロック(コストオーバーランの後ではなく事前に対処)予算制限
レート制限開発者ごと、チームごと、または環境ごとのリクエストレートをスロットリングレート制限
コスト属性の管理どの開発者、チーム、モデルがすべてのコストの発生源であるかを正確に示すダッシュボードアナリティクス
RBACとバーチャルキー開発者のマシン上にAnthropic APIキーを置かない — チームメンバーはアクセスレベルに応じたTrueFoundryキーで認証アクセス制御
自動フェイルオーバーAnthropicがレート制限や障害に直面した場合、ゲートウェイは設定された次のプロバイダーで静かに再試行ロードバランシング&フォールバック
ガードレールリクエストがモデルに到達する前に、PII検出、プロンプトインジェクション保護、カスタムコンテンツポリシーを適用ガードレール
完全な監査トレイルユーザー、モデル、トークン数、コスト、レイテンシを含むすべてのリクエストをログ保存 — OpenTelemetry経由でエクスポート可能OpenTelemetryエクスポート

ゲートウェイのオーバーヘッドはp95で約3〜4ミリ秒、単一vCPUで350以上のRPSを実現します。 Claude Codeのレスポンスタイム(ミリ秒ではなく秒単位)を考慮すると、ゲートウェイによる知覚可能なレイテンシの増加はありません。

ステップ1: Claude CodeをTrueFoundry AI Gatewayに向ける

コアとなる設定は、単一の環境変数です:

永続的な設定(本番運用で推奨される方法)を行うには、Claude Codeのsettings.jsonを編集します。2つのパスがサポートされています:

  • グローバル(すべてのプロジェクトに適用): ~/.claude/settings.json
  • プロジェクト固有(バージョン管理にチェックイン): プロジェクトディレクトリ内の.claude/settings.json

標準APIキーの設定

開発者がTrueFoundry APIキーで認証する場合はこれを使用します(エンタープライズで推奨されるパターン — 開発者のマシンにAnthropicキーを置きません):‍

各フィールドの機能:

  • ANTHROPIC_BASE_URL — すべてのClaude CodeリクエストをTrueFoundryにリダイレクトします
  • ANTHROPIC_AUTH_TOKEN — TrueFoundry APIキー。開発者をゲートウェイに対して認証します(Anthropic APIキーを置き換えます)
  • ANTHROPIC_MODEL — Claude Codeセッションのデフォルトモデル
  • ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL、ANTHROPIC_DEFAULT_HAIKU_MODEL — Claude Codeの組み込みモデルエイリアス(/model opus、/model sonnet、/model haiku)を、TrueFoundryで設定したモデルにマッピングします
  • CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS — 安定したゲートウェイ動作のために、実験的なClaude Code機能を無効にします
  • ANTHROPIC_CUSTOM_HEADERS — コンテキスト管理などのベータ機能のために、x-tfy-anthropic-betaヘッダーをAnthropicに転送します

重要: Claude CodeはモデルIDの文字列マッチングによってモデル機能(拡張思考、ToolSearch、ベータツールブロック)を検出します。ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL、およびANTHROPIC_DEFAULT_HAIKU_MODELに、claude-opus-4-7、claude-sonnet-4-6、またはclaude-haiku-4-5のような認識可能なAnthropicモデルIDが含まれていることを確認してください。TrueFoundryバーチャルモデルを使用している場合は、表示名に基礎となるモデルID(例:your-account/claude-haiku-4-5)が含まれていることを確認し、文字列マッチングが成功するようにしてください。

Claude Code Maxサブスクリプションの設定

チームがClaude Code Maxサブスクリプションを使用している場合、Claude CodeはAnthropicアカウントの認証用にAuthorizationヘッダーを保持します。代わりにANTHROPIC_CUSTOM_HEADERSでx-tfy-api-keyを使用してください:‍

Maxユーザーにとってこのパターンが優れている理由:

  • Claude Codeのセッション認証のためにAnthropic Maxサブスクリプションを維持できます — AuthorizationヘッダーはそのままAnthropicに届きます
  • TrueFoundryはx-tfy-api-key経由で別途認証を行います — ゲートウェイがリクエストをガバナンスし、Anthropicはサブスクリプション経由で請求を処理します
  • 日常のClaude Codeワークフローを変更することなく、中央集中型ガバナンス(可視性、クォータ、RBAC、ログ、ガードレール)を獲得できます

完全な統合ガイドについてはTrueFoundry Claude Codeドキュメントを、MaxサブスクリプションのバリエーションについてはClaude Code Max統合を参照してください。

ステップ2: Claude Code経由でGPT-5、Gemini、その他あらゆるモデルを使用する

ここが、Claude Codeプロキシが利便性向上からイノベーションへと進化するポイントです。Claude CodeがTrueFoundryを経由してルーティングされると、Anthropicだけでなく、あらゆるプロバイダーのあらゆるモデルに到達できるようになります。 TrueFoundryゲートウェイのダッシュボードでプロバイダーアカウント(OpenAI、Google Vertex AI、AWS Bedrock、Azure OpenAI、xAI、または独自のオンプレミスデプロイメント)を追加するだけで、それらのモデルを同じゲートウェイエンドポイントで利用できるようになります。

Claude CodeのエイリアスをAnthropic以外のモデルに向ける

Claude Codeの「opus」スロット(最も能力の高いモデルティア)にGPT-5を使用するには、モデルエイリアスを更新するだけです:

この設定では以下のようになります:

  • /model opus → GPT-5(複雑なアーキテクチャや設計タスク用)
  • /model sonnet → Claude Sonnet 4(標準的なコーディングタスク用)
  • /model haiku → Gemini 2.5 Flash(メールバリデーションや迅速な検索などの高速で軽量なタスク用)

開発者体験はまったく同じです。 開発者は引き続き/model opusや--model haikuを使用します。各エイリアスの背後にどのプロバイダーがあるかを知る必要も、OpenAIやGoogleの資格情報を管理する必要もありません。

高度なルーティングのためのバーチャルモデルの使用

TrueFoundryのバーチャルモデルを使用すると、重みベース、優先度ベース、またはレイテンシベースのルーティングを用いて、複数のプロバイダーにわたってリクエストをルーティングする単一のモデル識別子を作成できます。Claude Codeのモデルエイリアスをバーチャルモデルに向けると、ゲートウェイがルーティングロジックを透明に処理します。

例:プロバイダー間にわたる優先度ベースのフォールバック

プライマリのAnthropicアカウントがレート制限に達した場合、開発者に気づかれることなく、自動的にBedrock Claude、そしてGPT-4へとフォールバックします:

例:重みベースのA/B評価

チーム全体に導入する前に、Claude Codeトラフィックの10%で新しいモデルをカナリアテストします:‍

次に、Claude Codeのsonnetエイリアスをこのバーチャルモデルに向けます。Claude Codeのsonnetリクエストの10%がGPT-5に送信され、結果を比較するために完全なコストと品質のメトリクスがゲートウェイダッシュボードに表示されます。

ステップ3: すべてのClaude Codeリクエストに適用されるエンタープライズコントロール

Claude CodeがTrueFoundryを経由してルーティングされると、開発者が設定したからではなく、ゲートウェイ層で強制適用されるため、すべてのリクエストがエンタープライズグレードのガバナンスを自動的に継承します。

予算制限:発生する前にコストオーバーランを停止

TrueFoundryの階層型予算制限は、毎月の請求書が届いた後ではなく、トークンが消費される前にトリガーされます。ルールはスタックされ、組み合わされます:

順序ルールIDフィルター予算単位
1senior-eng-budget対象:team:senior-engineers$50/日ユーザー
2default-dev-budget(全対象に一致)$10/日ユーザー
3opus-monthly-capモデル:anthropic-main/claude-4-opus$1000/月共有

シニアエンジニアには1日あたり50ドルが割り当てられます。その他のすべてのユーザーはデフォルトで1日あたり10ドルです。そして組織全体でのOpusの総支出は月額1000ドルに制限されるため、すべての開発者が個人の上限内に収まっていたとしても、組織レベルのモデル予算を超過することはありません。

レート制限:オンプレミスおよび制御環境の保護

TrueFoundry AI Gateway interface showing how to configure rate limitingrules through the Configtab

ゲートウェイでのレート制限は、Claude Code固有の3つのシナリオを処理します:

  • CIパイプライン:CIで実行されるClaude Codeは、インタラクティブな開発者セッションとは独立してレート制限されるべきです。コードレビューのためにClaude Codeを呼び出すテストスイートが、開発者のアクティブなコーディングセッションと同じクォータを消費するべきではありません。
  • 開発用モデル vs. 本番用モデル:メタデータスコープのレート制限により、environment: devリクエストをより安価なモデルにルーティングし、本番環境に影響を与えることなくリクエストレートを制限できます。
  • オンプレミスGPUの保護:Claude Codeのプライマリターゲットとしてオンプレミスモデルを実行している場合、オンプレミスのエンドポイントをレート制限し、容量が飽和したときにクラウドAPIへ自動バーストさせます。

コスト属性の管理:誰が何を消費しているかを正確に把握

TrueFoundryによって処理されるすべてのClaude Codeリクエストは、認証されたユーザーに自動的に割り当てられます。アナリティクスダッシュボードには、開発者、チーム、モデル、日付ごとに分解されたコストが表示され、X-TFY-METADATAヘッダー経由で渡す任意のメタデータタグでフィルタリングできます。

プロジェクトベースのコスト属性管理を使用しているチームの場合、Claude Codeのリクエストにproject_idまたはfeatureメタデータのタグを付けると、すべてのリクエストが適切なコストセンターに自動的にマッピングされます:‍

すべてのトレースは、OpenTelemetry経由でGrafana、Datadog、Splunk、または既存のオブザーバビリティスタックにエクスポートされます。

ステップ4: エンジニアリングチーム全体へのデプロイ

1人の開発者のsettings.jsonを設定するのは簡単です。しかし、組織内のすべての開発者にわたって一貫したプロキシ設定を強制適用するには、デプロイメント戦略が必要です。TrueFoundryは3つのアプローチをサポートしています:

オプションA: MDMプッシュによる管理対象設定(エンタープライズに推奨)

MDMソリューション(Jamf、Kandji、Mosyle、Intune)を介してすべての企業デバイスにmanaged-settings.jsonファイルを配信し、OSレベルで変更できないようにロックします。これがClaude Codeのエンドポイント管理対象設定アプローチです。‍

システムレベルのパス:

  • macOS: /Library/Application Support/ClaudeCode/managed-settings.json
  • Linux: /etc/claude-code/managed-settings.json

この設定は改ざん耐性があり、ネットワークへの依存なしで起動時に即座に適用され、開発者の作業を必要としません。MDMプロファイルを受け取ったすべてのマシンは、自動的にTrueFoundry経由でプロキシ処理されます。

オプションB: Anthropic Admin Console経由のサーバー管理対象設定

Claude Admin Console(Admin Settings → Claude Code → Managed settings)を介して設定を中央で構成します。開発者が組織の資格情報で認証するときにAnthropicのサーバーから設定が送信されるため、ファイルのデプロイは不要です。

このアプローチはMDMインフラストラクチャを必要とせず、BYOD(個人所有)デバイスでも動作します。設定は認証時に配信され、ユーザーが上書きするのはより困難です。

オプションC: バージョン管理内のプロジェクトレベルのsettings.json

すべてのリポジトリのルートに.claude/settings.jsonをコミットします。リポジトリをクローンしてそのディレクトリでClaude Codeを実行する開発者は、TrueFoundryゲートウェイURLやモデル設定を含むプロジェクト設定を自動的に使用します。‍

これは、標準化されたリポジトリ構造を持つチームにとって最も摩擦の少ないオプションです。新しい開発者は、クローンした瞬間にプロキシ設定を継承します。

ステップ5: VS Code拡張機能とClaude Agent SDK

VS Code拡張機能

Claude Code VS Code拡張機能は、CLIを設定すればTrueFoundryとシームレスに連携します。拡張機能は単体で動作するものではなく、事前にClaude Code CLIがインストールされ設定されている必要があります。‍

拡張機能は、CLI設定(ベースURL、APIキー、モデルエイリアス)を自動的に使用します。個別のセットアップは不要です。

macOS/Linuxに関する注意: GUIアプリケーションは、デフォルトではシェル環境変数を継承しません。拡張機能がANTHROPIC_BASE_URLを確実に取得できるように、常にClaude Codeが設定されているターミナルからVS Codeを起動してください。

Claude Agent SDK

Claude Agent SDK(Claude Code SDKの後継)は、TrueFoundry経由で既存の.claude/settings.jsonと連携します。プログラムでゲートウェイ設定を読み込むには、setting_sources=["project"]を指定します:

Anthropic Direct、AWS Bedrock、Google Vertex AIを含むすべてのTrueFoundry設定は、Agent SDKでまったく同様に動作します。

自作Claude Codeプロキシ vs. TrueFoundry AI Gateway

機能自作リバースプロキシTrueFoundry AI Gateway
セットアップ時間数日から数週間数分 — 1つの環境変数を変更するだけ
マルチプロバイダールーティングカスタム構築が必要標準搭載:Anthropic、OpenAI、Gemini、Bedrock、Azure、オンプレミス
開発者ごとの予算制限含まれない階層型で設定可能
コスト属性ダッシュボードカスタム構築が必要OTELエクスポート付きで標準搭載
自動フェイルオーバーリクエストごとのカスタム再試行ロジックゲートウェイレベルでプロバイダーごとに設定可能
ガードレール(PII、インジェクション)含まれない標準搭載
RBAC / バーチャルアカウントカスタム構築が必要SSO/SCIM付きで標準搭載
セマンティックキャッシュ含まれない標準搭載
継続的なメンテナンス自社チームが所有TrueFoundry管理(SaaS)またはセルフホスト
デプロイモードセルフホストのみSaaS、ハイブリッド、または完全セルフホストVPC

Try now.

One gateway for all your models, MCP servers, and agents. No credit card needed.

Start free
Table of Contents

One Gateway for Every LLM, Agent and MCP Server

Book a 30-min with our AI expert

Book a Demo

The fastest way to build, govern and scale your AI

Book Demo
Summarize with
ChatGPT logo by OpenAI
Perplexity AI logo
Blurry red snowflake on white background, symmetrical frosty design with soft edges and abstract shape.

Discover More

No items found.
Guide to Langgraph vs Langchain
November 16, 2026
|
5 min read

LangChain vs LangGraph:どちらが最適か?

比較
A detailed guide on Claude Fable 5
November 16, 2026
|
5 min read

Claude Fable 5: API、ベンチマーク、料金、使い方

エンジニアリングとプロダクト
openrouter vs litellm
November 16, 2026
|
5 min read

LiteLLMとOpenRouter:あなたに最適なのはどちらか?

比較
November 16, 2026
|
5 min read

大規模言語モデルにおけるトランスフォーマーアーキテクチャ

LLM用語
No items found.

Recent Blogs

Black left pointing arrow symbol on white background, directional indicator.
Black left pointing arrow symbol on white background, directional indicator.
Take a quick product tour
Start Product Tour
Product Tour