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

Max PrilutskiyГенеральный директор и соучредитель5 мин чтения

В 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. Если нет, добавит сервер и попросит вас перезапустить агент и снова вставить промпт. Агент в облаке или CI пропустит этот шаг и вход через браузер. См. Сеансы без участия человека.
  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 никогда не создаётся.
  • Если файл не удаётся прочитать, он ссылается за пределы проекта или содержит непарные маркеры, 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 #

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Записать блок без запроса подтверждения.

Без --status команда завершается с ошибкой и ничего не записывает, если нет агентов для проверки. В этом случае укажите нужный агент с помощью --client.

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