Google Vertex AI 上の Claude Code

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

​

前提条件

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

​

Vertex AI でサインイン

​

リージョン設定

​

手動でセットアップする

​

1. Vertex AI API を有効にする

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

# Vertex AI API を有効にする
gcloud services enable aiplatform.googleapis.com

​

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

1. Vertex AI 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 を設定する

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

# オプション：カスタムエンドポイントまたはゲートウェイ用に Vertex エンドポイント 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-7'
export ANTHROPIC_DEFAULT_SONNET_MODEL='claude-sonnet-4-6'
export ANTHROPIC_DEFAULT_HAIKU_MODEL='claude-haiku-4-5@20251001'

export ANTHROPIC_MODEL='claude-opus-4-7'
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 に切り替えることを検討してください

​

追加リソース

• Vertex AI ドキュメント
• Vertex AI 価格
• Vertex AI クォータと制限