Ce face /setup-vertex
/setup-vertex pornește un asistent care configurează Claude Code pentru Google Cloud’s Agent Platform. Alegi metoda de autentificare: Application Default Credentials din gcloud, un fișier cu cheia unui service account sau credențialele deja prezente în mediu. Apoi alegi proiectul și regiunea, asistentul verifică ce modele Claude poate invoca proiectul și te lasă să le fixezi.
Rezultatul se salvează în blocul env al setărilor de utilizator (~/.claude/settings.json sau $CLAUDE_CONFIG_DIR/settings.json). Rulezi comanda oricând vrei să schimbi credențialele, proiectul, regiunea sau modelele fixate.
Comanda este ascunsă din meniul de comenzi până setezi CLAUDE_CODE_USE_VERTEX=1, așa că o tastezi complet. La prima folosire alegi din ecranul de login 3rd-party platform, apoi Google Vertex AI, eticheta pe care promptul de login o folosește încă. Înainte activezi API-ul Agent Platform în proiectul GCP și ceri acces la modelele Claude din Model Garden.
Sintaxă și opțiuni
| Opțiune / Parametru | Descriere |
|---|---|
(fără argumente) |
Deschide asistentul de configurare Google Cloud’s Agent Platform. |
Exemple practice de terminal
Exemplul 1: Schimbarea proiectului sau a regiunii
> /setup-vertexExemplul 2: Activarea API-ului în proiectul GCP
Pas din configurarea manuală; înlocuiește YOUR-PROJECT-ID cu ID-ul proiectului.
gcloud config set project YOUR-PROJECT-ID
gcloud services enable aiplatform.googleapis.comGreșeli frecvente și bune practici
- Cauți comanda în meniul
/fărăCLAUDE_CODE_USE_VERTEX=1. Este ascunsă, dar funcționează dacă o tastezi complet. - Alegi o regiune în care modelele implicite ale Claude Code nu sunt disponibile. Disponibilitatea diferă între regiuni, locații multi-regiune și endpoint-ul global; schimbă locația sau alege un model suportat.