localize.dev

Documentación / Agentes / Claude Code

Localizar una aplicación con Claude Code

Agregue el servidor MCP de localize.dev y el hook posterior a la edición a Claude Code, para que el nuevo texto de la interfaz de usuario obtenga claves de traducción y traducciones mientras Claude escribe el código.

Cómo funciona

Claude Code puede escribir código i18n, pero no sabe qué cadenas omitió o qué necesitan tus otros idiomas. Con el servidor MCP de localize.dev llama a localize en los archivos que cambió: el texto obtiene claves, el código se reescribe en tu biblioteca i18n y los nuevos mensajes se traducen a todos los idiomas en los que se envía la aplicación.

npx localize-dev init --agent agrega el servidor a .mcp.json y un hook posterior a la edición a .claude/settings.json. Después de cada edición, el hook escanea el archivo que Claude tocó, y cuando encuentra texto que no está traducido, le dice a Claude que llame a localize, para que nadie tenga que recordar preguntar.

Configúralo

Primero ejecuta npx localize-dev login en tu terminal. Te inicia sesión a través del navegador y guarda una clave, que el servidor lee, por lo que la configuración a continuación no lleva ninguna.

  1. Ejecuta claude mcp add en tu repositorio.
  2. Reinicia el agente o recarga sus servidores MCP para que comience a localizar.
  3. Abre tu repositorio y pídele algo similar a la indicación de abajo.
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 instala el plugin
claude plugin marketplace add ufortstephen/localize-dev
claude plugin install localize-dev@uselocalize

Lo que obtienes

Dónde va el servidor
.mcp.json
Servidor
localize-dev mcp, iniciado con npx en tu máquina
Clave
El que guardó npx localize-dev login
Lo que añade init --agent
El servidor en .mcp.json, el hook posterior a la edición en .claude/settings.json y la sección AGENTS.md

Bueno saberlo

  • El plugin es la otra forma de entrar. Agrega el servidor y una habilidad que le dice a Claude cuándo usarlo, y deja el repositorio en paz.
  • El hook ejecuta npx localize-dev hook después de Editar, MultiEditar y Escribir. Solo escanea, por lo que no necesita clave y no utiliza ninguna de tu asignación. Establece LOCALIZE_DEV_HOOK=off para pausarlo.
  • Claude Code lee CLAUDE.md, no AGENTS.md. Cuando el repositorio no tiene CLAUDE.md, init --agent crea uno que importa AGENTS.md, para que ambos agentes sigan las mismas instrucciones.

Pruébalo

Pregunta algo como esto. El agente debería llamar a la herramienta localize.

“Localiza src/components/Checkout.tsx en español y francés.”

Mantenlo traducido

El texto que el agente deja codificado aún se detecta: npx localize-dev check en CI falla una solicitud de extracción que agrega una copia no traducida, y no necesita una clave.

npx localize-dev check

Todos los agentes y la referencia de herramientas están en la página del servidor MCP.