localize.dev

Dokumentation / Agenten / Codex

App mit Codex lokalisieren

Fügen Sie localize.dev zu ~/.codex/config.toml hinzu, damit OpenAI Codex hartcodierten UI-Text finden, ihm Schlüssel geben und ihn übersetzen kann, sowohl in der CLI als auch in der IDE-Erweiterung.

Funktionsweise

Codex liest MCP-Server aus ~/.codex/config.toml, und die CLI sowie die IDE-Erweiterung teilen sich diese Datei. Fügen Sie die [mcp_servers.localize]-Tabelle einmal hinzu und beide können die Tools von localize.dev aufrufen.

Codex folgt AGENTS.md. npx localize-dev init --agent fügt dort einen Abschnitt hinzu, der ihn anweist, localize nach der Änderung von UI-Text aufzurufen und npx localize-dev check --changed auszuführen, bevor er fertig ist.

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ügen Sie die Tabelle [mcp_servers.localize] zu ~/.codex/config.toml hinzu.
  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.
~/.codex/config.toml
[mcp_servers.localize]
command = "npx"
args = ["-y", "localize-dev", "mcp"]

Was Sie erhalten

Wohin der Server geht
~/.codex/config.toml
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 Abschnitt AGENTS.md mit den Anweisungen. Fügen Sie den Server manuell hinzu, wie oben.

Gut zu wissen

  • Die Konfigurationsdatei ist TOML, nicht JSON: command und args gehören unter [mcp_servers.localize].
  • Codex erhält keinen After-Edit-Hook. Der Abschnitt AGENTS.md und ein check in CI fangen Text auf, den es hartcodiert lässt.
  • Beginnen Sie mit einer schreibgeschützten Eingabeaufforderung: Bitten Sie Codex, check auszuführen, bevor Sie einen Pull Request öffnen. check und config benötigen keinen Schlüssel und verbrauchen niemals Ihr Kontingent.

Probieren Sie es aus

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

“Bevor ich den PR öffne, prüfen Sie auf fest codierten Text und fehlende Übersetzungen.”

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.