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

# CLI와 Claude로 빌드하기

> Whop CLI와 Claude를 함께 사용해 터미널에서 Whop 앱을 스캐폴딩하고, 빌드하고, 배포하세요.

Whop CLI와 Claude를 함께 사용하면 "Whop 앱을 만들고 싶다"는 생각을 터미널을 떠나지 않고 작동하는 통합으로 바꿀 수 있습니다. CLI는 스캐폴딩과 배포를 담당하고 에이전트의 도구로 자신을 등록할 수 있으며, Claude는 MCP로 Whop 문서를 읽고 코드를 작성합니다. 사용자는 계속 과정에 참여합니다.

> [!NOTE]
>
> Whop 계정이 필요합니다. `curl -fsSL https://whop.com/install.sh | sh`로 CLI를 설치하세요. 이 페이지의 명령은 CLI v0.16.1을 기준으로 검증되었습니다.

> [!WARNING]
>
> CLI는 프로덕션에서 작동합니다. 샌드박스 모드가 없으며, 마법사가 실제 앱을 생성하고 실제 돈을 이동시킬 수 있습니다.

## 비즈니스 선택하기

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

CLI가 작업할 Whop 비즈니스를 선택하거나 생성하고 로그인합니다. 로그인만 하려면 `whop login --method oauth`를 실행하면 브라우저가 열립니다.

## 에이전트에 Whop 도구 제공하기

Claude가 빌드하는 동안 문서를 읽고 API를 호출할 수 있도록 두 개의 Whop MCP 서버를 연결하세요. 두 서버의 설치 블록은 [AI 및 MCP](https://docs.whop.com/ko/developer/guides/ai_and_mcp.md)에 있습니다.

그런 다음 에이전트가 매번 설명을 듣지 않아도 Whop의 규칙을 알 수 있도록 Whop의 스킬 파일을 동기화하세요:

```bash theme={null}
whop skills add
```

이제 Claude는 최신 문서를 바탕으로 Whop에서 결제를 받는 방법 같은 질문에 답하고, API를 통해 계정에서 작업할 수 있습니다.

## 앱 스캐폴딩하기

```bash theme={null}
whop apps init --name "My App" --app_type b2c_app
```

앱을 등록하고, 최신 템플릿을 스캐폴딩하고, Whop 호스팅에 맞게 연결하고, 의존성을 설치합니다. 그런 다음 Claude에게 이렇게 요청하세요: *"Whop 문서를 사용해서 Whop Elements 체크아웃과, 결제 시 접근 권한을 부여하는 웹훅을 추가해 줘."* Claude는 [Whop MCP 서버](https://docs.whop.com/ko/developer/guides/ai_and_mcp.md)에서 최신 API를 가져와 그에 맞춰 코드를 작성합니다.

## 개발한 다음 배포하기

```bash theme={null}
whop apps dev       # build and run locally
whop apps deploy    # build, typecheck, upload, and promote to production
```

프로덕션으로 승격하지 않고 업로드하려면 `whop apps deploy --preview`를 사용한 다음, 나중에 승격하세요. 롤백도 같은 방법으로 합니다.

> [!TIP]
>
> 세션 내내 Claude를 Whop MCP 서버에 연결된 상태로 유지하세요. 그래야 코드가 최신 API를 따릅니다.

## 다음 단계

> [card] [AI 및 MCP](https://docs.whop.com/ko/developer/guides/ai_and_mcp.md)
>
> 전체 MCP 설정.

> [card] [Whop CLI](https://docs.whop.com/ko/cli/overview.md)
>
> 전체 명령 목록.


## Related topics

- [Whop CLI 에이전트 모드](https://docs.whop.com/ko/cli/agent-mode.md)
- [Whop CLI](https://docs.whop.com/ko/cli/overview.md)
- [블루프린트로 프로젝트 시작하기](https://docs.whop.com/ko/developer/guides/blueprints.md)
