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

sandbox — команда для Claude Code: что делает и как установить

Команда sandbox создаёт временный SpecKit-проект по рецепту или показывает доступные рецепты и уже созданные песочницы. Работает в Claude Code и Codex.

MIT ★ 110 обновлён 2026-10-19

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/commands/sandbox.md
Открыть на GitHub

Что делает sandbox

sandbox создаёт небольшую временную песочницу из рецепта в соседнем репозитории speckit-sandboxes. Пустой вызов показывает рецепты и существующие песочницы, а where печатает путь к корню песочниц. При сборке занятое имя не перезаписывается: добавляется суффикс вроде -2 или -3.

Для режима разработки есть флаг --dev: тогда Companion берётся из текущего checkout через COMPANION_DIR="$PWD". Дополнительные аргументы после имени передаются рецепту без изменений, что нужно, например, для сценария living-specs. Команда не удаляет папки и не пишет в этот репозиторий.

Перед запуском нужен checkout репозитория speckit-sandboxes: .claude/sandboxes-env.sh задаёт пути к нему и к корню песочниц. Без этого checkout команда остановится. Если сборка завершится ошибкой, частично созданная папка останется на месте.

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

  • создать временный SpecKit-проект по рецепту
  • посмотреть список доступных рецептов
  • найти уже созданные песочницы
  • узнать путь к корню песочниц
  • собрать песочницу с Companion из текущего checkout

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

  • Создай песочницу по рецепту living-specs с именем drift-check
  • Покажи доступные рецепты и уже созданные песочницы через /sandbox
  • Выведи путь к корню песочниц командой /sandbox where

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

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

.claude/commands/sandbox.md

Вызов — /sandbox. Для всех проектов — ~/.claude/commands/

Вопросы о sandbox

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

Скопируйте файл в .claude/commands/sandbox.md.

Что делает команда sandbox?

Она создаёт временную SpecKit-песочницу из рецепта либо выводит список рецептов и существующих песочниц. Путь к корню можно получить через /sandbox where.

Что произойдёт при запуске sandbox с флагом --dev?

Companion будет установлен из текущего checkout через COMPANION_DIR="$PWD". Рецепты vscode-qa-stock, copilot-stock и claude-mod-stock отказываются от --dev, поэтому сборка не запускается.

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

sandbox.md · MIT
---
allowed-tools: Bash(. .claude/sandboxes-env.sh:*), Bash("$SANDBOXES_REPO"/new-sandbox.sh:*), Bash(ls:*)
description: Build a throwaway SpecKit test sandbox from a recipe, or list the recipes and the sandboxes that exist
argument-hint: "[<recipe> [name] [--dev] | where]"
---

## Your task

Build one test sandbox, or show what there is. A sandbox is a small throwaway project in a known starting state; the recipes live in the sibling `speckit-sandboxes` repo and every built sandbox lands under its sandbox root, never in this repo.

Shell state does not persist between Bash calls, so start each one with `. .claude/sandboxes-env.sh`. It sets `$SANDBOXES_REPO` (the sibling checkout) and `$SANDBOXES_DIR` (the sandbox root). If it says there is no checkout, relay that line and stop.

### Read `$ARGUMENTS`

- **empty**: list. Print the recipes, then the sandboxes that already exist:

  ```bash
  . .claude/sandboxes-env.sh && "$SANDBOXES_REPO"/new-sandbox.sh --list
  . .claude/sandboxes-env.sh && ls -1 "$SANDBOXES_DIR" 2>/dev/null || echo "(no sandboxes yet)"
  ```

  Show both as two short lists, with the root's path above the second. Do not build anything. Two folders in the second list are not sandboxes, so say what they are when they show up: `bench-cells` holds the benchmark's cells and `awesome-copilot` is `/publish-canvas`'s upstream clone.

- **`where`**: print the sandbox root and nothing else.

  ```bash
  . .claude/sandboxes-env.sh && "$SANDBOXES_REPO"/new-sandbox.sh --where
  ```

- **`<recipe> [name]`**: build one. The name defaults to the recipe, and a name that is taken is never reused: the new sandbox becomes `<name>-2`, then `-3`.

  ```bash
  . .claude/sandboxes-env.sh && "$SANDBOXES_REPO"/new-sandbox.sh <recipe> [name]
  ```

- **`<recipe> [name] --dev`**: the same, with Companion installed from this checkout in place of the published build. `COMPANION_DIR` points the recipe here; without it the recipe uses the `speckit-companion` folder beside the sandboxes repo, which is not this checkout when you are in a worktree.

  ```bash
  . .claude/sandboxes-env.sh && COMPANION_DIR="$PWD" "$SANDBOXES_REPO"/new-sandbox.sh <recipe> [name] -- --dev
  ```

  A recipe with no Companion (`vscode-qa-stock`, `copilot-stock`, `claude-mod-stock`) refuses `--dev`; say so and build nothing.

Anything else after the name goes to the recipe after `--`, unchanged: `living-specs` takes its scenario that way (`/sandbox living-specs drift-check ls-6`). An unknown recipe prints the list; relay it.

### Report

The recipe ends by printing `Sandbox ready: <folder>` and what to do in it. Relay exactly that: the folder, and what to type next. Add nothing of your own, and do not open the folder or run anything in it.

### Guardrails

- This command never deletes anything: not a sandbox, not a file inside one, not the root. Throwing a sandbox away is the user's call and the user's `rm`.
- It never builds over an existing folder, and never writes into this repo.
- A build that fails leaves its half-built folder in place. Name it in the report so the user can look, and do not clean it up.

© alfredoperez · MIT · alfredoperez/speckit-companion

Похожие слэш-команды

Все слэш-команды по теме «Тесты и QA» →
windows-sandbox-interactive Scott Hanselman Скилл windows-sandbox-interactive для Claude Code управляет приложением в работающей Windows Sandbox. Он помогает пройти UI-сценарий, воспроизвести ошибку или сравнить состояние системы до и после действия. CX Codex +1 ★ 494звёзд репо sandbox-self-test tomgranot Скилл sandbox-self-test проверяет набор HubSpot-скиллов в отдельном тестовом аккаунте: создаёт фикстуры, запускает сценарии, формирует отчёт и удаляет данные. CX Codex +1 ★ 81звёзд репо sandbox-stable cloudflare Скилл sandbox-stable помогает создавать и поддерживать Cloudflare Sandbox на стабильном пакете @cloudflare/sandbox. Он нужен для изолированных Linux-сред в Workers. CX Codex +1 85 900установок sandbox-next cloudflare Скилл для разработки приложений Cloudflare Sandbox на превью-версии SDK 1.0 (@cloudflare/sandbox@next). Даёт агенту правила работы с новым API процессов и терминалов. CX Codex +1 85 100установок zeroboot-vm-sandbox reason-machines Скилл zeroboot-vm-sandbox запускает код агента в отдельной KVM-виртуалке через Zeroboot: форк шаблона занимает меньше миллисекунды. CX Codex +1 1 300установок bailian-sandbox modelstudioai Скилл bailian-sandbox управляет песочницами и шаблонами Alibaba Bailian из терминала: создать, подключить, поставить на паузу, удалить. CX Codex +1 1 100установок

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

Весь набор →
bench-sync Команда bench-sync для Claude Code и Codex, которая запекает ячейки бенчмарка и измеряет текущую версию spec-kit и расширения Companion. Нужна, чтобы отследить, как меняется производительность инструмента при обновлениях. CX Codex +1 ★ 110звёзд репо speckit.companion.living-show Команда speckit.companion.living-show для Claude Code показывает часть living spec: заголовки требований, одно требование целиком или правила для файла. Она запускается, когда нужно найти конкретное правило, не открывая весь документ. CX Codex +1 ★ 110звёзд репо speckit.companion.status Команда speckit.companion.status для Claude Code и Codex показывает шаг, статус, решения и следующее действие активной спеки из .spec-context.json. Она работает только на чтение. CX Codex +1 ★ 110звёзд репо speckit.plan Промпт speckit.plan запускает процесс планирования реализации по спецификации: собирает research.md, data-model.md и схемы API в папку contracts/. CX Codex GP ChatGPT ★ 110звёзд репо release-qa Команда release-qa для Claude Code проверяет код перед выпуском: сравнивает его с последним тегом версии, запускает тесты и ручные проверки, пишет отчёт с вердиктом ship или fix-first. Блокирует /publish до прохождения проверок. CX Codex +1 ★ 110звёзд репо install-local Команда install-local собирает и ставит локальные версии расширений VS Code и spec-kit из репозитория speckit-companion, автоматически повышая patch-версию для сброса кэша. CX Codex +1 ★ 110звёзд репо speckit.companion.living-drift Команда speckit.companion.living-drift показывает, какие файлы возможностей living spec изменились с момента последнего коммита их спецификаций. Помогает найти изменения, которые не попали обратно в спецификацию. CX Codex +1 ★ 110звёзд репо speckit.companion.resume Команда speckit.companion.resume для Claude Code восстанавливает состояние spec-driven разработки после перерыва. Она переносит записанные решения в контекст и запускает следующий шаг пайплайна. CX Codex +1 ★ 110звёзд репо

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

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