クリーンアップ

このページでは、コードが正常に終了した場合や予期せず終了した場合でもリソースが解放されるよう、サンドボックスを確実に終了する方法を説明します。これらのパターンを使用すると、スクリプトの完了後に孤立したサンドボックスが実行されたまま残るのを防げます。

認証を選択する

以下の例は、CKS が指定されているセクションを除き、サーバーレスキャパシティ上で実行されます。サンドボックスを所有するアカウントの認証情報を選択してください。キーまたはトークンの取得方法については、認証情報の選択と取得を参照してください。インストールコマンドは、有効化した Python 仮想環境で実行してください。使用する認証情報のタブにある Python コードを、このページで実行する Python スクリプトと同じディレクトリに sandbox_auth.py として保存します。このファイルに保存されるのは認証方式の選択だけで、認証情報そのものは含まれません。各例ではこのファイルから AUTH をインポートし、新しく作成するサンドボックスやセッションごとに明示的に渡します。

Forge API キー
CoreWeave API アクセストークン

SDK の W&B 認証方式で Forge APIキーを使用します。

uv pip install 'cwsandbox[wandb]>=1.14.2'
export WANDB_API_KEY="[WANDB-API-KEY]"

sandbox_auth.py

from cwsandbox import AuthStrategy

AUTH = AuthStrategy.WANDB

CoreWeave 組織のトークンを使用します。

uv pip install 'cwsandbox>=1.14.2'
export CWSANDBOX_API_KEY="[API-ACCESS-TOKEN]"

sandbox_auth.py

from cwsandbox import AuthStrategy

AUTH = AuthStrategy.COREWEAVE_API_KEY

CKS 配置を使用する場合は、CoreWeave トークンを選択し、ランナーを有効化したうえで、サンドボックスの作成時または SandboxDefaults で placement_mode="cks" を設定します。auth=AUTH を指定してセッションを作成すると、そのセッションが所有するサンドボックスも認証されます。サンドボックスへの再接続、一覧表示、クリーンアップを行う際も、同じ認証情報を使用してください。

サンドボックスのクリーンアップ

コンテキストマネージャーを使用すると、クリーンアップを自動的に処理できます。

from cwsandbox import Sandbox
from sandbox_auth import AUTH

with Sandbox.run(resources={"cpu": "1", "memory": "1Gi"}, auth=AUTH) as sandbox:
    sandbox.exec(["echo", "hello"]).result()
# 自動的に停止します

コンテキストマネージャーを使用せずに作成したサンドボックスでは、.stop() を明示的に呼び出してください。

from cwsandbox import Sandbox
from sandbox_auth import AUTH

sandbox = Sandbox.run(resources={"cpu": "1", "memory": "1Gi"}, auth=AUTH)
sandbox.exec(["echo", "hello"]).result()
sandbox.stop().result()

安全策として、SDK は atexit とシグナル (Ctrl+C、SIGTERM) に対するグローバルなクリーンアップハンドラを登録します。これらのハンドラは Session に属するサンドボックスを停止するため、セッションで管理されているサンドボックスは予期せず終了した場合でも停止されます。一方、Sandbox.run() で直接作成したサンドボックスはセッションに属さないため、プロセスの終了後も、明示的に停止するか有効期間が切れるまで実行され続けます。この動作を前提としたワークフローについては、Sandboxes SDK で Claude Code を設定するを参照してください。一括クリーンアップ、タグ付けの戦略、孤立したサンドボックスの復旧については、クリーンアップパターンガイドを参照してください。

サンドボックス

サンドボックスを使用する

サンドボックスの管理

リファレンス

認証を選択する

サンドボックスのクリーンアップ

​認証を選択する

​サンドボックスのクリーンアップ

認証を選択する

サンドボックスのクリーンアップ