# gt: General Translation CLI tool: Options globales
URL: https://generaltranslation.com/fr/docs/cli/reference/global-options.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Contrôlez la sortie, les vérifications de compatibilité et l’aide des commandes dans le CLI de General Translation. Référence API des options globales du CLI.

Les options globales s’appliquent à la commande `gt` et à ses sous-commandes. L’option `--quiet` peut figurer avant ou après une sous-commande.

## Vue d’ensemble [#overview]

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

| Option                                                        | Description                                                               | Type      | Facultatif | Par défaut |
| ------------------------------------------------------------- | ------------------------------------------------------------------------- | --------- | ---------- | ---------- |
| [`--skip-version-check`](#skip-version-check)                 | Ignore la vérification de cohérence des versions des paquets du monorepo. | `boolean` | Oui        | `false`    |
| [`--suppress-id-compatibility-warning`](#suppress-id-warning) | Masque l’avertissement de compatibilité des ID de paquet React.           | `boolean` | Oui        | `false`    |
| [`-q, --quiet`](#quiet)                                       | Masque les journaux informatifs.                                          | `boolean` | Oui        | `false`    |
| [`-h, --help`](#help)                                         | Affiche l’aide de la commande actuelle.                                   | `boolean` | Oui        | `false`    |

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

**Type** `boolean` · **Facultatif** · **Par défaut** `false`

Ignore la vérification de cohérence des paquets General Translation dans un monorepo. Les autres validations sont toujours exécutées. Pour conserver ce comportement pour chaque commande, définissez `"skipVersionCheck": true` dans `gt.config.json`.

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

**Type** `boolean` · **Facultatif** · **Par défaut** `false`

Masque l’avertissement relatif à une incompatibilité de comportement des ID de paquets React. Ne modifie ni les versions des paquets ni le comportement de traduction.

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

**Type** `boolean` · **Facultatif** · **Par défaut** `false`

Masque les bannières, les indicateurs de progression et les journaux informatifs. Les avertissements et les erreurs restent visibles. Les données renvoyées par les commandes ne sont pas masquées pour autant : [`gt api-key create`](/docs/cli/reference/commands/api-key-create) écrit toujours le nouveau secret sur stdout.

Lorsque `GT_LOG_FORMAT` vaut `json` ou `agent`, le mode silencieux relève le niveau de journalisation de la console à `warn`. Il ne remplace pas un `GT_LOG_LEVEL` plus restrictif, tel que `error`.

Il fonctionne également avec les sous-commandes imbriquées, quelle que soit sa position.

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

*Remarque : le mode silencieux masque les journaux, mais pas les interactions. Les invites s’affichent toujours ; fournissez donc les options requises par une commande lorsque vous l’exécutez de manière non interactive.*

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

**Type** `boolean` · **Facultatif** · **Par défaut** `false`

Affiche l’aide, les options et les sous-commandes disponibles sans exécuter la commande.

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

## Variable d’environnement de l’API [#api-url]

`GT_API_URL` définit l’origine de l’API pour toutes les commandes. Elle a priorité sur [`baseUrl`](/docs/cli/reference/config#base-url) dans `gt.config.json` ; si aucune des deux n’est définie, la CLI utilise `https://api.gtx.dev`. Une valeur vide est traitée comme une valeur non définie.

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

## Variables d&#39;environnement de journalisation [#logging]

Ces variables d&#39;environnement configurent la journalisation de la CLI. Elles s&#39;appliquent à toutes les commandes.

| Variable        | Description                               | Valeurs                          | Par défaut                                                                             |
| --------------- | ----------------------------------------- | -------------------------------- | -------------------------------------------------------------------------------------- |
| `GT_LOG_LEVEL`  | Niveau minimal affiché dans la console.   | `debug`, `info`, `warn`, `error` | `info`                                                                                 |
| `GT_LOG_FORMAT` | Format de sortie de la console.           | `default`, `json`, `agent`       | `default` dans un terminal ; `agent` en CI ou lorsque stdout n&#39;est pas un terminal |
| `GT_LOG_FILE`   | Écrit un journal complet dans ce fichier. | Chemin de fichier                | —                                                                                      |

`default` correspond à l&#39;affichage interactif, avec la bannière ASCII et la ligne indiquant la version de la CLI. `json` écrit un objet de journal JSON par ligne. `agent` écrit de simples lignes horodatées `LEVEL: message`, sans couleur ni bannière. La bannière est également omise avec `json`.

Depuis `gt` 2.26.10, si `GT_LOG_FORMAT` n&#39;est pas défini, `agent` est utilisé lorsque stdout n&#39;est pas un terminal, ainsi que lorsque `CI` n&#39;est pas vide et ne vaut ni `false` ni `0`. Définissez `GT_LOG_FORMAT=default` pour conserver l&#39;affichage interactif dans ces environnements.

`GT_LOG_FILE` permet explicitement de capturer les journaux de débogage, et [`--quiet`](#quiet) ne l&#39;affecte pas. Désactivez la sortie dans la console tout en conservant un journal complet sur le disque :

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

Pour [`gt api-key create`](/docs/cli/reference/commands/api-key-create), les diagnostics sont envoyés vers stderr. Le secret est écrit tel quel sur stdout, même avec la journalisation JSON, et n&#39;est jamais capturé par `GT_LOG_FILE`.

*Remarque : une valeur non valide de `GT_LOG_FORMAT` ou `GT_LOG_LEVEL` interrompt la commande et génère une erreur.*

## Sitemap

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