Configurar um ambiente de desenvolvimento local

Saiba como configurar um ambiente de desenvolvimento local para Google Cloud. Este documento aborda as principais ferramentas necessárias para criar, testar e executar aplicativos com serviços do Google Cloud :

  • CLI gcloud: gerencie recursos da nuvem, configure projetos e defina Application Default Credentials (ADC) locais.
  • Bibliotecas de cliente do Cloud: acesse as APIs Google Cloud de maneira programática usando bibliotecas idiomáticas na sua linguagem de programação preferida.

Este documento também mostra como instalar o plug-in google-cloud-developer para receber ajuda com tarefas de Google Cloud e programação em vários agentes diferentes.

Para uma visão geral de outras ferramentas e interfaces no Google Cloud, consulte Formas de interagir com o Google Cloud.

Antes de começar

Peça para o administrador da organização atender aos seguintes pré-requisitos:

  • Provisione sua identidade de usuário: atribua uma conta do Cloud Identity ou do Google Workspace.
  • Conceda acesso ao projeto e papéis do IAM: atribua os papéis necessários do Identity and Access Management (IAM) ao projeto.
  • Ative o faturamento: verifique se o Cloud Billing está ativado no seu projeto.

Para uma configuração em toda a organização, consulte o fluxo guiado de configuração doGoogle Cloud .

Configurar a CLI gcloud e a autenticação

Configure a CLI gcloud (gcloud) para gerenciar recursos e autenticar seu ambiente local:

  1. Instale a CLI gcloud na sua estação de trabalho local.
  2. Execute gcloud init no terminal para fazer login e selecionar seu projeto padrão.
  3. Execute gcloud auth application-default login para configurar o Application Default Credentials (ADC). As ADCs permitem que as bibliotecas de cliente locais se autentiquem automaticamente no seu projeto.

Instalar bibliotecas de cliente do Cloud

Para acessar os Google Cloud serviços de forma programática no código do aplicativo:

  1. Ative as APIs do Cloud necessárias para seu projeto.
  2. Instale as bibliotecas de cliente do Cloud para sua linguagem de programação (como Java, Python ou Go). Seu código é autenticado automaticamente usando o ADC.

Instalar o plug-in google-cloud-developer

Se você usa um agente como Claude Code, CLI do Antigravity ou Codex CLI para ajudar no seu trabalho de desenvolvimento, instale o plug-in google-cloud-developer para receber ajuda com tarefas de Google Cloud e programação. Este plug-in inclui:

  • Habilidades para ajudar na criação de contas, configuração de faturamento, gerenciamento de projetos e autenticação em Google Cloud serviços e APIs.
  • A habilidade finding-google-skills, que localiza e executa a habilidade certa do produto do Google sob demanda, evitando a necessidade de pré-carregar as habilidades do Google.
  • O servidor MCP remoto Developer Knowledge, que permite pesquisar a documentação oficial para desenvolvedores do Google e recuperar informações sobre produtos como Google Cloud, Firebase, Android, Maps e muito mais.

Instale o plug-in google-cloud-developer usando as instruções a seguir, de acordo com seu agente.

CLI do Antigravity

  1. Instale o plug-in especificando a localização dele no repositório Habilidades do agente do Google:

    agy plugin install https://github.com/google/skills/plugins/cloud/google-cloud-developer

  2. Ative a API Developer Knowledge no seu projeto Google Cloud usando a CLI gcloud:

    gcloud services enable developerknowledge.googleapis.com --project=YOUR_PROJECT_ID

Claude Code

  1. Adicione o mercado de plug-ins do Google e instale o plug-in:

    claude plugin marketplace add google/skills
claude plugin install google-cloud-developer@google-plugins

  2. Ative a API Developer Knowledge no seu projeto Google Cloud usando a CLI gcloud:

    gcloud services enable developerknowledge.googleapis.com --project=YOUR_PROJECT_ID

  3. Crie uma chave de API para a API Developer Knowledge seguindo as instruções em Criar e proteger a chave de API. Salve a chave criada em um local seguro.

  4. Ative o acesso autenticado ao servidor MCP de conhecimento do desenvolvedor usando a chave de API criada na etapa anterior:

    claude mcp add google-dev-knowledge \
--scope user \
--transport http https://developerknowledge.googleapis.com/mcp \
--header "X-Goog-Api-Key: YOUR_API_KEY"

CLI do Codex

  1. Adicione o mercado de plug-ins do Google e instale o plug-in:

    codex plugin marketplace add google/skills
codex plugin add google-cloud-developer@google-plugins

  2. Ative a API Developer Knowledge no seu projeto Google Cloud usando a CLI gcloud:

    gcloud services enable developerknowledge.googleapis.com --project=YOUR_PROJECT_ID

  3. Crie uma chave de API para a API Developer Knowledge seguindo as instruções em Criar e proteger a chave de API. Salve a chave criada em um local seguro.

  4. Para ativar o acesso autenticado ao servidor MCP de conhecimento do desenvolvedor, atualize ~/.codex/config.toml (ou o .codex/config.toml do seu projeto) para incluir as seguintes linhas:

    [mcp_servers.google-developer-knowledge]
  url = "https://developerknowledge.googleapis.com/mcp"
  http_headers = { "X-Goog-Api-Key" = "YOUR_API_KEY" }

Ferramentas e ambientes alternativos

Se o fluxo de trabalho exigir ambientes de desenvolvimento ou ferramentas de infraestrutura específicos, considere o seguinte:

A seguir