HyperTeams준비물
이 장에서 배우는 것 두 가지 준비물과 각각의 설치·확인 방법. 여기서 막히면 다음 단계로 못 갑니다.
두 가지
| 준비물 | 왜 필요한가 |
|---|---|
| Claude Code | HyperTeams가 시키는 대상 |
| Node.js | HyperTeams가 그 위에서 돎 |
1. Claude Code
설치
터미널(macOS·Linux) 또는 PowerShell(Windows)에 붙여넣으세요.
로그인
설치 후 한 번 실행해서 로그인해 둡니다.
로그인 절차가 안내됩니다. 이게 중요한 이유는, 하이퍼팀즈(HyperTeams)가 이 로그인을 그대로 쓰기 때문입니다. 여기서 로그인해두면 HyperTeams에는 따로 키를 넣을 일이 없습니다.
확인
버전이 나오면 준비 완료입니다.
command not found가 나오면 설치 직후 열려 있던 터미널에는 아직 반영이 안 된 것입니다. 새 터미널 창을 열어 다시 해보세요.
2. Node.js
설치
nodejs.org에서 LTS 버전을 받으세요. LTS는 "장기 지원"이라는 뜻이고, 안정적인 쪽입니다.
설치 프로그램을 실행하고 기본값으로 진행하면 됩니다.
확인
둘 다 확인하기
두 명령을 연달아 실행해서 둘 다 버전이 나오면 다음 단계로 갈 수 있습니다.
자주 막히는 곳
"설치했는데 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 키를 따로 넣지 않아도 되는 이유는?
답
Claude Code의 로그인을 그대로 쓰기 때문입니다. 그래서 설치 후 claude를 한
번 실행해 로그인해두는 단계가 중요합니다.
2. command not found가 나올 때 가장 먼저 해볼 것은?
답
새 터미널 창을 여는 것입니다. 설치가 경로 설정을 바꾸는데 이미 열려 있던 터미널은 그 변경을 모릅니다.
3. 다음 단계로 갈 수 있는지 확인하는 명령은?
답
claude --version && node --version — 둘 다 버전이 나오면 준비 완료입니다.
준비가 됐으면 설치는 한 줄입니다 → 설치하기