Настройка с помощью агента для разработки

Поручите 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 с нуля #

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

Агент:

  1. Проверяет, доступны ли ему MCP-инструменты Lingo.dev. Если нет, добавляет сервер и просит вас перезапустить агент и снова вставить промпт.
  2. Определяет стек, находит все исходные файлы, которые загружает приложение, и следует руководству для этого стека (Rails, iOS, Android, Markdoc, письма, библиотека i18n или сайт документации).
  3. Просит вас войти в учётную запись. По его запросу выполните npx @lingo.dev/cli@latest login в своём терминале. Никогда не вставляйте ключ API в переписку.
  4. Выполняет lingo init и lingo link. Если в проекте уже есть переводы, проверяет их на ошибки в плейсхолдерах, непереведённый текст и расхождения в терминах. Вносит только те исправления, которые вы одобрите.
  5. Показывает план и lingo push --estimate и приступает к переводу только после вашего одобрения.
  6. Регистрирует новые локали в приложении и предлагает подключить GitHub App.

Подключение GitHub App #

text
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 в корне проекта, чтобы в каждом следующем сеансе агент знал: перед локализацией нужно прочитать руководства:

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 отсутствует, файл создаётся. Текст вне маркеров сохраняется, а при следующем запуске заменяется только текст между ними.
  • В существующий 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 #

bash
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 #

bash
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).