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

sandbox-next — скилл для Claude Code: сборка приложений на Cloudflare Sandbox SDK 1.0

Скилл для разработки приложений Cloudflare Sandbox на превью-версии SDK 1.0 (@cloudflare/sandbox@next). Даёт агенту правила работы с новым API процессов и терминалов.

Apache-2.0 85 100 установок ★ 3 424 обновлён 2026-10-31

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

Что делает sandbox-next

Cloudflare Sandbox запускает изолированные Linux-окружения на контейнерах, управляемых из Workers. Превью SDK 1.0 изменил модель выполнения процессов: sandbox.exec(argv) теперь возвращает хэндл при старте, а результат собирается методами output(), waitForExit(), waitForPort(). Неявного шелла нет — синтаксис оболочки передаётся явно через ["/bin/bash", "-lc", script]. Каждый запуск независим: cd или export в одной команде не видны следующей.

Скилл проверяет, что Worker и образ контейнера стоят на одной линии (@next в зависимости — cloudflare/sandbox:next в Dockerfile). Если обнаруживает стабильную версию пакета без тега @next, останавливается и просит загрузить sandbox-stable. Для миграции со стабильной версии есть отдельный скилл sandbox-migrate-to-next. Перед реализацией агент открывает нужную страницу документации по задаче — обработка процессов, терминалы PTY, интерпретаторы, обработка ошибок, файлы и mount-точки.

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

  • собрать Worker для Cloudflare Sandbox на превью SDK 1.0
  • запустить процесс в контейнере и дождаться его завершения
  • открыть терминал PTY в браузере из Workers-приложения
  • проверить, что зависимость и образ на одной линии @next
  • получить stdout и exitCode команды через хэндл процесса

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

  • Создай Worker, который запускает python3 script.py в Sandbox на @next и возвращает stdout
  • Добавь скилл sandbox-next для Claude Code
  • Проверь, что package.json и Dockerfile на одной линии @next

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

1Через Skills CLI (Vercel)

npx skills add cloudflare/skills --skill sandbox-next -a claude-code

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

~/.claude/skills/sandbox-next/SKILL.md

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

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

Вопросы о sandbox-next

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

Выполни npx skills add cloudflare/skills --skill sandbox-next -a claude-code, затем скилл окажется в ~/.claude/skills/sandbox-next/SKILL.md.

Что делает sandbox-next?

Даёт агенту правила работы с превью SDK 1.0 Cloudflare Sandbox: проверяет версию пакета и образа, открывает документацию по задаче, предотвращает использование API стабильной версии.

Чем превью SDK 1.0 отличается от стабильной версии?

exec возвращает хэндл при старте процесса, а не результат выполнения. Результат собирается методами output(), waitForExit(), waitForPort(). Нет неявного шелла и нет stdin у процессов. Для интерактивной работы нужны терминалы через createTerminal.

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

SKILL.md · Apache-2.0
---
name: sandbox-next
description: Build or maintain Cloudflare Sandbox apps on @cloudflare/sandbox@next (SDK 1.0 preview). Use sandbox-migrate-to-next when porting a stable app.
---

# Sandbox SDK — `@next` (1.0 preview)

Isolated Linux environments on [Cloudflare Containers](https://developers.cloudflare.com/containers/index.md), driven from Workers.

**Prefer preview docs and installed `@next` types over memory.** APIs change; this skill is a gate, a contract, and a retrieval map—not a full manual.

We recommend **new projects** on this line. Apps still on the default package use **`sandbox-stable`**. Port only when asked, via **`sandbox-migrate-to-next`**.

## 1. Gate — confirm the package line

Before writing code, inspect the app:

| Check | Must match |
| ----- | ---------- |
| npm dependency | `@cloudflare/sandbox@next` (or another preview tag) |
| Container image | Same line (e.g. `cloudflare/sandbox:next`, `next-python`) |

| If you find… | Action |
| ------------ | ------ |
| Default `@cloudflare/sandbox` (no `@next`) | **Stop.** Load **`sandbox-stable`**. Do not apply this skill’s APIs. |
| User wants to port stable → `@next` | **Stop.** Load **`sandbox-migrate-to-next`**. |
| Self-deployed **bridge** only | Bridge is **not** on the 1.0 preview line yet. Keep bridge on stable package + image. [Bridge (stable)](https://developers.cloudflare.com/sandbox/sdk/bridge/index.md) |

Never mix an `@next` Worker package with a stable container image (or the reverse).

Skills install: [Agent setup](https://developers.cloudflare.com/agent-setup/index.md) · [cloudflare/skills](https://github.com/cloudflare/skills)

## 2. Contract — non-negotiables

- `sandbox.exec(argv)` takes an **argv** list and resolves when the process **starts**. It returns a **handle**, not a finished command result.
- Collect results with handle methods: `output()`, `logs()`, `waitForExit()`, `waitForPort()`, `waitForLog()`, `kill(signal?)`.
- No implicit shell. Shell syntax needs an explicit shell, e.g. `["/bin/bash", "-lc", script]`.
- Each launch is independent. A `cd` / `export` in one `exec` is not visible to the next. Pass `cwd` and `env` per launch, or one shell script.
- Process handles have **no stdin**. Interactive use → terminals (`createTerminal` + `connect`).
- Local wait `timeout` / `AbortSignal` cancel the **wait only**. They do not kill the process. Use `kill` or `exec`’s remote `timeout`.
- `getProcess` / `listProcesses` / `getTerminal` / `listTerminals` do **not** start a container; they return `null` / `[]` when none is up.
- Process and terminal IDs belong to the **current container**, not forever to a sandbox ID. For work that must survive replace, store the full job (argv, cwd, env, app state)—not only an id.
- Non-secret config only in `setEnvVars` / launch `env`. Live credentials stay in the Worker; use outbound handlers when the sandbox calls external APIs.
- Do **not** invent removed stable APIs (`gitCheckout` on core, string-`exec` completion, session execution, `sandbox.terminal(request)`).
- Do **not** use one retry loop for every error (see Errors docs).

Minimal shape:

```ts
import { getSandbox, proxyToSandbox, Sandbox } from "@cloudflare/sandbox";

export { Sandbox };

const sandbox = getSandbox(env.Sandbox, "user-123");
const process = await sandbox.exec(["python3", "-c", "print(2 + 2)"]);
const result = await process.output({ encoding: "utf8" });
// result.stdout, result.exitCode
```

Task-specific API documentation: [references/api-quick-ref.md](references/api-quick-ref.md)

Examples index (`next` branch): [references/examples.md](references/examples.md)

## 3. Retrieve — open the doc for the task

Fetch the page before implementing. Installed `@next` types win over guesses.

| You need to… | Open |
| ------------ | ---- |
| Orient / choose preview | [1.0 preview overview](https://developers.cloudflare.com/sandbox/index.md) |
| First Worker, wrangler, Dockerfile | [Get started](https://developers.cloudflare.com/sandbox/index.md) |
| `exec`, handles, readiness, durability | [Process execution](https://developers.cloudflare.com/sandbox/index.md) |
| Process API signatures | [Processes API](https://developers.cloudflare.com/sandbox/index.md) |
| Sandbox ID vs container vs sleep/destroy | [Lifecycle](https://developers.cloudflare.com/sandbox/index.md) |
| `cwd` / `env` / `setEnvVars` | [Environment](https://developers.cloudflare.com/sandbox/index.md) |
| Interactive PTY / browser terminal | [Terminals](https://developers.cloudflare.com/sandbox/index.md) · [Terminals API](https://developers.cloudflare.com/sandbox/index.md) |
| Python/JS code interpreter | [Interpreter](https://developers.cloudflare.com/sandbox/index.md) · [Interpreter API](https://developers.cloudflare.com/sandbox/index.md) |
| Extensions model | [Extensions](https://developers.cloudflare.com/sandbox/index.md) |
| Error classes and recovery | [Errors](https://developers.cloudflare.com/sandbox/index.md) · [Errors API](https://developers.cloudflare.com/sandbox/index.md) |
| Common failures | [Troubleshooting](https://developers.cloudflare.com/sandbox/index.md) |
| API hub | [API reference](https://developers.cloudflare.com/sandbox/index.md) |
| Files, mounts, backups, ports, tunnels, `proxyToSandbox` | Main docs for shared surfaces (ignore stable-only session/transport/`sandbox.terminal`): [Files](https://developers.cloudflare.com/sandbox/sdk/api/files/index.md) · [Storage / mounts](https://developers.cloudflare.com/sandbox/sdk/api/storage/index.md) · [Ports](https://developers.cloudflare.com/sandbox/sdk/api/ports/index.md) · [Tunnels](https://developers.cloudflare.com/sandbox/sdk/api/tunnels/index.md) · [Backups](https://developers.cloudflare.com/sandbox/sdk/api/backups/index.md) · [Outbound traffic](https://developers.cloudflare.com/sandbox/sdk/guides/outbound-traffic/index.md) · [Expose services](https://developers.cloudflare.com/sandbox/sdk/guides/expose-services/index.md) · [Production](https://developers.cloudflare.com/sandbox/sdk/guides/preview-urls-custom-domain/index.md) |
| Example apps | [examples on `next`](https://github.com/cloudflare/sandbox-sdk/tree/next/examples) |
| Still on stable package | **`sandbox-stable`** · [Main Sandbox docs](https://developers.cloudflare.com/sandbox/index.md) |
| Porting an existing stable app | **`sandbox-migrate-to-next`** · [Migrate](https://developers.cloudflare.com/sandbox/sdk/migrate/index.md) |

## 4. Before you ship

- Lockfile and Dockerfile on the **same** `@next` line  
- Typecheck against installed `@next` types  
- No live secrets in sandbox env  
- Production preview hostnames need wildcard DNS on a custom domain when using those URL patterns  

## Skill feedback

If the user reports that this skill gave incorrect or outdated guidance, or is missing information, read [references/skill-feedback.md](references/skill-feedback.md).

© cloudflare · Apache-2.0 · cloudflare/skills

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
upstash-box-js Upstash Скилл upstash-box-js для Claude Code, Codex, Cursor и других агентов: учит работать с TypeScript/JavaScript SDK @upstash/box для запуска облачных контейнеров-песочниц. CX Codex +1 1 400установок Cloudflare Container docker Cloudflare Container — MCP-сервер для Claude Code, создающий изолированную песочницу для разработки. В ней ИИ-ассистент запускает код и тесты без риска для хостовой системы. CX Codex +1 sandbox-sdk официальный Cloudflare Описывает работу с Cloudflare Sandbox SDK: запуск команд и кода в изолированной среде, файловые операции и preview URL. Помогает исполнять код через Cloudflare Workers. CX Codex GP ChatGPT +1 4установок bailian-sandbox modelstudioai Скилл bailian-sandbox управляет песочницами и шаблонами Alibaba Bailian из терминала: создать, подключить, поставить на паузу, удалить. CX Codex +1 1 100установок platform-sandbox-configure forcedotcom Скилл platform-sandbox-configure управляет жизненным циклом песочниц Salesforce через Connect REST API. Позволяет запрашивать инвентарь и активировать обновления прямо в чате. CX Codex +1 3 200установок sandbox Vercel Inc. Запускает изолированные MicroVM на Linux через Vercel Sandbox SDK для безопасного выполнения чужого кода и тестов. CX Codex +1 689установок

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

Весь набор →
cloudflare-one Проектирует, настраивает и диагностирует Cloudflare One Zero Trust и SASE. Берётся в работу, когда агент или скрипт упирается в страницу авторизации Cloudflare Access. CX Codex +1 111 600установок turnstile-spin Скилл turnstile-spin настраивает защиту от ботов Cloudflare Turnstile во фронтенде и бэкенде: добавляет виджет, прописывает проверку siteverify и проверяет токены API. CX Codex +1 110 900установок cloudflare-one-migrations Скилл cloudflare-one-migrations помогает спланировать переход с VPN, SWG или SASE на Cloudflare One: сопоставляет политики, находит пробелы и расписывает порядок выката. CX Codex +1 107 100установок sandbox-stable Скилл sandbox-stable помогает создавать и поддерживать Cloudflare Sandbox на стабильном пакете @cloudflare/sandbox. Он нужен для изолированных Linux-сред в Workers. CX Codex +1 85 900установок sandbox-migrate-to-next Скилл sandbox-migrate-to-next для Claude Code переносит Cloudflare Sandbox со стабильной версии пакета на предварительный релиз @cloudflare/sandbox@next (SDK 1.0). Готовит код к переходу на будущий стабильный релиз. CX Codex +1 85 000установок nextjs-on-cloudflare Скилл nextjs-on-cloudflare для развёртывания Next.js приложений на Cloudflare Workers через vinext. Используй для новых проектов, миграции существующих приложений или выбора между vinext и OpenNext. CX Codex +1 60 100установок k2 Скилл k2 для Claude Code помогает настраивать и диагностировать Cloudflare K2 и K2 Streams. Он подключается к задачам по созданию потоков, записи и чтению событий. CX Codex +1 37 900установок basin Скилл для построения и отладки аналитических workflows в Cloudflare Basin. Помогает потокировать данные в R2 Iceberg-таблицы, управлять каталогами и выполнять распределённые SQL-запросы. CX Codex +1 37 800установок

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

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