CoreWeave Sandboxes を使い始める

サーバーレスキャパシティ上のサンドボックスでコマンドを実行し、その出力を表示します。クラスターのセットアップは必要ありません。

始める前に

サーバーレスサンドボックスは一般提供されており、使用量に応じて課金されます。アクセスは組織単位で有効化されます。組織のアクセスをリクエストするには、サポートにお問い合わせください。組織で Forge 専用クラウドを使用している場合は、Forge 専用クラウドでサンドボックスを使用するの手順に従ってください。

最初のサンドボックスを実行する

サンドボックスを所有し、その料金の請求先となるアカウントの認証情報を選択します。Forge APIキーはサーバーレスへの配置をサポートしています。CoreWeave API アクセストークンは、サーバーレスと CoreWeave Kubernetes Service (CKS) の両方への配置をサポートしています。アカウントの要件については、認証情報を選択して取得するを参照してください。使用する認証情報に対応するセクションの手順を実行してから、結果を検証してください。

Forge APIキー

Forge APIキーを取得します。アカウントをお持ちでない場合は、同じリンクから新規登録してください。次に、ターミナルでキーを設定します。以下の例では FORGE_API_KEY を明示的に読み取っています。SDK はこの環境変数を自動的には検出しません。

export FORGE_API_KEY="[FORGE-API-KEY]"

Python
TypeScript

uv をインストールした状態で、次の内容を hello.py として保存します。

hello.py

import os
from cwsandbox import AuthHeaders, Sandbox

forge_auth = AuthHeaders(
    headers={"x-wandb-api-key": os.environ["FORGE_API_KEY"]},
    strategy="wandb_api_key",
)

with Sandbox.run(
    auth=forge_auth,
    resources={"cpu": "1", "memory": "1Gi"},
) as sandbox:
    print(sandbox.exec(["echo", "Hello!"]).result().stdout)

Python 3.11 とサンドボックスクライアントを使用して実行します。これらがインストールされていない場合は、次のコマンドによって自動的にインストールされます。

uv run --python 3.11 --with 'cwsandbox>=1.14.2' hello.py

Node.js 22 以降をインストールした状態で、クライアントをインストールします。

npm install @coreweave/cwsandbox

次の内容を hello.mts として保存します。

hello.mts

import { createSandboxClient } from "@coreweave/cwsandbox/wandb";

const client = createSandboxClient({
  apiKey: process.env.FORGE_API_KEY,
});
const result = await client.withSandbox(
  async (sandbox) => sandbox.commands.run(["echo", "Hello!"]),
  { resources: { cpu: "1", memory: "1Gi" } },
);
console.log(result.stdout);

tsx を使用して実行します。

npx --yes --package=tsx tsx hello.mts

x-wandb-api-key ヘッダー、wandb_api_key ストラテジー識別子、および TypeScript の /wandb エントリポイントは、Forge の認証に使用する現行の SDK 識別子です。これらの識別子は変更せず、記載どおりに使用してください。

CoreWeave API アクセストークン

Sandbox User ロールを付与する Access Policy の作成または更新を管理者に依頼してください。手順については、アクセスポリシーを作成するを参照してください。 Tokens ページで API アクセストークンを作成し、その Token Secret をコピーして、ターミナルで設定します。

export CWSANDBOX_API_KEY="[API-ACCESS-TOKEN]"

Python
TypeScript

uv をインストールしたうえで、次の内容を hello.py として保存します。

hello.py

from cwsandbox import AuthStrategy, Sandbox

with Sandbox.run(
    auth=AuthStrategy.COREWEAVE_API_KEY,
    resources={"cpu": "1", "memory": "1Gi"},
) as sandbox:
    print(sandbox.exec(["echo", "Hello!"]).result().stdout)

Python 3.11 とサンドボックスクライアントを使用して実行します。これらがインストールされていない場合は、このコマンドによって自動的にインストールされます。

uv run --python 3.11 --with 'cwsandbox>=1.10.0' hello.py

Node.js 22 以降をインストールしたうえで、クライアントをインストールします。

npm install @coreweave/cwsandbox

次の内容を hello.mts として保存します。

hello.mts

import { createSandboxClientFromEnv } from "@coreweave/cwsandbox/node";

const client = createSandboxClientFromEnv();
const result = await client.withSandbox(
  async (sandbox) => sandbox.commands.run(["echo", "Hello!"]),
  { resources: { cpu: "1", memory: "1Gi" } },
);
console.log(result.stdout);

tsx で実行します。

npx --yes --package=tsx tsx hello.mts

結果を確認する

このサンプルを実行すると次の出力が表示され、処理の完了時にサンドボックスが停止します。

Output

Hello!

このサンドボックスには 1 CPU と 1 GiB のメモリが割り当てられています。サーバーレスでは、リソースの制限値はリクエスト値と同じに設定されます。CPU とメモリを変更するには、resources を変更します。同時実行数のクォータ、作成リクエストのレート制限、クォータエラーについては、制限とクォータを参照してください。

次のステップ

ワークロードに応じて、以下のガイドに進んでください。

独自のコンピュートを使用する: クラスターでランナーを有効にし、そのクラスター上でサンドボックスを実行します。
サンドボックスの配置とスピルオーバー: サーバーレスと CKS のキャパシティを比較し、フォールバックを設定します。
コーディングエージェントを実行する: コーディングエージェントをサンドボックスに接続します。
GPU サンドボックス: GPU へのアクセスをリクエストし、GPU ワークロードを実行します。
Python クライアント: コマンドの実行、ファイルの操作、サンドボックスの設定を行います。

サンドボックス

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

サンドボックスの管理

リファレンス

CoreWeave Sandboxes を使い始める

始める前に

最初のサンドボックスを実行する

Forge APIキー

CoreWeave API アクセストークン

結果を確認する

次のステップ

​始める前に

​最初のサンドボックスを実行する

​Forge APIキー

​CoreWeave API アクセストークン

​結果を確認する

​次のステップ

始める前に

最初のサンドボックスを実行する

Forge APIキー

CoreWeave API アクセストークン

結果を確認する

次のステップ