Mit einem Coding-Agenten einrichten
Die CLI enthält Anleitungen speziell für Coding-Agenten wie Claude Code, Codex und Cursor. Gib deinem Agenten einen der folgenden Prompts. Er führt lingo agent-guide aus, liest die passende Anleitung und erledigt die Aufgabe mit der CLI in deinem Repository. Aufgaben rund um dein Konto, etwa das Glossar der Engine oder die Verbindung zur GitHub App, laufen über den Lingo.dev MCP server.
Die Anleitungen werden mit der CLI ausgeliefert. So liest ein Agent immer die Anleitung zur Version, die er verwendet. Bevor er etwas übersetzt, zeigt er dir einen Plan und eine Schätzung und wartet auf deine Zustimmung.
Prompts #
Öffne deinen Agenten im Stammverzeichnis des Projekts und füge einen Prompt ein.
Lingo.dev von Grund auf einrichten #
Set up Lingo.dev localization in this project. Run npx @lingo.dev/cli@latest agent-guide setup and follow it.Der Agent:
- Kontrolliert, ob ihm die Lingo.dev-MCP-Tools zur Verfügung stehen. Falls nicht, fügt er den Server hinzu und bittet dich, ihn neu zu starten und den Prompt erneut einzufügen. Ein Cloud- oder CI-Agent überspringt diesen Schritt und die Anmeldung im Browser; siehe Sitzungen ohne menschliche Beteiligung.
- Ermittelt den Technologie-Stack, findet alle Quelldateien, die die App lädt, und folgt der Anleitung für diesen Stack (Rails, iOS, Android, Markdoc, E-Mails, eine i18n-Bibliothek oder eine Dokumentationswebsite).
- Bittet dich um die Anmeldung. Führe
npx @lingo.dev/cli@latest loginin deinem eigenen Terminal aus, wenn du dazu aufgefordert wirst. Füge niemals einen API-Schlüssel in die Unterhaltung ein. - Führt
lingo initundlingo linkaus. Wenn das Projekt bereits Übersetzungen enthält, kontrolliert er sie auf fehlerhafte Platzhalter, unübersetzten Text und uneinheitliche Begriffe. Er korrigiert nur, was du freigibst. - Zeigt dir den Plan und eine
lingo push --estimateund übersetzt erst nach deiner Zustimmung. - Registriert die neuen Sprachen in der App und bietet an, die GitHub App zu verbinden.
GitHub App verbinden #
Connect the Lingo.dev GitHub App to this repository. Run npx @lingo.dev/cli@latest agent-guide github and follow it.Der Agent richtet das Projekt zunächst ein, falls das noch nicht geschehen ist. Er kontrolliert, ob die GitHub App auf das Repository zugreifen kann, und gibt dir Links, mit denen du mögliche Probleme beheben kannst. Du entscheidest, ob die App nach einem Merge oder in Pull Requests übersetzt. Den Pull Request mit der Konfiguration öffnet er erst mit deiner Zustimmung.
Der AGENTS.md-Block #
lingo init und lingo agent setup schreiben einen kurzen Block in AGENTS.md im Stammverzeichnis des Projekts. So weiß der Agent in jeder späteren Sitzung, dass er vor Lokalisierungsaufgaben die Anleitungen lesen soll:
<!-- lingo:begin -->
## Lingo.dev localization
This project is localized with Lingo.dev. The config is `.lingo/config.json` next to this file. Lingo.dev commands and workflows change between versions, so do not rely on what you remember about them.
Before any localization task (translating content, adding a locale, connecting GitHub, changing the glossary or tone of voice), run `npx @lingo.dev/cli agent-guide` from this directory and follow the guide it names. The guides ship with the CLI and describe the version you run.
This block is written by `lingo init` and `lingo agent setup`. Text between the markers is replaced on the next run; keep your own notes outside them.
<!-- lingo:end -->AGENTS.mdwird erstellt, falls die Datei fehlt. Text außerhalb der Markierungen bleibt erhalten. Bei einem späteren Durchlauf wird nur der Text zwischen den Markierungen ersetzt.- Eine vorhandene
CLAUDE.mderhält den Block ebenfalls, es sei denn, sie importiert eineAGENTS.md, die ihn bereits enthält (@AGENTS.md).CLAUDE.mdwird nie erstellt. - Die Datei bleibt unverändert und es erscheint eine Warnung, wenn sie nicht gelesen werden kann, auf ein Ziel außerhalb des Projekts verweist oder ihre Markierungen nicht paarweise zusammenpassen. Korrigiere die Datei und führe
lingo agent setuperneut aus. Ergänze--client <name>, wenn dein Agent nicht erkannt wird. - Führe
lingo init --no-agents-mdaus, um den Block zu überspringen.
Wenn ein Agent einen Lingo.dev-Befehl in einem Projekt ausführt, dessen AGENTS.md oder CLAUDE.md keinen Block enthält, gibt die CLI eine Zeile auf stderr aus, die ihn auffordert, lingo agent setup -y auszuführen. Menschen und CI bekommen diese Zeile nie zu sehen.
lingo agent setup #
lingo agent setupKontrolliert, ob die Coding-Agenten auf diesem Rechner (Claude Code, Codex und Cursor sowie der Agent, in dem der Befehl ausgeführt wird) über den Lingo.dev MCP server verfügen. Für jeden Agenten, bei dem er fehlt, nennt der Befehl die Konfigurationsdatei, die du ändern musst. Agentenkonfigurationen ändert er nie selbst. Füge den Server anhand der Schritte unter MCP-Einrichtung hinzu. Innerhalb eines Projekts schreibt der Befehl nach Rückfrage auch den AGENTS.md-Block.
| Option | Wirkung |
|---|---|
--client <name> | Nur diesen Agenten kontrollieren, auch wenn er nicht erkannt wurde: claude-code, codex oder cursor. Mehrfach verwendbar. |
--dry-run | Anzeigen, was sich ändern würde, ohne etwas zu schreiben. |
--status | Anzeigen, was für die erkannten Agenten eingerichtet ist. --client ignorieren. |
-y, --yes | Den Block ohne Rückfrage schreiben. |
Ohne --status schlägt der Befehl fehl, wenn kein Agent zur Kontrolle vorhanden ist, und schreibt nichts. Gib deshalb mit --client einen Agenten an.
lingo agent-guide #
lingo agent-guide # the agent guide and the list of guides
lingo agent-guide setup # one guideOhne Namen gibt der Befehl die Anleitung aus, mit der jeder Agent beginnt (CLI oder MCP, Anmeldung, noch nicht abgeschlossene Ersteinrichtung), und listet die Anleitungen auf. Mit einem Namen gibt er die entsprechende Anleitung aus. Bei einem unbekannten Namen endet er mit Code 1 und listet die in dieser Version verfügbaren Anleitungen auf. Für Menschen, die @lingo.dev/react verwenden, gibt es eigene Anleitungen unter lingo guide.
Sitzungen ohne menschliche Beteiligung #
Setze in einer Cloud- oder CI-Sitzung LINGO_API_KEY, damit sich der Agent nicht anmelden muss. Ein solcher Agent erledigt den CLI-Teil der Aufgabe und richtet den MCP server nicht ein. In seiner letzten Nachricht listet er die verbleibenden Aufgaben auf, für die Zugriff auf das Konto nötig ist. Du kannst sie in der Web-App oder mit einem Agenten erledigen, der über den MCP server verfügt.
Wird eine Übersetzung aus Abrechnungsgründen abgelehnt, beendet sich die CLI mit Code 9, wenn eine Person eingreifen muss (Guthaben aufgebraucht, Engine-Limit erreicht oder eine Funktion im Tarif nicht verfügbar). Ist das tägliche Kontingent an Tokens aufgebraucht, endet sie mit Code 75. Sie gibt den Grund und einen Link zur Abrechnungsseite aus. Die Anleitungen weisen Agenten an, bei beiden Codes anzuhalten.
Berichte von Agenten #
Die Anleitungen bitten Agenten, Lingo.dev über lingo agent report einen kurzen Bericht zu senden, wenn ein Schritt fehlschlägt und wenn eine Aufgabe endet. So können wir die Anleitungen verbessern. Ein Bericht enthält die Anleitung und den Schritt, eine Zusammenfassung in ein oder zwei Sätzen, den Vorschlag des Agenten, seinen Namen sowie die verknüpfte Organisation und Engine. Die CLI entfernt Zugangsdaten und geheime Werte aus der Zusammenfassung und dem Vorschlag und kürzt beide auf jeweils 500 Zeichen. Die Anleitungen weisen Agenten an, in keinem Feld Code, Dateiinhalte oder Geheimnisse anzugeben. Ein Bericht führt niemals dazu, dass die Aufgabe fehlschlägt. Es wird nichts gesendet, wenn niemand angemeldet ist oder die Telemetrie deaktiviert ist (LINGO_TELEMETRY_DISABLED=1, DO_NOT_TRACK=1 oder OTEL_SDK_DISABLED=true).