Setup Claude Code com GCP Vertex AI
aberoham/claude-code-gcp-setup
Configure Claude Code no Vertex AI com um comando
Ver no GitHubScript de configuração automatizado para macOS que integra Claude Code com Google Cloud Vertex AI. Configura isoladamente gcloud, habilita Vertex AI API e gerencia variáveis de ambiente sem interferir no seu perfil padrão.
Instalação
npx convez-ai aberoham/claude-code-gcp-setup1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Integrar Claude Code com infraestrutura GCP existente
- Configurar ambiente de desenvolvimento com Vertex AI
- Gerenciar múltiplas configurações gcloud isoladamente
Veredito

Ferramenta prática e bem documentada para quem quer usar Claude Code via Vertex AI em ambiente GCP. Automatiza passos repetitivos e reduz fricção na configuração inicial, embora seja específica para macOS e requeira GCP setup prévio.
README
A tradução para o português deste README ainda está na fila.
Claude Code on GCP Vertex AI Setup
A setup script for macOS users who want to use Claude Code via Google Cloud Vertex AI.
See the official Vertex AI documentation for full details.
What it does
- Creates an isolated gcloud configuration (
claude-code) so it doesn't interfere with your default profile - Helps you select a GCP project (prioritizes projects with "vertexai" in the name)
- Checks if Vertex AI API is enabled
- Configures application-default credentials
- Adds required environment variables to
~/.zshrc
Prerequisites
- macOS with Python 3 (system default)
- Google Cloud SDK (
gcloudCLI) - A GCP project with Vertex AI API enabled and Claude model access
Usage
curl -O https://raw.githubusercontent.com/aberoham/claude-code-gcp-setup/main/setup-claude-vertex.py
python3 setup-claude-vertex.py
Or clone and run:
git clone https://github.com/aberoham/claude-code-gcp-setup.git
cd claude-code-gcp-setup
python3 setup-claude-vertex.py
Environment variables configured
CLAUDE_CODE_USE_VERTEX=1
CLOUDSDK_ACTIVE_CONFIG_NAME=claude-code
CLOUD_ML_REGION=global
ANTHROPIC_VERTEX_PROJECT_ID=<your-project>
Undo
To disable Vertex AI mode and revert to standard Claude Code:
python3 setup-claude-vertex.py --undo
This comments out the environment variables in your ~/.zshrc.