/setup-vertex
为 Google Cloud 的 Agent Platform 配置身份验证、项目、区域和模型固定版本。
/setup-vertex 通过一个交互式向导，为 Google Cloud 的 Agent Platform（文档如今这样称呼此前的「Vertex AI」，但登录界面仍然显示「Google Vertex AI」）配置身份验证、项目、区域和模型锁定。
作为独立的斜杠命令，/setup-vertex 只有在设置了 CLAUDE_CODE_USE_VERTEX=1 时才可见。即使没有设置这个变量，你依然可以进入同一个向导：首次启动 claude 时，在登录提示界面选择 "3rd-party platform"，再选择 "Google Vertex AI"；如果已经登录，则用 /login 打开同一个菜单。
向导第一次跑完之后，你可以随时再次调用 /setup-vertex，用来修改凭据、项目、区域或模型锁定；此时模型锁定这一步会以你当前已锁定的模型作为起点。结果会保存在 ~/.claude/settings.json，如果设置了 CLAUDE_CONFIG_DIR 变量，则保存在 $CLAUDE_CONFIG_DIR/settings.json。
✅ 什么时候用？
团队使用 Google Cloud 的 Agent Platform
在设置了 CLAUDE_CODE_USE_VERTEX=1 的情况下执行 /setup-vertex，通过向导配置身份验证、项目、区域和模型锁定。
之后再调整模型锁定
在更换了 Google Cloud 项目之后再次调用 /setup-vertex；模型锁定这一步会以当前已锁定的模型作为起点。
⛔ 什么时候不该用？
没有设置环境变量时，作为斜杠命令使用
/setup-vertex 只有在设置了 CLAUDE_CODE_USE_VERTEX=1 时才会出现在斜杠命令菜单中。
更好的选择: 启动 claude，在登录提示界面选择 "3rd-party platform" → "Google Vertex AI"；如果已登录，则使用 /login——这两种方式即使不设置该环境变量，也能打开同一个向导。
来源
- Claude Code 文档（官方） ↗ code.claude.com
更多命令 · Claude Code