Skip to main content
Whop CLI(whop)는 현재 API를 터미널에서 사용할 수 있게 해줍니다. 앱 배포, 상품 생성, 가격 설정, 지급 전송, 광고 운영, 통계 조회를 할 수 있습니다. 모든 명령은 스크립트와 AI 에이전트를 위해 비대화형으로도 작동합니다.
CLI에는 샌드박스나 테스트 모드가 없습니다. 모든 명령은 프로덕션 환경에서 실행되며, 많은 명령이 실제 리소스를 생성하거나 실제 자금을 이동시킬 수 있습니다. 상태를 변경하는 명령은 확인을 요청하며, whop send --dry-run은 결제를 보내지 않고 미리 보여줍니다.

설치

설치 스크립트는 whop을 ~/.local/bin(Windows에서는 %USERPROFILE%\.local\bin)에 설치하며 셸 프로필은 수정하지 않습니다. 설치 후 whop을 찾을 수 없다면 해당 디렉터리를 PATH에 추가하세요. 예: export PATH="$HOME/.local/bin:$PATH". 다른 위치에 설치하려면 WHOP_INSTALL_DIR을 설정하세요. npm 패키지에는 Node.js 22 이상이 필요합니다.
설치를 확인하세요. 버전 번호가 출력됩니다:
whop --help는 CLI가 사용하는 API 버전도 보여줍니다.

로그인

whop login --method oauth는 브라우저를 엽니다. whop login --method api-key --apiKey whop_xxx는 비대화형입니다. 프로필을 사용하면 여러 ID를 유지할 수 있으며, whop auth list, whop auth switch, whop auth status로 관리합니다. 그런 다음 CLI가 작업할 비즈니스를 선택하세요:

포함된 항목

whop --help의 그룹 구성 방식대로 정리된 74개의 명령 그룹: 모든 명령은 명령을 참조하거나 whop <group> --help를 실행하세요.

자주 쓰는 명령

대부분의 그룹은 whop <resource> list|get|create|update라는 같은 형태를 따릅니다. 모든 명령은 구조화된 출력을 위해 --format json을 지원합니다. 계정 범위 명령은 기본적으로 선택된 비즈니스를 사용하며, --account_id로 다른 비즈니스를 선택할 수 있습니다.

앱 배포

연결된 프로젝트를 빌드하고, 타입 검사하고, 업로드한 다음 프로덕션으로 승격합니다. 승격하지 않고 업로드만 하려면 --preview를 전달한 다음, 나중에 whop apps builds promote <build_id>로 배포하세요. 이전 빌드를 승격하는 것이 롤백하는 방법이기도 합니다. 배포 후 앱의 서버 로그를 확인하세요:

비대화형 사용

CI, 스크립트 또는 헤드리스 에이전트의 경우 로그인하는 대신 WHOP_API_KEY를 설정하세요. 대시보드의 Developer에서 키를 생성하고, 에이전트에게 키를 제공하기 전에 인증 및 API 키를 참조하세요.
macOS와 Linux의 독립 실행형 설치는 백그라운드에서 자동으로 업데이트됩니다. 알림만 받으려면 WHOP_CLI_AUTO_UPDATE=0을 설정하세요. 그 외의 경우 대화형 터미널에서 새 릴리스가 나오면 알려주며, whop --update로 설치할 수 있습니다. Homebrew 설치는 brew upgrade whop으로 업데이트합니다.

다음 단계

명령

CLI 자체의 설명이 포함된 모든 명령 그룹입니다.

에이전트 모드

스킬 동기화와 기계 판독 가능한 플래그입니다.

CLI와 Claude로 빌드하기

에이전트와 함께 Whop 앱을 스캐폴딩하고 배포하세요.

인증 및 API 키

CLI 로그인에 사용하는 자격 증명의 범위를 지정하세요.