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

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# Whop CLI

> Whop CLI를 설치하고 로그인한 다음 터미널에서 비즈니스 전체를 관리하세요: 커머스, 자금, 광고, 앱 전반에 걸친 74개의 명령 그룹.

Whop CLI(`whop`)는 현재 API를 터미널에서 사용할 수 있게 해줍니다. 앱 배포, 상품 생성, 가격 설정, 지급 전송, 광고 운영, 통계 조회를 할 수 있습니다. 모든 명령은 스크립트와 AI 에이전트를 위해 비대화형으로도 작동합니다.

> [!WARNING]
>
> CLI에는 샌드박스나 테스트 모드가 없습니다. 모든 명령은 프로덕션 환경에서 실행되며, 많은 명령이 실제 리소스를 생성하거나 실제 자금을 이동시킬 수 있습니다. 상태를 변경하는 명령은 확인을 요청하며, `whop send --dry-run`은 결제를 보내지 않고 미리 보여줍니다.

## 설치

```bash macOS / Linux theme={null}
curl -fsSL https://whop.com/install.sh | sh
```

```powershell Windows theme={null}
irm https://github.com/whopio/whop-public-cli/releases/latest/download/install.ps1 | iex
```

```bash Homebrew theme={null}
brew install whopio/tap/whop
```

```bash npm theme={null}
npm install -g @whop/cli
```

> [!NOTE]
>
> 설치 스크립트는 `whop`을 `~/.local/bin`(Windows에서는 `%USERPROFILE%\.local\bin`)에 설치하며 셸 프로필은 수정하지 않습니다. 설치 후 `whop`을 찾을 수 없다면 해당 디렉터리를 `PATH`에 추가하세요. 예: `export PATH="$HOME/.local/bin:$PATH"`. 다른 위치에 설치하려면 `WHOP_INSTALL_DIR`을 설정하세요. npm 패키지에는 Node.js 22 이상이 필요합니다.

설치를 확인하세요. 버전 번호가 출력됩니다:

```bash theme={null}
whop --version
```

`whop --help`는 CLI가 사용하는 API 버전도 보여줍니다.

## 로그인

```bash theme={null}
whop login
```

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

```bash theme={null}
whop quickstart
```

## 포함된 항목

`whop --help`의 그룹 구성 방식대로 정리된 74개의 명령 그룹:

| 카테고리 | 그룹 |
| - | - |
| 시작하기 | `quickstart` · `apps` |
| 커머스 | `products` · `variants` · `promo-codes` · `checkout-configurations` · `waitlist-entries` · `memberships` · `shipments` · `reviews` · `review-reports` · `product-affiliates` |
| 핵심 리소스 | `accounts` · `users` · `members` · `team-members` · `search` · `external-accounts` · `social-accounts` |
| 결제 | `payments` · `invoices` · `confirmation-tokens` · `payment-quotes` · `setup-intents` · `refunds` · `resolution-center-cases` · `dispute-alerts` · `disputes` · `payment-rules` · `financing-applications` |
| 자금 | `deposits` · `transfers` · `payouts` · `ledgers` · `cards` · `cashback-rules` · `swaps` · `trades` · `verifications` · `send` |
| 웹사이트 | `domains` · `app-installations` · `experiments` |
| 광고 | `ad-campaigns` · `ad-groups` · `ads` · `audiences` · `ad-pixels` |
| 분석 | `stats` · `people` · `events` · `exports` · `economic-intelligence` |
| 커뮤니케이션 | `livestreams` · `notifications` · `email-addresses` |
| 파트너 | `partners` · `partner-referral-requests` |
| 인력 | `bounties` · `bounty-submissions` |
| 미디어 | `files` · `media` |
| 개발자 | `api-keys` · `webhooks` · `permissions` · `api-logs` · `report-feedback` · `ask-question` |
| 인증 | `auth` · `login` · `logout` |
| 통합 | `completions` · `mcp` · `skills` |

모든 명령은 [명령](https://docs.whop.com/ko/cli/commands.md)을 참조하거나 `whop <group> --help`를 실행하세요.

## 자주 쓰는 명령

```bash theme={null}
whop --help                  # all commands
whop products list           # what you're selling
whop variants create --help  # options for any command
whop checkout-configurations create --variant_id plan_xxx   # shareable checkout link
whop stats time-series list  # the metric catalog
whop stats time-series get net_revenue --from 2026-01-01 --to 2026-01-31
whop accounts get jordan     # retrieve a business by route
```

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

## 앱 배포

```bash theme={null}
whop apps deploy
```

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

배포 후 앱의 서버 로그를 확인하세요:

```bash theme={null}
whop apps logs app_xxx               # recent logs for your app
whop apps logs app_xxx --level error --query "checkout"
```

## 비대화형 사용

CI, 스크립트 또는 헤드리스 에이전트의 경우 로그인하는 대신 `WHOP_API_KEY`를 설정하세요. [대시보드](https://whop.com/dashboard)의 **Developer**에서 키를 생성하고, 에이전트에게 키를 제공하기 전에 [인증 및 API 키](https://docs.whop.com/ko/developer/guides/auth-scoping.md)를 참조하세요.

```bash theme={null}
WHOP_API_KEY=whop_xxx whop products list --format json
```

macOS와 Linux의 독립 실행형 설치는 백그라운드에서 자동으로 업데이트됩니다. 알림만 받으려면 `WHOP_CLI_AUTO_UPDATE=0`을 설정하세요. 그 외의 경우 대화형 터미널에서 새 릴리스가 나오면 알려주며, `whop --update`로 설치할 수 있습니다. Homebrew 설치는 `brew upgrade whop`으로 업데이트합니다.

## 다음 단계

> [card] [명령](https://docs.whop.com/ko/cli/commands.md)
>
> CLI 자체의 설명이 포함된 모든 명령 그룹입니다.

> [card] [에이전트 모드](https://docs.whop.com/ko/cli/agent-mode.md)
>
> 스킬 동기화와 기계 판독 가능한 플래그입니다.

> [card] [CLI와 Claude로 빌드하기](https://docs.whop.com/ko/developer/guides/cli-with-claude.md)
>
> 에이전트와 함께 Whop 앱을 스캐폴딩하고 배포하세요.

> [card] [인증 및 API 키](https://docs.whop.com/ko/developer/guides/auth-scoping.md)
>
> CLI 로그인에 사용하는 자격 증명의 범위를 지정하세요.


## Related topics

- [Whop CLI 명령](https://docs.whop.com/ko/cli/commands.md)
- [Whop CLI 에이전트 모드](https://docs.whop.com/ko/cli/agent-mode.md)
- [CLI로 웹사이트 빌드하기](https://docs.whop.com/ko/developer/websites/quickstart.md)
