Blog

Lokalisierung, während Ihr Coding-Agent schreibt

Der localize.dev MCP-Server und ein After-Edit-Hook ermöglichen es Claude Code, Cursor und anderen Agenten, neue UI-Texte in derselben Änderung zu übersetzen, in der sie hinzugefügt werden.

Stephen Ufort · 11. November 2026 · 3 Min. Lesezeit

Claude Code ruft das localize MCP-Tool auf, um eine Zeile zu reparieren, die die i18n-Prüfung nicht bestanden hat

Coding-Agenten schreiben UI-Texte schnell, und fast alle davon sind hartcodiertes Englisch. Eine App, die letzten Monat vollständig lokalisiert war, kann diesen Monat Dutzende von unübersetzten Zeichenfolgen haben, und niemand hat sie von Hand eingegeben.

localize.dev bietet Agenten die gleiche Engine wie die CLI, als MCP-Server, plus einen Hook, der den Agenten informiert, wenn eine Datei, die er gerade bearbeitet hat, unübersetzten Text enthält. Dieser Beitrag erklärt, wie die beiden zusammenpassen.

Fünf Werkzeuge

Der MCP-Server hat fünf Werkzeuge. Zwei davon sind kostenlos und benötigen keinen Schlüssel:

  • check: hartcodierte Kopien und fehlende oder veraltete Übersetzungen, jeweils mit Datei und Zeile. Übergeben Sie paths, um nur die vom Agenten geänderten Dateien zu überprüfen.
  • config: die Konventionen der App für das Schreiben von UI-Texten, damit neuer Code t() auf die gleiche Weise aufruft wie der Rest der App.
  • localize: gibt hardcodierte Textschlüssel, schreibt den Code neu und übersetzt die neuen Nachrichten.
  • translate: füllt fehlende Übersetzungen in den Sprachdateien aus.
  • add_language: fügt eine Sprache zur Konfiguration hinzu und übersetzt jede Nachricht in sie.

Führen Sie es lokal mit npx -y localize-dev mcp aus, damit die Code-Neuschreibung auf Ihrem Rechner erfolgt. Browser-Builder wie Lovable, Bolt und v0 können keinen lokalen Prozess starten, sie verbinden sich daher mit dem gehosteten Server bei https://uselocalize.dev/api/mcp mit OAuth oder API-Schlüssel.

Der Hook, der die Schleife schließt

Ein MCP-Tool hilft nur, wenn der Agent daran denkt, es aufzurufen. In Claude Code sorgt ein Nachbearbeitungs-Hook dafür. Nach jedem Bearbeiten oder Schreiben führt der Hook check auf der Datei aus, die der Agent gerade geändert hat. Wenn die Datei UI-Code mit unübersetztem Text ist, beendet der Hook mit Code 2, und Claude Code zeigt seine Nachricht dem Agenten:

what the agent sees
localize.dev: src/components/SignIn.tsx has UI text that isn't translated yet.
  line 9: "We'll email you a 6-digit code. No password needed."
Call the localize tool of the localize-dev MCP server with paths ["components/SignIn.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/SignIn.tsx

Der Agent ruft dann localize mit diesem Pfad auf. Der Satz erhält einen Schlüssel, die Zeile wird umgeschrieben, um t() aufzurufen, und die neue Nachricht wird in jede Sprache übersetzt, die die App hat, im selben Zug wie der Code, den der Agent schrieb.

Der Hook stört den Agenten nie. Eine Datei, die kein UI-Code ist, eine saubere Datei, und jeder Fehler im Hook selbst beenden alle mit Code 0 und geben nichts aus. Setze LOCALIZE_DEV_HOOK=off, um es für eine Sitzung auszuschalten.

Einrichtung

Ein Befehl fügt alles zum Repository hinzu:

npx localize-dev init --agent
  • Der MCP-Server in .mcp.json für Claude Code und .cursor/mcp.json für Cursor.
  • Der Nachbearbeitungs-Hook in .claude/settings.json, bei Bearbeitung, MultiEdit und Schreiben.
  • Ein Abschnitt in AGENTS.md und CLAUDE.md, und eine Cursor-Regel für die UI-Dateien der App, die dem Agenten sagt, während des Schreibens zu lokalisieren und check auszuführen, bevor er fertig ist.

Es fügt nur das hinzu, was bereits vorhanden ist. Deine anderen Server, Hooks und Anweisungen bleiben, und wenn du es erneut ausführst, ersetzt es seinen eigenen Abschnitt anstatt einen zweiten hinzuzufügen. Füge --pre-commit hinzu, um auch gestagte Dateien vor jedem Commit zu überprüfen, für Änderungen ohne Agent.

Warum nicht einfach den Agenten fragen

Sie können einen Agenten bitten, Strings zu extrahieren und zu übersetzen, ohne all dies, und für eine Datei funktioniert das oft. Im gesamten App driftet die Schlüssel zwischen Dateien, Pluralformen, die der Agent nicht bedacht hat, gehen verloren, und nichts erkennt den nächsten unübersetzten Satz. Der MCP-Server gibt dem Agenten dasselbe Schlüsselregister, dieselben Übersetzungsprüfungen und denselben CI-Check wie bei einem vollständigen Lauf.

Probieren Sie es mit Ihrem eigenen Code im Playground aus, kein Konto erforderlich