# 명령어 레퍼런스

> **찾아보는 장입니다.** 순서대로 읽지 않아도 됩니다.

모든 명령은 **어느 폴더에서든** 실행할 수 있습니다.

## 한눈에

| 명령 | 하는 일 |
|---|---|
| `hyperteams` | 이 터미널에 붙여서 켜기. Ctrl-C로 종료 |
| `hyperteams start --background` | 창을 닫아도 계속 돌게 켜기 |
| `hyperteams stop` | 이 설치본이 띄운 것을 전부 내리기 |
| `hyperteams restart` | 멈추고 백그라운드로 다시 띄우기 |
| `hyperteams setup` | 접속 주소와 비밀번호 다시 정하기 |
| `hyperteams upgrade` | 최신 버전으로 올리기 |
| `hyperteams upgrade --check` | 새 버전이 있는지만 확인 |
| `hyperteams uninstall` | 설치 폴더와 명령 정리 |

---

## 켜기

```bash
hyperteams
```

이 터미널에 붙어서 돕니다. **창을 닫으면 같이 꺼집니다.**

```bash
hyperteams start --background
```

주소를 확인하고 나면 프롬프트가 돌아옵니다. 창을 닫아도 계속 돕니다.

| | 로그 |
|---|---|
| 현재 실행분 | `logs/server.log` |
| 직전 실행분 | `logs/server.log.prev` (한 세대 보관) |

**부팅 시 자동 실행**하려면 이 명령을 시스템 시작 항목에 등록하세요 — macOS는
launchd, Linux는 systemd, Windows는 작업 스케줄러입니다.

---

## 끄기

보통은 띄운 터미널에서 **Ctrl-C**입니다. 그 터미널이 없어졌다면(창을 닫았거나
접속이 끊겼거나):

```bash
hyperteams stop
```

**이 설치본이 띄운 것을 전부 내립니다** — 앱도, 터널도, 열어둔 터미널도.

> 진행 중인 작업이 있으면 알려주고 한 번 물어봅니다. **다시 시작해도 그 작업은
> 이어지지 않기** 때문입니다.

---

## 다시 시작

```bash
hyperteams restart
```

멈추고 **백그라운드로** 다시 띄웁니다 — 이 창을 붙잡지 않습니다. 꺼져 있었다면
그냥 켭니다.

이 창에 붙여서 띄우고 싶으면:

```bash
hyperteams restart --foreground
```

**언제 쓰나**: [터널을 연결한 뒤](/guide/ht-remote-access), 설정을 바꾼 뒤.

---

## 설정 바꾸기

```bash
hyperteams setup
```

접속 주소와 비밀번호를 다시 정합니다. **비밀번호를 잊었을 때**도 이걸 씁니다.

---

## 업데이트

```bash
hyperteams upgrade
```

이 컴퓨터에 맞는 최신 빌드를 받아 **프로그램 파일만 제자리에서 바꿉니다.**

내 것들은 손대지 않습니다:

```
✓ 데이터베이스 (대화·사용량 기록)
✓ .env.local (설정)
✓ 터널 자격증명
```

**애초에 빌드에 들어 있지 않기 때문**입니다. 실행 중이면 먼저 멈추므로, 끝난 뒤
`hyperteams`로 다시 시작하세요.

바꾸지 않고 확인만:

```bash
hyperteams upgrade --check
```

> **재설치는 업데이트 방법이 아닙니다.** 설치 스크립트를 다시 돌리면 기록과 설정이
> 어떻게 될지 보장되지 않습니다.

---

## 다른 포트로 실행

```bash
PORT=9000 hyperteams
```

기본 번호가 이미 쓰이고 있을 때 씁니다. 매번 지정하기 번거로우면
`hyperteams setup`으로 기본값을 바꾸세요.

---

## 삭제

```bash
hyperteams uninstall
```

설치 폴더와 `hyperteams` 명령을 함께 정리합니다.

> **저장된 기록도 같이 지워지므로 지우기 전에 한 번 더 물어봅니다.**

남는 것:

```
✓ Claude Code 자체
✓ 작업 폴더와 그 안의 파일
```

---

## 상황별 찾아보기

| 이럴 때 | 이 명령 |
|---|---|
| 터미널을 계속 쓰고 싶다 | `hyperteams start --background` |
| 창을 닫았는데 끄고 싶다 | `hyperteams stop` |
| 설정을 바꿔서 적용해야 한다 | `hyperteams restart` |
| 비밀번호를 잊었다 | `hyperteams setup` |
| 새 버전이 있는지 궁금하다 | `hyperteams upgrade --check` |
| 포트가 충돌한다 | `PORT=9000 hyperteams` |
| `command not found` | 새 터미널 창을 열기 |

---

문제가 생겼을 때는 → [문제 해결](/guide/ht-troubleshooting)