# 첫 접속을 점검해보기

> **이 장에서 배우는 것**
> 읽는 장이 아니라 **하는 장**입니다. 켜고 · 붙고 · 로그를 보고 · 끄는 것까지
> 한 번씩 해봅니다. **나중에 막혔을 때 어디를 볼지**를 지금 만들어두는 것이
> 목적입니다.

## 준비물

```
□ 30분
□ 설치가 끝난 상태
□ 터미널 창 하나
```

아직 설치를 안 했다면 [설치하기](/guide/ht-install)를 먼저 하세요.

**아직 아무 일도 시키지 않습니다.** 이 실습은 "일이 되는지"가 아니라 "내가
상태를 확인할 수 있는지"를 봅니다.

---

## 1단계 — 버전 세 개 적기 (5분)

문제가 생겼을 때 가장 먼저 물어보는 것들입니다. **지금 적어두세요.**

```
□ hyperteams --version   →
□ node --version         →
□ OS 와 버전             →
```

**메모장이 아니라 이 실습 기록에 남기세요.** 나중에 문의할 때 이 세 줄이
있으면 왕복 한 번이 줄어듭니다.

---

## 2단계 — 켜고 접속 (5분)

[처음 켜고 접속하기](/guide/ht-first-run)대로 켜고 브라우저로 붙습니다.

### 무엇을 보나

```
□ 터미널에 주소가 표시되나
□ 그 주소로 화면이 열리나
□ 화면 어딘가에 "연결됨" 상태 표시가 있나
```

**세 번째를 찾아두세요.** 나중에 "안 되는데요"의 절반은 실은 안 붙은
상태입니다. 붙었는지 보는 자리를 알고 있으면 그 절반이 사라집니다.

---

## 3단계 — 로그 찾아보기 (10분)

**이 단계가 이 실습의 핵심입니다.** 문제가 없을 때 로그를 한 번 열어보세요.

```
□ 로그가 어디에 남는지 확인했다
□ 지금 화면에 마지막 몇 줄을 띄워봤다
□ 정상일 때 어떤 줄이 나오는지 봤다   ← 이게 중요합니다
```

**세 번째 줄이 이유입니다.** 정상일 때의 로그를 본 적이 없으면, 문제가 생겼을
때 어느 줄이 이상한 줄인지 구분할 수 없습니다. 전부 이상해 보입니다.

### 일부러 오류 한 번 만들기

없는 명령을 한 번 쳐서 **오류가 로그에 어떻게 남는지** 보세요.

```
□ 오류 줄이 정상 줄과 눈에 띄게 다른가
□ 그 줄에 시각이 붙어 있나
```

---

## 4단계 — 끄고 다시 켜기 (5분)

```
□ 정상적으로 껐다
□ 껐을 때 화면이 어떻게 되는지 봤다
□ 다시 켰을 때 이전 상태가 남아 있나 확인했다
```

**세 번째를 꼭 보세요.** 무엇이 남고 무엇이 사라지는지 한 번 확인해두면,
나중에 "그거 어디 갔죠"를 안 겪습니다.

---

## 5단계 — 자동 시작 결정 (5분)

[세 가지 실행 방식](/guide/ht-first-run)을 보고 **지금 하나를 고르세요.**

| 방식 | 나에게 맞나 |
|---|---|
| 필요할 때만 터미널에서 | □ |
| 백그라운드로 띄워두기 | □ |
| 컴퓨터 켤 때 자동 | □ |

```
고르는 기준:
  하루에 한두 번 쓴다        → 필요할 때만
  업무 중 계속 쓴다          → 백그라운드
  예약을 걸 것이다           → 자동 시작 (안 켜져 있으면 예약이 안 돕니다)
```

**세 번째 줄을 놓치지 마세요.** 예약을 쓸 계획이면 자동 시작이 사실상 필수입니다.

---

## 자기 점검

```
□ 버전 세 줄을 적어뒀다
□ 접속 상태를 보는 자리를 안다
□ 정상일 때의 로그를 봤다        ← 안 봤으면 3단계로
□ 오류 줄이 어떻게 생겼는지 봤다
□ 실행 방식을 하나 골랐다
```

---

## 확인

**1. 문제가 없을 때 로그를 미리 열어보라는 이유는?**

<details>
<summary>답</summary>

**정상일 때의 모습을 알아야 이상한 줄을 구분할 수 있기 때문**입니다. 처음 보는
로그는 전부 수상해 보입니다.
</details>

**2. 접속 상태 표시를 미리 찾아두는 이유는?**

<details>
<summary>답</summary>

**"안 된다"의 절반이 실제로는 안 붙은 상태이기 때문**입니다. 붙었는지 보는 자리를
알면 원인 절반이 즉시 걸러집니다.
</details>

**3. 예약을 쓸 계획이면 실행 방식을 어떻게 골라야 합니까?**

<details>
<summary>답</summary>

**자동 시작**입니다. 컴퓨터가 켜져 있어도 프로그램이 안 떠 있으면 예약이 돌지
않습니다.
</details>

---

이제 일을 시킬 폴더를 등록합니다 → [작업 폴더 등록하기](/guide/ht-working-directory)
