준비물

이 장에서 배우는 것 두 가지 준비물과 각각의 설치·확인 방법. 여기서 막히면 다음 단계로 못 갑니다.

Node.js·터미널이 무엇인지 모르겠다면 프로그램과 언어 · 터미널과 명령어를 먼저 보세요.

두 가지

준비물	왜 필요한가
에이전트 CLI 하나	HyperTeams가 시키는 대상
Node.js	HyperTeams가 그 위에서 돎

1. 에이전트 CLI — 셋 중 하나

하이퍼팀즈(HyperTeams)는 아래 셋을 굴립니다. 하나만 있으면 됩니다.

에이전트	명령	로그인
Claude Code	`claude`	Claude 구독 또는 API 키
ChatGPT Codex	`codex`	ChatGPT 구독
Antigravity	`agy`	Google 계정

여러 개를 깔아 두시면 업무를 만들 때 골라 쓰고, 폴더마다 기본 엔진을 정해 둘 수 있습니다. 처음이시라면 쓰고 계신 구독이 있는 쪽 하나로 시작하세요.

설치 명령(다음 장)은 Claude Code만 알아서 깔아 줍니다. 나머지 둘은 설치 한 줄을 안내만 하는데, 배포 방식이 컴퓨터마다 갈려 반쯤 성공하는 설치보다 안내가 낫기 때문입니다.

Claude Code

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

ChatGPT Codex

npm 전역 설치라 Node.js가 먼저 있어야 합니다(아래 2번).

codex login이 브라우저를 열고 ChatGPT 계정을 묻습니다.

Antigravity

설치 후 한 번 실행해 Google 계정으로 로그인합니다.

로그인이 중요한 이유

하이퍼팀즈(HyperTeams)가 이 로그인을 그대로 쓰기 때문입니다. 여기서 로그인해 두면 HyperTeams에는 따로 키를 넣을 일이 없습니다.

확인

깔기로 하신 것의 버전이 나오면 준비 완료입니다.

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

2. Node.js

설치

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

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

확인

둘 다 확인하기

에이전트 하나와 Node.js, 둘 다 버전이 나오면 다음 단계로 갈 수 있습니다.

Codex나 Antigravity를 쓰신다면 앞의 명령만 codex --version · agy --version 으로 바꾸시면 됩니다.

자주 막히는 곳

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

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

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

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

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

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

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

"Node.js LTS와 AI 에이전트 CLI 하나(Claude Code · ChatGPT Codex · Antigravity 중 하나) 설치가 필요합니다. 모두 개발 도구이고 공식 배포처는 nodejs.org, claude.ai, npm, antigravity.google입니다."

"로그인이 안 됩니다"

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

확인

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

답

에이전트의 로그인을 그대로 쓰기 때문입니다. 그래서 설치 후 claude(또는 codex login, agy)를 한 번 실행해 로그인해두는 단계가 중요합니다.

2. 에이전트를 셋 다 깔아야 하나요?

답

아니요, 하나면 됩니다. 여러 개를 깔아 두면 업무마다 골라 쓸 수 있고 폴더마다 기본 엔진을 정할 수 있지만, 시작에 필요한 것은 하나입니다.

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

답

claude --version && node --version — 에이전트 하나와 Node.js 둘 다 버전이 나오면 준비 완료입니다. Codex·Antigravity를 쓰신다면 앞을 codex --version · agy --version으로 바꾸세요.

준비가 됐으면 설치는 한 줄입니다 → 설치하기