> ## 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.

# W&B Dedicated Cloud에서 샌드박스 사용하기

> W&B Dedicated Cloud 인스턴스의 API 키로 서버리스 샌드박스를 인증합니다.

조직에서 W\&B Dedicated Cloud를 사용하는 경우, `wandb.ai`가 아닌 전용 인스턴스에서 발급한 API 키로 서버리스 샌드박스를 인증하세요. Python 클라이언트는 키와 인스턴스 호스트 이름을 CoreWeave 샌드박스 서비스로 전송하고, 서비스는 해당 인스턴스를 기준으로 키를 검증합니다. 인증 시 올바른 인스턴스가 선택되도록 클라이언트에 인스턴스 URL을 지정하세요.

<h2 id="before-you-begin">
  시작하기 전에
</h2>

다음이 필요합니다.

* W\&B Dedicated Cloud 인스턴스에서 샌드박스 액세스가 활성화되어 있어야 합니다. 인스턴스에 필요한 서버 업데이트가 적용되었는지 확인하고 액세스를 요청하려면 W\&B 계정 팀에 문의하세요.
* W\&B Dedicated Cloud 인스턴스의 URL(예: `https://[INSTANCE].wandb.io`). 호스트 이름은 `.wandb.io`로 끝나야 합니다. 맞춤형 도메인을 사용하는 인스턴스는 지원되지 않습니다.
* Python 3.11 이상

에어갭 설치를 포함한 W\&B Self-Managed 배포는 지원되지 않습니다. TypeScript 클라이언트는 아직 Dedicated Cloud 인스턴스를 지원하지 않으므로 Python 클라이언트를 사용하세요.

<h2 id="get-an-api-key-from-your-instance">
  인스턴스에서 API 키 가져오기
</h2>

[forge.coreweave.com/settings#apikeys](https://forge.coreweave.com/settings#apikeys)가 아닌 전용 인스턴스에서 개인 API 키를 생성하세요.

1. W\&B Dedicated Cloud 인스턴스에 로그인하세요.
2. 사용자 프로필 아이콘을 클릭한 다음 **User Settings**를 클릭하세요.
3. **API Keys** 섹션까지 스크롤한 다음 키를 생성하세요.

W\&B는 키를 생성할 때 한 번만 전체 키를 표시합니다. 자세한 내용은 W\&B 문서의 [API 키는 어떻게 찾나요?](/ko/support/models/articles/how-do-i-find-my-api-key#personal-api-key)를 참조하세요.

키는 개인(사용자) API 키여야 합니다. 다른 유형의 W\&B 자격 증명은 거부됩니다.

<h2 id="point-the-client-at-your-instance">
  클라이언트가 인스턴스를 가리키도록 설정하기
</h2>

`wandb` extra를 포함하여 Python 클라이언트를 설치하세요.

```bash theme={"system"}
uv pip install 'cwsandbox[wandb]>=1.10.0'
```

인스턴스 URL과 API 키를 설정하세요. `[INSTANCE]`는 인스턴스의 호스트 이름 접두사로, `[WANDB-API-KEY]`는 생성한 키로 바꾸세요.

```bash theme={"system"}
export WANDB_BASE_URL="https://[INSTANCE].wandb.io"
export WANDB_API_KEY="[WANDB-API-KEY]"
```

클라이언트는 `wandb` 라이브러리를 통해 자격 증명을 가져옵니다. 이 라이브러리는 `WANDB_BASE_URL`을 읽어 키를 발급한 W\&B 인스턴스를 확인합니다.

<h2 id="run-a-sandbox">
  샌드박스 실행하기
</h2>

W\&B 인증을 사용하려면 `auth=AuthStrategy.WANDB`를 전달하세요. 이 값을 지정하지 않으면 클라이언트는 `CWSANDBOX_API_KEY`에서 CoreWeave API 액세스 토큰을 찾습니다.

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

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

명령이 성공하면 출력에 `Hello!`가 표시됩니다.

인증에 실패하면 `WANDB_BASE_URL`이 키를 생성한 인스턴스와 일치하는지 확인하세요. 전용 인스턴스에서 생성한 키로는 `wandb.ai`에 인증할 수 없고, `wandb.ai`에서 생성한 키로는 전용 인스턴스에 인증할 수 없습니다.

<h2 id="next-steps">
  다음 단계
</h2>

* [CoreWeave 샌드박스 시작하기](/ko/products/sandboxes/serverless/get-started)에서 배치 모드, 자격 증명, 스필오버에 대해 알아보세요.
* [Python 클라이언트](/products/sandboxes/client) 문서에서는 라이프사이클, 실행, 파일 오퍼레이션을 비롯한 다양한 SDK 패턴을 설명합니다.
