> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coreweave.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Forge 専用クラウドでサンドボックスを使用する

> Forge 専用クラウドの APIキーを使用して、サーバーレスキャパシティ上のサンドボックスを認証します。

組織で Forge 専用クラウドを使用している場合は、`wandb.ai` ではなく専用インスタンスの APIキーを使用して、サーバーレスキャパシティ上のサンドボックスを認証します。Python クライアントはキーとインスタンスのホスト名を CoreWeave Sandboxes サービスに送信し、サービスはお使いのインスタンスでそのキーを検証します。認証先として正しいインスタンスが選択されるよう、キーと一緒にインスタンスのホスト名を渡してください。

<h2 id="before-you-begin">
  始める前に
</h2>

以下が必要です。

* Forge 専用クラウドインスタンスでサンドボックスへのアクセスが有効になっていること。インスタンスに必要なサーバー更新が適用されているかどうかの確認とアクセスのリクエストについては、Forge のアカウント担当チームにお問い合わせください。
* Forge 専用クラウドインスタンスの URL (例: `https://[INSTANCE].wandb.io`) 。ホスト名の末尾は `.wandb.io` である必要があります。カスタムドメインのインスタンスはサポートされていません。
* Python 3.11 以降。

Forge のセルフマネージドのデプロイは、エアギャップ環境へのインストールも含めてサポートされていません。TypeScript クライアントは現時点で専用クラウドインスタンスに対応していないため、Python クライアントを使用してください。

<h2 id="get-an-api-key-from-your-instance">
  インスタンスから APIキーを取得する
</h2>

個人用 APIキーは、[forge.coreweave.com/settings#apikeys](https://forge.coreweave.com/settings#apikeys) ではなく、専用インスタンスで作成してください。

1. Forge の専用クラウドインスタンスにサインインします。
2. ユーザープロフィールアイコンをクリックし、**User Settings** をクリックします。
3. **APIキー** セクションまでスクロールし、キーを作成します。

完全なキーが表示されるのは、作成時の 1 回のみです。詳細については、Forge ドキュメントの [APIキーを見つけるには？](/ja/support/models/articles/how-do-i-find-my-api-key#personal-api-key) を参照してください。

キーには個人用 (ユーザー) APIキーを使用する必要があります。それ以外のタイプの Forge 認証情報は受け付けられません。

<h2 id="point-the-client-at-your-instance">
  インスタンスの認証を設定する
</h2>

Python クライアントをインストールします。

```bash theme={"system"}
uv pip install 'cwsandbox>=1.14.2'
```

インスタンスのホスト名とAPIキーを設定します。`[INSTANCE]` はインスタンスのホスト名の接頭辞に、`[FORGE-API-KEY]` は作成したキーに置き換えてください。

```bash theme={"system"}
export FORGE_HOST="[INSTANCE].wandb.io"
export FORGE_API_KEY="[FORGE-API-KEY]"
```

この例では、ホスト名を `x-wandb-host` ヘッダーで渡しています。ホスト名は `https://` やパスを含めずに使用してください。Sandbox API endpoint は変更されません。

<h2 id="run-a-sandbox">
  サンドボックスを実行する
</h2>

`AuthHeaders` を使用して、キーと専用インスタンスのホスト名を渡します。

```python theme={"system"}
import os
from cwsandbox import AuthHeaders, Sandbox

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

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

コマンドが成功すると、出力に `Hello!` が表示されます。

認証に失敗した場合は、`FORGE_HOST` がキーを作成したインスタンスと一致しているか確認してください。専用クラウドのインスタンスで作成したキーは `wandb.ai` での認証に使用できず、`wandb.ai` のキーも専用クラウドのインスタンスでの認証には使用できません。

<h2 id="next-steps">
  次のステップ
</h2>

* 配置モード、認証情報、スピルオーバーについては、[CoreWeave Sandboxes を使い始める](/ja/products/sandboxes/get-started) を参照してください。
* ライフサイクル、実行、ファイル操作、その他の SDK パターンについては、[Python クライアント](/ja/products/sandboxes/client) のドキュメントを参照してください。