Первая песочница¶

CLI установлен, gateway запущен — создайте песочницу для проекта, с которым будет работать агент.

Чтобы alias base указывал на опубликованный Quarshell image, задайте CAUTEM_USE_GHCR=1 и сохраните policy-файл, как показано в инструкциях для macOS или Linux. Ниже предполагается путь ~/.config/cautem/default-policy.yaml.

Создание¶

Создайте sandbox под управлением Gateway:

cautem sandbox create \
  --name demo \
  --gateway-workspace default \
  --from base \
  --policy ~/.config/cautem/default-policy.yaml \
  --upload "$PWD" \
  --memory 2g

Флаг	Что делает
`--name`	Имя sandbox
`--gateway-workspace`	Workspace выбранного Gateway
`--from`	Alias image; `base` использует GHCR при `CAUTEM_USE_GHCR=1`
`--policy`	YAML-файл политики sandbox
`--upload`	Копия локального проекта в `/workspace`
`--memory`	Лимит памяти sandbox

Работа внутри¶

cautem sandbox list
cautem sandbox exec demo -- uname -a
cautem sandbox connect demo

connect открывает интерактивный shell в sandbox. Gateway workspace задаёт область ресурса и не монтирует локальную папку.

Доступы¶

Опционально. Секреты хранятся в gateway и не попадают в песочницу — агент видит только плейсхолдеры:

GITHUB_TOKEN=… cautem provider create --name gh --type github --credential GITHUB_TOKEN

cautem sandbox create \
  --name demo-with-gh \
  --gateway-workspace default \
  --from base \
  --policy ~/.config/cautem/default-policy.yaml \
  --provider gh

Подробнее: Credential-провайдеры · Cursor Agent.

Логи, остановка, удаление¶

cautem logs demo --tail --source proxy
cautem sandbox stop demo
cautem sandbox delete demo

delete удаляет песочницу, её proxy sidecar, сеть и data volumes. Секреты провайдеров остаются в gateway.

Что дальше¶

Когда агент упирается в заблокированный хост, он получает 403 с причиной. В разделе Политика — как одобрить узкое правило без пересоздания песочницы, а в Пересоздание sandbox — какие изменения всё же требуют нового контейнера.