Агенты для кодинга

Агенты для кодирования

Claude Code, Codex, Cursor и другие AI-агенты для разработки развертывают приложения и управляют ими в Lizard (lizard.build) через Lizard CLI. Один раз установите Lizard Skill командой npx skills add lizard-build/skill -g; после этого агент загружает встроенное в CLI руководство командой lizard skills get core --json и читает флаги любой команды через --help --json, чтобы узнать доступные параметры. Клиенты с поддержкой MCP, например ChatGPT и Claude, могут вместо этого использовать Lizard MCP. Полный пример развертывания с агентом смотрите в руководстве Развёртывание из Claude Code, Codex или Cursor.

Встроенный навык

Авторитетное руководство по использованию находится внутри CLI и версионируется вместе с ним, поэтому оно всегда соответствует установленной версии. Агент читает его с помощью:

lizard skills get core --json

Это возвращает { name, frontmatter, content, … } — content является полным руководством (конвейер сборки, приоритет переменных окружения, аддоны, обнаружение, коды выхода). Связанные подкоманды:

lizard skills list        # available embedded skills
lizard skills get core    # the core guide
lizard skills path        # where skills are stored

Так как руководство поставляется в составе бинарника, lizard upgrade обновляет и инструкции агента.

Самоописывающиеся команды

Агенты обнаруживают точную форму флагов во время выполнения вместо того, чтобы полагаться на запомненный синтаксис:

lizard --help --json                # full command tree + exit codes
lizard <cmd> --help --json          # a specific command's schema

См. JSON и автоматизация.

Бутстраппинг в агенте

Типичный поток работы агента:

  1. Загрузите руководство: lizard skills get core --json → прочитайте content.
  2. Проверьте авторизацию оптимистически: выполните задачу пользователя; при коде выхода 2 запустите lizard login, передайте пользователю выведенный URL, затем повторите попытку.
  3. Запустите пробный период, если попросят: у нового аккаунта нет тарифа, поэтому первое создание завершится ошибкой HTTP 402 (code: "PAYMENT_REQUIRED", код выхода 1). Выполните lizard billing start --json, передайте пользователю url страницы Checkout, затем повторите попытку после того, как он добавит карту.
  4. Определите контекст перед мутацией: lizard status (связка cwd) и lizard ps --json (сервисы).
  5. Действуйте с помощью руководства — add, up, secrets, domain и т.д., всегда с --json.

Если бинарник lizard отсутствует, сначала установите его. На macOS или Linux используйте скрипт установки:

curl -fsSL https://lizard.build/install.sh | bash

Ему не нужны ни Node.js, ни sudo. Скрипт создает ссылку на lizard в папке, которая уже есть в PATH, поэтому агент может вызвать его в той же сессии. Если скрипт пишет, что lizard может быть не найден, вызывайте ~/.lizard/bin/lizard. На Windows выполните в PowerShell:

irm https://lizard.build/api/cli/install.ps1 | iex

Или установите из npm в любой системе:

npm install -g @lizard-build/cli

Соглашения, которым должны следовать агенты

  • Всегда передавайте --json при неинтерактивных вызовах.
  • Подтверждайте деструктивные действия (удаление сервиса, удаление аддона, перезапись секрета на уровне проекта, перезагрузка продакшена) с пользователем — встроенные подсказки CLI срабатывают только при наличии TTY.
  • Ограничивайте область действия секретов потребляющим сервисом по умолчанию; резервируйте --global для явно публичных значений. См. Переменные и секреты.
  • Не пишите Dockerfile без запроса — lizardpack автоматически определяет большинство стеков. Сначала попробуйте задеплоить. См. Конвейер сборки.
  • Не используйте lizard up для переключения git-базированного сервиса на загрузку — используйте service set + redeploy.

Интеграции с редакторами

Lizard Skill распространяется как публичный бутстрап, чтобы агенты в редакторах и ассистентах могли устанавливать и загружать его по требованию, а затем управлять тем же CLI, который описан во всей этой документации. Установите его один раз для всех своих агентов:

npx skills add lizard-build/skill -g

Он работает с Claude Code, Cursor, Codex, Copilot, Gemini CLI и другими агентами, которые читают формат Agent Skills. Для клиентов, которые работают через MCP, а не выполняют shell-команды, используйте Lizard MCP.

Это относится и к AI IDE: они пишут и тестируют приложение, но не хостят его. См. развертывание приложения, созданного в Google Antigravity, где весь деплой выполняется одним промптом.

Чтобы Claude Code или ChatGPT могли редактировать страницу, открытую в Chrome, используйте Lizard Studio.

Lizard MCP

Lizard MCP позволяет ChatGPT, Claude и другим MCP-клиентам управлять вашими проектами Lizard: создавать сервисы и аддоны, выполнять повторный деплой, читать логи и метрики, задавать секреты, масштабировать реплики и подключать домены. Это размещенный сервер, который работает по Streamable HTTP по адресу:

https://employ-woman-g1q2.us-east-1.onlizard.com/mcp

Клиент с поддержкой OAuth авторизует вас при первом использовании. Другие клиенты передают API-ключ liz_ в заголовке Authorization: Bearer; создайте его командой lizard keys create <name>.

Добавьте его в Claude Code:

claude mcp add --transport http lizard https://employ-woman-g1q2.us-east-1.onlizard.com/mcp

Для Cursor и других клиентов, настраиваемых через JSON:

{
  "mcpServers": {
    "lizard": {
      "url": "https://employ-woman-g1q2.us-east-1.onlizard.com/mcp",
      "headers": { "Authorization": "Bearer liz_your_key" }
    }
  }
}

Запуск пробного периода, оплата и отмена Pro выполняются на странице Billing. Если аккаунту нужно оплатить тариф, прежде чем он сможет что-то создать, ошибка инструмента содержит PAYMENT_REQUIRED и ссылку, которую нужно открыть.

Хостинг собственного MCP-сервера

Работа агента через Lizard CLI и запуск приложения с MCP требуют разных действий. Команды CLI, описанные выше, не предоставляют MCP-транспорт. Чтобы развернуть собственный сервер с Streamable HTTP, следуйте руководству по удаленному MCP.

См. также

Панель приложения

Обновлено