# gt: General Translation CLI tool: gt login URL: https://generaltranslation.com/es/docs/cli/reference/commands/login.mdx Docs index: https://generaltranslation.com/llms.txt Description: Inicia sesión en tu cuenta para usar los flujos de trabajo alojados de la CLI. Referencia de la API del comando gt login. Usa login para autenticar una configuración existente. Si quieres una configuración guiada del proyecto, ejecuta [`gt init`](/docs/cli/reference/commands/init); este comando inicia sesión por ti cuando crea un proyecto o una clave y no hay ninguna clave de herramientas ni ningún inicio de sesión guardado disponible. Para crear una clave con permisos restringidos, usa [`gt api-key create`](/docs/cli/reference/commands/api-key-create). ## Descripción general [#overview] Requiere [Node.js 20 o posterior](/docs/cli/quickstart#quickstart); se recomienda usar una versión LTS con soporte vigente. ```bash npx gt login [options] ``` | Parámetro | Descripción | Tipo | Opcional | Predeterminado | | ------------------------------- | ------------------------------------------------------------------------------------ | --------- | -------- | ---------------- | | [`--no-browser`](#flags) | Usa la autorización de dispositivo en lugar de un callback local del navegador. | `boolean` | Sí | `false` | | [`-c, --config `](#flags) | Archivo de configuración cuyo `baseUrl` determina la API en la que se inicia sesión. | `string` | Sí | `gt.config.json` | **Cambios en v2.22:** el antiguo comando auth y su flag de tipo de clave se han eliminado; no se conservan como alias. Login sustituye al inicio de sesión en la cuenta; init y la creación explícita de claves se encargan del aprovisionamiento. Las API Keys existentes siguen siendo válidas. ## Cómo funciona [#how-it-works] * Abre tu navegador para que puedas aprobar el acceso de la CLI a tu cuenta. * Los permisos de tu cuenta determinan a qué proyectos y operaciones puedes acceder. * Usa la autorización de dispositivo si se indica `--no-browser` o si no puede escuchar el callback del navegador en esta máquina. En ese caso, muestra una URL de verificación y un código para que apruebes el acceso desde otro dispositivo. * En sesiones SSH, usa automáticamente la autorización de dispositivo. Un fallo al abrir el navegador no basta por sí solo para cambiar de modo: abre tú mismo la URL de autorización que se muestra o vuelve a ejecutar el comando con `--no-browser`. * Guarda una sesión de cuenta, no una selección de proyecto. No crea API Keys ni escribe en `.env.local`. Los SDK de runtime no cargan las sesiones de la CLI. Para la vinculación de proyectos, la precedencia de las claves explícitas y las credenciales de CI, consulta [Configurar la CLI](/docs/cli/guides/configuring#credentials). ## Flags [#flags] **`--no-browser`** · **Tipo** `boolean` · **Opcional** · **Predeterminado** `false` Usa la autorización de dispositivo sin abrir un navegador. Sigue siendo necesaria la aprobación de una persona; no se trata de una autenticación desatendida para CI. **`-c, --config `** · **Tipo** `string` · **Opcional** · **Predeterminado** `gt.config.json` Lee [`baseUrl`](/docs/cli/reference/config#base-url) de este archivo de configuración en lugar del `gt.config.json` detectado. `GT_API_URL` sigue teniendo prioridad sobre este valor. Requiere `gt` 2.23.0 o posterior. También se aplican las [opciones globales](/docs/cli/reference/global-options). ## Ejemplos [#examples] ```bash # Inicia sesión con un navegador en este equipo npx gt login # Aprueba el inicio de sesión desde otro dispositivo npx gt login --no-browser ``` Tras la aprobación, verifica la cuenta con [`gt whoami`](/docs/cli/reference/commands/whoami). Usa [`gt logout`](/docs/cli/reference/commands/logout) para eliminar la sesión guardada. ## Almacenamiento y solución de problemas [#storage] Las sesiones se guardan en `$XDG_STATE_HOME/gt/credentials.json` cuando `XDG_STATE_HOME` es una ruta absoluta; en caso contrario, se guardan en `~/.local/state/gt/credentials.json`. Los valores XDG relativos se ignoran. Cuando el sistema lo admite, las credenciales usan permisos de archivo que solo permiten el acceso al propietario; no se cifran ni se almacenan en el llavero del sistema operativo. Los inicios de sesión guardados con formatos anteriores no se migran automáticamente. Vuelve a iniciar sesión si tus credenciales guardadas están desactualizadas o no son válidas. Los archivos de credenciales dañados se conservan como copias de seguridad `.corrupt-`. La CLI mantiene tu sesión iniciada entre comandos. Evita actualizar el mismo inicio de sesión guardado desde varios procesos de la CLI a la vez. ## Sitemap See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.