localize.dev

Documenti / Agenti / Claude Code

Localizza un'app con Claude Code

Aggiungi il server MCP di localize.dev e l'hook post-modifica a Claude Code, in modo che il nuovo testo dell'interfaccia utente ottenga chiavi di traduzione e traduzioni mentre Claude scrive il codice.

Come funziona

Claude Code può scrivere codice i18n, ma non sa quali stringhe ha perso o di cosa hanno bisogno le tue altre lingue. Con il server MCP di localize.dev chiama localize sui file che ha modificato: il testo ottiene chiavi, il codice viene riscritto nella tua libreria i18n e i nuovi messaggi vengono tradotti in ogni lingua in cui l'app viene distribuita.

npx localize-dev init --agent aggiunge il server a .mcp.json e un hook post-modifica a .claude/settings.json. Dopo ogni modifica, l'hook esamina il file toccato da Claude e, quando trova testo non tradotto, dice a Claude di chiamare localize, in modo che nessuno debba ricordarsi di chiedere.

Configuralo

Esegui prima npx localize-dev login nel tuo terminale. Ti autentica tramite il browser e salva una chiave, che il server legge, quindi la configurazione sottostante non ne contiene nessuna.

  1. Esegui claude mcp add nel tuo repository.
  2. Riavvia l'agente o ricarica i suoi server MCP, in modo che avvii localize.
  3. Apri il tuo repository e chiedigli qualcosa come il prompt qui sotto.
terminal
claude mcp add localize -- npx -y localize-dev mcp

# Share it with your team through .mcp.json
claude mcp add --scope project localize -- npx -y localize-dev mcp

# Or the server, the after-edit hook and AGENTS.md in one go
npx localize-dev init --agent
O installa il plugin
claude plugin marketplace add ufortstephen/localize-dev
claude plugin install localize-dev@uselocalize

Cosa ottieni

Dove va il server
.mcp.json
Server
localize-dev mcp, avviato con npx sulla tua macchina
Chiave
Quello che npx localize-dev login ha salvato
Cosa aggiunge init --agent
Il server in .mcp.json, l'hook post-modifica in .claude/settings.json e la sezione AGENTS.md

Buono a sapersi

  • Il plugin è l'altro modo per entrare. Aggiunge il server e un'abilità che dice a Claude quando usarlo, e lascia il repository in pace.
  • L'hook esegue npx localize-dev hook dopo Modifica, Modifica multipla e Scrittura. Esegue solo la scansione, quindi non necessita di chiavi e non utilizza la tua quota. Imposta LOCALIZE_DEV_HOOK=off per metterlo in pausa.
  • Claude Code legge CLAUDE.md, non AGENTS.md. Quando il repository non ha CLAUDE.md, init --agent ne crea uno che importa AGENTS.md, in modo che entrambi gli agenti seguano le stesse istruzioni.

Provalo

Chiedi qualcosa del genere. L'agente dovrebbe chiamare lo strumento localize.

“Localizza src/components/Checkout.tsx in spagnolo e francese.”

Mantienilo tradotto

Il testo che l'agente lascia hardcoded viene comunque rilevato: npx localize-dev check in CI fallisce una pull request che aggiunge testo non tradotto e non necessita di una chiave.

npx localize-dev check

Tutti gli agenti e il riferimento allo strumento si trovano nella pagina del server MCP.