Anthropic
OpenAI
xAI
Gemini
G
google-vertex-ai.md
2026-06-29 23:02 UTC to 2026-06-30 23:02 UTC
2 added, 2 removed.
Page
Diff
2026
2026
2025
Jan
Feb
Mar
Apr
May
Jun
Jul
Aug
Sep
Oct
Nov
Dec
Google Vertex AI 上の Claude Code
Google Vertex AI を通じた Claude Code の設定方法について学びます。セットアップ、IAM 設定、トラブルシューティングを含みます。
export const ContactSalesCard = ({surface}) => {
const utm = content => utm_source=claude_code&utm_medium=docs&utm_content=${surface}_${content};
const iconArrowRight = (size = 13) => <svg width={size} height={size} viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2.5" strokeLinecap="round" strokeLinejoin="round" aria-hidden="true">
.cc-cs { --cs-slate: #141413; --cs-clay: #d97757; --cs-clay-deep: #c6613f; --cs-gray-000: #ffffff; --cs-gray-700: #3d3d3a; --cs-border-default: rgba(31, 30, 29, 0.15); font-family: inherit; } .dark .cc-cs { --cs-slate: #f0eee6; --cs-gray-000: #262624; --cs-gray-700: #bfbdb4; --cs-border-default: rgba(240, 238, 230, 0.14); } .cc-cs-card { display: flex; align-items: center; justify-content: space-between; gap: 16px; padding: 14px 16px; margin: 0; background: var(--cs-gray-000); border: 0.5px solid var(--cs-border-default); border-radius: 8px; flex-wrap: wrap; } .cc-cs-text { font-size: 13px; color: var(--cs-gray-700); line-height: 1.5; flex: 1; min-width: 240px; } .cc-cs-text strong { font-weight: 550; color: var(--cs-slate); } .cc-cs-actions { display: flex; align-items: center; gap: 8px; flex-shrink: 0; } .cc-cs-btn-clay { display: inline-flex; align-items: center; gap: 8px; background: var(--cs-clay-deep); color: #fff; border: none; border-radius: 8px; padding: 8px 14px; font-size: 13px; font-weight: 500; transition: background-color 0.15s; white-space: nowrap; } .cc-cs-btn-clay:hover { background: var(--cs-clay); } .cc-cs-btn-ghost { display: inline-flex; align-items: center; gap: 8px; background: transparent; color: var(--cs-gray-700); border: 0.5px solid var(--cs-border-default); border-radius: 8px; padding: 8px 14px; font-size: 13px; font-weight: 500; } .cc-cs-btn-ghost:hover { background: rgba(0, 0, 0, 0.04); } .dark .cc-cs-btn-ghost:hover { background: rgba(255, 255, 255, 0.04); } @media (max-width: 720px) { .cc-cs-actions { width: 100%; } };
return <div className="cc-cs not-prose">
<div className="cc-cs-card">
<div className="cc-cs-text">
Deploying Claude Code across your organization? Talk to sales about enterprise plans, SSO, and centralized billing.
<div className="cc-cs-actions">
<a href={https://claude.com/pricing?${utm('view_plans')}#plans-business} className="cc-cs-btn-ghost">
View plans
<a href={https://claude.com/contact-sales?${utm('contact_sales')}} className="cc-cs-btn-clay">
Contact sales {iconArrowRight()}
;
};
前提条件
Claude Code を Vertex AI で設定する前に、以下を確認してください。
請求が有効になっている Google Cloud Platform（GCP）アカウント
Vertex AI API が有効になっている GCP プロジェクト
目的の Claude モデルへのアクセス（例：Claude Sonnet 4.6）
Google Cloud SDK（gcloud）がインストールされ、設定されていること
目的の GCP リージョンに割り当てられたクォータ
Vertex AI 認証情報でサインインするには、以下のVertex AI でサインイン に従ってください。チーム全体に Claude Code をデプロイするには、手動セットアップ の手順を使用し、ロールアウト前にモデルバージョンをピン留めして ください。
Vertex AI でサインイン
Google Cloud 認証情報を持っていて、Vertex AI を通じて Claude Code の使用を開始したい場合、ログインウィザードがそれをガイドします。GCP 側の前提条件はプロジェクトごとに 1 回完了します。ウィザードが Claude Code 側を処理します。
2
Claude Code を起動して Vertex AI を選択する
claude を実行します。ログインプロンプトで、3rd-party platform 、次に Google Vertex AI を選択します。
3
ウィザードプロンプトに従う
Google Cloud への認証方法を選択します。gcloud からの Application Default Credentials、サービスアカウントキーファイル、または環境内に既にある認証情報です。ウィザードはプロジェクトとリージョンを検出し、プロジェクトが呼び出せる Claude モデルを確認し、それらをピン留めできます。結果はユーザー設定ファイル の env ブロックに保存されるため、環境変数を自分でエクスポートする必要はありません。
サインイン後、いつでも /setup-vertex を実行してウィザードを再度開き、認証情報、プロジェクト、リージョン、またはモデルピンを変更できます。
リージョン設定
Claude Code は Vertex AI のグローバル 、マルチリージョン、および地域別エンドポイントをサポートしています。CLOUD_ML_REGION を global、eu または us などのマルチリージョンロケーション、または us-east5 などの特定のリージョンに設定します。Claude Code は各フォームの正しい Vertex AI ホスト名を選択します。これには、マルチリージョンロケーション用の aiplatform.eu.rep.googleapis.com および aiplatform.us.rep.googleapis.com ホストが含まれます。
手動でセットアップする
ウィザードの代わりに環境変数を通じて Vertex AI を設定するには、例えば CI またはスクリプト化されたエンタープライズロールアウトで、以下の手順に従ってください。
1. Vertex AI API を有効にする
GCP プロジェクトで Vertex AI API を有効にします。
gcloud config set project YOUR-PROJECT-ID
gcloud services enable aiplatform.googleapis.com
2. モデルアクセスをリクエストする
Vertex AI で Claude モデルへのアクセスをリクエストします。
Vertex AI Model Garden に移動します'Claude'モデルを検索します
目的の Claude モデルへのアクセスをリクエストします（例：Claude Sonnet 4.6）
承認を待ちます（24 ～ 48 時間かかる場合があります）
Claude Code は標準的な Google Cloud 認証を使用します。
詳細については、Google Cloud 認証ドキュメント を参照してください。
Claude Code v2.1.121 以降は、同じ Application Default Credentials チェーンを通じて X.509 証明書ベースのワークロード ID フェデレーション をサポートしています。GOOGLE_APPLICATION_CREDENTIALS を認証情報設定ファイルのパスに設定します。
高度な認証情報設定
Claude Code は gcpAuthRefresh 設定を通じて GCP の自動認証情報更新をサポートしています。Claude Code が GCP 認証情報の有効期限が切れているか読み込めないことを検出すると、リクエストを再試行する前に新しい認証情報を取得するために設定されたコマンドを実行します。
{
"gcpAuthRefresh" : "gcloud auth application-default login" ,
"env" : {
"ANTHROPIC_VERTEX_PROJECT_ID" : "your-project-id"
}
}
コマンドの出力はユーザーに表示されますが、対話的な入力はサポートされていません。これは、CLI が URL を表示し、ブラウザで認証を完了するブラウザベースの認証フローに適しています。認証が完了しない場合、更新コマンドは 3 分後にタイムアウトします。.claude/settings.json などのプロジェクト設定で gcpAuthRefresh を設定した場合、コマンドはワークスペース信頼プロンプトを受け入れた後にのみ実行されます。
次の環境変数を設定します。
export CLAUDE_CODE_USE_VERTEX=1
export CLOUD_ML_REGION=global
export ANTHROPIC_VERTEX_PROJECT_ID=YOUR-PROJECT-ID
export DISABLE_PROMPT_CACHING=1
export ENABLE_PROMPT_CACHING_1H=1
export VERTEX_REGION_CLAUDE_HAIKU_4_5=us-east5
export VERTEX_REGION_CLAUDE_4_6_SONNET=europe-west1
ほとんどのモデルバージョンには、対応する VERTEX_REGION_CLAUDE_* 変数があります。完全なリストについては、環境変数リファレンス を参照してください。どのモデルがグローバルエンドポイントをサポートしているか、または地域別のみをサポートしているかを確認するには、Vertex Model Garden を確認してください。
prompt caching は自動的に有効になります。これを無効にするには、DISABLE_PROMPT_CACHING=1 を設定します。デフォルトの 5 分ではなく 1 時間のキャッシュ TTL をリクエストするには、ENABLE_PROMPT_CACHING_1H=1 を設定します。1 時間の TTL でのキャッシュ書き込みはより高いレートで課金されます。レート制限を高くするには、Google Cloud サポートに連絡してください。Vertex AI を使用する場合、Google Cloud 認証情報を通じて認証が処理されるため、/logout コマンドは無効になります。
Claude Code は Vertex AI でデフォルトで MCP tool search を無効にしているため、MCP ツール定義は事前にロードされます。Vertex AI は Claude Sonnet 4.5 以降および Claude Opus 4.5 以降のツール検索をサポートしています。ENABLE_TOOL_SEARCH=true を設定して、これらのモデルで有効にします。Vertex AI の以前のモデルは必要なベータヘッダーを受け入れず、これらのモデルでツール検索を有効にするとリクエストが失敗します。
5. モデルバージョンをピン留めする
これらの環境変数を特定の Vertex AI モデル ID に設定します。
ANTHROPIC_DEFAULT_OPUS_MODEL がない場合、Vertex 上の opus エイリアスは Opus 4.6 に解決されます。最新モデルを使用するには、Opus 4.8 ID に設定します。
export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'
export ANTHROPIC_DEFAULT_SONNET_MODEL='claude-sonnet-5'
export ANTHROPIC_DEFAULT_HAIKU_MODEL='claude-haiku-4-5@20251001'
現在および従来のモデル ID については、モデル概要 を参照してください。環境変数の完全なリストについては、モデル設定 を参照してください。
Claude Code は、ピン留め変数が設定されていない場合、これらのデフォルトモデルを使用します。
モデルタイプ
デフォルト値
プライマリモデル
claude-sonnet-4-5@20250929
小型/高速モデル
プライマリモデルと同じ
セッションタイトル生成などのバックグラウンドタスクは、小型/高速モデル（通常は Haiku クラスモデル）を使用します。Vertex AI では、Haiku がすべてのプロジェクトまたはリージョンで有効になっていない可能性があるため、Claude Code はこれをプライマリモデルにデフォルト設定します。バックグラウンドタスクに Haiku を使用するには、ANTHROPIC_DEFAULT_HAIKU_MODEL をプロジェクトで利用可能なモデル ID に設定します。
モデルをさらにカスタマイズするには、以下を実行します。
export ANTHROPIC_MODEL='claude-opus-4-8'
export ANTHROPIC_DEFAULT_HAIKU_MODEL='claude-haiku-4-5@20251001'
起動時のモデルチェック
Claude Code が Vertex AI で設定されて起動すると、使用するモデルがプロジェクトでアクセス可能であることを確認します。このチェックには Claude Code v2.1.98 以降が必要です。
Claude Code デフォルトより古いモデルバージョンをピン留めしていて、プロジェクトが新しいバージョンを呼び出せる場合、Claude Code はピンを更新するよう促します。受け入れると、新しいモデル ID がユーザー設定ファイル に書き込まれ、Claude Code が再起動されます。拒否すると、次のデフォルトバージョン変更まで記憶されます。
モデルをピン留めしていなくて、現在のデフォルトがプロジェクトで利用できない場合、Claude Code は現在のセッション用に前のバージョンにフォールバックし、通知を表示します。フォールバックは永続化されません。Model Garden で新しいモデルを有効にするか、バージョンをピン留めして 選択を永続化してください。
IAM 設定
必要な IAM 権限を割り当てます。
roles/aiplatform.user ロールには、必要な権限が含まれています。
aiplatform.endpoints.predict - モデル呼び出しとトークンカウントに必要
より制限的な権限については、上記の権限のみを持つカスタムロールを作成してください。
詳細については、Vertex IAM ドキュメント を参照してください。
100 万トークンコンテキストウィンドウ
Claude Sonnet 5、Opus 4.6 以降、および Sonnet 4.6 は、Vertex AI で100 万トークンコンテキストウィンドウ をサポートしています。Sonnet 5 は常に 100 万ウィンドウで実行され、選択する [1m] バリアントはありません。その他のモデルについては、Claude Code は 100 万トークンモデルバリアントを選択すると、拡張コンテキストウィンドウを自動的に有効にします。
セットアップウィザード は、モデルをピン留めするときに 100 万トークンコンテキストオプションを提供します。手動でピン留めされたモデルの代わりに有効にするには、モデル ID に [1m] を追加します。詳細については、サードパーティデプロイメント用のモデルをピン留めする を参照してください。
トラブルシューティング
「デフォルト認証情報を読み込めません」エラーが発生した場合：
gcloud auth application-default login を実行して Application Default Credentials をセットアップしてくださいGOOGLE_APPLICATION_CREDENTIALS をサービスアカウントキーファイルパスに設定してくださいすべてのオプションについては、GCP 認証情報の設定 を参照してください
クォータの問題が発生した場合：
「モデルが見つかりません」404 エラーが発生した場合：
Model Garden でモデルが有効になっていることを確認してください指定したロケーションでモデルが利用可能であることを確認してください。一部のモデルは global またはマルチリージョンロケーション（eu および us など）でのみ提供され、特定のリージョンでは提供されていません
CLOUD_ML_REGION=global を使用している場合、Model Garden の「サポートされている機能」でモデルがグローバルエンドポイントをサポートしていることを確認してください。グローバルエンドポイントをサポートしていないモデルの場合は、以下のいずれかを実行してください：
ANTHROPIC_MODEL または ANTHROPIC_DEFAULT_HAIKU_MODEL を通じてサポートされているモデルを指定するか、VERTEX_REGION_<MODEL_NAME> 環境変数を使用してリージョンまたはマルチリージョンロケーションを設定してください
429 エラーが発生した場合：
地域別エンドポイントの場合、プライマリモデルと小型/高速モデルが選択したリージョンでサポートされていることを確認してください
より良い可用性のために CLOUD_ML_REGION=global に切り替えることを検討してください
追加リソース
236 236
237 ```bash theme={null}237 ```bash theme={null}
238 export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'238 export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'
239 export ANTHROPIC_DEFAULT_SONNET_MODEL='claude-sonnet-4-6 '239 export ANTHROPIC_DEFAULT_SONNET_MODEL='claude-sonnet-5 '
240 export ANTHROPIC_DEFAULT_HAIKU_MODEL='claude-haiku-4-5@20251001'240 export ANTHROPIC_DEFAULT_HAIKU_MODEL='claude-haiku-4-5@20251001'
241 ```241 ```
242 242
290 100 万トークンコンテキストウィンドウ290 100 万トークンコンテキストウィンドウ
291 </h2>291 </h2>
292 292
293 Claude Opus 4.6 以降および Sonnet 4.6 は、Vertex AI で[100 万トークンコンテキストウィンドウ](https://platform.claude.com/docs/ja/build-with-claude/context-windows#1m-token-context-window)をサポートしています。Claude Code は、 100 万トークンモデルバリアントを選択すると、拡張コンテキストウィンドウを自動的に有効にします。293 Claude Sonnet 5、 Opus 4.6 以降、および Sonnet 4.6 は、Vertex AI で[100 万トークンコンテキストウィンドウ](https://platform.claude.com/docs/ja/build-with-claude/context-windows#1m-token-context-window)をサポートしています。Sonnet 5 は常に 100 万ウィンドウで実行され、選択する `[1m]` バリアントはありません。その他のモデルについては、 Claude Code は 100 万トークンモデルバリアントを選択すると、拡張コンテキストウィンドウを自動的に有効にします。
294 294
295 [セットアップウィザード](#sign-in-with-vertex-ai)は、モデルをピン留めするときに 100 万トークンコンテキストオプションを提供します。手動でピン留めされたモデルの代わりに有効にするには、モデル ID に `[1m]` を追加します。詳細については、[サードパーティデプロイメント用のモデルをピン留めする](/ja/model-config#pin-models-for-third-party-deployments)を参照してください。295 [セットアップウィザード](#sign-in-with-vertex-ai)は、モデルをピン留めするときに 100 万トークンコンテキストオプションを提供します。手動でピン留めされたモデルの代わりに有効にするには、モデル ID に `[1m]` を追加します。詳細については、[サードパーティデプロイメント用のモデルをピン留めする](/ja/model-config#pin-models-for-third-party-deployments)を参照してください。
296 296
