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

Built for Speed: ~10ms Latency, Even Under Load
Blazingly fast way to build, track and deploy your models!
- Handles 350+ RPS on just 1 vCPU — no tuning needed
- Production-ready with full enterprise support
はじめに
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プロキシの基礎となります。 プロキシとは、以下の処理を行うサーバーを指します。
- Claude CodeからAnthropic形式のAPIリクエストを受け取る
- プロキシ層で制御、ルーティング、またはオブザーバビリティを追加する
- リクエストを実際のモデルプロバイダー(Anthropic、OpenAI、Google、Bedrock、オンプレミスなど)に転送する
- Claude Codeが期待するフォーマットでレスポンスを返す
最もシンプルなプロキシは、ログ機能を備えたリバースプロキシです。最も洗練されたプロキシは、認証、予算設定の強制、複数プロバイダーにわたるモデルルーティング、セマンティックキャッシュ、ガードレール、完全な監査ログを処理するエンタープライズAIゲートウェイであり、これらすべてを透明性の高い方法で実行し、開発者側でのClaude Codeの動作を変更することはありません。
なぜチームは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リクエストは、自動的に以下のメリットを獲得します:
ゲートウェイのオーバーヘッドは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の階層型予算制限は、毎月の請求書が届いた後ではなく、トークンが消費される前にトリガーされます。ルールはスタックされ、組み合わされます:
シニアエンジニアには1日あたり50ドルが割り当てられます。その他のすべてのユーザーはデフォルトで1日あたり10ドルです。そして組織全体でのOpusの総支出は月額1000ドルに制限されるため、すべての開発者が個人の上限内に収まっていたとしても、組織レベルのモデル予算を超過することはありません。
レート制限:オンプレミスおよび制御環境の保護

ゲートウェイでのレート制限は、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 delivers ~3–4 ms latency, handles 350+ RPS on 1 vCPU, scales horizontally with ease, and is production-ready, while LiteLLM suffers from high latency, struggles beyond moderate RPS, lacks built-in scaling, and is best for light or prototype workloads.














.webp)





.webp)
.webp)
.png)

.png)
.png)
.png)
.png)
.png)
.webp)
.webp)






