Sandcat CLI
Песочница в Docker запускает агента без подтверждений под фильтром трафика и с подстановкой секретов в прокси.
- 204 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Режим `--dangerous` снимает подтверждения у агента, и защита держится на правилах сети, которые задает пользователь.
- Установщик из сети и прокси хранят ключи API в настройках на вашей машине.
Установка
- Работает в
Ручная установка
curl -fsSL https://raw.githubusercontent.com/VirtusLab/sandcat/master/install.sh | shПервый шаг быстрого старта. Дальше `sandcat init` и `sandcat run`.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Режим `--dangerous` снимает подтверждения у агента, и защита держится на правилах сети, которые задает пользователь.
- Установщик из сети и прокси хранят ключи API в настройках на вашей машине.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Sandcat разворачивает песочницу для ИИ-агентов Claude Code, Cursor CLI, Codex CLI и GitHub Copilot CLI. Весь сетевой трафик контейнера идет через прозрачный mitmproxy по WireGuard, без настройки прокси в каждом инструменте. Движок правил разрешает или запрещает HTTP/S-запросы и DNS по спискам, а прочие TCP и UDP отбрасываются. Секреты подставляются на уровне прокси: контейнер не видит настоящих значений. CLI `sandcat` инициализирует проект командой `sandcat init`, например `--agent claude --ide vscode --stacks "python,node"`, и запускает его через `sandcat run` либо как контейнер разработки в VS Code. Проект входит в платформу Visdom от VirtusLab.
Для кого. Разработчикам и командам безопасности, которые хотят давать агенту полный доступ к командам, но ограничивать сеть и защищать ключи.
Подходит, если
- Агента запускают в режиме без подтверждений, и сеть надо ограничить списком разрешенных хостов.
- Ключи API нельзя оставлять внутри контейнера, где работает агент.
- Нужна воспроизводимая среда в VS Code как контейнер разработки.
- Команде нужно разрешить агенту доступ только к пакетным реестрам.
Не подходит, если
- Нужна защита от вредоносного кода на уровне ядра: контейнер Docker слабее виртуальной машины.
- Нет Docker с `docker compose` и утилиты `yq`.
- Надо запускать агента на удаленной машине без Docker.
Пример запроса к агенту
Настрой Sandcat для этого проекта на Python и Node с агентом Claude и открой его как контейнер разработки.Ограничения
Нужны Docker с `docker compose` и `yq`. Установка идет через `install.sh` из репозитория: прочитайте скрипт до запуска. Ключи API добавляют в `~/.config/sandcat/settings.json`, а правила разрешений пишет пользователь, поэтому слишком широкий список ослабляет защиту. Песочница на Docker не заменяет изоляцию виртуальной машины. Документация вынесена на сайт sandcat.virtuslab.com. Последний коммит сделан в ноябре 2026 года.
Как отключить. Остановите контейнеры командой `docker compose down` для проекта, удалите папку `.devcontainer` с файлами Sandcat и настройки `~/.config/sandcat/`.
Частые вопросы
Как установить Sandcat?
Выполните `curl -fsSL https://raw.githubusercontent.com/VirtusLab/sandcat/master/install.sh | sh`. Нужны Docker с `docker compose` и `yq`.
Как инициализировать проект?
Командой `sandcat init --agent claude --ide vscode --stacks "python,node" --name myproject`. Затем добавьте ключи в `~/.config/sandcat/settings.json` и запустите `sandcat run`.
Как контейнер получает секреты?
Не получает. Прокси подставляет настоящие значения в исходящие запросы, а внутри контейнера лежат только заглушки.
Что с трафиком вне HTTP?
Запросы HTTP/S и DNS проходят через правила, а любые другие TCP и UDP, не содержащие имени хоста, блокируются.
Какие агенты поддерживаются?
Claude Code, Cursor CLI, Codex CLI и GitHub Copilot CLI.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыagents-sandbox запускает кодового агента внутри отдельной микровиртуальной машины, скрывая от него остальную систему и секреты.
Песочница для ИИ-агентов на Linux и macOS без контейнеров: файлы, сеть и системные вызовы закрыты, пока вы не откроете их явно
Claude Code, Codex, OpenCode и pi работают в усиленном контейнере: файлы только проекта, сеть по белому списку, ключи в прокси.
Команда safehouse запускает Claude Code, Codex и другие агенты в песочнице macOS: файлы закрыты по умолчанию, нужные папки открываются флагами
Один бинарный файл запускает кодинг-агентов в песочнице: микровиртуалка, сетевые правила и скрытые от агента секреты.
VibeKit запускает Claude Code, Codex и другие CLI-агенты через прокси: вымарывает секреты в ответах, ведет журнал сессий, по флагу прячет агента в Docker
Коротко о README
В README разобраны схема с прозрачным прокси, быстрый старт из трех шагов и раскладку репозитория: CLI, шаблоны контейнера разработки и скрипты фильтрации сети. Полная документация лежит на отдельном сайте.