# gt: General Translation CLI tool: gt init
URL: https://generaltranslation.com/it/docs/cli/reference/commands/init.mdx
---
title: gt init
description: Esegui la procedura guidata di configurazione di General Translation per impostare un progetto. Riferimento API per il comando gt init.

---

Avvia la procedura guidata di configurazione che prepara un progetto per General Translation. Questo è il comando predefinito: se esegui `npx gt` senza specificare alcun comando, viene avviato `init`.

La procedura guidata rileva il framework in uso e, a seconda del progetto, installa le dipendenze, configura il framework, crea un `gt.config.json` e genera le credenziali. Per una guida passo passo, consulta [Configurazione della CLI](/docs/cli/guides/configuring).

```bash
npx gt init
```

## Come funziona [#how-it-works]

1. Rileva il tuo framework. Per un progetto Next.js App Router o Mintlify, propone invece di collegare l'AI Agent [Locadex](/docs/platform/locadex/quickstart).
2. Per un progetto basato su React, installa facoltativamente `gt-react` o `gt-next` e aggiunge `GTProvider` (sperimentale).
3. Ti chiede l'impostazione regionale predefinita e quelle di destinazione e crea `gt.config.json`. Per l'archiviazione locale, crea anche un file [`loadTranslations`](/docs/react/reference/functions/load-translations).
4. Installa `gt` come dipendenza di sviluppo se non è già installato.
5. Facoltativamente, genera una chiave API e un ID progetto e li scrive in `.env.local`.

*Nota: il passaggio di configurazione di React è sperimentale e potrebbe non funzionare per tutti i progetti. Verifica le modifiche apportate.*

## Opzioni [#flags]

| Parametro             | Descrizione                                       | Tipo       | Facoltativo | Predefinito                                      |
| --------------------- | ------------------------------------------------- | ---------- | ----------- | ------------------------------------------------ |
| `--src <paths...>`    | Pattern glob per il codice sorgente dell&#39;app. | `string[]` | Sì          | pattern glob `src`, `app`, `pages`, `components` |
| `-c, --config <path>` | Percorso del file di configurazione.              | `string`   | Sì          | `gt.config.json`                                 |

## Esempio [#example]

```bash
# Esegui la procedura guidata di configurazione completa
npx gt init

# Eseguire gt senza alcun comando produce lo stesso risultato
npx gt
```

## Altre note [#notes]

* `init` esegue gli stessi passaggi di [`gt configure`](/docs/cli/reference/commands/configure) e [`gt auth`](/docs/cli/reference/commands/auth), oltre alla procedura guidata sperimentale di configurazione di React. Esegui ciascun comando singolarmente per ripetere solo quel passaggio. Non esegue [`gt setup`](/docs/cli/reference/commands/setup), che carica i tuoi file sorgente.
* La chiave API e l’ID progetto non sono necessari per usare `gt-react` o `gt-next` — servono solo per chiamare l’API di General Translation.
* Se la configurazione sperimentale di React non funziona per il tuo progetto, configura React manualmente usando la documentazione di [React](/docs/react/react-quickstart).