localize.dev

Dokumentation / Agenten / Claude Code

App mit Claude Code lokalisieren

Fügen Sie den localize.dev MCP-Server und den After-Edit-Hook zu Claude Code hinzu, damit neuer UI-Text Übersetzungsschlüssel und Übersetzungen erhält, während Claude den Code schreibt.

Funktionsweise

Claude Code kann i18n-Code schreiben, aber es weiß nicht, welche Strings es verpasst hat oder was Ihre anderen Sprachen benötigen. Mit dem localize.dev MCP-Server ruft es localize für die geänderten Dateien auf: Der Text erhält Schlüssel, der Code wird in Ihre i18n-Bibliothek umgeschrieben und die neuen Nachrichten werden in jede Sprache übersetzt, in der die App ausgeliefert wird.

npx localize-dev init --agent fügt den Server zu .mcp.json und einen After-Edit-Hook zu .claude/settings.json hinzu. Nach jeder Bearbeitung scannt der Hook die von Claude berührte Datei, und wenn er nicht übersetzten Text findet, weist er Claude an, localize aufzurufen, damit sich niemand daran erinnern muss zu fragen.

Richten Sie es ein

Führen Sie zuerst npx localize-dev login in Ihrem Terminal aus. Es meldet Sie über den Browser an und speichert einen Schlüssel, den der Server liest, sodass die folgende Konfiguration keine enthält.

  1. Führen Sie claude mcp add in Ihrem Repository aus.
  2. Starte den Agenten neu oder lade seine MCP-Server neu, damit er mit der Lokalisierung beginnt.
  3. Öffne dein Repository und frage es etwas Ähnliches wie die Eingabeaufforderung unten.
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
Oder installieren Sie das Plugin
claude plugin marketplace add ufortstephen/localize-dev
claude plugin install localize-dev@uselocalize

Was Sie erhalten

Wohin der Server geht
.mcp.json
Server
localize-dev mcp, gestartet mit npx auf Ihrem Computer
Schlüssel
Der, den npx localize-dev login gespeichert hat
Was init --agent hinzufügt
Der Server in .mcp.json, der After-Edit-Hook in .claude/settings.json und der Abschnitt AGENTS.md

Gut zu wissen

  • Das Plugin ist der andere Weg hinein. Es fügt den Server und eine Fähigkeit hinzu, die Claude sagt, wann es ihn benutzen soll, und lässt das Repository in Ruhe.
  • Der Hook führt npx localize-dev hook nach Edit, MultiEdit und Write aus. Er scannt nur, benötigt also keinen Schlüssel und verbraucht nichts von Ihrem Kontingent. Setzen Sie LOCALIZE_DEV_HOOK=off, um ihn zu pausieren.
  • Claude Code liest CLAUDE.md, nicht AGENTS.md. Wenn das Repository kein CLAUDE.md hat, erstellt init --agent eines, das AGENTS.md importiert, sodass beide Agenten denselben Anweisungen folgen.

Probieren Sie es aus

Fragen Sie etwas wie dieses. Der Agent sollte das localize-Tool aufrufen.

“Lokalisieren Sie src/components/Checkout.tsx ins Spanische und Französische.”

Behalten Sie es übersetzt

Text, den der Agent hartcodiert hinterlässt, wird immer noch abgefangen: npx localize-dev check in CI schlägt eine Pull-Anfrage fehl, die nicht übersetzten Text hinzufügt, und sie benötigt keinen Schlüssel.

npx localize-dev check

Alle Agenten und der Tool-Referenz sind auf der MCP-Serverseite.