Google Cloud の Agent Platform 上の Claude Code

前提条件

• 請求が有効になっている Google Cloud Platform（GCP）アカウント
• Google Cloud の Agent Platform API が有効になっている GCP プロジェクト
• 目的の Claude モデルへのアクセス（例：Claude Sonnet 4.6）
• Google Cloud SDK（gcloud）がインストールされ、設定されていること
• 目的の GCP リージョンに割り当てられたクォータ

Agent Platform でサインイン

リージョン設定

手動でセットアップする

1. Agent Platform API を有効にする

# プロジェクト ID を設定
gcloud config set project YOUR-PROJECT-ID

# Agent Platform API を有効にする
gcloud services enable aiplatform.googleapis.com

2. モデルアクセスをリクエストする

1. Google Cloud の Agent Platform Model Gardenに移動します
2. 「Claude」モデルを検索します
3. 目的の Claude モデルへのアクセスをリクエストします（例：Claude Sonnet 4.6）
4. 承認を待ちます（24 ～ 48 時間かかる場合があります）

3. GCP 認証情報を設定する

高度な認証情報設定

{
  "gcpAuthRefresh": "gcloud auth application-default login",
  "env": {
    "ANTHROPIC_VERTEX_PROJECT_ID": "your-project-id"
  }
}

4. Claude Code を設定する

# Agent Platform 統合を有効にする
export CLAUDE_CODE_USE_VERTEX=1
export CLOUD_ML_REGION=global
export ANTHROPIC_VERTEX_PROJECT_ID=YOUR-PROJECT-ID

# オプション：カスタムエンドポイントまたはゲートウェイ用に Agent Platform エンドポイント URL をオーバーライドする
# export ANTHROPIC_VERTEX_BASE_URL=https://aiplatform.googleapis.com

# CLOUD_ML_REGION=global の場合、グローバルエンドポイントをサポートしていないモデルのリージョンをオーバーライドする
export VERTEX_REGION_CLAUDE_HAIKU_4_5=us-east5
export VERTEX_REGION_CLAUDE_4_6_SONNET=europe-west1

• VERTEX_REGION_CLAUDE_*：Claude Code は CLOUD_ML_REGION にフォールバックします。
• CLOUD_ML_REGION：Claude Code は us-east5 にフォールバックします。

• Claude Opus 4.5、Sonnet 4.5、Haiku 4.5、およびそれ以降：Claude Code はデフォルトでツール検索を有効にします。
• 以前のモデル：Claude Code は MCP ツール定義を事前にロードします。これは、これらのモデルの Agent Platform サービングスタックが必要なベータヘッダーを拒否するためです。ENABLE_TOOL_SEARCH=true を設定してもこれを上書きしません。

5. モデルバージョンをピン留めする

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'

• --model、ANTHROPIC_MODEL、または model 設定でプライマリモデルを選択すると、バックグラウンドタスクはそのモデルを使用します。ANTHROPIC_DEFAULT_MODELで設定したモデルで Claude Code がセッションを開始する場合、バックグラウンドタスクもそのモデルを使用します。ANTHROPIC_DEFAULT_SONNET_MODEL なしで ANTHROPIC_DEFAULT_OPUS_MODEL を設定することも、組み込み Sonnet モデルがプロジェクトで有効になっていない可能性があるため、選択としてカウントされます。
• バックグラウンドタスクに Haiku を使用するには、ANTHROPIC_DEFAULT_HAIKU_MODEL をプロジェクトで利用可能なモデル ID に設定します。

export ANTHROPIC_MODEL='claude-opus-4-8'
export ANTHROPIC_DEFAULT_HAIKU_MODEL='claude-haiku-4-5@20251001'

6. 設定を確認する

起動時のモデルチェック

• 受け入れた場合: Claude Code は新しいモデル ID をユーザー設定ファイルに書き込み、再起動します
• 拒否した場合: Claude Code は次のデフォルトバージョン変更までその選択を記憶します

特定のモデルでセッションを開始する

記憶されたモデルの拒否

組織がモデル許可リストを強制している場合

{
  "availableModels": ["claude-opus-4-8", "claude-sonnet-4-5@20250929"],
  "enforceAvailableModels": true
}

セッション中にモデルが無効化された場合

• セッションがピン留めされたモデル、または選択した特定のバージョンを使用している
• Claude Code が試すモデルのいずれも利用できない。auto モードでは、Claude Code は Agent Platform で auto モードがサポートするモデルにのみ切り替えます。

IAM 設定

• aiplatform.endpoints.predict - モデル呼び出しとトークンカウントに必要

100 万トークンコンテキストウィンドウ

トラブルシューティング

• gcloud auth application-default login を実行して Application Default Credentials をセットアップしてください
• GOOGLE_APPLICATION_CREDENTIALS をサービスアカウントキーファイルパスに設定してください
• すべてのオプションについては、GCP 認証情報の設定を参照してください

• Cloud Consoleを通じて現在のクォータを確認するか、クォータ増加をリクエストしてください

• Model Gardenでモデルが有効になっていることを確認してください
• 指定したロケーションでモデルが利用可能であることを確認してください。一部のモデルは global またはマルチリージョンロケーション（eu および us など）でのみ提供され、特定のリージョンでは提供されていません
• CLOUD_ML_REGION=global を使用している場合、Model Gardenの「サポートされている機能」でモデルがグローバルエンドポイントをサポートしていることを確認してください。グローバルエンドポイントをサポートしていないモデルの場合は、以下のいずれかを実行してください：
  • ANTHROPIC_MODEL または ANTHROPIC_DEFAULT_HAIKU_MODEL を通じてサポートされているモデルを指定するか、
  • 環境変数リファレンスに記載されているモデルの VERTEX_REGION_CLAUDE_* 変数を使用して、リージョンまたはマルチリージョンロケーションを設定してください

• 地域別エンドポイントの場合、プライマリモデルと小型/高速モデルが選択したリージョンでサポートされていることを確認してください
• より良い可用性のために CLOUD_ML_REGION=global に切り替えることを検討してください

追加リソース

• Google Cloud の Agent Platform ドキュメント
• Google Cloud の Agent Platform 価格
• Google Cloud の Agent Platform クォータと制限