Configura un entorno de desarrollo local

Obtén más información para configurar un entorno de desarrollo local paraGoogle Cloud. En este documento, se describen las herramientas principales necesarias para compilar, probar y ejecutar aplicaciones con los servicios de Google Cloud :

  • CLI de gcloud: Administra recursos de Cloud, configura proyectos y establece credenciales predeterminadas de la aplicación (ADC) locales.
  • Bibliotecas cliente de Cloud: Accede a las Google Cloud APIs 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 y otras interfaces en Google Cloud, consulta Formas de interactuar con Google Cloud.

Antes de comenzar

Pídele al administrador de tu 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 en 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 tu 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 Google Cloud servicios de forma 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, Antigravity CLI o Codex CLI para ayudarte en tu trabajo de desarrollo, puedes instalar el complemento de google-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 facturación, la administración de proyectos y la autenticación en las APIs y los servicios de Google Cloud
  • La habilidad finding-google-skills, que localiza y ejecuta la habilidad del producto de Google adecuada a pedido, lo que evita la necesidad de precargar las habilidades de Google.
  • El servidor de MCP remoto de Developer Knowledge, que permite buscar la documentación oficial para desarrolladores de Google y recuperar información sobre los productos de Google, como Google Cloud, Firebase, Android, Maps y muchos más.

Instala el complemento google-cloud-developer siguiendo las instrucciones que se indican a continuación según tu agente.

CLI de Antigravity

  1. Instala el complemento especificando su ubicación en el repositorio de Google Agent Skills:

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

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

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

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 la gcloud CLI:

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

  3. Crea una clave de API para la API de Developer Knowledge siguiendo las instrucciones de Crea y protege la clave de API. Guarda la clave que crees en una ubicación segura.

  4. Exporta la clave de API a tu entorno antes de iniciar 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 la gcloud CLI:

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

  3. Crea una clave de API para la API de Developer Knowledge siguiendo las instrucciones de Crea y protege la clave de API. Guarda la clave que crees en una ubicación segura.

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

    [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?