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.
- Fügen Sie die Tabelle [mcp_servers.localize] zu ~/.codex/config.toml hinzu.
- 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.
[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 logingespeichert hat - Was
init --agenthinzufügt - Der Abschnitt
AGENTS.mdmit den Anweisungen. Fügen Sie den Server manuell hinzu, wie oben.
Gut zu wissen
- Die Konfigurationsdatei ist TOML, nicht JSON:
commandundargsgehören unter[mcp_servers.localize]. - Codex erhält keinen After-Edit-Hook. Der Abschnitt
AGENTS.mdund eincheckin CI fangen Text auf, den es hartcodiert lässt. - Beginnen Sie mit einer schreibgeschützten Eingabeaufforderung: Bitten Sie Codex,
checkauszuführen, bevor Sie einen Pull Request öffnen.checkundconfigbenö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 checkAlle Agenten und der Tool-Referenz sind auf der MCP-Serverseite.