---
title: CLI 개요
description: sume.com 개발자 플랫폼을 위한 현재 Sume CLI 표면을 살펴보세요.
---

Sume CLI는 현재 `api.sume.com/v1` Developer API를 감싸는 agent-first 래퍼입니다.
이전 소비자 제품 CLI 표면과는 의도적으로 분리되어 있습니다.

## 현재 상태

출시된 CLI(`sumelabs/cli`)는 계정 확인, 카탈로그 탐색, Job, 입력 에셋,
Avatar 1.0, Avatar Video 1.0, 번들 agent skills, 스키마 탐색, 로컬 진단을
지원합니다.

**생성 기능은 Avatar 중심입니다.** 오늘 기준으로 Image 1.0, Video 1.0,
Music 1.0을 위한 일급 CLI 서브커맨드는 없습니다. 이 계열은
[Developer API](/public-api)를 직접 호출하세요([Image](/models/image),
[Video](/models/video), [Music](/models/music) 참고).

로컬 `sume mcp`는 현재 CLI 릴리스에서 **출시되지 않았습니다**(`coming_soon`).
Cursor/Claude에서 원격 MCP를 쓰려면 `https://mcp.sume.com/mcp`의
[호스팅 MCP](/mcp) 커넥터를 사용하세요.

호스팅 인스톨러로 현재 네이티브 바이너리를 설치합니다.

```bash
curl https://cli.sume.com/install -fsS | bash
```

Windows PowerShell은 다음과 같습니다.

```powershell
irm https://cli.sume.com/install.ps1 | iex
```

인스톨러는 최신 `sumelabs/cli` GitHub Release를 확인해 플랫폼에 맞는 바이너리를
내려받고, `checksums.txt`로 검증한 뒤 `~/.sume-com/bin` 아래에 `sume`를
설치합니다.

그다음 브라우저 플로로 로그인하세요.

```bash
sume login
sume auth status
```

## API 베이스

```text
https://api.sume.com/v1
```

## 자주 쓰는 명령어

```bash
sume login
sume auth status
sume account get
sume balance
sume usage get --limit 20
sume catalog list
sume jobs list
sume jobs status <job_id>
sume jobs result <job_id>
sume avatars create --confirm-paid --avatar-handle studio_presenter --type prompt --prompt "Friendly presenter"
sume avatar-videos create --confirm-paid --avatar-handle sume_clawra --script "Say hello" --quality plus
```

기계가 읽을 안정적인 출력이 필요하면 `--json`을 쓰고, 민감한 URL이나 계정
메타데이터가 포함될 수 있는 출력을 자동화가 읽는다면 `--agent`를 쓰세요.
아바타 비디오 스크립트는 4~60초 범위로 추정되어야 합니다.

## 다음 페이지

1. [설치와 업데이트](/cli/install-login)
2. [명령어 레퍼런스](/cli/commands)
3. [생성 워크플로](/cli/generation-workflows)
4. [호스팅 MCP](/mcp) — 원격 커넥터(오늘은 로컬 `sume mcp`보다 이쪽을 권장합니다)