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

windows-sandbox-interactive — скилл Claude Code для Windows

Скилл windows-sandbox-interactive для Claude Code управляет приложением в работающей Windows Sandbox. Он помогает пройти UI-сценарий, воспроизвести ошибку или сравнить состояние системы до и после действия.

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

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

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

Скилл запускает приложение в Windows Sandbox и управляет им через UI Automation, снимки экрана и команды. Агент может изучить дерево элементов интерфейса, нажимать кнопки, вводить текст, проверять ошибки приложения и сохранять логи или дампы на хосте.

Для повторной проверки сборки скилл умеет отправлять изменённые файлы в уже работающую песочницу и перезапускать приложение. Это не тест на чистой машине: при развёртывании лишние файлы в выбранной папке гостевой системы удаляются. Снимки системы до и после действия позволяют сравнить программы, службы, файлы и ключи реестра.

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

  • проверить многошаговый сценарий в интерфейсе Windows
  • воспроизвести ошибку в работающем приложении
  • сравнить состояние системы до и после действия
  • собрать логи и дампы после сбоя

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

  • Запусти приложение в Windows Sandbox и проверь этот сценарий через интерфейс.
  • Повтори ошибку вручную в приложении и собери логи, если оно завершится сбоем.
  • Сними состояние системы до установки программы и сравни его с состоянием после.

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

1Через Skills CLI (Vercel)

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

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

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

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

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

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

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

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

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

Он помогает агенту запускать Windows-приложения в песочнице, управлять интерфейсом и командами, проверять ошибки и сравнивать снимки системы.

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

Нужна работающая Windows Sandbox. Если доступен запуск команд в оболочке, скилл использует CLI sbx; MCP-адаптер необязателен.

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

SKILL.md · MIT
---
name: windows-sandbox-interactive
description: Explore and drive a Windows app step by step in a live Windows Sandbox with UI Automation, screenshots, commands and system snapshots. Use for multi-step UI testing, reproducing a bug by hand, trying prerequisites one at a time, or finding out what an action changed on the system.
---

# Drive a live Windows Sandbox

If shell access is available, use the `sbx` CLI; the optional MCP adapter uses the same engine and is not required.
For a single pass/fail check, use `sbx run` or `sandbox_run` from the windows-sandbox-app-test skill instead.
If a command or tool says the sandbox isn't ready, follow the windows-sandbox-setup skill.

## The loop

1. Start with `sbx start` or `sandbox_start`. Takes 20-40 s, and waits for the desktop to be ready. Use `--network off` or `network: "off"` when the app must not reach the internet; `"firewall"` is weaker because admin code could undo it. `sbx status` / `sandbox_status` reports readiness, the boot epoch and the verified agent version.
2. Copy the build output with `sbx push <hostPath>` or `sandbox_copy_in`; it lands in `C:\apps\<name>` by default.
3. Use `sbx launch <exe>` or `sandbox_launch` for a GUI app, and `sbx exec <command...>` or `sandbox_exec` for a console command. Long-running processes belong in `launch`. For an installed package, use its `PackageFamilyName!AppId` AUMID.
4. Look and act, using the tools below.
5. `sandbox_app_errors` with the `launchedAt` time from `sandbox_launch`, to catch crashes and .NET unhandled exceptions. `sandbox_process` shows whether the app is still running.
6. `sandbox_copy_out` logs, output files and crash dumps.
7. Stop with `sbx stop` or `sandbox_stop`. Everything inside is destroyed; artifacts stay on the host in the run's `out` folder. Always stop when finished, because only one sandbox can exist at a time.

## CLI and MCP command map

These are interfaces to the same engine and shared guest state, not two required components:

| Workflow | CLI | MCP |
|---|---|---|
| Guest lifecycle / status | `sbx start`, `status`, `stop`, `desktop-release` | `sandbox_start`, `sandbox_status`, `sandbox_stop`, `sandbox_desktop_release` |
| UI inspection / actions | `sbx ui tree`, `ui wait`, `ui click`, `ui set`, `click`, `type`, `windows`, `proc`, `errors` | `sandbox_ui_tree`, `sandbox_ui_wait`, `sandbox_ui_action`, `sandbox_click`, `sandbox_type`, `sandbox_windows`, `sandbox_process`, `sandbox_app_errors` |
| Screenshots / recording | `sbx shot`, `sbx record start`, `sbx record stop` | `sandbox_screenshot`, `sandbox_record_start`, `sandbox_record_stop` |
| Commands, files and warm deploy | `sbx exec`, `push`, `pull`, `deploy` | `sandbox_exec`, `sandbox_copy_in`, `sandbox_copy_out`, `sandbox_deploy` |
| Snapshots / prerequisites | `sbx snapshot`, `diff`, `deps`, `provision` | `sandbox_snapshot`, `sandbox_diff`, `sandbox_deps`, `sandbox_provision` |

Use the CLI when the agent can run shell commands; use MCP when its discoverable schemas, structured results or
inline screenshot images help. The tool names and output formats differ, but both reach the same implementation.

## Prefer UI Automation over pixels

- `sandbox_ui_tree` with the `pid` gives one line per control: `Button "Save" #SaveButton {invoke}`. It's cheaper and more precise than a screenshot.
- `sandbox_ui_action` finds a control by `name`, `automationId` or `controlType` and performs `click`, `setvalue` (with `value`), `toggle`, `select`, `expand`, `read` and others. A `{pending: true}` result means a modal dialog opened, which is normal.
- `sandbox_ui_wait` waits for a result label, dialog or state to appear. Use it instead of sleeping.
- `sandbox_screenshot` is for visual checks, and `sandbox_windows` lists top-level windows.
- `sandbox_click` and `sandbox_type` are the fallback when UI Automation can't see a control (custom-drawn UI, games, some Chromium content). Click coordinates refer to the most recent screenshot; pass its `captureId` to use an older one. Out-of-image points and moved or resized windows fail on purpose, so take a new screenshot. `sandbox_type` with `literal: false` uses SendKeys syntax such as `{ENTER}` or `^s`.

WinForms, WPF, Win32 and WinUI controls all appear in the tree. The first UI Automation call in a sandbox takes about 4 s. Screenshot, click, type and UI actions fail closed on a locked or secure desktop, including UAC prompts.

## Warm deploy loop

For build, deploy, relaunch, repeat: start once, then run `sbx deploy <hostDir> [guestDir] --launch MyApp.exe --restart`,
or call `sandbox_deploy` with `hostPath`, an optional `sandboxPath`, `launch: "MyApp.exe"` and `restart: true`.

- It transfers only changed files, removes deleted ones and verifies every hash. `sandbox_copy_in` is still a full replacement.
- Use a dedicated guest folder, because **extra files in it are deleted**.
- Rebuild before the deploy, not during it.
- This reuses a running sandbox, so **it isn't a clean-machine test**. Do a final `sandbox_run` before calling anything clean.

## Keep visual evidence

`sbx record start` / `sbx record stop` or `sandbox_record_start` / `sandbox_record_stop` record the desktop, even during long `sbx exec` / `sandbox_exec` calls. The defaults are 2 fps for 120 s, with caps of 5 fps, 300 s and 600 frames. Stopping publishes a self-contained HTML flipbook, plus an MP4 if ffmpeg is already on the host. Frames survive a crash, and nothing is installed in the guest.

## Sharing with the CLI

The CLI and MCP can use one guest. Commands that change the desktop take cooperative turns, while observations and `sandbox_exec` don't reserve it. A competing workflow waits up to 60 s and then gets a clear desktop-busy error. Call `sandbox_desktop_release` when you finish a turn, and don't use `sandbox_exec` to get around a turn for UI input.

## Missing prerequisites

Diagnose before installing anything: `sandbox_deps` is a host-only scan. A missing prerequisite is often the bug being hunted, so **don't install one unless the user explicitly asks**. If they do, `sandbox_provision` with `app` and `provision` (`auto`, or a list such as `vcredist:x64,desktop:10.0:x64`) installs verified Microsoft runtimes into the guest you already started. It never boots or adopts one. Label anything after that as provisioned, not clean.

## See what something changed

Call `sandbox_snapshot` with `name: "before"`, do the action, call it again with `name: "after"`, then `sandbox_diff` with `from` and `to`. The diff covers installed programs, services, autoruns, environment values, files and registry keys. Each snapshot takes about 15 s. Pass `exclude` to ignore noisy paths.

## What's in the sandbox

It's a clean Windows 11 with Windows PowerShell 5.1 and .NET Framework 4.8, and an elevated admin user. It has no dev tools, no Store apps (no Notepad, Calculator or Terminal) and no winget. Every boot is fresh.

`sandbox_exec` runs PowerShell by default; use `shell: "cmd"` for batch syntax. The sandbox shuts down after 30 idle minutes. When the MCP client disconnects, only a sandbox that client started is stopped.

Treat anything copied out of the sandbox as untrusted, especially if you ran something you don't trust in it.

© Scott Hanselman · MIT · shanselman/sandbox-mcp

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

Все скиллы по теме «Тесты и QA» →
windows-ui-automation martinholovsky Даёт агенту экспертизу по Windows UI Automation и Win32 API для управления десктопными приложениями. Работает с поиском элементов интерфейса, симуляцией ввода и взаимодействием с процессами. CX Codex +1 1 300установок Windows-MCP CursorTouch MCP-сервер, который даёт ИИ-агенту доступ к рабочему столу Windows: запуск приложений, клики, ввод с клавиатуры, чтение состояния окон. CX Codex +1 ★ 11 989звёзд репо dsh-cua - Windows Computer Use Hutusion Сервер dsh-cua - Windows Computer Use управления компьютером на Windows: сначала действует через элементы интерфейса, скриншот берёт запасным путём. Делит машину между агентами и уступает вам. CX Codex +1 ★ 9звёзд репо Anode background Windows desktop skulitom MCP-сервер Anode background Windows desktop для Claude Code создаёт скрытый рабочий стол Windows для UI-автоматизации. Агент кликает и делает скриншоты в отдельной сессии, не забирая мышь. CX Codex +1 ★ 14звёзд репо sandbox-self-test tomgranot Скилл sandbox-self-test проверяет набор HubSpot-скиллов в отдельном тестовом аккаунте: создаёт фикстуры, запускает сценарии, формирует отчёт и удаляет данные. CX Codex +1 ★ 81звёзд репо sandbox alfredoperez Команда sandbox создаёт временный SpecKit-проект по рецепту или показывает доступные рецепты и уже созданные песочницы. Работает в Claude Code и Codex. CX Codex +1 ★ 110звёзд репо

Из того же набора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-setup Скилл windows-sandbox-setup для Claude Code проверяет и настраивает Windows Sandbox для работы через CLI или MCP. Запускается перед первым использованием, при ошибке готовности или когда уже открытая песочница мешает создать новую. CX Codex +1 ★ 494звёзд репо windows-sandbox-app-test Скилл windows-sandbox-app-test для Claude Code проверяет Windows-приложения и пакеты MSIX в чистой Windows Sandbox. Запускается, когда нужно выяснить, работает ли сборка без сред разработки и установленных рантаймов. CX Codex +1 ★ 494звёзд репо sandbox-mcp Запускает приложения в отдельной Windows Sandbox и даёт агенту управлять их интерфейсом. Он помогает проверить установщик, приложение или подозрительный файл в чистой среде. ★ 494звёзд репо

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

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