Mit einem Coding-Agenten einrichten

Lass Claude Code, Codex oder Cursor Lingo.dev in deinem Projekt einrichten – mit den Agenten-Anleitungen der CLI: Prompts zum Kopieren, dem AGENTS.md-Block, lingo agent setup und lingo agent-guide.

Die CLI enthält Anleitungen 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 auf Kontoebene, etwa rund um 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 für die Version, die er verwendet. Bevor er etwas übersetzt, zeigt er dir einen Plan und eine Schätzung und wartet auf deine Zustimmung.

Prompts #

Füge im Projektstammverzeichnis einen Prompt in deinen Agenten ein.

Lingo.dev von Grund auf einrichten #

text
Set up Lingo.dev localization in this project. Run npx @lingo.dev/cli@latest agent-guide setup and follow it.

Der Agent:

  1. Überprüft, ob ihm die Lingo.dev-MCP-Tools zur Verfügung stehen. Falls nicht, fügt er den Server hinzu und bittet dich, den Agenten neu zu starten und den Prompt erneut einzufügen.
  2. 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).
  3. Bittet dich, dich anzumelden. Führe npx @lingo.dev/cli@latest login in deinem eigenen Terminal aus, wenn er dich dazu auffordert. Füge niemals einen API-Schlüssel in die Unterhaltung ein.
  4. Führt lingo init und lingo link aus. Wenn das Projekt bereits Übersetzungen enthält, untersucht er sie auf fehlerhafte Platzhalter, unübersetzten Text und uneinheitliche Begriffe und nimmt nur Korrekturen vor, denen du zustimmst.
  5. Zeigt dir den Plan sowie lingo push --estimate und übersetzt erst nach deiner Zustimmung.
  6. Registriert die neuen Sprachen in der App und bietet an, die GitHub App zu verbinden.

GitHub App verbinden #

text
Connect the Lingo.dev GitHub App to this repository. Run npx @lingo.dev/cli@latest agent-guide github and follow it.

Der Agent richtet zuerst das Projekt ein, falls das noch nicht geschehen ist. Er überprüft, ob die GitHub App Zugriff auf das Repository hat, und gibt dir andernfalls Links, mit denen du das beheben kannst. Du wählst, ob die App nach einem Merge oder in Pull Requests übersetzt. Den Pull Request mit der Konfiguration öffnet er erst nach deiner Zustimmung.

Der AGENTS.md-Block #

lingo init und lingo agent setup schreiben einen kurzen Block in AGENTS.md im Projektstammverzeichnis. So weiß der Agent in jeder späteren Sitzung, dass er vor Lokalisierungsarbeiten die Anleitungen lesen soll:

markdown
<!-- 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.md wird erstellt, wenn die Datei fehlt. Text außerhalb der Markierungen bleibt erhalten. Ein späterer Durchlauf ersetzt nur den Text dazwischen.
  • Auch eine vorhandene CLAUDE.md erhält den Block, es sei denn, sie importiert eine AGENTS.md, die ihn bereits enthält (@AGENTS.md). CLAUDE.md wird niemals erstellt.
  • Eine Datei bleibt unter Ausgabe einer Warnung unverändert, wenn sie nicht gelesen werden kann, auf ein Ziel außerhalb des Projekts verweist oder ihre Markierungen keine passenden Paare bilden. Korrigiere die Datei und führe lingo agent setup erneut aus.
  • Um den Block zu überspringen, führe lingo init --no-agents-md aus.

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 den Agenten auffordert, lingo agent setup -y auszuführen. Menschen und CI bekommen diese Zeile nie zu sehen.

lingo agent setup #

bash
lingo agent setup

Überprüft, 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 ohne diesen Server nennt der Befehl die Konfigurationsdatei, die geändert werden muss. Er bearbeitet niemals Agentenkonfigurationen. 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.

OptionWirkung
--client <name>Nur diesen Agenten überprüfen, auch wenn er nicht erkannt wurde: claude-code, codex oder cursor. Mehrfach verwendbar.
--dry-runAnzeigen, was sich ändern würde, ohne etwas zu schreiben.
--statusAnzeigen, was für die erkannten Agenten eingerichtet ist. Ignoriert --client.
-y, --yesDen Block ohne Rückfrage schreiben.

Wenn kein Agent zur Überprüfung vorhanden ist, schlägt der Befehl fehl, ohne etwas zu schreiben.

lingo agent-guide #

bash
lingo agent-guide           # the agent guide and the list of guides
lingo agent-guide setup     # one guide

Ohne Namen wird die Anleitung ausgegeben, mit der jeder Agent startet (CLI oder MCP, Anmeldung, noch nicht abgeschlossenes Onboarding), und alle Anleitungen werden aufgelistet. Mit einem Namen wird die entsprechende Anleitung ausgegeben. Bei einem unbekannten Namen endet das Programm mit Exit-Code 1 und listet die in dieser Version verfügbaren Anleitungen auf. lingo guide stellt die Anleitungen für Personen bereit, die @lingo.dev/react verwenden.

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 auf, was noch über das Konto erledigt werden muss. Diese Aufgaben kannst du in der Web-App oder mit einem Agenten abschließen, der über den MCP server verfügt.

Wenn eine Übersetzung aus Abrechnungsgründen abgelehnt wird, endet die CLI mit Code 9, falls ein Mensch eingreifen muss (Guthaben aufgebraucht, Engine-Limit erreicht oder eine Funktion im Tarif fehlt), und mit Code 75, falls das tägliche Kontingent an Tokens aufgebraucht ist. Sie gibt den Grund und den Link zur Abrechnungsseite aus. Die Anleitungen weisen Agenten an, bei beiden Codes anzuhalten.

Berichte von Agenten #

Die Anleitungen bitten Agenten, Lingo.dev mit 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 Namen des Agenten sowie die verknüpfte Organisation und Engine. Die CLI entfernt Zugangsdaten und geheime Werte und kürzt jeden Text auf 500 Zeichen. Ein Bericht führt niemals dazu, dass die Aufgabe fehlschlägt. Wenn niemand angemeldet ist oder die Telemetrie deaktiviert ist (LINGO_TELEMETRY_DISABLED=1, DO_NOT_TRACK=1 oder OTEL_SDK_DISABLED=true), wird nichts gesendet.