# 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.

---

`init` è il comando predefinito: se esegui `npx gt` senza specificare alcun comando, viene eseguito.

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 configura il framework (sperimentale). Le app Vite ricevono un bootstrap [`initializeGTSPA`](/docs/react/reference/config#initialize-spa) che viene eseguito prima del punto di ingresso dell'app esistente; le altre app React supportate usano [`GTProvider`](/docs/react/reference/components/gt-provider).
3. Ti chiede le impostazioni regionali predefinite e di destinazione mancanti e crea o aggiorna `gt.config.json`. Le impostazioni esistenti relative alle impostazioni regionali e ai file vengono mantenute. Per l'archiviazione locale di Vite, crea anche un file [`loadTranslations`](/docs/react/reference/functions/load-translations) e file vuoti per le impostazioni regionali di destinazione.
4. Installa `gt` come dipendenza di sviluppo quando il workflow configurato richiede un'installazione persistente della CLI. La configurazione del framework Vite non aggiunge `gt`; continua a eseguirlo con `npx gt`.
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.
* In un monorepo, esegui `init` dalla directory dell&#39;app specifica. Il comando si interrompe senza modificare file quando la directory corrente è la radice di un&#39;area di lavoro con `pnpm-workspace.yaml` o un campo `workspaces`.
* La configurazione automatica non è disponibile per le applicazioni Electron.
* 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).