convez.ai
PluginDevOps & InfraestruturaIntermediário
aberoham

Setup Claude Code com GCP Vertex AI

aberoham/claude-code-gcp-setup

Configure Claude Code no Vertex AI com um comando

Ver no GitHub
InicialPluginScore · de 0 a 100

Script 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-setup

1 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

Estrelas
4
Forks
1
Acompanhando
0
Saúde
28%
Último commit
há 10 meses
Versão
—
Issues abertas
2
Contribuidores
1

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

  1. Creates an isolated gcloud configuration (claude-code) so it doesn't interfere with your default profile
  2. Helps you select a GCP project (prioritizes projects with "vertexai" in the name)
  3. Checks if Vertex AI API is enabled
  4. Configures application-default credentials
  5. Adds required environment variables to ~/.zshrc

Prerequisites

  • macOS with Python 3 (system default)
  • Google Cloud SDK (gcloud CLI)
  • 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.

Ver o original no GitHub

Bom para

Relacionados