Configurar um ambiente de desenvolvimento local

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

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

Neste documento, também mostramos como instalar o plug-in google-cloud-developer para receber ajuda com tarefas do 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 concluir os seguintes pré-requisitos:

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

Para configurar 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 estação de trabalho local.
  2. Execute gcloud init no terminal para fazer login e selecionar o projeto padrão.
  3. Execute gcloud auth application-default login para configurar o Application Default Credentials (ADC). O ADC permite que as bibliotecas de cliente locais sejam autenticadas automaticamente no projeto.

Instalar bibliotecas de cliente do Cloud

Para acessar os serviços do Google Cloud de maneira 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 a CLI do Claude Code, a CLI do Antigravity ou a CLI do Codex para ajudar no seu trabalho de desenvolvimento, instale o plug-in google-cloud-developer para receber ajuda com tarefas do 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 serviços e APIs do Google Cloud .
  • A skill finding-google-skills, que localiza e executa a skill certa do produto do Google sob demanda, evitando a necessidade de pré-carregar as Google Skills.
  • O servidor MCP remoto Developer Knowledge, que permite pesquisar a documentação para desenvolvedores oficial do Google e recuperar informações sobre produtos do Google, como Google Cloud, Firebase, Android, Maps e muito mais.

Instale o plug-in google-cloud-developer seguindo as instruções abaixo com base no seu agente.

Antigravity

Instale o plug-in do Antigravity Marketplace:

  1. No Antigravity, acesse Customizações > Marketplace e pesquise "Google Cloud Developer".
  2. Clique no botão Adicionar.

Se preferir, instale o plug-in usando a CLI do Antigravity:

agy plugin install google-cloud-developer

CLI do Claude Code

  1. Adicione o marketplace 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 do 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 Criar e proteger a chave de API. Salve a chave criada em um local seguro.

  4. Exporte a chave de API para seu ambiente antes de iniciar a CLI do Claude Code:

    export DEVELOPERKNOWLEDGE_API_KEY=YOUR_API_KEY

CLI do Codex

  1. Adicione o marketplace 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 do 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 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 atualizando ~/.codex/config.toml (ou o .codex/config.toml do seu projeto) para incluir as seguintes linhas:

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

  5. Exporte a chave de API para seu ambiente antes de iniciar o Codex:

    export DEVELOPERKNOWLEDGE_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