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.
- Führen Sie claude mcp add in Ihrem Repository aus.
- Starte den Agenten neu oder lade seine MCP-Server neu, damit er mit der Lokalisierung beginnt.
- Öffne dein Repository und frage es etwas Ähnliches wie die Eingabeaufforderung unten.
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 --agentclaude plugin marketplace add ufortstephen/localize-dev
claude plugin install localize-dev@uselocalizeWas 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 logingespeichert hat - Was
init --agenthinzufügt - Der Server in
.mcp.json, der After-Edit-Hook in.claude/settings.jsonund der AbschnittAGENTS.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 hooknach Edit, MultiEdit und Write aus. Er scannt nur, benötigt also keinen Schlüssel und verbraucht nichts von Ihrem Kontingent. Setzen SieLOCALIZE_DEV_HOOK=off, um ihn zu pausieren. - Claude Code liest
CLAUDE.md, nichtAGENTS.md. Wenn das Repository keinCLAUDE.mdhat, erstelltinit --agenteines, dasAGENTS.mdimportiert, 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 checkAlle Agenten und der Tool-Referenz sind auf der MCP-Serverseite.