[DOCS] Google Vertex AI docs missing interactive setup wizard and login-screen flow

Resolved 💬 2 comments Opened Apr 9, 2026 by coygeek Closed Apr 11, 2026

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/google-vertex-ai

Section/Topic

The Google Vertex AI setup flow for first-time users, especially the interactive login-screen wizard that configures authentication, project, region, credential verification, and model pinning.

Current Documentation

The Vertex page currently jumps straight into manual setup steps:

## Setup ### 1. Enable Vertex AI API Enable the Vertex AI API in your GCP project:

The same page later says:

When using Vertex AI, the /login and /logout commands are disabled since authentication is handled through Google Cloud credentials.

By contrast, Bedrock has a dedicated section documenting an interactive setup wizard, but the Vertex page does not mention an equivalent flow.

What's Wrong or Missing?

Claude Code v2.1.98 added an interactive Google Vertex AI setup wizard accessible from the login screen when the user selects 3rd-party platform. The current Vertex docs do not mention that this wizard exists, where to find it, or what configuration it performs.

That leaves the page incomplete in two ways:

A. Missing first-run discovery path

Users are not told they can start Vertex setup from the claude login screen instead of manually assembling environment variables first.

B. Missing explanation of wizard outputs

The docs do not explain that the wizard walks through GCP authentication, project and region selection, credential verification, and model pinning.

Suggested Improvement

Add a new section near the top of google-vertex-ai similar to the Bedrock page, for example:

## Set up with the interactive wizard The login screen includes an interactive Vertex AI setup wizard for first-time configuration. Select 3rd-party platform at the claude login prompt, then choose Google Vertex AI. The wizard guides you through: - GCP authentication - Project selection - Region configuration - Credential verification - Model pinning Claude Code writes the resulting configuration to your settings so you can start using Vertex without manually assembling the initial setup.

Also add a short cross-reference from the existing manual setup section explaining when users should prefer the wizard versus manual env-var configuration.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/google-vertex-ai | 20-102 | Vertex page documents only manual setup and does not mention the new interactive wizard |
| https://code.claude.com/docs/en/setup | 158-160 | Setup page routes users to Vertex docs but does not point them to the login-screen setup flow |
| https://code.claude.com/docs/en/commands | 79 | Bedrock wizard is documented here, which highlights the missing Vertex setup coverage |

Total scope: 3 pages affected

View original on GitHub ↗

This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗