Il modo migliore per localizzare un’app generata da Claude Code è restare in Claude Code: installa una skill di localizzazione, lascia che l’agente internazionalizzi la codebase e lascia che l’infrastruttura mantenga sincronizzate tutte le lingue da quel momento in poi. globalize.now è un’infrastruttura di localizzazione basata su IA, costruita esattamente per questo loop. Estrae le stringhe hardcoded nelle chiavi di traduzione, genera i file di traduzione e restituisce le lingue tradotte come pull request a ogni push su git. Questa guida mostra l’intero processo, da un repo solo in inglese a una PR multilingue mergiata.

Perché la tua app Claude Code è solo in inglese?

Perché Claude Code, come ogni coding agent, scrive il testo rivolto agli utenti come stringhe letterali. È il percorso più breve per ottenere una feature funzionante e il prompt predefinito non chiede di creare chiavi di traduzione. Quando l’app funziona, l’inglese è hardcoded in centinaia di componenti e plurali e date vengono gestiti con concatenazioni di stringhe che hanno senso in una sola lingua.

La soluzione più allettante è chiedere all’agente di «tradurre l’app in tedesco». Il risultato è una seconda lingua hardcoded: componenti duplicati o una pila di ternari, mentre ogni feature futura raddoppia il lavoro. Abbiamo già parlato di questo anti-pattern in come localizzare un’app generata dall’IA. Tradurre senza internazionalizzare è il modo in cui il debito i18n si accumula.

Qual è il modo migliore per localizzare un’app generata da Claude Code?

Esegui il workflow di localizzazione dentro l’agente che ha costruito l’app: una skill insegna a Claude Code la procedura di internazionalizzazione e l’infrastruttura gestisce traduzione e sincronizzazione dopo ogni push. Le skill sono il formato di estensione supportato da Anthropic per Claude Code: cartelle di istruzioni che l’agente carica quando un’attività corrisponde, come documentato nella documentazione Agent Skills. Sono anche portabili: la skills CLI di Vercel installa pacchetti di skill in Claude Code, Cursor, Codex e decine di altri agenti, così lo stesso workflow viaggia con l’agente che scegli.

È un modello diverso da quello della maggior parte degli strumenti di localizzazione. Le piattaforme consolidate hanno aggiunto feature basate su IA e connettori per agenti sopra un workflow che continua ad avere la dashboard al centro: le stringhe vivono nel loro sistema e l’agente ne è un client. La localizzazione agent-native ribalta il modello. Il lavoro avviene nel tuo repository, l’agente gestisce l’internazionalizzazione e globalize.now gestisce traduzione e sincronizzazione. Non c’è un database di contenuti separato da tenere allineato al codice, perché il codice è il database.

Come si localizza un’app Claude Code, passo dopo passo?

Il loop completo prevede cinque passaggi, e quello più impegnativo lo fa l’agente.

  1. Connetti il repository a globalize.now. La conversione viene eseguita una volta, nell’app, e arriva come pull request. Per eseguire invece questo primo passaggio da Claude Code, installa le skill:

    npx skills add globalize-now/globalize-skills

    Aggiungi --all se vuoi rendere le skill disponibili a ogni agente sulla tua macchina, non solo a Claude Code.

  2. Chiedi a Claude Code di internazionalizzare l’app. Prima la skill fa ispezionare il repo: quale framework usi, quali stringhe sono rivolte agli utenti e se esiste già una configurazione i18n. Propone un piano, la libreria, la struttura delle chiavi e l’organizzazione dei file di traduzione, poi aspetta la tua approvazione prima di toccare il codice.

  3. Connetti il repository a globalize.now per attivare la traduzione a ogni push. La configurazione per sviluppatori richiede una sola connessione, mentre chi costruisce con strumenti basati su IA ottiene lo stesso loop senza toccare il terminale oltre il primo passaggio.

  4. Fai push. Le stringhe nuove e modificate tornano tradotte in una pull request, che revisioni come qualsiasi altra modifica al codice.

  5. Fai merge. Aggiungere un’altra lingua in seguito è una modifica di configurazione, non un progetto.

In un vero monorepo di produzione, un agente eseguito con questo workflow ha internazionalizzato la codebase e prodotto cinque lingue in circa 30 minuti. I tempi variano in base alle dimensioni del progetto, ma è nel passaggio 2 che una settimana di refactoring manuale si riduce a una sessione con l’agente.

Cosa cambia davvero l’agente nel tuo codice?

Converte le stringhe letterali in chiamate di traduzione e genera i file di traduzione necessari al runtime. In concreto: sceglie o rileva una libreria runtime per i18n — i18next, next-intl o Lingui, in base al tuo stack — sostituisce il testo JSX hardcoded con chiamate t() o componenti messaggio, genera chiavi con nomi sensati e scrive il file di traduzione nella lingua sorgente. I plurali diventano vere forme ICU invece di count + " items".

globalize.now non sostituisce la libreria runtime e non traduce passando il lavoro a una coda esterna. Si colloca un livello sopra: l’infrastruttura che genera e mantiene le chiavi e i file di traduzione consumati dal runtime. Se hai già configurato i18next o next-intl, la skill mantiene le chiavi e la struttura esistenti e riparte da dove sei arrivato.

Cosa succede al push successivo su git?

Ogni push dopo la configurazione attiva la traduzione di ciò che è cambiato e le lingue aggiornate arrivano come pull request. Nessun passaggio di export, nessun import, nessuna coda in uno strumento separato. La revisione avviene dove gli ingegneri revisionano già il codice: nel diff.

Questo è l’intero modello operativo. Configuralo una volta e attiva la sincronizzazione automatica a ogni push su git, senza interventi manuali. Il problema tipico delle app costruite con l’IA — l’agente rilascia feature più velocemente di quanto qualsiasi processo di localizzazione riesca a seguirle — diventa irrilevante, perché il processo di localizzazione è agganciato allo stesso push con cui viene rilasciata la feature.

Servono un server MCP o una dashboard?

No. MCP collega un agente a una piattaforma esterna; una skill insegna all’agente a lavorare dove vive il codice. Diversi prodotti di localizzazione offrono oggi server MCP. È un miglioramento concreto rispetto al copia-incolla in un editor web, ma le stringhe e il loro stato continuano a vivere sulla piattaforma dall’altra parte della connessione, e devi comunque riconciliare i due sistemi.

Con il loop skill più push non c’è nulla da riconciliare. I file di traduzione vivono in git, le traduzioni arrivano come commit e il rollback è git revert. Abbiamo spiegato perché questo pattern si sta diffondendo in Le skill di Claude Code stanno diventando lo standard per la localizzazione. Entrambi gli approcci sono migliori dell’era delle dashboard; la differenza sta nella posizione della source of truth.

Quanto costa localizzare un’app Claude Code?

globalize.now costa 20 € al mese per workspace e include 20 € di credito per la traduzione — circa 200.000 parole — ogni mese. Oltre questa soglia, si applica un costo basato sui token alla stessa tariffa per carattere. Un solo piano, nessun tier, nessun costo per seat o per lingua. Lingue illimitate, incluse quelle RTL. Un SaaS tipico con circa 10.000 chiavi di traduzione distribuite su 5 lingue rientra comodamente nel volume incluso.

La registrazione include 5 € di credito per la traduzione e non richiede una carta. Copre circa un milione di caratteri: abbastanza per eseguire l’intero loop su un’app reale prima di pagare qualsiasi cosa.

La tua app è già pronta. Per localizzarla basta installare una skill e fare un push.

globalize.now trasforma il testo hardcoded dell'app in file di localizzazione pronti e li mantiene aggiornati mentre rilasci.

Prova globalize.now gratis