Claude CodeをLLM Gateway経由で接続する

LLM Gatewayは、複数のモデル提供先を一つの社内エンドポイントへ集約し、認証、監査、レート制限、請求を管理する中継です。Claude Codeから見た接続先と、背後のBedrock・Vertex・Foundryなどを混同しないよう、GatewayがどのAPI形式とモデル名を受けるかを先に確定します。

設定の考え方

Claude Codeが見ているURLと、背後の提供先を分けて記録します。

1. 1Claude CodeGatewayが受けるAPI形式とモデル名で依頼する。
2. 2社内Gateway認証、モデル名の対応、ログや制限を管理する。
3. 3モデル提供先Bedrockなど、実際の推論と契約の条件を確認する。

一つのリクエストを各段階のログで照合します。Gateway側の保存方針も、提供先の保持条件とは別に確認します。

GatewayのURL、認証方式、Claude Messages API互換性、ストリーミング、tool use、長いコンテキスト、エラーの透過性を確認します。公式の第三者プロバイダー設定にあるANTHROPIC_*_BASE_URLへGatewayを指定し、Gatewayが認証を処理する場合は対応するCLAUDE_CODE_SKIP_*_AUTH=1を使います。プロバイダーごとの変数名を取り違えないでください。

LiteLLMなどを使う場合も、Claude CodeのモデルaliasとGateway側のmodel名をマッピングし、失敗時のフォールバックを明記します。キーは環境変数や秘密管理サービスへ置き、リクエスト本文・tool引数・ログの保存範囲を管理します。/status、Gatewayログ、provider側のログを同じリクエストで突き合わせると切り分けやすくなります。

接続できない時は、DNS/TLS、URLのパス、認証ヘッダー、モデル名、ストリーミングとtool schema、タイムアウトを順に確認します。Gatewayが書き換えたデータとAnthropicの利用条件も契約で確認します。公式LLM Gateway、第三者連携、Enterprise setupを照合しました。実機検証はしていません。

Gatewayの試験では、単純なテキスト、tool use、ストリーミング、長い入力、エラー応答を別々に送り、直接プロバイダーとの差を記録します。ログの本文を保存する場合はマスキングと保持期限を設定し、Gateway障害時の停止または切り替え手順を決めます。

Gatewayの前段で接続が失敗する場合は企業ネットワークのProxy・CA確認、プロバイダー固有の設定はBedrockやVertexを参照します。