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

# オプション：必要に応じてプロンプトキャッシングを無効にする
export DISABLE_PROMPT_CACHING=1

# オプション：デフォルトの 5 分ではなく 1 時間のプロンプトキャッシュ TTL をリクエストする
export ENABLE_PROMPT_CACHING_1H=1

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

​

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_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'

​

起動時のモデルチェック

​

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_<MODEL_NAME> 環境変数を使用してリージョンまたはマルチリージョンロケーションを設定してください

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

​

追加リソース

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