# Sandbox SDK

安全で隔離されたコード実行環境を構築します

> 以下のリンクは、各ページの Markdown 版を直接指します。 任意のページは、`index.md` サフィックスなしの URL に `Accept: text/markdown` ヘッダーを付けて取得することもできます（例: `curl -H "Accept: text/markdown" https://developers.cloudflare.com/sandbox/`）。
>
> その他の Cloudflare 製品は、[Cloudflare ドキュメントディレクトリ](https://developers.cloudflare.com/llms.txt) を参照してください。

## 概要

- [Sandbox SDK](https://developers.cloudflare.com/sandbox/index.md): Cloudflare Workers と Containers を使って、安全で分離されたコード実行環境を構築します。

## はじめに

- [はじめに](https://developers.cloudflare.com/sandbox/get-started/index.md): 分離されたコンテナで Python コードを実行する、最初の Sandbox SDK Worker を作成します。

## 1.0 プレビュー

- [1.0 プレビュー](https://developers.cloudflare.com/sandbox/1-0-preview/index.md): @cloudflare/sandbox@next をインストールします。Cloudflare Containers 上のより薄い Sandbox SDK です。Sandbox SDK 1.0 の準備ができたら移行します。
- [API リファレンス](https://developers.cloudflare.com/sandbox/1-0-preview/api/index.md): `@cloudflare/sandbox@next` の API リファレンスです。プロセス、ターミナル、エラー、関連するプレビュー面を扱います。
- [エラー](https://developers.cloudflare.com/sandbox/1-0-preview/api/errors/index.md): @cloudflare/sandbox@next のエラークラス、コード、context フィールドです。
- [インタープリター](https://developers.cloudflare.com/sandbox/1-0-preview/api/interpreter/index.md): @cloudflare/sandbox@next のコードインタープリター拡張機能のリファレンスです。
- [プロセス](https://developers.cloudflare.com/sandbox/1-0-preview/api/processes/index.md): Sandbox SDK 1.0 プレビューにおける argv の exec、SandboxProcess ハンドル、ログ、待機、関連型のリファレンスです。
- [ターミナル](https://developers.cloudflare.com/sandbox/1-0-preview/api/terminals/index.md): Sandbox SDK 1.0 preview の createTerminal、Terminal ハンドル、出力ストリーム、connect、制御メソッドのリファレンスです。
- [環境変数](https://developers.cloudflare.com/sandbox/1-0-preview/environment/index.md): Sandbox SDK 1.0 プレビューで、プロセスとターミナルが環境変数を受け取る仕組みです。
- [エラーと回復](https://developers.cloudflare.com/sandbox/1-0-preview/errors/index.md): コンテナーの起動、停止、作業の中断時に発生する Sandbox SDK 1.0 プレビューの失敗から再試行して回復します。
- [拡張機能](https://developers.cloudflare.com/sandbox/1-0-preview/extensions/index.md): @cloudflare/sandbox@next に、任意の Sandbox 機能を追加します。
- [始める](https://developers.cloudflare.com/sandbox/1-0-preview/get-started/index.md): @cloudflare/sandbox@next をインストールし、サンドボックスで最初のプロセスハンドルを実行します。
- [コードインタープリター](https://developers.cloudflare.com/sandbox/1-0-preview/interpreter/index.md): @cloudflare/sandbox@next のインタープリター拡張機能で、サンドボックス上の Python、JavaScript、TypeScript を実行します。
- [サンドボックスのライフサイクル](https://developers.cloudflare.com/sandbox/1-0-preview/lifecycle/index.md): Sandbox SDK 1.0 プレビューにおけるサンドボックス ID、コンテナ、および stop、replace、destroy のあとに残るものと消えるもの。
- [移行する](https://developers.cloudflare.com/sandbox/1-0-preview/migrate/index.md): 既存の Sandbox SDK アプリケーションを、安定版パッケージから @cloudflare/sandbox@next へ更新します。
- [プロセスの実行](https://developers.cloudflare.com/sandbox/1-0-preview/processes/index.md): Sandbox SDK 1.0 プレビューがコマンドを実行する仕組み — argv による起動、プロセスハンドル、コンテナの寿命です。
- [ターミナル](https://developers.cloudflare.com/sandbox/1-0-preview/terminals/index.md): Sandbox SDK 1.0 プレビューの対話型 PTY ターミナル。リソースモデルとブラウザ接続を説明します。
- [トラブルシューティング](https://developers.cloudflare.com/sandbox/1-0-preview/troubleshooting/index.md): `@cloudflare/sandbox@next` でよくある失敗と、その直し方です。

## チュートリアル

- [チュートリアル](https://developers.cloudflare.com/sandbox/tutorials/index.md): AI エージェント、コード実行環境、テストパイプラインを構築する、Sandbox SDK の手順付きチュートリアルです。
- [AI コード実行環境を作る](https://developers.cloudflare.com/sandbox/tutorials/ai-code-executor/index.md): Claude で自然言語から Python コードを生成し、サンドボックスで安全に実行します。
- [AI でデータを分析する](https://developers.cloudflare.com/sandbox/tutorials/analyze-data-with-ai/index.md): CSV ファイルをアップロードし、Claude で分析コードを生成し、可視化を返します。
- [自動テストパイプライン](https://developers.cloudflare.com/sandbox/tutorials/automated-testing-pipeline/index.md): Git リポジトリをクローンし、依存関係をインストールし、テストを実行して結果を報告するパイプラインを構築します。
- [サンドボックスで Claude Code を実行する](https://developers.cloudflare.com/sandbox/tutorials/claude-code/index.md): Claude Code を使い、GitHub リポジトリのタスクを実装します。
- [Claude Managed Agents をセットアップする](https://developers.cloudflare.com/sandbox/tutorials/claude-managed-agents/index.md): 自己管理の Cloudflare 環境で Claude Managed Agents を実行します。
- [コードレビューボットを作る](https://developers.cloudflare.com/sandbox/tutorials/code-review-bot/index.md): リポジトリをクローンし、Claude でコードを分析して、GitHub の PR にレビューコメントを投稿します。
- [セルフホストマシンを使い、Cloudflare 上で Cursor Cloud Agents を実行する](https://developers.cloudflare.com/sandbox/tutorials/cursor-cloud-agents/index.md): 割り当てられた各セッションを、分離された Cloudflare コンテナ内で動かす Cursor のセルフホストマシンをデプロイします。
- [Cloudflare で Devin Outposts を動かす](https://developers.cloudflare.com/sandbox/tutorials/devin-outposts/index.md): 各 Devin セッションを、分離された Cloudflare コンテナで動かす Devin Outpost をデプロイします。
- [OpenAI Agents SDK で AI コーディングエージェントを構築する](https://developers.cloudflare.com/sandbox/tutorials/openai-agents/index.md): OpenAI Agents SDK と Cloudflare Sandbox を使い、分離環境でコードを書き、テストし、成果物を渡す Python エージェントを構築します。
- [OpenAI Agents API を使い、Cloudflare Containers で Codex を実行する](https://developers.cloudflare.com/sandbox/tutorials/openai-agents-api/index.md): OpenAI Agents API 経由で Codex が使える Cloudflare の実行環境をデプロイします。
- [R2 でデータを永続化する](https://developers.cloudflare.com/sandbox/tutorials/persistent-storage/index.md): R2 バケットをローカルのファイルシステムパスとしてマウントし、サンドボックスのライフサイクルをまたいでデータを永続化します。
- [Workers AI を使ったコードインタープリター](https://developers.cloudflare.com/sandbox/tutorials/workers-ai-code-interpreter/index.md): 公式の workers-ai-provider パッケージと Workers AI の GPT-OSS モデルで、コードインタープリターを構築します。

## ガイド

- [ガイド](https://developers.cloudflare.com/sandbox/guides/index.md): Sandbox SDK で特定の作業を進める実践ガイドです。
- [2026 年の非推奨機能からの移行ガイド](https://developers.cloudflare.com/sandbox/guides/2026-deprecation/index.md): 現行の安定版パッケージで、非推奨の Sandbox SDK 機能から移行します。
- [バックグラウンドプロセスを実行する](https://developers.cloudflare.com/sandbox/guides/background-processes/index.md): 長時間実行するサービスとアプリケーションを起動し、管理します。
- [バックアップと復元](https://developers.cloudflare.com/sandbox/guides/backup-restore/index.md): サンドボックスのディレクトリを R2 にスナップショットし、後から復元します。
- [ブラウザーターミナル](https://developers.cloudflare.com/sandbox/guides/browser-terminals/index.md): xterm.js または素の WebSocket を使い、ブラウザーベースのターミナルをサンドボックスシェルに接続します。
- [コードインタープリターを使う](https://developers.cloudflare.com/sandbox/guides/code-execution/index.md): 豊富な出力形式で Python と JavaScript のコードを実行します。
- [Sandbox アプリケーションをデプロイする](https://developers.cloudflare.com/sandbox/guides/deploy/index.md): Sandbox Worker をデプロイし、npm パッケージとコンテナイメージを同じリリースラインに揃えます。
- [Docker-in-Docker を実行する](https://developers.cloudflare.com/sandbox/guides/docker-in-docker/index.md): サンドボックスコンテナ内で Docker コマンドを実行します。
- [コマンドを実行する](https://developers.cloudflare.com/sandbox/guides/execute-commands/index.md): ストリーミング出力、エラー処理、シェルアクセス付きでコマンドを実行します。
- [サービスを公開する](https://developers.cloudflare.com/sandbox/guides/expose-services/index.md): プレビュー URL を作成し、Web サービス用のポートを公開します。
- [ファイルシステムの変更を監視する](https://developers.cloudflare.com/sandbox/guides/file-watching/index.md): ファイルとディレクトリをリアルタイムで監視し、反応の速い開発ツールや自動化ワークフローを構築します。
- [Git で作業する](https://developers.cloudflare.com/sandbox/guides/git-workflows/index.md): リポジトリのクローン、ブランチの管理、Git 操作の自動化を行います。
- [ファイルを管理する](https://developers.cloudflare.com/sandbox/guides/manage-files/index.md): サンドボックス内のファイルを読み書きし、整理し、同期します。
- [バケットをマウントする](https://developers.cloudflare.com/sandbox/guides/mount-buckets/index.md): 永続データ向けに、S3 互換のオブジェクトストレージをローカルのファイルシステムとしてマウントします。
- [アウトバウンドトラフィックを処理する](https://developers.cloudflare.com/sandbox/guides/outbound-traffic/index.md): Workers を使い、サンドボックスからのアウトバウンド HTTP を傍受して処理します。
- [カスタムドメインでプレビュー URL を設定する](https://developers.cloudflare.com/sandbox/guides/preview-urls-custom-domain/index.md): ワイルドカード DNS、ルート、TLS を設定し、exposePort のプレビュー URL を自分のドメインで使えるようにします。
- [外部 API へのプロキシリクエスト（古いガイド）](https://developers.cloudflare.com/sandbox/guides/proxy-requests/index.md): この古い Sandbox SDK ガイドは、サンドボックスの送信トラフィックを制御する現行ガイドへ案内します。
- [出力をストリームする](https://developers.cloudflare.com/sandbox/guides/streaming-output/index.md): コマンドとプロセスからのリアルタイム出力を扱います。
- [WebSocket 接続](https://developers.cloudflare.com/sandbox/guides/websocket-connections/index.md): サンドボックス内で動いている WebSocket サーバーに接続します。
- [Workers バインディングに接続する](https://developers.cloudflare.com/sandbox/guides/workers-connections/index.md): サンドボックスから KV、R2、Durable Objects、そのほかのバインディングにアクセスします。

## API リファレンス

- [API リファレンス](https://developers.cloudflare.com/sandbox/api/index.md): コード実行、ファイル管理、プロセス実行、サービスの公開向けの Sandbox SDK API です。
- [バックアップ](https://developers.cloudflare.com/sandbox/api/backups/index.md): サンドボックスディレクトリの特定時点のスナップショットを作成し、復元します。
- [コマンド](https://developers.cloudflare.com/sandbox/api/commands/index.md): Sandbox SDK のコンテナでコマンドを実行し、バックグラウンドプロセスを管理します。
- [ファイル監視](https://developers.cloudflare.com/sandbox/api/file-watching/index.md): Sandbox SDK の watch API を使い、サンドボックスのファイルシステム変更をリアルタイムで監視します。
- [ファイル](https://developers.cloudflare.com/sandbox/api/files/index.md): Sandbox SDK のファイルシステムでファイルの読み書きと管理を行います。
- [コードインタープリター](https://developers.cloudflare.com/sandbox/api/interpreter/index.md): Sandbox SDK で、Python、JavaScript、TypeScript のコードを豊富な出力形式で実行します。
- [ライフサイクル](https://developers.cloudflare.com/sandbox/api/lifecycle/index.md): Sandbox SDK のコンテナインスタンスとリソースを作成、設定、管理します。
- [ポート](https://developers.cloudflare.com/sandbox/api/ports/index.md): Sandbox SDK の ports API を使い、公開プレビュー URL でサンドボックスのサービスを公開します。
- [セッション](https://developers.cloudflare.com/sandbox/api/sessions/index.md): サンドボックス内で、作業ディレクトリと環境変数が独立したシェルセッションを作成します。
- [ストレージ](https://developers.cloudflare.com/sandbox/api/storage/index.md): 永続データにアクセスするため、S3 互換のストレージバケットを Sandbox SDK のファイルシステムにマウントします。
- [ターミナル](https://developers.cloudflare.com/sandbox/api/terminal/index.md): WebSocket でブラウザーベースのターミナル UI をサンドボックスのシェルに接続します。
- [トンネル](https://developers.cloudflare.com/sandbox/api/tunnels/index.md): クイックトンネル（*.trycloudflare.com）またはゾーン上のホスト名に紐づける名前付きトンネルで、Sandbox のサービスをインターネットに公開します。

## 概念

- [概念](https://developers.cloudflare.com/sandbox/concepts/index.md): Sandbox SDK の仕組み、アーキテクチャ、ライフサイクル、セキュリティ、セッションを説明します。
- [アーキテクチャ](https://developers.cloudflare.com/sandbox/concepts/architecture/index.md): Sandbox SDK は Workers、Durable Objects、Containers を組み合わせて、安全なコード実行を実現します。
- [ディレクトリのバックアップ](https://developers.cloudflare.com/sandbox/concepts/backup-restore/index.md): 本番の復元はコピーオンライトのオーバーレイをマウントします。ローカルの復元はアーカイブを展開します。
- [コンテナランタイム](https://developers.cloudflare.com/sandbox/concepts/containers/index.md): Sandbox SDK のコンテナは、Python、Node.js、よく使う開発ツールが入った、隔離された Linux 環境です。
- [プレビュー URL](https://developers.cloudflare.com/sandbox/concepts/preview-urls/index.md): Sandbox SDK のプレビュー URL は、サンドボックス内で動くサービスへ公開 HTTPS でアクセスできます。
- [サンドボックスのライフサイクル](https://developers.cloudflare.com/sandbox/concepts/sandboxes/index.md): Sandbox SDK のサンドボックスは、アクティビティに応じて running、sleeping、destroyed の状態を移ります。
- [セキュリティモデル](https://developers.cloudflare.com/sandbox/concepts/security/index.md): Sandbox SDK は、信頼できないコードを安全に実行するため、VM 単位の分離、入力検証、ネットワーク制御を使います。
- [セッション管理](https://developers.cloudflare.com/sandbox/concepts/sessions/index.md): Sandbox SDK のセッションは、1 つのサンドボックス内のシェル実行コンテキストです。
- [ターミナル接続](https://developers.cloudflare.com/sandbox/concepts/terminal/index.md): Sandbox SDK のターミナル接続は、ブラウザー UI とコンテナーシェルの間で双方向データをストリームします。

## Sandbox ブリッジ

- [Sandbox ブリッジ](https://developers.cloudflare.com/sandbox/bridge/index.md): sandbox ブリッジ Worker をデプロイし、任意の言語やプラットフォームから HTTP 経由で Cloudflare Sandbox を制御します。
- [HTTP API リファレンス](https://developers.cloudflare.com/sandbox/bridge/http-api/index.md): sandbox bridge Worker が公開する HTTP API の全ルートを記載します。

## 設定

- [設定](https://developers.cloudflare.com/sandbox/configuration/index.md): Wrangler、Dockerfile、環境変数、トランスポートモードで Sandbox SDK のデプロイを設定します。
- [Dockerfile リファレンス](https://developers.cloudflare.com/sandbox/configuration/dockerfile/index.md): パッケージ、ツール、設定で Sandbox SDK のコンテナイメージをカスタマイズします。
- [環境変数](https://developers.cloudflare.com/sandbox/configuration/environment-variables/index.md): 環境変数で、設定、シークレット、ランタイム設定を Sandbox SDK のコンテナーに渡します。
- [Sandbox オプション](https://developers.cloudflare.com/sandbox/configuration/sandbox-options/index.md): スリープタイムアウト、リソース制限、コンテナ設定で Sandbox SDK の動作を構成します。
- [トランスポートモード](https://developers.cloudflare.com/sandbox/configuration/transport/index.md): Durable Objects とコンテナのあいだで、Sandbox SDK がどのように通信するかを設定します。
- [Wrangler の設定](https://developers.cloudflare.com/sandbox/configuration/wrangler/index.md): Sandbox SDK 向けに Wrangler のバインディング、Durable Objects、コンテナ設定を行います。

## プラットフォーム

- [プラットフォーム](https://developers.cloudflare.com/sandbox/platform/index.md): Sandbox SDK の料金とリソース制限などのプラットフォーム情報です。
- [制限](https://developers.cloudflare.com/sandbox/platform/limits/index.md): Sandbox SDK のリソース制限です。vCPU、メモリ、ディスク、コンテナの制約を含みます。
- [料金](https://developers.cloudflare.com/sandbox/platform/pricing/index.md): Sandbox SDK の料金は、基盤となる Containers プラットフォームの使用量単価に基づきます。