Vertex AI Provider Settings

Provider Configuration

Set these environment variables before launching Claude Code:

Copy
# Required: Vertex AI provider settings
export CLAUDE_CODE_USE_VERTEX=1
export CLOUD_ML_REGION=us-east5
export ANTHROPIC_VERTEX_PROJECT_ID=your-gcp-project-id

Settings File

Optionally configure model preferences in .claude/settings.json:

Copy
{
  "env": {
    "CLAUDE_CODE_USE_VERTEX": "1",
    "CLOUD_ML_REGION": "us-east5",
    "ANTHROPIC_VERTEX_PROJECT_ID": "your-gcp-project-id"
  },
  "preferences": {
    "model": "claude-sonnet-4-20250514"
  }
}

Available Regions

Region	Location
us-east5	Columbus, Ohio
us-central1	Iowa
europe-west1	Belgium
europe-west4	Netherlands
asia-southeast1	Singapore

Prerequisites

1. GCP Project with Vertex AI API enabled
2. Authentication: Run gcloud auth application-default login
3. IAM Role: Vertex AI User role on the project
4. Model Access: Request access to Claude models in Vertex AI Model Garden

Troubleshooting

Issue	Solution
Permission denied	Check IAM role: gcloud projects get-iam-policy $PROJECT_ID
Model not found	Verify model access in Vertex AI Model Garden
Region not available	Try us-east5 (primary region for Claude)
Auth failed	Re-run gcloud auth application-default login

Cost Management

• Vertex AI pricing is per-token, billed to your GCP project
• Set budget alerts in GCP Console > Billing > Budgets
• Use claude-haiku-4-20250514 for cost-sensitive tasks
• Monitor usage in Vertex AI > Model Monitoring