lizard sandbox

Создавайте Sandboxes и управляйте ими из терминала: Sandboxes. Псевдоним: lizard sb.

Использование

lizard sandbox create [flags]
lizard sandbox list [flags]
lizard sandbox exec <id> -- <command>
lizard sandbox ssh <id>
lizard sandbox fork <id> [flags]
lizard sandbox rm <id> [flags]

Каждый sandbox принадлежит проекту: тому, который вы укажете через -p, иначе тому, который связан с текущей директорией, иначе проекту по умолчанию вашего аккаунта (самому старому проекту в вашем личном рабочем пространстве).

Подкоманды

lizard sandbox create

Создаёт sandbox и выводит его ID.

ФлагОписание
-t, --template <name>Шаблон (по умолчанию base). Доступные шаблоны: base, interpreter, codex, desktop, desktop-camoufox (только US East), opencode, pi, prime, claude. Сервер проверяет список региона
-s, --size <size>nano, mini, small, medium (по умолчанию; в пробном периоде small), large или big (только на платных тарифах). nano работает только с шаблонами base, claude и codex, mini — только с ними и interpreter, а big — только с этими четырьмя и desktop; эти три размера работают без тома
--timeout <ms>Время жизни в миллисекундах (по умолчанию 300000, пять минут); 0 отключает истечение срока. На пробном периоде не больше 3600000 (1 час), а 0 даёт 1 час
--region <code>Регион, в котором создаётся sandbox
--snapshot <id>Запустить из сохранённого снапшота; нельзя сочетать с --size
--volume <name-or-id>Подключить Persistent Volume
--with-token [key]Выполнить вход в lizard внутри sandbox с новым ключом, который ограничен проектом sandbox и удаляется вместе с sandbox. Ключ liz_, который вы передаёте, а без значения — ключ liz_, с которым вы запускаете команду, только авторизует запрос; при входе через браузер такого ключа нет. В шаблоне base нет lizard
-p, --project <id>Проект (по умолчанию связанный, иначе ваш проект по умолчанию)

Lizard тарифицирует каждый размер посекундно по фиксированной ставке, пока sandbox работает, включая простой. В цену входят локальный диск и 2 ТБ исходящего трафика на аккаунт за последние 30 дней. Успешная пауза останавливает оплату вычислений; диск sandbox на паузе стоит $0.14 за ГБ-месяц используемого пространства, пока вы не возобновите или не удалите sandbox, и столько же стоит каждый снимок, пока вы его не удалите. Persistent Volumes оплачиваются по тарифу тома, в том числе после отключения тома от sandbox.

РазмерvCPUПамятьДискЦена
nano0.5 (1 vCPU, ограниченный половиной ядра)1 GiB5 GB$0.00405/h
mini12 GiB10 GB$0.0081/h
small24 GiB20 GB$0.0162/h
medium48 GiB40 GB$0.0324/h
large816 GiB80 GB$0.0648/h
big1632 GiB120 GB$0.1296/h

Ключ, который устанавливает --with-token, может прочитать любой процесс в sandbox и пользоваться им в проекте sandbox, пока sandbox не удалят.

Пока не начался пробный период или тариф, create возвращает HTTP 402 со ссылкой на Checkout; выполните lizard billing start. Лимиты считают vCPU запущенных sandbox: 40 на тарифе Pro после первого оплаченного счёта, 220 на тарифе Pro 5x и 1,200 на тарифе Pro 20x. У Pro 5x и Pro 20x нет лимита на запуски sandbox. Приостановленные sandbox не учитываются. В пробном периоде sandbox работает в регионе США и имеет размер small, mini или nano, одновременно 1 Small, 2 Mini и 2 Nano. Второй одновременно работающий small либо третий mini или nano, будь то создание, fork или возобновление, возвращает HTTP 403 с TRIAL_SIZE_RUNNING; приостановите или удалите один из них либо запустите mini вместо small. medium возвращает HTTP 403 с TRIAL_SANDBOX_SIZE, large или big — HTTP 403 с SANDBOX_SIZE_NOT_ALLOWED, а другой регион — HTTP 403 с TRIAL_SANDBOX_REGION. При превышении лимита vCPU create возвращает HTTP 429 с SANDBOX_LIMIT_REACHED. См. Лимиты. Песочница пробного периода удаляется не позже чем через 1 час после запуска: без --timeout (или с 0) она получает 1 час, а --timeout больше 3600000 возвращает HTTP 403 с TRIAL_SANDBOX_LIFETIME.

lizard sandbox list

Выводит список sandbox в связанном проекте (псевдоним ls).

ФлагОписание
-p, --project <id>Вывести список для указанного проекта
--allВывести все sandbox во всех ваших рабочих пространствах

lizard sandbox rm <id>

Удаляет sandbox (псевдонимы delete и kill).

ФлагОписание
-y, --yesПропустить подтверждение

lizard sandbox timeout <id> <ms>

Задаёт новое время жизни, отсчитываемое с текущего момента, в миллисекундах (не меньше 1000). Это не таймер простоя: выполнение команд его не сбрасывает. На пробном периоде срок нельзя перенести дальше чем на 1 час после создания песочницы; более поздний возвращает HTTP 403 с TRIAL_SANDBOX_LIFETIME и latestExpiresAt.

lizard sandbox exec <id> -- <command>

Запускает одну команду внутри sandbox через sh -c, передаёт её вывод потоком и завершается с её кодом выхода.

lizard sandbox ssh <id>

Открывает интерактивную оболочку в работающем sandbox (псевдоним shell). Используется ваш вход в Lizard, поэтому настраивать SSH-ключи не нужно; ограниченный API-ключ получает доступ только к sandbox в своей области. Ctrl-C, стрелки и автодополнение по Tab передаются в sandbox. Чтобы выйти, введите exit или нажмите Ctrl-D.

Нужен интерактивный терминал; в скрипте используйте lizard sandbox exec. Это не протокол SSH, поэтому SSH-клиенты, scp и проброс портов не работают.

lizard sandbox expose <id> <port>

Назначает порту в sandbox HTTPS-адрес. Порт приватный: запросам нужен токен доступа sandbox — в заголовке X-Lizard-Access-Token или в query-параметре lizard_token, который уже есть в выведенном URL. Запросы без него получают HTTP 401. С --json результат дополнительно содержит hostname и accessToken.

lizard sandbox unexpose <id> <port> удаляет URL.

lizard sandbox desktop <id>

Запускает графический рабочий стол sandbox, созданного с -t desktop, и выводит URL для браузера и URL только для просмотра. Относитесь к обеим ссылкам как к паролям.

ФлагОписание
--view-onlyВывести или открыть только URL для просмотра
--resolution <WxH>Размер экрана, от 640x480 до 3840x2160
--openОткрыть рабочий стол в браузере
--statusПоказать состояние рабочего стола и URL, не запуская его
--stopОстановить рабочий стол и удалить его URL

lizard sandbox vnc <id>

Подключает VNC-приложение (macOS Screen Sharing, TigerVNC, RealVNC) к рабочему столу sandbox, созданного с -t desktop. У рабочего стола нет публичного VNC-порта, поэтому CLI слушает localhost и передаёт каждое подключение в sandbox через защищённый WebSocket. При необходимости он запускает рабочий стол, выводит адрес и VNC-пароль и работает до нажатия Ctrl-C.

ФлагОписание
--port <port>Локальный порт (по умолчанию 5900; если он занят — следующий свободный)
--view-onlyИспользовать пароль только для просмотра: наблюдение без управления
--openОткрыть адрес в VNC-приложении (vnc://, Screen Sharing в macOS)

Пауза, возобновление и снапшоты

КомандаЧто делает
lizard sandbox pause <id>Сохраняет файлы sandbox и ставит его на паузу. Запущенные процессы завершаются, память теряется. Успешная пауза останавливает оплату вычислений; диск стоит $0.14 за ГБ-месяц используемого пространства, пока вы не возобновите или не удалите sandbox
lizard sandbox resume <id>Загружает приостановленный sandbox заново с его файлами
lizard sandbox snapshot <id> --name <name>Сохраняет только файлы работающего sandbox в снимок, который восстанавливается только в его проекте и регионе. Снимок стоит $0.14 за ГБ-месяц используемого дискового пространства, пока вы его не удалите
lizard sandbox restore <snapshot-id>Запускает новый sandbox из снапшота в проекте и регионе снапшота. --volume <name-or-id> монтирует в /workspace том из этого проекта, --timeout <ms> задаёт время жизни (по умолчанию 300000)
lizard sandbox snapshotsВыводит список снапшотов, сделанных в проекте (-p для другого проекта, --mine для всех снапшотов, которые сделали вы)
lizard sandbox snapshot-rm <snapshot-id>Удаляет снапшот (псевдоним snapshot-delete, -y пропускает подтверждение)

pause, resume и snapshot ждут завершения работы; укажите --no-wait, чтобы вернуться сразу после постановки в очередь. О том, что сохраняет каждый шаг, см. Пауза, возобновление и снапшоты.

Снапшот sandbox с подключённым томом содержит копию файлов тома на момент создания снапшота. Каждое восстановление получает эту копию и не принимает --volume, а любой, кто может восстановить снапшот, может прочитать эти файлы. --volume работает только со снапшотом sandbox, у которого не было тома, и том должен быть в проекте и регионе снапшота.

lizard sandbox fork <id>

Запускает живые копии работающего sandbox. Lizard ненадолго ставит sandbox на паузу, один раз снимает его память, процессы и файлы и запускает из этого снимка каждую копию. Исходный sandbox продолжает работать с тем же ID и временем жизни. Подготовьте один sandbox (инструменты установлены, приложение загружено), затем сделайте форк, чтобы раздать работу копиям без повторной настройки.

ФлагОписание
-n, --count <n>Сколько копий запустить, от 1 до 100 (по умолчанию 1)
--timeout <ms>Время жизни каждой копии, не меньше 1000; по умолчанию — время жизни исходного sandbox

Каждая копия — это запуск sandbox: она учитывается в лимитах запущенных sandbox и запусков, работает с размером исходного sandbox и оплачивается по этому размеру. С --json вывод содержит по одной записи на копию: {"sandbox": {...}} или {"error": "..."}. Если хотя бы одна копия не запустилась, команда завершается с кодом 1, а запущенные копии работают, пока вы их не удалите. Нельзя сделать форк sandbox на паузе или sandbox с подключённым томом (HTTP 409).

lizard sandbox files

КомандаЧто делает
lizard sandbox files ls <id> [path]Выводит содержимое директории (по умолчанию /)
lizard sandbox files cat <id> <path>Выводит содержимое файла
lizard sandbox files put <id> <local> <remote>Загружает локальный файл
lizard sandbox files get <id> <remote> <local>Скачивает файл
lizard sandbox files rm <id> <path>Удаляет файл или директорию

Coding-агенты

Запускайте coding-агента внутри sandbox со своими учётными данными. Сначала подключите их через lizard agents. Создайте sandbox из шаблона агента (codex, claude, opencode, pi или prime); в шаблоне base нет Node.js, и агенты в нём работать не могут.

lizard sandbox prompt <id> <prompt...> отправляет промпт и передаёт потоком действия агента.

ФлагОписание
--agent <name>codex (по умолчанию), claude, pi, opencode или prime
-c, --conversation <id>Продолжить эту беседу
--newНачать новую беседу
-m, --model <model>Используемая модель
--effort <level>Усилие рассуждения: minimal, low, medium, high или xhigh
--cwd <dir>Рабочая директория в sandbox (по умолчанию /workspace)
-v, --verboseТакже выводить вывод команд
--no-waitВернуться сразу после принятия промпта

Ctrl-C прекращает наблюдение; агент продолжает работу. lizard sandbox interrupt <id> [-c <conversation>] останавливает его текущий ход. lizard sandbox conversations <id> выводит список бесед, сначала новые.

Примеры

Создание sandbox и запуск команды

lizard sandbox create --size small --timeout 600000
lizard sandbox exec genuine-toddler-jasj -- python3 -c "print(1 + 1)"

Открытие оболочки

lizard sandbox ssh genuine-toddler-jasj

Подключение Persistent Volume

lizard volume create agent-workdir --size 10
lizard sandbox create --volume agent-workdir

Публикация порта

lizard sandbox exec genuine-toddler-jasj -- sh -c "nohup python3 -m http.server 3000 --bind 0.0.0.0 >/tmp/http.log 2>&1 &"
lizard sandbox expose genuine-toddler-jasj 3000

Использование рабочего стола через VNC-приложение

lizard sandbox create -t desktop
lizard sandbox vnc genuine-toddler-jasj --open

Запуск Codex в sandbox

lizard agents login chatgpt
lizard sandbox create -t codex
lizard sandbox prompt genuine-toddler-jasj "add a health check endpoint and test it"

Сохранение и восстановление sandbox

lizard sandbox snapshot genuine-toddler-jasj --name my-app
lizard sandbox snapshots --mine                     # find the snapshot ID
lizard sandbox restore <snapshot-id>

Форк подготовленного sandbox

lizard sandbox fork genuine-toddler-jasj -n 8 --json   # 8 copies with the same memory and files
lizard sandbox rm <copy-id>                            # delete a copy when its work is done

См. также

  • Sandboxes — среда выполнения, шаблоны и жизненный цикл
  • Быстрый старт Sandboxes — те же шаги через Lizard SDK
  • lizard volume — Persistent Volumes для подключения через --volume
  • lizard agents — учётные данные для sandbox prompt
  • Лимиты — размеры, лимиты запущенных sandbox, исходящий трафик и время жизни

Обновлено