Skip to content
← リリースに戻る · 2.1.321
改善 / v2.1.321

Gateway: upstream側でのANTHROPIC_*_BASE_URL無視

CHANGELOG 原文(英語)

Gateway: Changed Bedrock, Vertex and Foundry upstreams to ignore the ANTHROPIC_*_BASE_URL variables in the gateway's environment. Set base_url on the upstream to use another endpoint
公式の変更履歴を開く ↗

日本語での補足

Gateway: Bedrock、Vertex、Foundryのupstreamを変更し、gatewayの環境変数にあるANTHROPIC_*_BASE_URLを無視するように変更。別のエンドポイントを使うにはupstream側でbase_urlを設定する。

ドキュメント

ドキュメントの抜粋(参考訳)

Google Cloud Agent Platform

クライアント側の同等の設定については、Google CloudでClaude Codeを使うを参照してください。ゲートウェイ側のアップストリームは次のとおりです。

upstreams:
  - provider: vertex
    region: us-east5
    project_id: example-prod
    auth: {}                           # preferred: Application Default Credentials
    # OR a service account key file:
    # auth: { service_account_json: /secrets/sa.json }
    # Override the aiplatform endpoint for Private Service Connect:
    # base_url: https://us-east5-aiplatform.p.googleapis.com

空の auth ブロックは、Application Default Credentials(GOOGLE_APPLICATION_CREDENTIALS、GCEのメタデータ、またはGKEのWorkload Identity)を使います。サービスアカウントのJSONキーファイルもサポートされていますが、推奨されません。Workload Identityを使うか、GCEまたはCloud Runのインスタンスにサービスアカウントを紐付けてください。

リージョンごとのエンドポイントの代わりに、Google CloudのAgent Platformのグローバルエンドポイントを使うには、region: global を設定します。この場合、Googleが各リクエストを利用可能なリージョンへ振り分けるため、リージョンごとのモデルの提供状況を追跡する必要はありません。特定のリージョンを設定すると、すべてのリクエストがそのリージョンに固定されます。

Setup How
IAM permissions ゲートウェイのサービスアカウントに、プロジェクトへの roles/aiplatform.user、または aiplatform.endpoints.predict を含むカスタムロールを付与します。Google CloudのAgent Platform API(aiplatform.googleapis.com)を有効にします。
Model access Model Gardenで、プロジェクト向けにClaudeモデルを有効にします。モデルは特定のリージョンに公開されるため、対応リージョンはモデルカードで確認してください。
GKE (Workload Identity) GCPのサービスアカウントをゲートウェイのKubernetesサービスアカウントに紐付け、KSAに iam.gke.io/gcp-service-account: claude-gateway@<proj>.iam.gserviceaccount.com の注釈を付けます。auth: {} がこれを読み取ります。
Cloud Run / GCE サービスのサービスアカウントに roles/aiplatform.user を持つものを設定します。auth: {} がこれを読み取ります。
Anywhere else シークレットとしてマウントしたJSONキーファイルのパスを、auth: { service_account_json: /secrets/sa.json } に指定します。このフィールドにはファイルパスを指定し、キーの内容そのものは指定しないため、${file:…} 展開は関係しません。

取得日 · 2026-11-20

変更の詳細