Blog

Lassen Sie Claude Code UI-Text übersetzen, während es schreibt

Eine Feature-Anfrage in einer Next.js-App mit drei Sprachen: das Setup, die Hook-Nachricht, der localize-Aufruf, die Übersetzungen und der Check, aus einer echten Claude Code-Sitzung.

Stephen Ufort · 16. November 2026 · 5 Min. Lesezeit

Die Feature-Anfrage in Claude Code, der localize-Aufruf mit seinen Statistiken, die Bestätigungsnachricht in Spanisch, Deutsch und Französisch und der bestandene Check

Claude Code schreibt UI-Text in Englisch, wo immer die Funktion ihn benötigt. In einer bereits übersetzten App hinterlässt jede neue Funktion ein paar hartcodierte Strings. Dieser Beitrag verfolgt eine Feature-Anfrage in einer Next.js-App mit Spanisch, Deutsch und Französisch, vom Setup bis zum bestandenen Check, mit den echten Befehlen und Ausgaben.

Die App ist die Notizen-App aus dem Beitrag zum Hinzufügen von i18n zu einer Next.js App Router-App in einem einzigen Pull Request. Sie verfügt bereits über i18next, Locale-Dateien und einen Sprachumschalter. Wie der MCP-Server und der Hook intern funktionieren, steht im Beitrag zum Lokalisieren, während Ihr Coding-Agent schreibt; dieser hier zeigt sie bei einer echten Änderung.

Richten Sie es ein

Ein Befehl fügt den MCP-Server, den After-Edit-Hook und die Anweisungen für den Agenten hinzu:

$ 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.

Der Hook kommt in .claude/settings.json. Nach jedem Edit, MultiEdit oder Write führt Claude Code localize-dev hook auf der Datei aus, die der Agent geändert hat:

.claude/settings.json
{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|MultiEdit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "npx -y localize-dev hook",
            "timeout": 60
          }
        ]
      }
    ]
  }
}

AGENTS.md erhält einen kurzen Abschnitt, und CLAUDE.md importiert ihn, sodass Claude Code ihn zu Beginn jeder Sitzung liest:

AGENTS.md
## 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.

Committen Sie die Dateien, damit der Rest des Teams und seine Agenten sie auch erhalten. Starten Sie dann Claude Code neu, damit es den MCP-Server startet.

Fordern Sie eine Funktion an

Dies ist die gesamte Anfrage. Sie erwähnt keine Übersetzungen:

the prompt
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 las den Notizen-Code, schrieb dann eine Serveraktion, die eine Notiz löscht, eine Lösungsfunktion in der Daten-Schicht und das neue NoteList: eine Schaltfläche zum Löschen bei jeder Notiz, eine Bestätigung innerhalb der Zeile, eine Nachricht nach dem Löschen und eine Fehlermeldung, falls es fehlschlägt. Dieser erste Entwurf enthielt sieben englische Texte.

Was der Hook sieht

Hier ist, was der Hook für diesen ersten Entwurf ausgibt. Er fand alle sieben, einschließlich des aria-label und der beiden Template-Literale:

hook output
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.tsx

Der Hook wird mit dem Code 2 beendet, daher zeigt Claude Code diese Nachricht dem Agenten an. Eine Datei ohne zu übersetzenden Inhalt wird mit dem Code 0 beendet und gibt nichts aus. Um den Hook für eine Sitzung zu deaktivieren, setzen Sie LOCALIZE_DEV_HOOK=off.

Der localize-Aufruf

Direkt nach dem Schreiben der Komponente rief der Agent das Tool localize mit diesem Pfad auf. Hier sind der Aufruf und die Statistiken aus seinem Ergebnis:

localize tool call and result
localize({ "paths": ["components/NoteList.tsx"] })

"stats": {
  "filesScanned": 1,
  "stringsReplaced": 7,
  "newKeys": 6,
  "reusedKeys": 1,
  "translations": { "es": 6, "de": 6, "fr": 6 }
}

Sieben Zeichenketten wurden zu sechs Schlüsseln: die beiden Löschen-Schaltflächen teilen sich note_list.delete_button. Die Template-Literale wurden zu Nachrichten mit Platzhaltern, sodass Delete "${n.title}" jetzt eine Nachricht mit einem title-Platzhalter ist, und eine Sprache kann den Titel dort platzieren, wo ihre Grammatik ihn benötigt. Die Bestätigungszeile sieht jetzt so aus:

src/components/NoteList.tsx
{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>
)}

Die Übersetzungen

Der gleiche Aufruf wurde auf Spanisch, Deutsch und Französisch ausgefüllt. Dies sind die deutschen Ergänzungen:

locales/de.json
"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"

Deutsch verwendet seine eigenen Anführungszeichen und das formelle Sie („Versuchen Sie es erneut“), wie der Rest der App. Französisch erhielt « » mit Leerzeichen darin. Spanisch verwendet tú, wie in den früheren Nachrichten:

locales/es.json
"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}}\""

Der Agent hat keine davon von Hand geschrieben. Der Abschnitt in AGENTS.md fordert ihn auf, die Locale-Dateien anderer Sprachen in Ruhe zu lassen, und das hat er getan.

Vor der Fertigstellung geprüft

Bevor der Agent meldete, dass er fertig sei, führte er die Prüfung, dann den Typ-Checker und den Linter aus:

$ npx localize-dev check --changed
✅ Everything is localized (1 files scanned).

Seine Zusammenfassung enthielt drei nützliche Dinge. Es baute die Bestätigung in die Zeile ein, anstatt das eigene Popup des Browsers zu verwenden, sodass der Text übersetzt werden kann. Gelöschte Notizen kommen zurück, wenn der Server neu startet, da die Datenschicht ein Platzhalter ist. Und es hatte die Funktion nicht in einem Browser ausprobiert. Probieren Sie es selbst aus, bevor Sie zusammenführen: Die Prüfung deckt den Text ab, nicht ob das Löschen funktioniert.

Cursor und andere Agenten

Cursor erhält den gleichen MCP-Server in .cursor/mcp.json und eine Regel in .cursor/rules/localize.mdc für die UI-Dateien der App. init --agent fügt keinen Hook für Cursor hinzu, daher ist die Regel das, was den Agenten auffordert, localize aufzurufen. Andere Agenten, die AGENTS.md lesen, erhalten die gleichen Anweisungen, und ein Agent ohne MCP kann npx localize-dev run --files mit den geänderten Dateien ausführen.

Für Änderungen, die ohne Agent vorgenommen wurden, prüft npx localize-dev init --agent --pre-commit auch gestagte Dateien vor jedem Commit, und npx localize-dev check in CI schlägt eine Pull-Anfrage mit hartcodiertem Text fehl. Keiner von beiden benötigt einen API-Schlüssel.

Jemand, der jede Sprache liest, sollte sich immer noch die Locale-Dateien in der Diff ansehen. Der Lauf behält eine Anredeform pro Sprache bei, aber nur ein Leser weiß, ob „Löschen“ das Wort ist, das Ihre deutschen Benutzer auf dieser Schaltfläche erwarten.

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