改善 / 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