Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
La CLI de Google Cloud proporciona un instalador para cada plataforma compatible y se puede implementar de forma interactiva o no interactiva.
Instalación interactiva
El instalador te permite descargar, instalar y configurar la versión más reciente de Google Cloud CLI en modo interactivo. Cuando ejecutas el instalador, este descarga los componentes de Google Cloud CLI y los instala en el sistema local. También ejecuta tareas de configuración adicionales, como agregar componentes de gcloud CLI a tu PATH y habilitar la finalización de comandos en tu shell.
Linux y macOS
En la línea de comandos, ejecuta el siguiente comando:
curlhttps://sdk.cloud.google.com|bash
Cuando se te solicite, elige una ubicación en el sistema de archivos (por lo general, en el directorio principal) en la que quieras crear el subdirectorio google-cloud-sdk.
Si deseas enviar estadísticas de uso anónimas para ayudar a mejorar gcloud CLI, responde Y cuando se te solicite.
Para agregar herramientas de línea de comandos de gcloud CLI a tu PATH y habilitar la finalización de comandos, responde Y cuando se te solicite.
Reinicia tu shell:
exec-l$SHELL
Para inicializar el entorno de Google Cloud CLI, ejecuta gcloud init:
gcloudinit
Windows (instalador)
Google Cloud CLI funciona en Windows 8.1 y versiones posteriores, y en Windows Server 2012 y versiones posteriores.
Inicia el instalador y sigue las instrucciones. El instalador está firmado por Google LLC.
Si usas un lector de pantalla, marca la casilla de verificación Activar el modo de lector de pantalla. Esta opción configura gcloud para usar herramientas de seguimiento de estado en lugar de íconos giratorios Unicode, mostrar el progreso como un porcentaje y compactar tablas. Para obtener más información, consulta la guía de funciones de accesibilidad.
Google Cloud CLI requiere Python. Las versiones compatibles son Python 3.9 a 3.13. De forma predeterminada, la versión de Windows de Google Cloud CLI incluye Python 3. Para usar Google Cloud CLI, tu sistema operativo debe poder ejecutar una versión compatible de Python.
El instalador instala todas las dependencias necesarias, incluida la versión de Python correspondiente.
Si bien Google Cloud CLI instala y administra Python 3 de forma predeterminada, puedes usar una instalación de Python existente si desmarcas la opción para instalar Python incluido en el paquete.
Consulta gcloud topic startup para aprender a usar una instalación de Python existente.
Una vez completada la instalación, el instalador te da la opción de crear menús de inicio y accesos directos de escritorio, iniciar la shell de la Google Cloud CLI y configurar la gcloud CLI. Asegúrate de dejar las opciones para iniciar la shell y configurar la instalación. El instalador inicia una ventana de terminal y ejecuta el comando gcloud init.
La instalación predeterminada no incluye las extensiones de App Engine necesarias para implementar una aplicación con los comandos de gcloud. Estos componentes se pueden instalar con el administrador de componentes de la gcloud CLI.
Sugerencias para la solución de problemas:
Si la instalación no se hace correctamente debido a que el comando find no se reconoce, asegúrate de que la variable de entorno PATH esté configurada para incluir la carpeta que contiene find. Por lo general, esto es C:\WINDOWS\system32;.
Si desinstalaste gcloud CLI, debes reiniciar el sistema antes de volver a instalarla.
Si la descompresión falla, ejecuta el instalador como administrador.
Windows (ZIP)
También puedes instalar la versión más reciente desde un archivo .zip descargado:
Descarga google-cloud-sdk.zip y extrae su contenido. (Haz clic derecho en el archivo descargado y selecciona Extraer todo).
Inicia la secuencia de comandos google-cloud-sdk\install.bat y sigue las instrucciones de instalación.
Cuando la instalación finalice, reinicia el símbolo del sistema (cmd.exe).
Puedes automatizar la instalación de Google Cloud CLI con la secuencia de comandos de instalación.
Para Linux y MacOS:
Guarda la secuencia de comandos de instalación de forma local en lugar de enviarla a bash.
Ingresa lo siguiente en un símbolo de sistema:
curlhttps://sdk.cloud.google.com > install.sh
Ejecuta la secuencia de comandos y pasa los argumentos que se describen a continuación:
bashinstall.sh--disable-prompts
Las opciones de install.sh son las siguientes:
--disable-prompts: inhabilitar los mensajes.
--install-dir=DIRECTORY: Establece el directorio raíz de instalación en DIRECTORY. Google Cloud CLI se instala en DIRECTORY/google-cloud-sdk. El valor predeterminado es $HOME.
Para Windows, haz lo siguiente:
/S: instalar de forma silenciosa. No se muestran páginas del instalador. Usa marcas para cambiar la configuración de instalación.
/D: establecer el directorio de instalación predeterminado. Debe ser el último parámetro usado en la línea de comandos y no debe contener comillas, incluso si la ruta tiene espacios. Solo se admiten rutas absolutas; por ejemplo, /D=C:\CloudSDK.
/allusers: instalar para todos los usuarios.
/singleuser: instalar para el usuario actual (predeterminado).
/screenreader: activar el modo de lector de pantalla (la opción predeterminada es desactivarla)
/reporting: habilitar informes de uso (la opción predeterminada es desactivar los informes de uso)
/noreporting: inhabilitar los informes de uso (la opción predeterminada es desactivar los informes de uso)
/nostartmenu: no crear acceso directo al menú de inicio (la opción predeterminada es crear acceso directo).
/nodesktop: no crear acceso directo de escritorio (la opción predeterminada es crear acceso directo).
Pruébalo tú mismo
Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros
productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-04 (UTC)"],[],[],null,["# Using the Google Cloud CLI installer\n\nThe Google Cloud CLI provides an installer for each supported platform and can\nbe deployed interactively or non-interactively.\n\nInteractive installation\n------------------------\n\nThe installer lets you download, install, and set up the latest version of\nGoogle Cloud CLI in an interactive mode. When you run the installer,\nit downloads Google Cloud CLI components and installs them on the local\nsystem. It also performs additional setup tasks like adding gcloud CLI\ncomponents to your `PATH` and enabling command completion in your shell.\n| **Note:** The installer is designed to make it easy for a user to install the latest version of Google Cloud CLI. If you want to use a script to install a specific version in non-interactive mode --- for example, to install the same version automatically every time you build a production system --- use a [versioned archive](/sdk/docs/downloads-versioned-archives) of the Google Cloud CLI.\nLinux and macOS\n\n1. At the command line, run the following command: \n\n ```bash\n curl https://sdk.cloud.google.com | bash\n ```\n2. When prompted, choose a location on your file system (usually your Home directory) to create the `google-cloud-sdk` subdirectory under.\n3. If you want to send anonymous usage statistics to help improve gcloud CLI, answer `Y` when prompted.\n4. To add gcloud CLI command-line tools to your `PATH` and enable command completion, answer `Y` when prompted.\n5. Restart your shell: \n\n ```bash\n exec -l $SHELL\n ```\n6. To initialize the Google Cloud CLI environment, run [`gcloud init`](/sdk/gcloud/reference/init): \n\n ```bash\n gcloud init\n ```\nWindows (Installer)\n\nThe Google Cloud CLI works on Windows 8.1 and later and Windows Server 2012 and later.\n1.\n Download the [Google Cloud CLI installer](https://dl.google.com/dl/cloudsdk/channels/rapid/GoogleCloudSDKInstaller.exe).\n\n\n Alternatively, open a PowerShell terminal and run the following PowerShell commands: \n\n ```bash\n (New-Object Net.WebClient).DownloadFile(\"https://dl.google.com/dl/cloudsdk/channels/rapid/GoogleCloudSDKInstaller.exe\", \"$env:Temp\\GoogleCloudSDKInstaller.exe\")\n\n & $env:Temp\\GoogleCloudSDKInstaller.exe\n \n ```\n2. Launch the installer and follow the prompts. The installer is signed by Google LLC.\n\n\n If you're using a screen reader, check the **Turn on screen reader mode** checkbox. This\n option configures `gcloud` to use status trackers instead of unicode spinners,\n display progress as a percentage, and flatten tables. For more information, see the\n [Accessibility features guide](/sdk/docs/enabling-accessibility-features).\n3. Google Cloud CLI requires Python; supported versions are Python 3.9 to 3.13. By\n default, the Windows version of Google Cloud CLI comes bundled with Python 3. To use\n Google Cloud CLI your operating system must be able to run a supported version of Python.\n\n\n The installer installs all necessary dependencies, including the needed Python version.\n While Google Cloud CLI installs and manages Python 3 by default, you can use an existing\n Python installation if necessary by **unchecking** the option to Install Bundled Python.\n See [`gcloud topic startup`](/sdk/gcloud/reference/topic/startup) to\n learn how to use an existing Python installation.\n4. After installation is complete, the installer gives you the option to create Start Menu\n and Desktop shortcuts, start the Google Cloud CLI shell, and configure the\n gcloud CLI. Make sure that you leave the options to start the shell and configure your\n installation selected. The installer starts a terminal window and runs the\n [`gcloud init`](/sdk/gcloud/reference/init) command.\n\n5. The default installation doesn't include the App Engine extensions required to deploy an application using `gcloud` commands. These components can be installed using the [gcloud CLI component manager](/sdk/docs/managing-components).\n\n**Troubleshooting tips:**\n\n- If your installation is unsuccessful due to the `find` command not being recognized, ensure your `PATH` environment variable is set to include the folder containing `find`. Usually, this is `C:\\WINDOWS\\system32;`.\n- If you uninstalled the gcloud CLI, you must reboot your system before installing the gcloud CLI again.\n- If unzipping fails, run the installer as an administrator.\nWindows (Zip)\n\nYou can also install the latest version from a downloaded\n`.zip` file:\n\n1.\n Download\n [google-cloud-sdk.zip](https://dl.google.com/dl/cloudsdk/channels/rapid/google-cloud-sdk.zip)\n and extract its contents. (Right click on the downloaded file and\n select **Extract All**.)\n\n2.\n Launch the `google-cloud-sdk\\install.bat` script and follow\n the installation prompts.\n\n3.\n When the installation finishes, restart the command prompt\n (`cmd.exe`).\n\n4. Run [`gcloud init`](/sdk/gcloud/reference/init):\n\n ```\n C:\\\u003e gcloud init\n ```\n\nNon-interactive (silent) deployment\n-----------------------------------\n\nYou can automate Google Cloud CLI installation using the install script.\n\n**For Linux and MacOS:**\n\nSave the install script locally instead of piping it to bash.\n\n1. Enter the following at a command prompt: \n\n ```bash\n curl https://sdk.cloud.google.com \u003e install.sh\n ```\n2. Run the script, passing arguments described as follows: \n\n ```bash\n bash install.sh --disable-prompts\n ```\n\nThe `install.sh` options are:\n\n- `--disable-prompts` - disable prompts.\n- `--install-dir=`\u003cvar translate=\"no\"\u003eDIRECTORY\u003c/var\u003e - set the installation root directory to \u003cvar translate=\"no\"\u003eDIRECTORY\u003c/var\u003e. The Google Cloud CLI is installed in \u003cvar translate=\"no\"\u003eDIRECTORY\u003c/var\u003e`/google-cloud-sdk`. The default is $HOME.\n\n**For Windows:**\n| **Important:** These flags are for the [Windows installer](/sdk/docs/install-sdk) and are case sensitive.\n\n- `/S` - install silently. No installer pages are displayed. Use flags to change install settings.\n- `/D` - set the default installation directory. It must be the last parameter used in the command line and must not contain any quotes, even if the path contains spaces. Only absolute paths are supported, for example `/D=C:\\CloudSDK`\n- `/allusers` - install for all users\n- `/singleuser` - install for current user (default)\n- `/screenreader` - turn on screen reader mode (default is to turn it off)\n- `/reporting` - enable usage reporting (default is to turn off usage reporting)\n- `/noreporting` - disable usage reporting (default is to turn off usage reporting)\n- `/nostartmenu` - don't create start menu shortcut (default is to create shortcut)\n- `/nodesktop` - don't create desktop shortcut (default is to create shortcut)\n\nTry it for yourself\n-------------------\n\n\nIf you're new to Google Cloud, create an account to evaluate how our\nproducts perform in real-world scenarios. New customers also get $300 in\nfree credits to run, test, and deploy workloads.\n[Get started for free](https://console.cloud.google.com/freetrial)"]]