Summary

Cloudflare は Sandbox SDK の複数機能を廃止します。これらは新機能に置き換えられるか利用が少ないためで、2026-07-09 以降の SDK リリースには含まれません。エンジニア向けに短く実務的な移行手順を示します。

Key Points

トランスポート: HTTP と WebSocket は非推奨。2026年4月に導入された RPC が推奨デフォルト（2026-06-09 時点）。7/9 以降は削除。
- 対策: 環境変数 SANDBOX_TRANSPORT を rpc に設定するか、getSandbox() の transport オプションを rpc に切替。
デスクトップ機能: 技術デモ用のブラウザ制御は使用少なく、0.10.2 で削除済み。
exposePort → トンネル: exposePort() は Cloudflare Tunnel に置換。トンネル API とガイドに従って移行。
デフォルトセッション: exec() の既定セッションは混乱を招いたため段階的廃止。0.10.3 で enableDefaultSession フラグを導入。今すぐ enableDefaultSession: false を設定し、必要なら sandbox.createSession() を使用。
ストリーミング移行: readFile、writeFile、exec 等のバッファ系 API はデフォルトでストリーミングに統合予定。古いストリーム版は削除されます。
非コア機能: code interpreter、terminal、git 等は helpers に移行検討中（既存 API は保持予定）。

Migration（実務的手順）

まず SANDBOX_TRANSPORT=rpc を設定し、統合テストを実行。
exposePort() を使っている箇所はトンネル API に書き換え。
セッション挙動が必要な部分は enableDefaultSession: false にして sandbox.createSession() に置換。
大容量入出力はストリーム API に対応（既存コードでバッファ依存がないか確認）。
詳細は 2026 deprecation migration guide と Cloudflare 開発者 Discord を参照。

openaijamodel: gpt-5-mini-2025-08-07

Sandbox SDK - Sandbox SDK 機能の非推奨化

Sandbox SDK — 機能の非推奨化

公開日: 2026-06-09

本日、Sandbox SDK のいくつかの機能を非推奨化することを発表します。SDK は初期リリース以来大きく成長・成熟してきました。エージェントワークフローの発展に伴い、安全で分離されたコード実行を開発ワークフローに統合しやすくするため、多数の新機能や実験的機能を追加してきました。今後も高速にコードベースを改善しつつ、エージェント的ワークフローの安定した土台を維持するため、下記の機能を非推奨化します。これらは新しい機能に置き換えられたか、利用が少なかったためで、2026-07-09 まではコードベースに残りますが、それ以降の Sandbox SDK のリリースには含まれません。

HTTP および WebSocket トランスポート

2026 年 4 月に新しい RPC トランスポートをリリースし、WebSocket トランスポートを非推奨にしました。これはサンドボックスコンテナと Workers エコシステム間の通信方法を制御する設定です。RPC トランスポートは HTTP / WebSocket の制約を解消します。
2026-06-09 時点で RPC が推奨のデフォルトです。HTTP と WebSocket トランスポートは 2026-07-09 以降の Sandbox SDK に含まれなくなります。
2026-07-09 より前に移行するには、SANDBOX_TRANSPORT 環境変数を rpc に更新するか、getSandbox() を呼び出す際に transport オプションを設定してください。詳しくは transport configuration documentation を参照してください。

Desktop

Desktop 機能は、サンドボックス内からフルブラウザ環境を制御できることを示す技術デモとして導入されましたが、Cloudflare Browser Run の提供により利用が非常に少なくなりました。
この機能は 0.10.2 で削除済みです。

ポート公開（Expose ports）

最近 Sandbox SDK に Cloudflare Tunnel サポートを追加しました。これにより、サンドボックス内で動作するサービスをパブリックに公開するための堅牢な API が利用可能になり、ローカル開発や workers.dev ドメインへのデプロイで多くの問題を解決します。
exposePort() から tunnels に移行するには、tunnels API ドキュメントと expose services ガイドを参照してください。

デフォルトセッション（Default sessions）

既定では、Sandbox SDK の exec() メソッドは呼び出し間でデフォルトセッションを維持していました（1 回の呼び出しで cd した状態が次の呼び出しにも影響する）。手動で exec 文を書く開発者には便利でしたが、エージェントの挙動を混乱させ、追跡の難しいバグを引き起こしました。
0.10.3 で getSandbox() インターフェースに enableDefaultSession フラグを導入し、この動作をオフにできるようにしました。デフォルトセッションという概念とこのフラグは、今後のリリースで削除されます。
現時点では enableDefaultSession: false を設定することを推奨します。以前の挙動が必要な場合は、代わりに sandbox.createSession() API を使用してください。

その他の変更

バッファリングする API を統合し、デフォルトでストリーミングをサポートする方向に移行しています。対象には readFile、writeFile、exec が含まれ、ストリームの等価 API は削除されます。
code interpreter、terminal、git APIs のような非コア機能を helpers に移動することを検討しています。これらは既存の API を維持する予定のため、移行は容易になる見込みです。

次のステップ

これらの機能を使用している場合は、2026 deprecation migration guide を参照してください。
移行を支援する agent skill も提供しています。
質問がある場合は Cloudflare Developers Discord ↗ でお問い合わせください。

ご不明点や追加のサポートが必要であればお知らせください。

Sandbox SDK - Deprecating Sandbox SDK features

要約