localize.dev

Documenti / Agenti / Codex

Localizza un'app con Codex

Aggiungi localize.dev a ~/.codex/config.toml in modo che OpenAI Codex possa trovare il testo dell'interfaccia utente codificato, assegnargli chiavi e tradurlo, sia nella CLI che nell'estensione IDE.

Come funziona

Codex legge i server MCP da ~/.codex/config.toml, e la CLI e l'estensione IDE condividono quel file. Aggiungi la tabella [mcp_servers.localize] una volta ed entrambi potranno chiamare gli strumenti di localize.dev.

Codex segue AGENTS.md. npx localize-dev init --agent aggiunge una sezione lì che gli dice di chiamare localize dopo aver modificato il testo dell'interfaccia utente e di eseguire npx localize-dev check --changed prima che finisca.

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. Aggiungi la tabella [mcp_servers.localize] a ~/.codex/config.toml.
  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.
~/.codex/config.toml
[mcp_servers.localize]
command = "npx"
args = ["-y", "localize-dev", "mcp"]

Cosa ottieni

Dove va il server
~/.codex/config.toml
Server
localize-dev mcp, avviato con npx sulla tua macchina
Chiave
Quello che npx localize-dev login ha salvato
Cosa aggiunge init --agent
La sezione AGENTS.md con le istruzioni. Aggiungi il server manualmente, come sopra.

Buono a sapersi

  • Il file di configurazione è TOML, non JSON: command e args vanno sotto [mcp_servers.localize].
  • Codex non riceve un hook post-modifica. La sezione AGENTS.md e un check in CI catturano il testo che lascia codificato.
  • Inizia con un prompt di sola lettura: chiedi a Codex di eseguire check prima di aprire una pull request. check e config non necessitano di chiave e non utilizzano mai la tua quota.

Provalo

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

“Prima di aprire la PR, verifica la presenza di testo hardcoded e traduzioni mancanti.”

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.