
Локальная песочница для ваших ИИ-агентов
CodeRunner помогает изолировать ваших AI-агентов и их действия внутри песочницы.
Основной сценарий использования: запуск кода AI-агента в песочнице с явно выбранными монтированиями хоста и сетевым доступом. Изоляция снижает риск; она не предотвращает все потери данных или их утечку.
Для облачных управляемых виртуальных машин для агентов мы запустили - InstaVM - Мгновенные компьютеры для AI-агентов
Предварительные требования: Mac с macOS и Apple Silicon (M1/M2/M3/M4), Python 3.10+
Установщик генерирует токен песочницы в ~/.coderunner/api-token (или сохраняет
экспортированный вами CODERUNNER_API_TOKEN). Клиенты отправляют его как
Authorization: Bearer <token>; cat ~/.coderunner/api-token выводит его. Только
GET /health является публичным, а отсутствующий или слабый токен приводит к отказу в доступе. Прокси Claude
Desktop и примеры читают токен из этого файла, когда переменная
не задана. См. аутентификация и сетевые границы.
git clone https://github.com/instavm/coderunner.git
cd coderunner
chmod +x install.sh
./install.sh
Остановите песочницу, когда закончите:
container stop coderunner
Возобновите ту же песочницу позже, сохранив её файловую систему. Состояние ядра Python является энергозависимым и не переживает перезапуск виртуальной машины или сервера:
container start coderunner
Чтобы начать заново с чистым sandbox, удалите контейнер и снова запустите установщик:
container delete coderunner && ./install.sh
Ограничения CPU и памяти можно задать с помощью параметров установщика или переменных окружения CODERUNNER_CPUS и CODERUNNER_MEMORY:
./install.sh --cpus 4 --memory 8g
Дополнительные каталоги хоста должны быть смонтированы в /workspace. По умолчанию они доступны только для чтения; добавляйте :rw только если песочнице требуется запись на хост:
./install.sh \
--mount "$HOME/projects/api:/workspace/api" \
--mount "$HOME/projects/output:/workspace/output:rw"
Дополнительные монтирования по умолчанию отсутствуют. Настройки ресурсов и монтирований фиксируются при создании контейнера; удалите контейнер перед их изменением.
По умолчанию код, выполняемый в песочнице, имеет неограниченный сетевой доступ. Чтобы запустить его в сети только с хостом без доступа к интернету:
CODERUNNER_NETWORK=none ./install.sh
В этом режиме MCP-сервер доступен по адресу http://127.0.0.1:8222/mcp. Этот параметр фиксируется при создании контейнера; установщик отказывается возобновлять работу контейнера с другим сетевым режимом.
Claude Code выполняет команды на вашей машине от вашего имени, и единственной границей являются запросы разрешений. Если направить его на инструменты CodeRunner, он будет выполнять написанный им код в виртуальной машине: он сможет обращаться только к папкам, которые вы смонтировали в /workspace, к сети, которую вы разрешили, и к собственной файловой системе песочницы, что бы ему ни было поручено. Используйте песочницу для кода, который обрабатывает недоверенный ввод или который вы не стали бы запускать вручную, а также для нескольких агентов, которые не должны разделять состояние (именованные сессии). Она не защищает ничего, что вы смонтировали с правами на чтение и запись.
./install.sh (если ещё не выполнено)
container exec -it coderunner /bin/bash
root@coderunner:/app# npm install -g @anthropic-ai/claude-code
MCP-сервер будет доступен по адресу: http://coderunner.local:8222/mcp
Установщик создаёт ~/.coderunner/venv для прокси Claude Desktop. Для остальных примеров на Python установите их зависимости в собственное виртуальное окружение:
pip install -r examples/requirements.txt



Скопируйте пример конфигурации:
cd examples
cp claude_desktop/claude_desktop_config.example.json claude_desktop/claude_desktop_config.json
Отредактируйте файл конфигурации и замените пути-заполнители:
/path/to/your/python на $HOME/.coderunner/venv/bin/python, используя полный путь к вашему домашнему каталогу/path/to/coderunner на фактический путь к вашему клонированному репозиториюПример после редактирования:
{
"mcpServers": {
"coderunner": {
"command": "/Users/yourname/.coderunner/venv/bin/python",
"args": ["/Users/yourname/coderunner/examples/claude_desktop/mcpproxy.py"]
}
}
}
Обновите конфигурацию Claude Desktop:
Начните использовать CodeRunner в Claude: Код, который пишет Claude, теперь выполняется в песочнице.
Если инструмент отображается как «Disabled» в меню инструментов чата, хотя сервер указан как запущенный: полностью закройте Claude
Desktop (Cmd-Q) и откройте его снова, убедитесь, что command — это python из venv, который вывел установщик (в нём
есть fastmcp), и прочитайте ~/Library/Logs/Claude/mcp-server-coderunner.log на предмет ошибки прокси. Прокси
требует запущенной песочницы (container list) и файла токена ~/.coderunner/api-token.
Быстрый старт:
# 1. Install and start CodeRunner (one-time setup; run as yourself, it asks for sudo when it needs it)
git clone https://github.com/instavm/coderunner.git
cd coderunner
./install.sh
# 2. Add the sandbox with its token (the installer prints this command)
claude mcp add --transport http coderunner http://coderunner.local:8222/mcp \
--header "Authorization: Bearer $(cat ~/.coderunner/api-token)"
# 3. Reconnect to MCP servers
/mcp
Плагин Claude Code (claude plugin marketplace add https://github.com/instavm/coderunner-plugin) появился раньше
токена и получает 401, пока не отправит тот же заголовок; используйте команду выше, пока плагин не обновлён.
Шаги установки:
Перейдите в Plugin Marketplace:

Добавьте репозиторий InstaVM:

Выполните код Python с помощью Claude Code: