# gt: General Translation CLI tool: Opciones globales
URL: https://generaltranslation.com/es/docs/cli/reference/global-options.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Controla la salida, las comprobaciones de compatibilidad y la ayuda de comandos en la CLI de General Translation. Referencia de la API de las opciones globales de la CLI.

Las opciones globales se aplican al comando `gt` y a sus subcomandos. La opción `--quiet` puede aparecer antes o después de un subcomando.

## Descripción general [#overview]

```bash
npx gt [global options] <command>
```

| Opción                                                        | Descripción                                                                      | Tipo      | Opcional | Predeterminado |
| ------------------------------------------------------------- | -------------------------------------------------------------------------------- | --------- | -------- | -------------- |
| [`--skip-version-check`](#skip-version-check)                 | Omite la comprobación de consistencia de versiones de los paquetes del monorepo. | `boolean` | Sí       | `false`        |
| [`--suppress-id-compatibility-warning`](#suppress-id-warning) | Oculta la advertencia de compatibilidad de ID del paquete de React.              | `boolean` | Sí       | `false`        |
| [`-q, --quiet`](#quiet)                                       | Suprime los registros informativos.                                              | `boolean` | Sí       | `false`        |
| [`-h, --help`](#help)                                         | Muestra la ayuda del comando actual.                                             | `boolean` | Sí       | `false`        |

## `--skip-version-check` [#skip-version-check]

**Tipo** `boolean` · **Opcional** · **Predeterminado** `false`

Omite la comprobación de consistencia de los paquetes de General Translation en un monorepo. Las demás validaciones se ejecutan igualmente. Para conservar este comportamiento en todos los comandos, establece `"skipVersionCheck": true` en `gt.config.json`.

## `--suppress-id-compatibility-warning` [#suppress-id-warning]

**Tipo** `boolean` · **Opcional** · **Predeterminado** `false`

Oculta la advertencia sobre la incompatibilidad en el comportamiento de los ID del paquete de React. No modifica las versiones de los paquetes ni el comportamiento de traducción.

## `-q, --quiet` [#quiet]

**Tipo** `boolean` · **Opcional** · **Predeterminado** `false`

Suprime los banners, los indicadores de progreso y los registros informativos. Las advertencias y los errores siguen siendo visibles. Esto no suprime los datos que devuelve el comando: [`gt api-key create`](/docs/cli/reference/commands/api-key-create) sigue escribiendo el nuevo secreto en stdout.

Cuando `GT_LOG_FORMAT` es `json` o `agent`, el modo silencioso eleva el nivel de registro de la consola a `warn`. No reduce un `GT_LOG_LEVEL` más restrictivo, como `error`.

También funciona en subcomandos anidados, en cualquier posición.

```bash
npx gt translate --quiet
npx gt git setup --quiet
```

*Nota: El modo silencioso suprime los registros, no la interacción. Los avisos se siguen mostrando, así que proporciona las opciones que necesita un comando al ejecutarlo de forma no interactiva.*

## `-h, --help` [#help]

**Tipo** `boolean` · **Opcional** · **Predeterminado** `false`

Muestra la información de uso, las opciones y los subcomandos disponibles sin ejecutar el comando.

```bash
npx gt translate --help
```

## Variable de entorno de la API [#api-url]

`GT_API_URL` define el origen de la API para todos los comandos. Tiene prioridad sobre [`baseUrl`](/docs/cli/reference/config#base-url) en `gt.config.json`; si no se define ninguno de los dos, la CLI usa `https://api.gtx.dev`. Un valor vacío se considera como no definido.

```bash
GT_API_URL=https://api.example.com npx gt translate
```

## Variables de entorno para el registro [#logging]

Estas variables de entorno configuran el registro de la CLI. Se aplican a todos los comandos.

| Variable        | Descripción                                           | Valores                          | Predeterminado                                                              |
| --------------- | ----------------------------------------------------- | -------------------------------- | --------------------------------------------------------------------------- |
| `GT_LOG_LEVEL`  | Nivel mínimo que se muestra en la consola.            | `debug`, `info`, `warn`, `error` | `info`                                                                      |
| `GT_LOG_FORMAT` | Formato de salida de la consola.                      | `default`, `json`, `agent`       | `default` en una terminal; `agent` en CI o cuando stdout no es una terminal |
| `GT_LOG_FILE`   | Escribe un registro completo en esta ruta de archivo. | Ruta de archivo                  | —                                                                           |

`default` es la visualización interactiva, que incluye el banner ASCII y la línea con la versión de la CLI. `json` escribe un objeto de registro JSON por línea. `agent` escribe líneas `LEVEL: message` en texto plano con marca de tiempo, sin color y sin banner. Con `json` tampoco se muestra el banner.

A partir de `gt` 2.26.10, si `GT_LOG_FORMAT` no está definida, se usa `agent` cuando stdout no es una terminal y cuando `CI` no está vacía y su valor no es `false` ni `0`. Define `GT_LOG_FORMAT=default` para mantener la visualización interactiva en esos entornos.

`GT_LOG_FILE` es una opción explícita para capturar registros de depuración y [`--quiet`](#quiet) no le afecta. Silencia la consola y conserva un registro completo en disco:

```bash
GT_LOG_FILE=gt.log npx gt translate --quiet
```

En [`gt api-key create`](/docs/cli/reference/commands/api-key-create), los diagnósticos se envían a stderr. El secreto se escribe sin procesar en stdout incluso con el registro en formato JSON, y `GT_LOG_FILE` nunca lo captura.

*Nota: Un valor no válido para `GT_LOG_FORMAT` o `GT_LOG_LEVEL` interrumpe el comando y genera un error.*

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.
