Настройка с помощью агента для работы с кодом
В 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. Если нет, добавит сервер и попросит вас перезапустить агент и снова вставить промпт. Агент в облаке или CI пропустит этот шаг и вход через браузер. См. Сеансы без участия человека.
- Определит стек, найдёт все исходные файлы, которые загружает приложение, и выполнит инструкции из подходящего руководства (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никогда не создаётся. - Если файл не удаётся прочитать, он ссылается за пределы проекта или содержит непарные маркеры, CLI оставляет его без изменений и выводит предупреждение. Исправьте файл и снова выполните
lingo agent setup, добавив--client <name>, если агент не определяется. - Чтобы не добавлять блок, выполните
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 | Записать блок без запроса подтверждения. |
Без --status команда завершается с ошибкой и ничего не записывает, если нет агентов для проверки. В этом случае укажите нужный агент с помощью --client.
lingo agent-guide #
lingo agent-guide # the agent guide and the list of guides
lingo agent-guide setup # one guideБез имени выводит руководство, с которого начинает каждый агент (CLI или MCP, вход в учётную запись, незавершённая первоначальная настройка), и список руководств. С именем выводит указанное руководство. Если имя неизвестно, завершается с кодом 1 и выводит список руководств, доступных в этой версии. Для тех, кто использует @lingo.dev/react, есть отдельные руководства в lingo guide.
Сеансы без участия человека #
В облачном сеансе или 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).