Faites traduire le texte de l'interface utilisateur par Claude Code pendant qu'il écrit
Une demande de fonctionnalité dans une application Next.js avec trois langues : la configuration, le message du hook, l'appel à localize, les traductions et la vérification, à partir d'une vraie session Claude Code.
Stephen Ufort · 16 novembre 2026 · 5 min de lecture

Claude Code écrit le texte de l'interface utilisateur en anglais, où que la fonctionnalité en ait besoin. Dans une application déjà traduite, chaque nouvelle fonctionnalité laisse quelques chaînes codées en dur. Cet article suit une demande de fonctionnalité dans une application Next.js avec l'espagnol, l'allemand et le français, de la configuration à la vérification réussie, avec les commandes et la sortie réelles.
L'application est l'application de notes de l'article sur l'ajout d'i18n à une application Next.js App Router en une seule pull request. Elle dispose déjà d'i18next, de fichiers de locale et d'un sélecteur de langue. Le fonctionnement interne du serveur MCP et du hook se trouve dans l'article sur la localisation pendant que votre agent de codage écrit ; celui-ci les montre sur un changement réel.
Configurez-le
Une commande ajoute le serveur MCP, le hook après édition et les instructions pour l'agent :
$ 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.Le hook va dans .claude/settings.json. Après chaque Édition, MultiÉdition ou Écriture, Claude Code exécute localize-dev hook sur le fichier que l'agent a modifié :
{
"hooks": {
"PostToolUse": [
{
"matcher": "Edit|MultiEdit|Write",
"hooks": [
{
"type": "command",
"command": "npx -y localize-dev hook",
"timeout": 60
}
]
}
]
}
}AGENTS.md obtient une courte section, et CLAUDE.md l'importe, afin que Claude Code la lise au début de chaque session :
## 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.Validez les fichiers pour que le reste de l'équipe et leurs agents les obtiennent également. Redémarrez ensuite Claude Code pour qu'il démarre le serveur MCP.
Demander une fonctionnalité
Ceci est la requête entière. Elle ne mentionne pas de traductions :
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 a lu le code des notes, puis a écrit une action serveur qui supprime une note, une fonction de suppression dans la couche de données, et le nouveau NoteList : un bouton Supprimer sur chaque note, une confirmation dans la ligne, un message après la suppression et un message d'erreur en cas d'échec. Ce premier brouillon contenait sept éléments de texte en anglais.
Ce que le hook voit
Voici ce que le hook imprime pour ce premier brouillon. Il a trouvé les sept, y compris le aria-label et les deux littéraux de modèle :
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.tsxLe hook se termine avec le code 2, Claude Code affiche donc ce message à l'agent. Un fichier sans rien à traduire se termine avec le code 0 et n'imprime rien. Pour désactiver le hook pour une session, définissez LOCALIZE_DEV_HOOK=off.
L'appel localize
Juste après avoir écrit le composant, l'agent a appelé l'outil localize avec ce chemin. Voici l'appel et les statistiques de son résultat :
localize({ "paths": ["components/NoteList.tsx"] })
"stats": {
"filesScanned": 1,
"stringsReplaced": 7,
"newKeys": 6,
"reusedKeys": 1,
"translations": { "es": 6, "de": 6, "fr": 6 }
}Sept chaînes sont devenues six clés : les deux boutons Supprimer partagent note_list.delete_button. Les littéraux de modèle sont devenus des messages avec des espaces réservés, de sorte que Delete "${n.title}" est maintenant un message avec un espace réservé title, et une langue peut placer le titre où sa grammaire le nécessite. La ligne de confirmation ressemble maintenant à ceci :
{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>
)}Les traductions
Le même appel rempli en espagnol, allemand et français. Voici les ajouts allemands :
"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"L'allemand utilise ses propres guillemets et le vouvoiement formel (« Versuchen Sie es erneut »), comme le reste de l'application. Le français a reçu « » avec des espaces à l'intérieur. L'espagnol utilise tú, comme dans les messages précédents :
"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}}\""L'agent n'a écrit aucun de ceux-ci à la main. La section dans AGENTS.md lui demande de laisser tranquilles les fichiers de langue des autres langues, et il l'a fait.
Vérifié avant qu'il ait terminé
Avant de déclarer que c'était fait, l'agent a exécuté la vérification, puis le vérificateur de types et le linter :
$ npx localize-dev check --changed
✅ Everything is localized (1 files scanned).Son résumé disait trois choses utiles. Il a intégré la confirmation dans la ligne au lieu d'utiliser la fenêtre contextuelle du navigateur, de sorte que le texte puisse être traduit. Les notes supprimées reviennent lorsque le serveur redémarre, car la couche de données est un substitut. Et il n'avait pas essayé la fonctionnalité dans un navigateur. Essayez vous-même avant de fusionner : la vérification couvre le texte, pas si la suppression fonctionne.
Curseur et autres agents
Cursor obtient le même serveur MCP dans .cursor/mcp.json et une règle dans .cursor/rules/localize.mdc pour les fichiers d'interface utilisateur de l'application. init --agent n'ajoute aucun hook pour Cursor, donc la règle est ce qui demande à l'agent d'appeler localize. D'autres agents qui lisent AGENTS.md reçoivent les mêmes instructions, et un agent sans MCP peut exécuter npx localize-dev run --files avec les fichiers qu'il a modifiés.
Pour les modifications effectuées sans agent, npx localize-dev init --agent --pre-commit vérifie également les fichiers préparés avant chaque commit, et npx localize-dev check dans CI échoue une pull request avec du texte codé en dur. Aucun des deux n'a besoin d'une clé API.
Quelqu'un qui lit chaque langue devrait toujours examiner les fichiers de langue dans la différence. L'exécution conserve une forme d'adresse par langue, mais seul un lecteur sait si « Löschen » est le mot que vos utilisateurs allemands attendent sur ce bouton.
Essayez-le sur votre propre code dans le terrain de jeu, aucun compte requis