---
title: 설치와 업데이트
description: 현재 개발자 플랫폼 워크플로에 맞춰 Sume CLI를 설치하거나 실행하는 방법을 살펴보세요.
---

권장하는 공개 설치 경로는 네이티브 [`sumelabs/cli`](https://github.com/sumelabs/cli)
바이너리를 위한 호스팅 인스톨러입니다. 이 바이너리가 `api.sume.com` 워크플로를
위한 `sume.com` 개발자 플랫폼 CLI입니다.

## macOS 또는 Linux에 설치하기

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

인스톨러는 OS와 아키텍처에 맞는 최신 릴리스 바이너리를 내려받아
`checksums.txt`로 검증한 뒤 `~/.sume-com/bin` 아래에 `sume`를 설치합니다.
`PATH`에 이미 다른 `sume`가 있다면 조용히 덮어쓰지 않습니다.

## Windows PowerShell에 설치하기

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

## GitHub 바이너리 직접 내려받기

현재 릴리스 에셋 이름은 `sume-darwin-arm64`, `sume-darwin-x64`,
`sume-linux-arm64`, `sume-linux-x64`, `sume-windows-x64.exe`이며 각 GitHub
Release에 `checksums.txt`가 함께 첨부됩니다. 버전을 고정해 설치하려면 URL의
`latest`를 `v0.1.6` 같은 릴리스 태그로 바꾸세요.

```bash
OS="$(uname -s | tr '[:upper:]' '[:lower:]')"
ARCH="$(uname -m | sed 's/x86_64/x64/;s/aarch64/arm64/')"
curl -fsSL "https://github.com/sumelabs/cli/releases/latest/download/sume-${OS}-${ARCH}" -o /tmp/sume
chmod +x /tmp/sume
sudo mv /tmp/sume /usr/local/bin/sume
```

## 로그인

기본 인증 플로는 브라우저 로그인입니다.

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

원격이나 헤드리스 환경에서는 다음을 사용하세요.

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

CI와 통제된 서버 환경을 위해 수동 API 키 설정도 그대로 지원하지만, 로컬
사용자의 첫 실행 경로로 권장하지는 않습니다.

## 개발 빌드

CLI 소스 저장소에서 다음을 실행합니다.

```bash
pnpm install
pnpm run build
pnpm dev -- --help
```

로컬 바이너리가 필요하면 다음과 같이 빌드하세요.

```bash
pnpm run build:binary
./dist/sume --version
```

## 확인

```bash
sume version
sume doctor --agent --json
sume update --check
```

`sume update --check`는 로컬 파일을 건드리지 않고 더 새로운 GitHub Release가
있는지만 알려줍니다. 업그레이드하기로 했다면 호스팅 인스톨러를 다시 실행하세요.