셋 중 하나만 설치하세요
유료로 구독 중인 서비스의 도구를 고르면 지금 내는 구독료 안에서 씁니다. 구독이 여러 개면 편한 것 하나, 없으면 agy.
이런 분은이 도구를만든 곳참고
윈도우 노트북 기준입니다. 크롬북은 이번 연수에서 다루지 않습니다.
STEP 1명령 프롬프트(cmd) 열기
- 작업 표시줄 시작(⊞)을 누르고
cmd입력 - 열기 클릭 (또는 Enter)
- 창에
C:\Users\내이름>이 보이면 준비 끝
관리자 권한으로 실행은 쓰지 마세요. 관리자 창에서 설치하면 다른 계정 폴더에 깔려 평소 창에서 명령어를 못 찾을 수 있고, AI 에이전트가 시스템 파일까지 건드릴 권한을 갖게 됩니다.
STEP 2Node.js 설치하기 모두 공통
강의 실습에서 npm으로 설치하는 도구를 씁니다. 이미 깔려 있으면 아래 설치 확인만 하세요.
방법 A 추천cmd에 한 줄 입력
약관 동의를 물으면 Y 입력 후 Enter. 권한 확인 창이 뜨면 예.
방법 B홈페이지에서 내려받기
- nodejs.org/ko/download 접속
- LTS 버전의 Windows 설치 파일(.msi) 받기
- 설치 파일 실행 → 계속 Next → Install
설치 확인 cmd를 새로 열고 입력
v22 이상 숫자가 나오면 정상(예: v24.20.0). npm도 숫자가 나오면 끝입니다.
STEP 3고른 도구 하나만 설치하기
내 도구의 명령을 복사 → cmd에 붙여넣기(마우스 오른쪽 클릭 또는 Ctrl+V) → Enter. 진행 표시가 없어도 끝날 때까지 기다리세요.
출처 Claude Code 설치 문서 · Codex CLI (GitHub) · Antigravity CLI 시작하기
STEP 4설치 확인 (PATH)
PATH가 뭔가요?
윈도우가 명령어를 찾아보는 폴더 목록입니다. 설치 폴더가 여기 들어 있어야 어느 폴더에서든 도구 이름만 쳐서 실행할 수 있습니다.
새 cmd 창에서 입력
성공 아래처럼 설치 경로가 나옵니다(이름 부분은 내 계정 이름).
실패 경로 대신 "찾을 수 없다"는 안내(INFO: …)가 나오면 탭으로.
STEP 5실행하고 로그인하기
연습용 폴더를 만들고 그 안에서 내 도구를 실행합니다.
명령어를 못 찾는다고 나올 때
1먼저 해 볼 것
열려 있는 cmd 창을 모두 닫고 새로 엽니다. 설치 전에 열어 둔 창은 바뀐 PATH를 모릅니다. 대부분 이것으로 해결됩니다.
2그래도 안 되면 PATH에 직접 추가
- 시작에서 환경 변수 검색 → 계정의 환경 변수 편집
검색이 어려우면 cmd에 아래 명령을 넣어도 같은 창이 열립니다. - 위쪽 사용자 변수에서 Path 선택 → 편집
- 새로 만들기 → 아래 폴더 붙여넣기
- 확인을 눌러 모두 닫고 cmd를 새로 열어 다시 확인
설치 명령이 아예 실패하면 학교망 차단일 수 있습니다. 다른 네트워크(집·핫스팟)에서 다시 하거나, STEP 2에서 설치한 npm으로 설치합니다(Claude Code·Codex).
강의 전에 확인해 주세요
막히면 어느 STEP에서 멈췄는지와 오류 화면을 캡처해 단톡방에 올려 주세요.
