{"version":"2.1.98","anchor":"vertex-ai-setup-wizard","canonical_anchor":"vertex-ai-setup-wizard","heading":"Vertex AI Setup Wizard","tier":null,"area":null,"scope":null,"heads_up":null,"url":"https:\/\/changelogs.core-directive.com\/v\/2.1.98\/e\/vertex-ai-setup-wizard","release_url":"https:\/\/changelogs.core-directive.com\/v\/2.1.98","markdown":"### Vertex AI Setup Wizard\n\n**What**\n\nAn interactive, multi-step wizard for configuring Google Vertex AI as your model backend, with credential validation and model pinning.\n\n**Details**\n\n- Step-by-step flow: authentication method \u2192 service account key (if applicable) \u2192 GCP project \u2192 region \u2192 credential verification \u2192 model pinning \u2192 confirmation\n- Three authentication methods: Application Default Credentials (gcloud auth), service account key file, or existing environment credentials\n- Reads existing gcloud configurations to auto-discover project IDs\n- Validates credentials by making a test API call to Vertex AI\n- Probes each model tier (Sonnet, Opus, Haiku) with a one-token request to check availability\n- Provides specific error messages for common issues: expired credentials, missing permissions, wrong region, missing API enablement\n- Model pinning option: pin specific model versions that are confirmed working, or use Claude Code defaults (auto-updates)\n- Saves configuration to `~\/.claude\/settings.json` under the `env` key\n- For ADC users, reminds that `gcloud auth application-default login` refreshes credentials automatically\n\n**Evidence**\n\nVertex setup wizard (search for `\"How do you authenticate to Google Cloud?\"` and `\"Pin model versions\"`)"}