---
title: CLI 인증
description: CLI에서 사용할 Sume API 키를 설정하는 방법을 살펴보세요.
---

로컬 CLI의 기본 플로는 브라우저 로그인입니다. CLI가
[www.sume.com/cli/login](https://www.sume.com/cli/login) 기기 승인 페이지를
`user_code`와 함께 열고, 승인을 기다린 뒤 CLI 범위의 API 키를 로컬 설정에
저장합니다.

키를 직접 만들려면 [API Keys 대시보드](https://www.sume.com/dashboard/api-keys)를
사용하세요.

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

원격이나 헤드리스 터미널에서는 브라우저를 여는 대신 승인 URL을 출력합니다.

```bash
sume login --no-browser
```

CI, 서버 자동화, 고급 로컬 워크플로를 위해 수동 API 키 설정과 환경 변수도 그대로
지원합니다.

```bash
sume auth setup --api-key "$SUME_API_KEY"
```

```bash
export SUME_API_KEY="sume_live_..."
export SUME_API_BASE_URL="https://api.sume.com/v1"
export SUME_API_AUTH_MODE="x-api-key"
```

현재 CLI 기본값은 `x-api-key`입니다. `Authorization: Bearer`를 선호하는
클라이언트를 위해 `SUME_API_AUTH_MODE=bearer`도 지원합니다.

로컬 설정은 기본적으로 `~/.sume-com/config.json`에 저장됩니다.
