Command reference ยท Claude Code
/setup-vertex
Configures authentication, project, region, and model pins for Google Cloud's Agent Platform.
/setup-vertex configures authentication, project, region, and model pins for Google Cloud's Agent Platform (the docs now call the former "Vertex AI" this way, though the login screen still shows "Google Vertex AI") via an interactive wizard.
/setup-vertex is only visible as a standalone slash command when CLAUDE_CODE_USE_VERTEX=1 is set. Without this variable, you can still reach the same wizard: on the first start of claude, choose "3rd-party platform" and then "Google Vertex AI" at the login prompt โ if you're already logged in, /login opens the same menu.
Once you've gone through the wizard, you can call /setup-vertex again at any time afterward to change credentials, project, region, or model pins; the model pin step then starts from your currently pinned models. The result is saved in ~/.claude/settings.json, or in $CLAUDE_CONFIG_DIR/settings.json if that variable is set.
โ WHEN TO USE IT?
Team uses Google Cloud's Agent Platform
With CLAUDE_CODE_USE_VERTEX=1 set, run /setup-vertex to set up authentication, project, region, and model pins via the wizard.
Adjust model pins later
After switching Google Cloud projects, call /setup-vertex again; the model pin step then starts from the currently pinned models.
โ WHEN NOT TO?
As a slash command without the env var set
According to the docs, /setup-vertex only appears in the slash menu when CLAUDE_CODE_USE_VERTEX=1 is set.
Better: start claude and choose "3rd-party platform" โ "Google Vertex AI" at the login prompt, or /login if already logged in โ this opens the same wizard even without the env var.
SOURCES
- Claude Code docs (official) โ code.claude.com
MORE COMMANDS ยท Claude Code