# gt-node: General Translation Node.js SDK: Configurare gt-node
URL: https://generaltranslation.com/it/docs/node/guides/configuring.mdx
---
title: Configurare gt-node
description: "Come inizializzare General Translation gt-node: questa guida illustra locales, credenziali e distribuzione delle traduzioni."
related:
  links:
    - /docs/node/guides/translating-strings
    - /docs/node/guides/detecting-locale
    - /docs/node/guides/storing-translations

---

`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` o le variabili d'ambiente. Passa ogni valore esplicitamente.*

## Inizializzazione all'avvio [#initialize]

Chiama `initializeGT` 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'],
  projectId: process.env.GT_PROJECT_ID,
});
```

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

## Aggiungi le credenziali [#credentials]

Imposta l'ID progetto e la chiave API come variabili d'ambiente e passali. Usa la chiave di sviluppo durante lo sviluppo e la chiave di produzione in produzione.

```ts title="server.js"
initializeGT({
  defaultLocale: 'en',
  locales: ['en', 'es', 'fr'],
  projectId: process.env.GT_PROJECT_ID,
  devApiKey: process.env.NODE_ENV !== 'production' ? process.env.GT_API_KEY : undefined,
  apiKey: process.env.NODE_ENV === 'production' ? process.env.GT_API_KEY : undefined,
});
```

In fase di sviluppo, un `projectId` 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` 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