# gt: General Translation CLI tool: Démarrage rapide
URL: https://generaltranslation.com/fr/docs/cli/quickstart.mdx
---
title: Démarrage rapide
description: Découvrez à quoi sert la CLI de General Translation, quand l’utiliser et comment traduire votre premier projet.
related:
  links:
    - /docs/cli/guides/generating-translations
    - /docs/cli/guides/configuring
    - /docs/cli/guides/managing-translations
    - /docs/cli/guides/using-auto-jsx

---

La CLI de General Translation (`gt`) configure l’internationalisation et traduit votre projet depuis la ligne de commande.

Elle fonctionne avec [`gt-react`, `gt-next` et `gt-react-native`](/docs/react/overview), avec des bibliothèques i18n tierces comme `next-intl` et `i18next`, ainsi qu’avec des fichiers autonomes tels que JSON, YAML, Markdown et MDX.

## Ce que fait la CLI [#what-it-does]

La CLI vous donne un accès direct à :

* **Configuration** pour installer les dépendances, intégrer votre framework et créer un `gt.config.json`.
* **Traduction** pour envoyer votre contenu source à l’API General Translation et enregistrer les résultats dans votre base de code ou sur le CDN.
* **Briques de CI** pour téléverser, mettre en file d’attente et télécharger des traductions à différentes étapes du pipeline.
* **Validation** pour vérifier votre projet afin de détecter les erreurs de traduction sans appeler l’API.

## Quand utiliser la CLI [#when-to-use]

Utilisez la CLI lorsque vous souhaitez :

* Configurer un nouveau projet pour la traduction à l’aide d’un assistant.
* Traduire votre projet dans le cadre d’un build ou d’un pipeline CI.
* Traduire des fichiers de contenu autonomes sans ajouter de bibliothèque de framework.
* Conserver les traductions dans le contrôle de version avec votre contenu source.

## Démarrage rapide [#quickstart]

Installez `gt`, configurez votre projet et lancez votre première traduction.

### 1. Installez `gt`

Installez la CLI en tant que dépendance de développement.

<Tabs items={['npm', 'yarn', 'bun', 'pnpm']}>
  <Tab value="npm">
    ```bash
    npm install gt --save-dev
    ```
  </Tab>

  <Tab value="yarn">
    ```bash
    yarn add --dev gt
    ```
  </Tab>

  <Tab value="bun">
    ```bash
    bun add --dev gt
    ```
  </Tab>

  <Tab value="pnpm">
    ```bash
    pnpm add --save-dev gt
    ```
  </Tab>
</Tabs>

### 2. Configurez votre projet

Lancez l’assistant de configuration pour détecter votre framework, créer un `gt.config.json` et générer des identifiants d’accès.

```bash
npx gt init
```

L’assistant définit votre paramètre régional par défaut et vos paramètres régionaux cibles, choisit l’emplacement de stockage des traductions et enregistre votre clé API ainsi que votre ID de projet dans `.env.local`. Consultez [Configurer le CLI](/docs/cli/guides/configuring) pour plus de détails sur la configuration, ou [`gt init`](/docs/cli/reference/commands/init) pour la commande complète.

### 3. Ajoutez votre clé API de production

La commande [`translate`](/docs/cli/reference/commands/translate) nécessite une clé API de production et un ID de projet. L’assistant peut les générer pour vous, ou vous pouvez les créer sur la page [API Keys](https://generaltranslation.com/dashboard). Définissez-les en variables d’environnement pour que la CLI puisse les lire.

```bash title=".env"
GT_API_KEY=your-api-key
GT_PROJECT_ID=your-project-id
```

*Remarque : définissez votre clé API dans une variable d’environnement — ne l’ajoutez jamais à `gt.config.json`.*

### 4. Traduisez votre projet

Exécutez la commande `translate` pour traduire tous les fichiers configurés dans `gt.config.json`, ainsi que les composants inline [`<T>`](/docs/react/reference/components/t) et les entrées de dictionnaire présents dans votre code source.

```bash
npx gt translate
```

Les traductions sont enregistrées dans votre base de code, prêtes à être validées. Exécutez cette commande dans votre pipeline CI avant de lancer votre build de production. Consultez [Génération des traductions](/docs/cli/guides/generating-translations) pour voir le workflow complet.
## Next steps

- /docs/cli/guides/generating-translations
- /docs/cli/guides/configuring
- /docs/cli/guides/managing-translations
- /docs/cli/guides/using-auto-jsx