# gt: General Translation CLI tool: gt login
URL: https://generaltranslation.com/it/docs/cli/reference/commands/login.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Accedi al tuo account per i workflow della CLI in hosting. Riferimento API per il comando gt login.

Usa login per autenticare una configurazione esistente. Per una configurazione guidata del progetto, esegui [`gt init`](/docs/cli/reference/commands/init): il comando effettua l&#39;accesso quando crea un progetto o una chiave, se non sono disponibili né una chiave degli strumenti né un login salvato. Per creare una chiave con ambito limitato, usa [`gt api-key create`](/docs/cli/reference/commands/api-key-create).

## Panoramica [#overview]

Richiede [Node.js 20 o versioni successive](/docs/cli/quickstart#quickstart); è preferibile un rilascio LTS ancora supportato.

```bash
npx gt login [options]
```

| Parametro                       | Descrizione                                                                 | Tipo      | Facoltativo | Predefinito      |
| ------------------------------- | --------------------------------------------------------------------------- | --------- | ----------- | ---------------- |
| [`--no-browser`](#flags)        | Usa l'autorizzazione tramite dispositivo anziché un callback locale dal browser.         | `boolean` | Sì          | `false`          |
| [`-c, --config <path>`](#flags) | File di configurazione il cui `baseUrl` determina l&#39;API a cui accedere. | `string`  | Sì          | `gt.config.json` |

<Callout type="info">
  **Modificato nella v2.22:** il precedente comando auth e il relativo flag per il tipo di chiave sono stati rimossi e non sono disponibili come alias. Il login sostituisce l&#39;accesso all&#39;account, mentre init e la creazione esplicita delle chiavi gestiscono il provisioning. Le chiavi API esistenti restano utilizzabili.
</Callout>

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

* Apre il browser per consentirti di approvare l&#39;accesso della CLI al tuo account.
* Le autorizzazioni del tuo account determinano a quali progetti e operazioni puoi accedere.
* Usa l&#39;autorizzazione tramite dispositivo con `--no-browser`, oppure se non riesce a mettersi in ascolto del callback del browser su questa macchina. Mostra un URL di verifica e un codice da approvare su un altro dispositivo.
* Usa automaticamente l&#39;autorizzazione tramite dispositivo nelle sessioni SSH. Il solo mancato avvio del browser non fa cambiare modalità: apri manualmente l&#39;URL di autorizzazione mostrato oppure riesegui il comando con `--no-browser`.
* Salva una sessione dell&#39;account, non la selezione di un progetto. Non crea chiavi API né scrive `.env.local`. Gli SDK di runtime non caricano le sessioni della CLI.

Per l&#39;associazione del progetto, la precedenza delle chiavi esplicite e le credenziali per la CI, consulta [Configurare la CLI](/docs/cli/guides/configuring#credentials).

## Flag [#flags]

**`--no-browser`** · **Tipo** `boolean` · **Facoltativo** · **Predefinito** `false`

Usa l&#39;autorizzazione tramite dispositivo senza aprire un browser. L&#39;approvazione da parte di una persona è comunque necessaria: non si tratta di un&#39;autenticazione CI automatica senza intervento umano.

**`-c, --config <path>`** · **Tipo** `string` · **Facoltativo** · **Predefinito** `gt.config.json`

Legge [`baseUrl`](/docs/cli/reference/config#base-url) da questo file di configurazione anziché dal `gt.config.json` rilevato automaticamente. `GT_API_URL` ha comunque la precedenza. Richiede `gt` 2.23.0 o versioni successive.

Si applicano anche le [opzioni globali](/docs/cli/reference/global-options).

## Esempi [#examples]

```bash
# Accedi tramite il browser di questo computer
npx gt login

# Approva l'accesso da un altro dispositivo
npx gt login --no-browser
```

Dopo l&#39;approvazione, verifica l&#39;account con [`gt whoami`](/docs/cli/reference/commands/whoami). Usa [`gt logout`](/docs/cli/reference/commands/logout) per eliminare la sessione salvata.

## Archiviazione e risoluzione dei problemi [#storage]

Le sessioni vengono salvate in `$XDG_STATE_HOME/gt/credentials.json` se `XDG_STATE_HOME` è un percorso assoluto, altrimenti in `~/.local/state/gt/credentials.json`. I valori XDG relativi vengono ignorati.

Ove supportato, alle credenziali vengono applicate autorizzazioni sui file riservate al solo proprietario; le credenziali non vengono crittografate né archiviate nel portachiavi del sistema operativo. I formati di login salvati nelle versioni precedenti non vengono migrati automaticamente. Se le credenziali salvate sono obsolete o non valide, accedi di nuovo. I file di credenziali danneggiati vengono conservati come backup `.corrupt-<timestamp>`.

La CLI mantiene attivo l&#39;accesso tra un comando e l&#39;altro. Evita di aggiornare lo stesso login salvato da più processi della CLI contemporaneamente.

## Sitemap

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