# 준비물

> **이 장에서 배우는 것**
> 두 가지 준비물과 각각의 설치·확인 방법. 여기서 막히면 다음 단계로 못 갑니다.
>
> **Node.js·터미널이 무엇인지 모르겠다면** [프로그램과 언어](/guide/it-programs) · [터미널과 명령어](/guide/it-terminal)를 먼저 보세요.

## 두 가지

| 준비물 | 왜 필요한가 |
|---|---|
| **Claude Code** | HyperTeams가 **시키는 대상** |
| **Node.js** | HyperTeams가 그 위에서 돎 |

---

## 1. Claude Code

### 설치

터미널(macOS·Linux) 또는 PowerShell(Windows)에 붙여넣으세요.

```bash
# macOS / Linux
curl -fsSL https://claude.ai/install.sh | bash
```

```powershell
# Windows PowerShell
irm https://claude.ai/install.ps1 | iex
```

### 로그인

설치 후 **한 번 실행해서 로그인해 둡니다.**

```bash
claude
```

로그인 절차가 안내됩니다. 이게 중요한 이유는, **하이퍼팀즈(HyperTeams)가 이 로그인을 그대로
쓰기** 때문입니다. 여기서 로그인해두면 HyperTeams에는 따로 키를 넣을 일이
없습니다.

### 확인

```bash
claude --version
```

버전이 나오면 준비 완료입니다.

```
✓ 2.x.x           → 됨
✗ command not found → 설치가 안 됐거나 터미널을 새로 열어야 함
```

> **`command not found`가 나오면** 설치 직후 열려 있던 터미널에는 아직 반영이
> 안 된 것입니다. **새 터미널 창을 열어** 다시 해보세요.

---

## 2. Node.js

### 설치

[nodejs.org](https://nodejs.org/)에서 **LTS** 버전을 받으세요. LTS는 "장기
지원"이라는 뜻이고, 안정적인 쪽입니다.

설치 프로그램을 실행하고 기본값으로 진행하면 됩니다.

### 확인

```bash
node --version
```

```
✓ v20.x.x 이상    → 됨
✗ command not found → 설치 후 새 터미널을 열어보세요
```

---

## 둘 다 확인하기

두 명령을 연달아 실행해서 둘 다 버전이 나오면 다음 단계로 갈 수 있습니다.

```bash
claude --version && node --version
```

## 자주 막히는 곳

### "설치했는데 command not found가 나옵니다"

**십중팔구 터미널을 새로 열면 해결됩니다.** 설치 프로그램이 경로 설정을 바꾸는데,
이미 열려 있던 터미널은 그 변경을 모릅니다.

그래도 안 되면 컴퓨터를 다시 시작해보세요.

### "Windows에서 스크립트 실행이 차단됩니다"

PowerShell의 보안 설정 때문입니다. **관리자 권한으로 PowerShell을 열어** 다시
시도하거나, 회사 컴퓨터라면 IT 담당자에게 문의하세요.

### "회사 컴퓨터라 설치 권한이 없습니다"

이 경우는 IT 담당자의 도움이 필요합니다. 요청할 때 이렇게 설명하시면 됩니다.

> "Node.js LTS와 Claude Code CLI 설치가 필요합니다. 둘 다 개발 도구이고
> 공식 배포처는 nodejs.org와 claude.ai입니다."

### "Claude Code 로그인이 안 됩니다"

HyperTeams와는 무관한 문제입니다. Claude Code 자체의 로그인 절차를 먼저
해결해야 합니다.

---

## 확인

**1. HyperTeams에 API 키를 따로 넣지 않아도 되는 이유는?**

<details>
<summary>답</summary>

**Claude Code의 로그인을 그대로 쓰기 때문**입니다. 그래서 설치 후 `claude`를 한
번 실행해 로그인해두는 단계가 중요합니다.
</details>

**2. `command not found`가 나올 때 가장 먼저 해볼 것은?**

<details>
<summary>답</summary>

**새 터미널 창을 여는 것**입니다. 설치가 경로 설정을 바꾸는데 이미 열려 있던
터미널은 그 변경을 모릅니다.
</details>

**3. 다음 단계로 갈 수 있는지 확인하는 명령은?**

<details>
<summary>답</summary>

`claude --version && node --version` — 둘 다 버전이 나오면 준비 완료입니다.
</details>

---

준비가 됐으면 설치는 한 줄입니다 → [설치하기](/guide/ht-install)