CoreWeave Sandboxes 시작하기

서버리스 용량에서 실행되는 샌드박스에서 명령어를 실행하고 출력을 확인해 보세요. 클러스터를 따로 설정할 필요가 없습니다.

시작하기 전에

서버리스 샌드박스는 정식 출시되었으며, 사용량에 따라 요금이 청구됩니다. 액세스는 조직 단위로 활성화됩니다. 조직의 액세스 권한을 요청하려면 지원팀에 문의하세요. 조직에서 W&B Dedicated Cloud를 사용하는 경우 W&B Dedicated Cloud에서 샌드박스 사용하기를 참조하세요.

첫 번째 샌드박스 실행하기

샌드박스를 소유하고 비용을 청구받을 계정의 사용자 인증 정보를 선택하세요. Forge API 키는 서버리스 배치를 지원합니다. CoreWeave API 액세스 토큰은 서버리스 배치와 CoreWeave Kubernetes Service(CKS) 배치를 모두 지원합니다. 계정 요구 사항은 사용자 인증 정보 선택 및 발급을 참조하세요. 사용할 사용자 인증 정보의 탭을 선택한 다음 결과를 확인하세요.

Forge API 키
CoreWeave API 액세스 토큰

Forge API 키를 발급받으세요. 계정이 없다면 같은 링크에서 가입하세요. 그런 다음 터미널에 키를 설정하세요. 다음 예시에서는 W&B 인증을 명시적으로 선택합니다.

export WANDB_API_KEY="[WANDB-API-KEY]"

Python
TypeScript

uv가 설치되어 있다면 다음 코드를 hello.py로 저장하세요.

hello.py

from cwsandbox import AuthStrategy, Sandbox

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

Python 3.11과 샌드박스 클라이언트를 사용해 실행하세요. 둘 중 설치되지 않은 것이 있으면 이 명령어가 자동으로 설치합니다.

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

Node.js 22 이상이 설치되어 있다면 클라이언트를 설치하세요.

npm install @coreweave/cwsandbox@1.0.0

다음 코드를 hello.mts로 저장하세요.

hello.mts

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

const client = createSandboxClient({
  apiKey: process.env.WANDB_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

Forge API 키는 SDK의 기존 W&B 식별자인 WANDB_API_KEY, AuthStrategy.WANDB, TypeScript /wandb 진입점을 그대로 사용합니다.

Admin에게 Sandbox User 역할을 부여하는 액세스 정책을 생성하거나 업데이트해 달라고 요청하세요. 자세한 단계는 액세스 정책 생성을 참조하세요.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@1.0.0

다음 코드를 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!

샌드박스에는 CPU 1개와 메모리 1GiB가 할당됩니다. 평면 구조의 resources 딕셔너리는 CPU와 메모리의 요청량과 제한을 같은 값으로 설정합니다. CPU와 메모리를 직접 선택하려면 resources를 변경하세요. 동시 실행 할당량, 생성 요청에 대한 요청 속도 제한, 할당량 오류에 대한 자세한 내용은 제한 및 할당량을 참조하세요.

다음 단계

워크로드에 맞는 가이드를 이어서 확인하세요.

자체 컴퓨팅 사용: 클러스터에서 러너를 활성화하고 샌드박스를 실행하세요.
샌드박스 배치 및 스필오버: 서버리스 용량과 CKS 용량을 비교하고 폴백을 설정하세요.
코딩 에이전트 실행: 코딩 에이전트를 샌드박스에 연결하세요.
GPU 샌드박스: GPU 액세스를 요청하고 GPU 워크로드를 실행하세요.
Python 클라이언트: 명령어 실행, 파일 작업, 샌드박스 설정 방법을 알아보세요.
TypeScript 클라이언트: 명령어 실행과 Compose 파일 사용 방법을 알아보고 SDK API를 찾아보세요.

샌드박스

샌드박스 사용하기

샌드박스 관리

레퍼런스

CoreWeave Sandboxes 시작하기

시작하기 전에

첫 번째 샌드박스 실행하기

결과 확인

다음 단계

​시작하기 전에

​첫 번째 샌드박스 실행하기

​결과 확인

​다음 단계

시작하기 전에

첫 번째 샌드박스 실행하기

결과 확인

다음 단계