> ## 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 Dedicated Cloud에서 샌드박스 사용하기

> Forge Dedicated Cloud API 키로 서버리스 용량의 샌드박스를 인증합니다.

조직에서 Forge Dedicated Cloud를 사용하는 경우, `wandb.ai`가 아닌 전용 인스턴스에서 발급한 API 키로 서버리스 용량의 샌드박스를 인증하세요. Python 클라이언트가 키와 인스턴스 호스트 이름을 CoreWeave Sandboxes 서비스로 전송하면, 서비스는 해당 인스턴스를 기준으로 키를 검증합니다. 인증에 올바른 인스턴스가 사용되도록 키와 함께 인스턴스 호스트 이름을 전달하세요.

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

다음 항목이 필요합니다.

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

에어갭 설치를 포함한 Forge 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. Forge Dedicated Cloud 인스턴스에 로그인하세요.
2. 사용자 프로필 아이콘을 클릭한 다음 **User Settings**를 클릭하세요.
3. 아래로 스크롤하여 **API Keys** 섹션에서 키를 생성하세요.

전체 키는 생성할 때 한 번만 표시됩니다. 자세한 내용은 Forge 문서의 [API 키는 어떻게 찾나요?](/ko/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 엔드포인트는 변경 없이 그대로 사용합니다.

<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 시작하기](/ko/products/sandboxes/get-started)에서는 배치 모드, 사용자 인증 정보, 스필오버에 대해 설명합니다.
* [Python 클라이언트](/ko/products/sandboxes/client) 문서에서는 라이프사이클, 실행, 파일 작업을 비롯한 다양한 SDK 패턴을 설명합니다.