localize.dev

Docs / Agents / Claude Code

Localiser une application avec Claude Code

Ajoutez le serveur MCP localize.dev et le hook après édition à Claude Code, afin que le nouveau texte de l'interface utilisateur obtienne des clés de traduction et des traductions pendant que Claude écrit le code.

Comment ça marche

Claude Code peut écrire du code i18n, mais il ne sait pas quelles chaînes il a manquées ou ce dont vos autres langues ont besoin. Avec le serveur MCP localize.dev, il appelle localize sur les fichiers qu'il a modifiés : le texte obtient des clés, le code est réécrit dans votre bibliothèque i18n et les nouveaux messages sont traduits dans chaque langue dans laquelle l'application est livrée.

npx localize-dev init --agent ajoute le serveur à .mcp.json et un hook après édition à .claude/settings.json. Après chaque modification, le hook analyse le fichier que Claude a touché, et lorsqu'il trouve du texte non traduit, il indique à Claude d'appeler localize, afin que personne n'ait à se souvenir de demander.

Configurez-le

Exécutez d'abord npx localize-dev login dans votre terminal. Il vous connecte via le navigateur et enregistre une clé, que le serveur lit, de sorte que la configuration ci-dessous n'en contient aucune.

  1. Exécutez claude mcp add dans votre dépôt.
  2. Redémarrez l'agent ou rechargez ses serveurs MCP pour qu'il commence à localiser.
  3. Ouvrez votre dépôt et demandez-lui quelque chose de similaire à l'invite ci-dessous.
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
Ou installez le plugin
claude plugin marketplace add ufortstephen/localize-dev
claude plugin install localize-dev@uselocalize

Ce que vous obtenez

Où va le serveur
.mcp.json
Serveur
localize-dev mcp, démarré avec npx sur votre machine
Clé
Celui que npx localize-dev login a sauvegardé
Ce que init --agent ajoute
Le serveur dans .mcp.json, le hook après édition dans .claude/settings.json et la section AGENTS.md

Bon à savoir

  • Le plugin est l'autre moyen d'entrer. Il ajoute le serveur et une compétence qui indique à Claude quand l'utiliser, et laisse le dépôt tranquille.
  • Le hook exécute npx localize-dev hook après Édition, Édition multiple et Écriture. Il analyse uniquement, il n'a donc pas besoin de clé et n'utilise aucune de votre allocation. Définissez LOCALIZE_DEV_HOOK=off pour le mettre en pause.
  • Claude Code lit CLAUDE.md, pas AGENTS.md. Lorsque le dépôt n'a pas de CLAUDE.md, init --agent en crée un qui importe AGENTS.md, afin que les deux agents suivent les mêmes instructions.

Essayez

Demandez quelque chose comme ceci. L'agent doit appeler l'outil localize.

“Localisez src/components/Checkout.tsx en espagnol et en français.”

Gardez-le traduit

Le texte que l'agent laisse codé en dur est toujours détecté : npx localize-dev check dans CI échoue une demande de tirage qui ajoute une copie non traduite, et elle n'a pas besoin de clé.

npx localize-dev check

Tous les agents et la référence de l'outil se trouvent sur la page du serveur MCP.