К основному содержанию
скилл CX Codex

windows-sandbox-setup — скилл для Claude Code: настройка

Скилл windows-sandbox-setup для Claude Code проверяет и настраивает Windows Sandbox для работы через CLI или MCP. Запускается перед первым использованием, при ошибке готовности или когда уже открытая песочница мешает создать новую.

MIT ★ 494 обновлён 2026-11-15

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add shanselman/sandbox-mcp --skill windows-sandbox-setup -a claude-code
Открыть на GitHub

Что делает windows-sandbox-setup

Скилл проверяет готовность Windows Sandbox через sbx doctor, объясняет найденные проблемы и предлагает исправления по порядку. Проверка ничего не включает, не запрашивает права администратора и не перезагружает компьютер. Для подтверждения работы он запускает charmap.exe в песочнице с отключённой сетью.

Windows Sandbox работает на Windows 11 24H2 или новее в редакциях Pro, Enterprise и Education; агент должен работать на этом же компьютере. Редакции Home и Server не подходят. Для включения функции или настройки виртуализации обычно нужны права администратора и перезагрузка. Если другая песочница уже запущена, Windows не позволит создать ещё одну: скилл предлагает проверить её владельца, прежде чем останавливать.

Какие задачи решает

  • проверить готовность Windows Sandbox перед первым запуском
  • понять, почему sbx сообщает о неготовой песочнице
  • разобрать причину, по которой запущена другая песочница
  • подтвердить запуск тестовой программы без сети

Примеры запросов агенту

  • Проверь, готова ли Windows Sandbox к первому запуску.
  • Разберись, почему sbx сообщает, что Windows Sandbox не готова.
  • Проверь запущенную песочницу и объясни, как освободить слот.

Как установить windows-sandbox-setup

1Через Skills CLI (Vercel)

npx skills add shanselman/sandbox-mcp --skill windows-sandbox-setup -a claude-code

2Вручную: положить файлы

~/.claude/skills/windows-sandbox-setup/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/windows-sandbox-setup/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о windows-sandbox-setup

Как установить windows-sandbox-setup в Claude Code?

Выполни npx skills add shanselman/sandbox-mcp --skill windows-sandbox-setup -a claude-code. Файл скилла находится по пути ~/.claude/skills/windows-sandbox-setup/SKILL.md.

Что делает windows-sandbox-setup?

Скилл проверяет готовность Windows Sandbox, объясняет найденные неполадки и помогает подтвердить работу запуском тестовой программы.

Что нужно для работы windows-sandbox-setup?

Нужен компьютер с Windows 11 24H2 или новее в редакции Pro, Enterprise либо Education; агент должен работать на этом компьютере. Для MCP-интерфейса нужны Node.js 20 или новее в PATH и доступ к сети при первой загрузке. CLI не требует MCP-адаптера.

Исходный текст

SKILL.md · MIT
---
name: windows-sandbox-setup
description: Get Windows Sandbox ready for sandbox-mcp CLI or MCP workflows. Use when sbx or a sandbox tool says "Windows Sandbox isn't ready", when a sandbox is already running and blocks a new one, or before first use.
---

# Set up Windows Sandbox

Windows Sandbox runs only on **Windows 11 24H2 or later, Pro, Enterprise or Education**. Home and Server editions can't run it, and neither can macOS or Linux hosts. The agent must run on that Windows PC itself.

If shell access is available, use the `sbx` CLI; the optional MCP adapter uses the same engine and is not required.

## Check the PC

Run the read-only check. It never enables features, elevates or restarts anything.

```powershell
sbx doctor
```

If `sbx` isn't on PATH, use the portable ZIP's `.\sbx.cmd` (no Node.js install required). With Node.js and npm,
you can also run the one-off check without installing the plugin:

```powershell
npx --yes --package=github:shanselman/sandbox-mcp sbx doctor
```

To install the portable package with its bundled Node.js and verified download, follow [the agent setup guide](https://raw.githubusercontent.com/shanselman/sandbox-mcp/main/docs/agent-setup.md). It asks before admin changes or a restart.

Exit code 0 means ready. Exit code 1 lists each problem with its `Fix:` line; add `--json` for structured output.
`sbx start` and `sbx run` report the same readiness checks as `sandbox_start` and the one-shot MCP tools.

## Fix what it reports

Pass the fixes to the user, in order. They usually need an administrator and a restart, so don't run them yourself or try to work around them.

- **Sandbox feature off:** in an administrator PowerShell, run `Enable-WindowsOptionalFeature -Online -FeatureName Containers-DisposableClientVM -All`, then restart Windows.
- **`wsb` tool missing:** open Windows Sandbox from the Start menu once, then close it. It updates itself from the Microsoft Store, which adds `wsb`.
- **Virtualization off:** turn on Intel VT-x or AMD-V in UEFI/BIOS. Inside a VM, the host must enable nested virtualization.
- **Node.js too old:** `winget install OpenJS.NodeJS.LTS --source winget`, then restart the agent so it sees the new PATH.
- **Home or Server edition:** there is no fix short of a different Windows edition. Tell the user and stop.

## Confirm it works

With shell access, run `sbx run C:\Windows\System32\charmap.exe --network off`. Otherwise, call
`sandbox_run` with `app: "C:\\Windows\\System32\\charmap.exe"` and `network: "off"`. It should report PASS in under a minute.

## If you chose MCP and its tools don't appear

This only affects the optional MCP interface; the CLI remains usable. The plugin starts the server with
`cmd /d /c npx --yes github:shanselman/sandbox-mcp#<version>`, which needs Node.js 20 or later on PATH and
network access for the first download. Run that command in a terminal to see the error; a working server logs
`ready` to stderr and then waits on stdin. Press Ctrl+C to stop it.

## If a sandbox is already running

Windows allows one sandbox at a time. Check with `sbx status` or `sandbox_status`. Stop only a guest you own,
with `sbx stop` or `sandbox_stop`. If you don't own it, it may hold someone's work, so ask its owner or the user
rather than interrupting it. Only with their approval, use the force option.

## Settings

Set these in the shell environment for `sbx`, or in the MCP server environment when using that adapter:

| Variable | Default | Purpose |
|---|---|---|
| `SANDBOX_MCP_HOME` | `%LOCALAPPDATA%\sandbox-mcp` | Where runs, screenshots and reports are kept |
| `SANDBOX_MCP_ALLOWED_ROOTS` | any folder | `;`-separated host folders that may be copied in |
| `SANDBOX_MCP_IDLE_MINUTES` | `30` | Guest shuts down after this long idle; `0` disables |
| `SANDBOX_MCP_KEEP_ON_EXIT` | unset | `1` leaves the sandbox running when the client disconnects |

© Scott Hanselman · MIT · shanselman/sandbox-mcp

Похожие скиллы

Все скиллы по теме «Безопасность» →
sandbox-npm-install официальный github Скилл sandbox-npm-install ставит npm-зависимости на локальной ext4-файловой системе Docker и возвращает node_modules в workspace через symlink. Нужен при virtiofs. CX Codex +1 1 700установок zeroboot-vm-sandbox reason-machines Скилл zeroboot-vm-sandbox запускает код агента в отдельной KVM-виртуалке через Zeroboot: форк шаблона занимает меньше миллисекунды. CX Codex +1 1 300установок generate-sandbox-policy NVIDIA Скилл generate-sandbox-policy для Claude Code создаёт YAML-политики sandbox и настраивает сетевые middleware. Ограничивает доступ к API по хосту, методу или пути. CX Codex +1 731установок sandbox-guard UseAI-pro Скилл sandbox-guard для Claude Code и Codex генерирует Docker-конфигурацию песочницы для недоверенных скиллов. Не даёт чужому коду доступ к хосту. CX Codex +1 484установок rivet-sandbox-agent rivet-dev Скилл rivet-sandbox-agent для Claude Code запускает кодинг-агентов в изолированных песочницах и управляет ими через HTTP API для удалённого выполнения кода и работы с виртуальным рабочим столом. CX Codex +1 442установок windows-lateral-movement yaklang Скилл windows-lateral-movement для Claude Code описывает перемещение между Windows-хостами через PsExec, WMI, WinRM, DCOM, RDP и передачу хешей и билетов. Используется в пентесте после доступа к хосту. CX Codex +1 3 900установок

Из того же набора6

windows-sandbox-detonate Скилл windows-sandbox-detonate для Claude Code запускает подозрительные файлы в изолированной Windows Sandbox без сети. Агент показывает процессы, изменения системы и сетевую активность. CX Codex +1 ★ 494звёзд репо windows-sandbox-installer-test Скилл windows-sandbox-installer-test для Claude Code проверяет установщики и деинсталляторы Windows в чистой Windows Sandbox. Запускается по запросу проверить тихую установку .exe или .msi, зависание либо следы после удаления. CX Codex +1 ★ 494звёзд репо windows-sandbox-app-test Скилл windows-sandbox-app-test для Claude Code проверяет Windows-приложения и пакеты MSIX в чистой Windows Sandbox. Запускается, когда нужно выяснить, работает ли сборка без сред разработки и установленных рантаймов. CX Codex +1 ★ 494звёзд репо windows-sandbox-interactive Скилл windows-sandbox-interactive для Claude Code управляет приложением в работающей Windows Sandbox. Он помогает пройти UI-сценарий, воспроизвести ошибку или сравнить состояние системы до и после действия. CX Codex +1 ★ 494звёзд репо sandbox-mcp Запускает приложения в отдельной Windows Sandbox и даёт агенту управлять их интерфейсом. Он помогает проверить установщик, приложение или подозрительный файл в чистой среде. ★ 494звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой