Configura un entorno de desarrollo local

Aprende a configurar un entorno de desarrollo local para Google Cloud. En este documento, se describen las herramientas principales necesarias para compilar, probar y ejecutar aplicaciones con los servicios de Google Cloud :

  • gcloud CLI: Administra recursos de la nube, configura proyectos y establece credenciales predeterminadas de la aplicación (ADC) locales.
  • Bibliotecas cliente de Cloud: Accede a las APIs de Google Cloud de forma programática con bibliotecas idiomáticas en tu lenguaje de programación preferido.

En este documento, también se muestra cómo instalar el complemento de google-cloud-developer para obtener ayuda con las tareas de Google Cloud y la programación en varios agentes diferentes.

Para obtener una descripción general de otras herramientas e interfaces en Google Cloud, consulta Formas de interactuar con Google Cloud.

Antes de comenzar

Pídele al administrador de la organización que complete los siguientes requisitos previos:

  • Aprovisiona tu identidad de usuario: Asigna una cuenta de Cloud Identity o Google Workspace.
  • Otorga acceso al proyecto y roles de IAM: Asigna los roles de Identity and Access Management (IAM) necesarios para tu proyecto.
  • Habilita la facturación: Verifica que la Facturación de Cloud esté habilitada en tu proyecto.

Para la configuración de toda la organización, consulta el flujo guiado de configuración deGoogle Cloud .

Configura gcloud CLI y la autenticación

Configura gcloud CLI (gcloud) para administrar recursos y autenticar tu entorno local:

  1. Instala gcloud CLI en tu estación de trabajo local.
  2. Ejecuta gcloud init en la terminal para acceder y seleccionar tu proyecto predeterminado.
  3. Ejecuta gcloud auth application-default login para configurar las credenciales predeterminadas de la aplicación (ADC). Las ADC permiten que las bibliotecas cliente locales se autentiquen automáticamente en tu proyecto.

Instala las bibliotecas cliente de Cloud

Para acceder a los servicios de Google Cloud de manera programática desde el código de tu aplicación, haz lo siguiente:

  1. Habilita las APIs de Cloud necesarias para tu proyecto.
  2. Instala las bibliotecas cliente de Cloud para tu lenguaje de programación (como Java, Python o Go). Tu código se autentica automáticamente con ADC.

Instala el complemento de google-cloud-developer

Si usas un agente como Claude Code CLI, Antigravity CLI o Codex CLI para que te ayude en tu trabajo de desarrollo, puedes instalar el complemento degoogle-cloud-developer para obtener ayuda con las tareas de Google Cloud y la programación. Este complemento incluye lo siguiente:

  • Habilidades para ayudar con la creación de cuentas, la configuración de la facturación, la administración de proyectos y la autenticación en los servicios y las APIs de Google Cloud .
  • La habilidad finding-google-skills, que ubica y ejecuta la habilidad correcta del producto de Google a pedido, lo que evita la necesidad de precargar las Google Skills.
  • El servidor de MCP remoto Developer Knowledge, que proporciona la capacidad de buscar en la documentación para desarrolladores oficial de Google y recuperar información de los productos de Google, como Google Cloud, Firebase, Android, Maps y mucho más.

Instala el complemento google-cloud-developer con las siguientes instrucciones según tu agente.

Antigravity

Instala el complemento desde Antigravity Marketplace:

  1. En Antigravity, ve a Customizations > Marketplace y busca "Google Cloud Developer".
  2. Haz clic en el botón Agregar.

Como alternativa, instala el complemento con la CLI de Antigravity:

agy plugin install google-cloud-developer

CLI de Claude Code

  1. Agrega el mercado de complementos de Google y, luego, instala el complemento:

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

  2. Habilita la API de Developer Knowledge en tu proyecto de Google Cloud con gcloud CLI:

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

  3. Sigue las instrucciones para crear y proteger la clave de API y crear una clave de API para la API de Developer Knowledge. Guarda la clave que crees en una ubicación segura.

  4. Exporta la clave de API a tu entorno antes de iniciar la CLI de Claude Code:

    export DEVELOPERKNOWLEDGE_API_KEY=YOUR_API_KEY

CLI de Codex

  1. Agrega el mercado de complementos de Google y, luego, instala el complemento:

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

  2. Habilita la API de Developer Knowledge en tu proyecto de Google Cloud con gcloud CLI:

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

  3. Sigue las instrucciones para crear y proteger la clave de API y crear una clave de API para la API de Developer Knowledge. Guarda la clave que crees en una ubicación segura.

  4. Habilita el acceso autenticado al servidor de MCP de Developer Knowledge actualizando ~/.codex/config.toml (o el archivo .codex/config.toml de tu proyecto) para incluir las siguientes líneas:

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

  5. Exporta la clave de API a tu entorno antes de iniciar Codex:

    export DEVELOPERKNOWLEDGE_API_KEY=YOUR_API_KEY

Herramientas y entornos alternativos

Si tu flujo de trabajo requiere entornos de desarrollo o herramientas de infraestructura específicos, ten en cuenta lo siguiente:

¿Qué sigue?