Haz que Claude Code traduzca el texto de la interfaz de usuario mientras escribe
Una solicitud de función en una aplicación Next.js con tres idiomas: la configuración, el mensaje del hook, la llamada a localize, las traducciones y la verificación, de una sesión real de Claude Code.
Stephen Ufort · 16 de noviembre de 2026 · 5 min de lectura

Claude Code escribe texto de interfaz de usuario en inglés, donde la función lo necesite. En una aplicación que ya está traducida, cada nueva función deja algunas cadenas codificadas de forma rígida. Esta publicación sigue una solicitud de función en una aplicación Next.js con español, alemán y francés, desde la configuración hasta la verificación exitosa, con los comandos y la salida reales.
La aplicación es la aplicación de notas de la publicación sobre cómo agregar i18n a una aplicación Next.js App Router en una sola solicitud de extracción. Ya tiene i18next, archivos de localización y un selector de idioma. Cómo funcionan internamente el servidor MCP y el hook se encuentra en la publicación sobre localización mientras su agente de codificación escribe; este muestra cómo funcionan en un cambio real.
Configúralo
Un comando agrega el servidor MCP, el hook posterior a la edición y las instrucciones para el agente:
$ npx localize-dev init --agent
🤖 Wrote .mcp.json
🤖 Wrote .cursor/mcp.json
🤖 Wrote .claude/settings.json
🤖 Wrote AGENTS.md
🤖 Wrote CLAUDE.md
🤖 Wrote .cursor/rules/localize.mdc
Commit these so everyone working on the project, and their agents, gets them. Restart the agent to load the MCP server.El hook va en .claude/settings.json. Después de cada Edición, MultiEdición o Escritura, Claude Code ejecuta localize-dev hook en el archivo que el agente cambió:
{
"hooks": {
"PostToolUse": [
{
"matcher": "Edit|MultiEdit|Write",
"hooks": [
{
"type": "command",
"command": "npx -y localize-dev hook",
"timeout": 60
}
]
}
]
}
}AGENTS.md obtiene una sección corta, y CLAUDE.md la importa, para que Claude Code la lea al inicio de cada sesión:
## Translations (localize.dev)
The UI text is translated with localize.dev, so text people see goes through the i18n library and isn't hardcoded.
- After adding or changing UI text, call the `localize` tool of the localize-dev MCP server with the files you changed (`paths`, relative to the source folder `src`). It gives the text keys, rewrites the code and translates the new messages. Without the MCP server, run `npx localize-dev run --files <files>`.
- Before finishing, run `npx localize-dev check --changed`. It should pass.
- Leave new messages out of the other languages' locale files: localize fills them in. Fixing a translation that's wrong is fine.Confirma los archivos para que el resto del equipo y sus agentes también los obtengan. Luego reinicia Claude Code para que inicie el servidor MCP.
Solicita una función
Esta es la solicitud completa. No menciona traducciones:
Add a delete button to each note in the notes list. Ask for confirmation before removing a note, and show a short message after it's deleted.Claude Code leyó el código de las notas, luego escribió una acción de servidor que elimina una nota, una función de eliminación en la capa de datos y el nuevo NoteList: un botón Eliminar en cada nota, una confirmación dentro de la fila, un mensaje después de la eliminación y un mensaje de error si falla. Ese primer borrador tenía siete fragmentos de texto en inglés.
Lo que ve el hook
Aquí está lo que el hook imprime para ese primer borrador. Encontró los siete, incluido el aria-label y los dos literales de plantilla:
localize.dev: src/components/NoteList.tsx has UI text that isn't translated yet.
line 41: "Deleted "{deletedTitle}"."
line 43: "Couldn't delete the note. Try again."
line 54: "Delete "{title}"?"
line 56: "Delete"
line 59: "Cancel"
line 63: "Delete "{title}""
line 64: "Delete"
Call the localize tool of the localize-dev MCP server with paths ["components/NoteList.tsx"]: it gives this text translation keys, rewrites the code and translates it.
Without the MCP server, run in the project folder: npx localize-dev run --files src/components/NoteList.tsxEl hook sale con el código 2, por lo que Claude Code muestra este mensaje al agente. Un archivo sin nada que traducir sale con el código 0 y no imprime nada. Para desactivar el hook durante una sesión, establezca LOCALIZE_DEV_HOOK=off.
La llamada a localize
Justo después de escribir el componente, el agente llamó a la herramienta localize con esa ruta. Estas son la llamada y las estadísticas de su resultado:
localize({ "paths": ["components/NoteList.tsx"] })
"stats": {
"filesScanned": 1,
"stringsReplaced": 7,
"newKeys": 6,
"reusedKeys": 1,
"translations": { "es": 6, "de": 6, "fr": 6 }
}Siete cadenas se convirtieron en seis claves: los dos botones Eliminar comparten note_list.delete_button. Los literales de plantilla se convirtieron en mensajes con marcadores de posición, por lo que Delete "${n.title}" es ahora un mensaje con un marcador de posición title, y un idioma puede colocar el título donde su gramática lo necesite. La fila de confirmación ahora se ve así:
{confirmingId === n.id ? (
<div className="flex items-center gap-2 text-sm">
<span>{t('note_list.delete_note_confirmation', { title: n.title })}</span>
<button type="button" onClick={() => remove(n)} disabled={pending} className="rounded bg-red-600 px-3 py-1 text-white disabled:opacity-50">
{t('note_list.delete_button')}
</button>
<button type="button" onClick={() => setConfirmingId(null)} disabled={pending} className="rounded border px-3 py-1">
{t('note_list.cancel')}
</button>
</div>
) : (
<button type="button" onClick={() => { setConfirmingId(n.id); setFailed(false); }} aria-label={t('note_list.delete_note_button_label', { title: n.title })} className="rounded border px-3 py-1 text-sm text-red-600">
{t('note_list.delete_button')}
</button>
)}Las traducciones
La misma llamada completada en español, alemán y francés. Estas son las adiciones alemanas:
"deleted_note_message": "„{{deletedTitle}}“ gelöscht.",
"delete_note_error": "Die Notiz konnte nicht gelöscht werden. Versuchen Sie es erneut.",
"delete_note_confirmation": "„{{title}}“ löschen?",
"delete_button": "Löschen",
"cancel": "Abbrechen",
"delete_note_button_label": "„{{title}}“ löschen"El alemán usa sus propias comillas y el Sie formal ("Versuchen Sie es erneut"), igual que el resto de la app. El francés recibió « » con espacios dentro. El español usa tú, como en los mensajes anteriores:
"deleted_note_message": "Se eliminó \"{{deletedTitle}}\".",
"delete_note_error": "No se pudo eliminar la nota. Inténtalo de nuevo.",
"delete_note_confirmation": "¿Eliminar \"{{title}}\"?",
"delete_button": "Eliminar",
"cancel": "Cancelar",
"delete_note_button_label": "Eliminar \"{{title}}\""El agente no escribió ninguno de estos a mano. La sección en AGENTS.md le pide que deje en paz los archivos de localización de otros idiomas, y lo hizo.
Comprobado antes de que terminara
Antes de decir que estaba hecho, el agente ejecutó la comprobación, luego el verificador de tipos y el linter:
$ npx localize-dev check --changed
✅ Everything is localized (1 files scanned).Su resumen decía tres cosas útiles. Incorporó la confirmación en la fila en lugar de usar la ventana emergente del navegador, por lo que el texto se puede traducir. Las notas eliminadas vuelven cuando se reinicia el servidor, porque la capa de datos es un sustituto. Y no había probado la función en un navegador. Pruébalo tú mismo antes de fusionar: la comprobación cubre el texto, no si la eliminación funciona.
Cursor y otros agentes
Cursor obtiene el mismo servidor MCP en .cursor/mcp.json y una regla en .cursor/rules/localize.mdc para los archivos de interfaz de usuario de la aplicación. init --agent no agrega ningún hook para Cursor, por lo que la regla es lo que le pide al agente que llame a localize. Otros agentes que leen AGENTS.md obtienen las mismas instrucciones, y un agente sin MCP puede ejecutar npx localize-dev run --files con los archivos que cambió.
Para los cambios realizados sin un agente, npx localize-dev init --agent --pre-commit también verifica los archivos preparados antes de cada commit, y npx localize-dev check en CI falla una solicitud de extracción con texto codificado. Ninguno de los dos necesita una clave API.
Alguien que lea cada idioma todavía debería mirar los archivos de localización en la diferencia. La ejecución mantiene una forma de dirigirse por idioma, pero solo un lector sabe si "Löschen" es la palabra que sus usuarios alemanes esperan en ese botón.
Pruébalo en tu propio código en la zona de juegos, no se necesita cuenta