・AIが書いたコードを安全に動かしたい
・コーディングエージェントを自分で動かしたい
・ネットのSandbox SDKの例が古くて迷う
Cloudflare Sandboxes は、AI が書いたコードのような「信頼しないコード」を、自分のアプリから隔離して動かす仕組みです。中のコードはアプリのデータを直接読めず、何を渡すかは Worker が決めます。環境は Linux のコンテナと Dynamic Workers の2つです。
この記事では、2つの環境の選び方、できること、料金、Sandbox SDK の 0.x と 1.0 の違い、始め方、注意点を整理します。料金は2026年11月時点の公式ページの値です。ネットでよく見る getSandbox() の例は、古い書き方です。
この記事のゴール(読了目安 約8分)
Sandboxesの2つの環境と今のSDKの書き方を知り、AIのコードを動かす場所を選べるようになる
Cloudflare Sandboxesとは
サンドボックスとは、中のコードが外のデータや仕組みに手を出せないよう区切った、実行のための場所です。Sandboxes は、これを Workers(世界中の拠点でコードを動かす Cloudflare のサービス)から使えるようにした製品です。Workers の仕組みと料金は、Cloudflare Workers の記事で解説しています。
- 中のコードは、アプリのメモリやデータを直接読めない
- 渡す API やデータと、インターネットに出すかは Worker が決める
- Linux の Containers と Dynamic Workers の2つの環境を、1つの Worker から使える
公式は、モデルが生成したコードやリポジトリのテストを「信頼しないコード」の例に挙げています。アプリと同じプロセスで動かすべきでないコードの置き場所です。
2025年6月に実験的な「Code Sandboxes」として公開され、2026年4月13日に一般提供が始まりました。9月30日には Sandbox SDK(npm の @cloudflare/sandbox)の 1.0 が出ています。
仕組み:2つの実行環境と選び方
どちらも Worker が起動して仕事を渡します。分かれ目は、コードが Linux を前提にするか、決めたメソッドを呼ぶだけかです。
Linux のサンドボックスでは、Worker がセッション ID などの名前で Durable Object を呼びます。その Durable Object が this.ctx.container.start() で Linux のインスタンスを起動します。同じ名前は必ず同じ Durable Object に届く仕組みで、詳しくは Durable Objectsとはで解説しています。Dynamic Workers は、受け取ったコードをその場で新しい Worker として動かします。
npm test やコンパイラのように Linux が要るものは、コンテナで動かします。Dynamic Workers は子プロセスを起動できず、ネイティブのアドオンも読めないためです。

Sandboxesでできること
公式に手順があるものを、Linux のサンドボックスを中心に挙げます。
- コマンド:
exec()で、結果をまとめて返す・流しながら返す・裏で動かす。ターミナルも開ける - ファイル:
Filesクラスで出し入れし、スナップショットか R2 に残す - プレビュー:中の Web サーバーへ、Worker がリクエストを転送する
- 認証の要る API:Worker が許したリクエストにだけ鍵を足す
1.0 の exec() はシェルを通さずに起動するので、引数の文字列から別のコマンドは始まりません。
コーディングエージェント(コードを読み、直し、コマンドを動かして仕事を進める AI)を動かす公式の手順もあります。Claude Code や Codex を、1つの仕事専用のサンドボックスで動かす形です。モデルを呼ぶ API キーは Worker が足し、サンドボックスには入れません。 モデルへの通信を記録・制限する仕組みは、Cloudflare AI Gatewayとはの記事で紹介しています。

Devin や Cursor も自分のアカウントのサンドボックスで動かせます。そのテンプレートでは各社の処理が中で動くため、サンドボックスがその会社の資格情報を持ちます。
料金:有料プランで2種類の数え方
無料プランでは使えません。2026年11月時点の公式ページでは、Linux のサンドボックスは Containers の料金、Dynamic Workers は専用の料金表で数えます。
Linux のサンドボックスは、Containers の料金に Workers と Durable Objects の利用料が加わります。動いている間を10ミリ秒単位で数え、メモリとディスクは割り当て量、CPU は使った分です。単価とインスタンスの大きさは、Cloudflare Containersとはの記事で表にしています。
動いている間は、中で何もしていなくてもメモリとディスクが課金されます。 待つ時間が長いなら、短いタイムアウトで止め、ファイルはスナップショット(パブリックベータの間は無料)で次へ運ぶ手があります。
リクエストと CPU 時間は Workers の請求に含まれます。.load() は呼ぶたびに1つと数えるので、同じコードは決まった ID で .get() を使います。数え方は Dynamic Workers の料金ページにあります。
Sandbox SDKの0.xと1.0の違い
ネットの例の多くは 0.x の書き方です。新しく作るなら 1.0 で、0.x は既存のアプリ向けです。
2026年6月に 1.0 のプレビューが出て、9月30日に 1.0 が公開されました。
1.0 では、起動のたびにイメージと大きさを選べます。一方でパッケージは再試行も時間の上限も持たないので、自分のコードで決めます。ツールも自分のイメージに入れます。cloudflare/debian-trixie には Python も Git も入っていません。
0.x のままなら、証明書を更新した 0.12.14 に固定し、exposePort() などの非推奨の機能は新しく使いません。1.0 への移行は取り消せないので、先にステージングで試します。
始め方:Linuxでコマンドを1つ動かす
公式の Get started「Run a Linux command」で、手元で起動した Linux のサンドボックスに uname -a を実行させる流れです。Wrangler(Workers を操作する公式のコマンドラインツール)を使います。
- アカウントと Node.js を用意し、Docker を起動する
- ひな形を作り、フォルダに移る
- 設定ファイルに
containers(durable_object方式。パブリックベータ)と Durable Object の設定を書く src/index.tsを公式のコードに替える- 手元で起動し、別のターミナルからコマンドを送る
npm create cloudflare@latest -- sandbox-linux --category=hello-world --type=hello-world --lang=ts --no-deploy --no-git --no-agents
cd sandbox-linux
npx wrangler types
npx wrangler dev
curl http://localhost:8787 --request POST --json '{"argv":["uname","-a"]}'
exitCode が0で stdout に Linux が出れば成功です。手元の wrangler dev はインスタンスを Docker で動かすので、Docker が要ります。 Get started のイメージ(cloudflare/debian-trixie)を手元で動かすには Wrangler 4.141.0 以上が必要です。JavaScript だけなら、Dynamic Workers の Get started から始める道もあります。
使う前の注意点:鍵と止まり方
隔離されていても、中に入れたものは中のコードがすべて使えます。止まり方を知らないと、作業が消えたり、待つだけで課金されたりします。
- 分ける:中の全プロセスは root と同じ権限なので、利用者ごと・仕事ごとにサンドボックスを分ける
- 鍵を入れない:clone の URL に入れたトークンは
.git/configに残り、依存パッケージから読める。鍵は Worker の外向きハンドラーが HTTPS のリクエストにだけ足す - 出口を絞る:Container は既定でインターネットに出られない。インターネットを開けず、ハンドラーでパッケージのレジストリだけ許す。Dynamic Worker は
globalOutbound: nullで外を止める - 名前は認証ではない:呼んだ人を Worker で認証してから名前を決める
- 出力も信頼しない:プレビューはアプリと別のドメインで出す
- 止まる:非アクティブになると、設定したタイムアウト(最大6時間)で止まる。中でビルドが動いていても止まり、タイムアウトの設定は Durable Object の再起動で消える
- 入れ替わらない:デプロイしても、動いているインスタンスは前のイメージのまま動く
スナップショットで戻るのはファイルだけで、プロセスは戻りません。 自動では戻らないので、ID を保存して次の start() に渡します。作成か最後の復元から30日で消えるので、長く残すなら R2 に置きます。

よくある質問
Containersとは何が違いますか?
Linux のサンドボックスの中身は Containers のコンテナで、料金も同じです。Sandboxes は、守り方と止まり方の手順、Files などの補助、Dynamic Workers をまとめた入口です。
無料プランでも使えますか?
使えません。どちらの環境も、月5ドルの Workers 有料プランから使えます。
ネットにあるgetSandboxの例は使えますか?
0.x の書き方です。今も動きますが、修正は2026年12月31日までです。新しく作るなら 1.0 で始めます。
Pythonのコードも動かせますか?
動かせます。Linux なら Python を入れた自分のイメージで動かします。Dynamic Workers も Python に対応しています。
Dockerがなくても試せますか?
Linux の Get started では、手元の wrangler dev が Docker を使うので要ります。JavaScript だけなら Dynamic Workers の Get started があり、その手順に Docker は出てきません。
この記事のポイント
- 信頼しないコードをWorkerから隔離して動かす仕組み
- Linuxが要るならコンテナ、決めた処理だけならDynamic Workers
- Workers有料プランのみ。Linuxのサンドボックスは待機中も課金
- 新しく作るならSDK 1.0。0.xの修正は2026年末まで
まとめ
Cloudflare Sandboxes は、AI が書いたコードなど信頼しないコードを、アプリから隔離して動かす仕組みです。Linux が要るならコンテナ、決めたメソッドを呼ぶだけなら Dynamic Workers を選びます。Linux のサンドボックスは、待っているだけでも動いている間は課金されます。
新しく作るなら Sandbox SDK 1.0 で始め、ネットの getSandbox() の例は写さないようにします。鍵は Worker で足し、サンドボックスは利用者や仕事ごとに分けます。まずは公式の Get started で、Linux のコマンドを1つ動かしてみてください。






