# gt: General Translation CLI tool: CLI di traduzione
URL: https://generaltranslation.com/it/docs/cli.mdx
---
title: CLI di traduzione
description: Configura e traduci il tuo progetto con lo strumento CLI di General Translation
---

## Panoramica

Lo strumento CLI di General Translation (`gt`) ti consente di configurare l'internazionalizzazione e tradurre automaticamente il tuo progetto in una qualsiasi delle [lingue supportate](/docs/platform/supported-locales).

Funziona con [`gt-next`](/docs/next), [`gt-react`](/docs/react), [`gt-react-native`](/docs/react-native) e con librerie i18n di terze parti come `next-intl` e `i18next`. Puoi anche usarlo per tradurre file autonomi (JSON, MDX, HTML e altro).

## Quickstart

### 1. Configura il tuo progetto

```bash
npx gt@latest
```

Questo avvia l'assistente di setup, che:

* Installa le dipendenze necessarie (ad esempio `gt-next` o `gt-react`)
* Configura il tuo framework (plugin Next.js, provider React, ecc.)
* Crea un `gt.config.json` con le tue impostazioni regionali e le impostazioni dei file
* Genera le credenziali API


### 2. translate

```bash
npx gt translate
```

Questo comando traduce il tuo progetto usando l'API di General Translation. Eseguilo nella pipeline CI/CD **prima** della build di produzione.

<Callout type="info">
  **Nota:** Per il comando `translate` è necessaria una chiave API di produzione. L&#39;assistente di setup può generarne una per te, oppure puoi ottenerne una su [generaltranslation.com](https://generaltranslation.com).
</Callout>

Ecco fatto: bastano due comandi per passare da un progetto in una sola lingua a uno completamente tradotto.


## Comandi

| Comando                                     | Descrizione                                                                                                       |
| ------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| [`npx gt@latest`](/docs/cli/init)           | Esegui l&#39;assistente di setup. Installa le dipendenze, configura il progetto e genera le credenziali. |
| [`npx gt translate`](/docs/cli/translate)   | Traduci il progetto tramite l&#39;API di GT.                                                                      |
| [`npx gt configure`](/docs/cli/configure)   | Aggiorna la configurazione GT del progetto (`gt.config.json`).                                                    |
| [`npx gt auth`](/docs/cli/auth)             | Genera o aggiorna le credenziali API.                                                                             |
| [`npx gt generate`](/docs/cli/generate)     | Genera un file JSON con i dati di traduzione per l&#39;uso autonomo.                                              |
| [`npx gt upload`](/docs/cli/upload)         | Carica i file di origine e le traduzioni sulla piattaforma GT.                                                    |
| [`npx gt enqueue`](/docs/cli/enqueue)       | Metti in coda i file per la traduzione senza scaricare i risultati.                                               |
| [`npx gt download`](/docs/cli/download)     | Scarica le traduzioni precedentemente messe in coda o passate allo stage.                                         |
| [`npx gt stage`](/docs/cli/stage)           | Prepara le traduzioni per la revisione umana prima della pubblicazione.                                           |
| [`npx gt save-local`](/docs/cli/save-local) | Salva sulla piattaforma GT le modifiche locali alle traduzioni.                                                   |

## Guide

| Guida                            | Descrizione                                                          |
| -------------------------------- | -------------------------------------------------------------------- |
| [Branching](/docs/cli/branching) | Tieni traccia delle traduzioni separatamente per diversi branch Git. |
| [FAQ](/docs/cli/faqs)            | Domande comuni sullo strumento CLI.                                  |

## Formati supportati

La CLI può tradurre file in vari formati:

[GT](/docs/cli/formats/gt) · [JSON](/docs/cli/formats/json) · [MDX](/docs/cli/formats/mdx) · [TypeScript/JavaScript](/docs/cli/formats/ts) · [YAML](/docs/cli/formats/yaml) · [PO/POT](/docs/cli/formats/po) · [HTML](/docs/cli/formats/html) · [Testo semplice](/docs/cli/formats/txt)