# gt-node: General Translation Node.js SDK: Configurare gt-node
URL: https://generaltranslation.com/it/docs/node/guides/configuring.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Come inizializzare General Translation gt-node con locales, credenziali e distribuzione delle traduzioni.

`gt-node` si configura interamente tramite la chiamata a [`initializeGT`](/docs/node/reference/functions/initialize-gt), che esegui una volta all'avvio. Questa guida spiega quali valori passare e come vengono fornite le traduzioni.

*Nota: a differenza di `gt-next`, `gt-node` non legge automaticamente `gt.config.json` — importa esplicitamente quel file per condividere le relative impostazioni regionali con il runtime. Legge invece `GT_PROJECT_ID`, `GT_API_KEY` e `GT_DEV_API_KEY` come credenziali di fallback.*

## Inizializzazione all'avvio [#initialize]

Chiama [`initializeGT`](/docs/node/reference/functions/initialize-gt) una sola volta, prima di gestire qualsiasi richiesta, con le tue locales e le credenziali.

```ts title="server.js"
import { initializeGT } from 'gt-node';

initializeGT({
  defaultLocale: 'en',
  locales: ['en', 'es', 'fr'],
});
```

Per mantenere i valori sincronizzati con la CLI, importa il tuo `gt.config.json` e includi i suoi campi nella chiamata tramite spread.

## Aggiungi le credenziali [#credentials]

Imposta l'ID progetto e le chiavi API nell'ambiente in cui viene eseguito il servizio. [`initializeGT`](/docs/node/reference/functions/initialize-gt) le utilizza quando ometti i campi corrispondenti:

```bash
export GT_PROJECT_ID="your-project-id"
export GT_DEV_API_KEY="gtx-dev-..."
export GT_API_KEY="gtx-api-..."
```

I valori passati direttamente a [`initializeGT`](/docs/node/reference/functions/initialize-gt) hanno la precedenza sulle variabili d'ambiente. Se un valore esplicito è vuoto, viene usato il valore dell'ambiente.

In fase di sviluppo, un ID progetto e una chiave API di sviluppo consentono la traduzione su richiesta e l'hot reload, così le nuove stringhe vengono tradotte man mano che lavori. In produzione, le traduzioni provengono dai file pre-generati o dal CDN. Consulta il [riferimento della configurazione](/docs/node/reference/config) per tutte le opzioni.

## Scegli come vengono fornite le traduzioni [#delivery]

`gt-node` recupera le traduzioni in una di queste modalità:

* **General Translation CDN:** fornisci un `projectId` (senza un loader personalizzato) per recuperare le traduzioni dalla CDN di GT.
* **File locali:** fornisci un callback [`loadTranslations`](/docs/react/reference/functions/load-translations) che restituisce le traduzioni per un'impostazione regionale. Vedi [Memorizzare le traduzioni localmente](/docs/node/guides/storing-translations).
* **Endpoint personalizzato:** imposta un `cacheUrl` personalizzato per caricare le traduzioni dal tuo host, oppure `null` per disattivare il caricamento remoto.

## Gestire le traduzioni mancanti [#missing]

Quando manca una traduzione, `gt-node` restituisce la stringa sorgente interpolata con le tue variabili invece di generare un errore, così una richiesta produce sempre un risultato. Le ricerche nel dizionario tramite [`getTranslations`](/docs/node/reference/functions/get-translations) sono l'eccezione: un id di dizionario sconosciuto genera un errore. Mantieni i valori di [`initializeGT`](/docs/node/reference/functions/initialize-gt) allineati con quelli generati dalla CLI, così in produzione le traduzioni saranno pronte.

## Next steps

- /docs/node/guides/translating-strings
- /docs/node/guides/detecting-locale
- /docs/node/guides/storing-translations

## Sitemap

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