Настройка с помощью агента для разработки
Поручите Claude Code, Codex или Cursor настроить Lingo.dev в вашем проекте с помощью руководств CLI для агентов: промпты для копирования, блок AGENTS.md, lingo agent setup и lingo agent-guide.
В CLI есть руководства для агентов разработки, таких как Claude Code, Codex и Cursor. Передайте агенту один из промптов ниже. Он запустит lingo agent-guide, прочитает руководство по нужной задаче и выполнит её в вашем репозитории с помощью CLI. Для задач на уровне учётной записи — например, работы с глоссарием движка или подключения GitHub App — используется Lingo.dev MCP server.
Руководства входят в CLI, поэтому агент всегда читает руководство для той версии, с которой работает. Прежде чем что-либо переводить, агент показывает план и предварительную оценку и ждёт вашего одобрения.
Промпты #
Запустите агент из корня проекта и вставьте промпт.
Настройка Lingo.dev с нуля #
Set up Lingo.dev localization in this project. Run npx @lingo.dev/cli@latest agent-guide setup and follow it.Агент:
- Проверяет, доступны ли ему MCP-инструменты Lingo.dev. Если нет, добавляет сервер и просит вас перезапустить агент и снова вставить промпт.
- Определяет стек, находит все исходные файлы, которые загружает приложение, и следует руководству для этого стека (Rails, iOS, Android, Markdoc, письма, библиотека i18n или сайт документации).
- Просит вас войти в учётную запись. По его запросу выполните
npx @lingo.dev/cli@latest loginв своём терминале. Никогда не вставляйте ключ API в переписку. - Выполняет
lingo initиlingo link. Если в проекте уже есть переводы, проверяет их на ошибки в плейсхолдерах, непереведённый текст и расхождения в терминах. Вносит только те исправления, которые вы одобрите. - Показывает план и
lingo push --estimateи приступает к переводу только после вашего одобрения. - Регистрирует новые локали в приложении и предлагает подключить GitHub App.
Подключение GitHub App #
Connect the Lingo.dev GitHub App to this repository. Run npx @lingo.dev/cli@latest agent-guide github and follow it.Сначала агент настраивает проект, если это ещё не сделано. Затем проверяет, есть ли у GitHub App доступ к репозиторию. Если доступа нет, даёт ссылки, чтобы это исправить. Предлагает вам выбрать, когда приложение будет переводить: после слияния или в пул-реквестах. Открывает пул-реквест с конфигурацией только после вашего согласия.
Блок AGENTS.md #
lingo init и lingo agent setup записывают короткий блок в AGENTS.md в корне проекта, чтобы в каждом следующем сеансе агент знал: перед локализацией нужно прочитать руководства:
<!-- 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отсутствует, файл создаётся. Текст вне маркеров сохраняется, а при следующем запуске заменяется только текст между ними. - В существующий
CLAUDE.mdблок тоже добавляется, кроме случаев, когда файл импортируетAGENTS.md, в котором этот блок уже есть (@AGENTS.md).CLAUDE.mdникогда не создаётся. - Если файл не удаётся прочитать, он ссылается за пределы проекта или содержит непарные маркеры, файл остаётся без изменений и появляется предупреждение. Исправьте файл и снова выполните
lingo agent setup. - Чтобы не добавлять блок, выполните
lingo init --no-agents-md.
Когда агент выполняет команду Lingo.dev в проекте, где в AGENTS.md или CLAUDE.md нет блока, CLI выводит в stderr одну строку с указанием выполнить lingo agent setup -y. Люди и CI эту строку не видят.
lingo agent setup #
lingo agent setupПроверяет, подключён ли Lingo.dev MCP server к агентам разработки на этом компьютере (Claude Code, Codex и Cursor, а также агенту, внутри которого выполняется команда). Для каждого агента без подключения указывает, какой файл конфигурации нужно изменить. Команда никогда не меняет конфигурации агентов. Добавьте сервер по инструкции в разделе Настройка MCP. Внутри проекта команда также записывает блок AGENTS.md, предварительно запросив разрешение.
| Флажок | Действие |
|---|---|
--client <name> | Проверить только этот агент, даже если он не обнаружен: claude-code, codex или cursor. Можно указать несколько раз. |
--dry-run | Показать, что изменится, ничего не записывая. |
--status | Показать, что настроено для обнаруженных агентов. Игнорирует --client. |
-y, --yes | Записать блок без запроса разрешения. |
Если нет агента для проверки, команда завершается с ошибкой, ничего не записывая.
lingo agent-guide #
lingo agent-guide # the agent guide and the list of guides
lingo agent-guide setup # one guideЕсли название не указано, выводит руководство, с которого начинает работу каждый агент (CLI или MCP, вход в систему, незавершённая начальная настройка), и список руководств. Если название указано, выводит это руководство. Если название неизвестно, завершается с кодом 1 и выводит список руководств, доступных в этой версии. lingo guide предоставляет руководства тем, кто использует @lingo.dev/react.
Сеансы без участия человека #
В облачном сеансе или CI задайте LINGO_API_KEY, чтобы агенту не нужно было входить в учётную запись. Такой агент выполняет часть задачи, связанную с CLI, и не настраивает MCP server. В последнем сообщении он перечисляет оставшиеся задачи, для которых нужна учётная запись. Вы можете завершить их в веб-приложении или с помощью агента с подключённым MCP server.
Если перевод отклонён по причинам, связанным с оплатой, CLI завершается с кодом 9, когда требуется участие человека (закончились кредиты, достигнут лимит движка или нужная функция недоступна на текущем плане), и с кодом 75, когда исчерпан суточный лимит токенов. CLI выводит причину и ссылку на страницу оплаты. Руководства указывают агентам остановиться при любом из этих кодов.
Отчёты агентов #
Руководства просят агентов отправлять в Lingo.dev короткий отчёт с помощью lingo agent report при сбое на одном из шагов и по завершении задачи, чтобы мы могли улучшать руководства. В отчёте указаны руководство и шаг, краткое описание в одном-двух предложениях, имя агента, а также связанные организация и движок. CLI удаляет учётные данные и секретные значения и сокращает каждое текстовое поле до 500 символов. Отправка отчёта никогда не приводит к сбою задачи. Ничего не отправляется, если никто не вошёл в учётную запись или телеметрия отключена (LINGO_TELEMETRY_DISABLED=1, DO_NOT_TRACK=1 или OTEL_SDK_DISABLED=true).