코딩을 처음 접하시는 분도 괜찮습니다. 이 글은 Mac(macOS)에서 바이브코딩·Cursor 실습을 시작하기 전에 꼭 설치해야 하는 프로그램 3가지—Node.js, Git, Cursor를 처음부터 끝까지 따라 할 수 있도록 정리했습니다.
스크린샷과 영상을 보면서, 한 단계씩 그대로 진행해 주세요. Node.js, Git, Cursor 설치를 모두 마친 뒤, 마지막 설치 확인까지 반드시 완료해 주세요.
- 대상: 비개발자 / Mac(macOS) 사용자
- 예상 소요 시간: 15~20분 (Homebrew 설치 포함)
- 준비물: Mac 관리자 비밀번호, 인터넷 연결
Windows 사용자는 Windows 설치 가이드를 참고해 주세요.
먼저 알아두면 좋은 것
바이브코딩으로 앱이나 웹 페이지를 만들려면, Mac 안에 “만들고 실행할 수 있는 환경”이 갖춰져 있어야 합니다. 마치 요리를 하려면 배관 공사와 가스 공사가 있어야 하는 것과 같습니다.
이번에 설치하는 도구는 Node.js, Git, Cursor 세 가지입니다. 이름만 들어보면 낯설 수 있는데, 각각 어떤 프로그램인지, 바이브코딩에서 왜 필요한지만 먼저 짚고 넘어가겠습니다.
Node.js — 만든 앱을 Mac에서 돌려 주는 엔진
Node.js는 웹·앱 개발에서 쓰는 실행 엔진입니다. 바이브코딩으로 AI가 만들어 준 코드를 “실제로 내 Mac에서 실행”하려면 이 엔진이 있어야 합니다. 자동차에 엔진이 없으면 출발할 수 없듯, Node.js 없이는 npm run dev 같은 명령으로 만든 결과물을 미리보기할 수 없습니다.
바이브코딩 실습에서는 프로젝트를 시작할 때, 개발 서버를 띄울 때, 필요한 라이브러리를 받아올 때 거의 항상 Node.js가 뒤에서 동작합니다. 직접 코드를 많이 작성하지 않아도, Cursor 터미널에 입력하는 명령어 대부분이 Node.js 환경을 전제로 합니다.
Node.js를 설치하면 npm(노드 패키지 매니저)도 함께 설치됩니다. npm은 “이 프로젝트에 필요한 부품을 인터넷에서 받아와라”고 Mac에 지시하는 도구입니다. 실습 중 npm install처럼 한 줄로 추가 도구를 설치할 때 씁니다. 처음에는 Node.js와 npm이 한 세트라고만 기억하셔도 충분합니다.
설치가 끝나면 Cursor 터미널에서 아래 같은 명령어를 쓰게 됩니다. 지금은 외울 필요 없고, “Node.js가 있어야 이런 명령이 된다” 정도만 알아두세요.
npm install— 프로젝트에 필요한 패키지(부품)를 한꺼번에 받아옴npm run dev— 만든 웹·앱을 내 Mac에서 미리보기 (주소는 보통 localhost:3000)npx— 별도 설치 없이 도구를 한 번 실행 (프로젝트 생성 등)
터미널은 이런 명령어를 입력하는 창입니다. Cursor 하단 Terminal 탭이 바로 그 역할을 합니다.
Git — 파일 변경 기록을 남기고, 되돌리고, 공유하는 도구
Git은 파일의 변경 이력을 저장·관리하는 프로그램입니다. 워드에서 “버전 기록”으로 예전 문서를 되돌리듯, 코드 파일도 “어제 상태”, “일주일 전 상태”로 되돌릴 수 있게 해 줍니다. 실습 중 AI가 코드를 수정하다가 뭔가 꼬였을 때, Git이 있으면 이전 버전으로 안전하게 돌아갈 수 있습니다.
바이브코딩 환경에서 Git은 두 가지 역할을 합니다. 첫째, 내 Mac에서 프로젝트 폴더의 변경 사항을 기록합니다. 둘째, 나중에 GitHub 같은 서비스와 연결하면 만든 결과물을 온라인에 올리거나, 다른 사람과 공유할 수 있습니다. 포트폴리오를 웹에 배포하는 실습에서도 Git이 빠지지 않습니다.
Mac에는 Xcode 명령줄 도구에 Git이 포함된 경우가 많지만, 실습에서는 Homebrew로 최신 Git을 설치하는 방법을 안내합니다.
Cursor — AI와 함께 코드를 작성하는 실습용 편집기
Cursor는 코드를 작성·수정하는 프로그램(코드 편집기)입니다. 겉모습은 VS Code와 비슷하지만, 옆에 AI 채팅이 붙어 있어서 “로그인 페이지 만들어줘”, “버튼 색을 파란색으로 바꿔줘”처럼 말로 요청하면서 작업할 수 있습니다. 바이브코딩의 핵심 도구가 바로 이 Cursor입니다.
실습에서는 Cursor 한곳에서 거의 모든 일이 일어납니다. AI에게 지시하고, 생성된 코드를 확인하고, 터미널에 명령어를 입력하고, 파일을 저장하는 작업이 모두 Cursor 안에서 이루어집니다. 메모장이나 워드로는 코드 실행·AI 대화·터미널 사용이 한 번에 되지 않기 때문에, Cursor 설치는 선택이 아니라 필수입니다.
Cursor는 무료로 시작할 수 있고, Google 또는 GitHub 계정으로 로그인하면 바로 쓸 수 있습니다. 유료 플랜은 AI 사용량이 많아졌을 때 검토하시면 됩니다. 실습 입문 단계에서는 무료 범위로도 충분합니다.
세 도구를 한 번 설치해 두면, 이후 실습에서 필요한 다른 프로그램은 대부분 명령어 한두 줄로 추가할 수 있습니다. 지금은 각 도구가 “왜 필요한지” 정도만 이해하셨다면, 아래 설치 단계로 넘어가 주세요.
설치 체크리스트
먼저 세 프로그램을 순서대로 설치한 뒤, 설치 확인을 진행해 주세요.
설치
- ☐ 1. Node.js 설치
- ☐ 2. npm 업데이트
- ☐ 3. Git 설치 (Homebrew)
- ☐ 4. Cursor 설치
- ☐ 5. Cursor 터미널에서 Git 설정
설치 확인
- ☐ 6. Node.js 설치 확인 (
node -v) - ☐ 7. npm 설치 확인 (
npm -v) - ☐ 8. Git·전체 설치 확인 (
git -v,node -v,npm -v)
설치만 하고 확인을 건너뛰면, 실습 당일 “명령어가 안 된다”는 문제로 시간을 잃을 수 있습니다. 1~5단계 설치가 끝나면 6~8단계 확인까지 꼭 진행해 주세요.
설치
Node.js → npm 업데이트 → Git(Homebrew) → Cursor 순서로 설치합니다. Git 사용자 설정(5단계)까지 마치면 설치 확인으로 넘어갑니다.
1. Node.js 설치
Node.js는 바이브 코딩으로 만든 앱을 내 Mac에서 실행할 때 필요한 기본 엔진입니다. 웹·앱 개발 실습의 거의 모든 도구가 Node.js 위에서 동작합니다.
아래 영상을 보면서 진행해도 되고, 글의 스크린샷 순서대로 따라와도 됩니다.
1-1. Node.js 공식 사이트 접속
- 웹 브라우저(Safari, Chrome 등)를 엽니다.
- 주소창에 https://nodejs.org/ko 를 입력하고 Enter를 누릅니다.
- 한국어 페이지가 열리면 준비 완료입니다.
1-2. 설치 파일 다운로드
- 페이지 중앙의 Get Node.js® 버튼을 클릭합니다.
LTS / Current 중 뭘 골라야 하나요?
공식 페이지에서 직접 고를 경우 초록색 LTS 버튼을 누르세요.
LTS는 ‘가장 안정적인 버전’이라는 뜻이라, 비개발자에게 딱 맞습니다.
Current는 최신 실험 버전이라 실습용으로는 권장하지 않습니다.
Get Node.js® 버튼 하나만 보이면 LTS가 이미 선택된 상태이므로, 그대로 누르시면 됩니다.
- macOS용 설치 프로그램(.pkg)이 자동으로 다운로드됩니다. 파일 이름은
node-v○○.○.○.pkg형태입니다.
- 브라우저 하단이나 다운로드 폴더에서 .pkg 파일을 찾습니다.
1-3. Node.js 설치 프로그램 실행
- 다운로드한 .pkg 파일을 더블클릭해 실행합니다.
- “확인되지 않은 개발자” 경고가 나오면, 시스템 설정 → 개인정보 보호 및 보안에서 “그래도 열기”를 선택합니다.
- 설치 마법사가 열리면 계속(Continue) → 동의(Agree) → 설치(Install) 순서로 진행합니다.
- Mac 로그인 비밀번호를 입력하라는 창이 나오면 입력합니다. (입력 중 화면에 점이 표시되지 않아도 정상입니다.)
- 설치가 끝나면 닫기(Close)를 누릅니다.
Node.js 설치가 끝나면 npm 업데이트(2단계)로 넘어갑니다.
2. npm 업데이트
npm은 Node.js와 함께 설치되는 패키지 관리 도구입니다. Mac에서는 Node.js 설치 직후 npm을 최신 버전으로 한 번 올려 두면, 이후 실습에서 오류가 줄어드는 경우가 많습니다.
2-1. 터미널 열기
- 키보드
Cmd + Space를 눌러 Spotlight 검색을 엽니다. terminal을 입력하고 Enter를 눌러 터미널 앱을 실행합니다.
Cursor를 이미 설치했다면 Cursor 터미널(Cmd + J)을 써도 됩니다. Node.js 설치 직후에는 Mac 기본 터미널로 진행하는 것이 가장 단순합니다.
2-2. npm 최신 버전으로 업데이트
터미널에 아래 명령어를 입력하고 Enter를 누릅니다.
sudo npm install -g npm@latest
Mac 로그인 비밀번호를 입력하라는 메시지가 나오면 입력합니다. 입력 중 화면에 글자가 보이지 않는 것이 정상입니다.
업데이트가 끝나면 아래로 버전을 확인합니다.
npm -v
11.9.0처럼 버전 번호가 출력되면 npm 업데이트가 완료된 것입니다. 숫자가 조금 달라도 v10 이상이면 실습에 무리 없습니다.
3. Git 설치 (Homebrew)
Git은 실습 중 만든 파일의 변경 이력을 저장하고, 나중에 GitHub 같은 서비스와 연결할 때 필요한 도구입니다. Mac에서는 Homebrew(홈브류)라는 패키지 관리 도구를 통해 Git을 설치합니다.
3-1. Git이 이미 있는지 확인 (선택)
터미널에 아래를 입력해 보세요.
git --version
git version 2.x.x처럼 버전이 나오면 Git이 이미 설치된 상태입니다. 그래도 Homebrew Git을 설치하면 최신 버전을 쓸 수 있어 권장합니다. 버전이 나오지 않거나 “command not found”가 나오면 아래 Homebrew 설치를 진행하세요.
3-2. Homebrew 설치
터미널에 아래 명령어를 한 줄로 복사해 붙여 넣고 Enter를 누릅니다.
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
설치 중 Mac 로그인 비밀번호를 물어볼 수 있습니다. 화면 안내에 따라 Enter를 눌러 진행합니다.
Apple Silicon Mac(M1/M2/M3/M4)인 경우, 설치 마지막에 “Next steps”로 PATH 설정 명령이 표시됩니다. 안내에 나온 두 줄(예: echo >> ~/.zprofile …, eval "$(/opt/homebrew/bin/brew shellenv)")을 그대로 복사해 터미널에 실행한 뒤, 터미널을 껐다 켜 주세요.
Intel Mac은 대부분 추가 PATH 설정 없이 바로 brew 명령을 쓸 수 있습니다.
3-3. Git 설치
Homebrew 설치가 끝났다면, 터미널에 아래를 입력합니다.
brew install git
설치가 완료되면 버전을 확인합니다.
git --version
git version 2.x.x처럼 출력되면 Git 설치 성공입니다.
4. Cursor 설치
Cursor는 바이브 코딩 실습에서 사용할 AI 코드 편집기입니다. VS Code와 비슷한 화면에 AI 채팅이 붙어 있어, “이 기능 만들어줘”처럼 말로 요청하면서 코드를 작성할 수 있습니다.
4-1. 다운로드 및 설치
- Cursor 다운로드 페이지에 접속합니다.
- Mac용 Download 버튼을 눌러 설치 파일을 받습니다.
- 다운로드한 .dmg 파일을 열고, Cursor 아이콘을 Applications(응용 프로그램) 폴더로 드래그합니다.
- Applications에서 Cursor를 실행합니다. “확인되지 않은 개발자” 경고가 나오면, Cursor 아이콘을 Control+클릭 → 열기를 선택합니다.
4-2. 첫 실행 및 로그인
- 처음 실행하면 Google 또는 GitHub 계정으로 로그인하라는 화면이 나옵니다. Google 계정으로 로그인해 주세요.
- 로그인 후 기본 단축키 안내, 테마 선택, 한국어 설정 등 초기 설정 화면이 나올 수 있습니다. 기본값으로 두거나, 한국어를 선호하시면 Language에서 Korean을 선택하시면 됩니다.
4-3. Agent 창 → Editor 창으로 바꾸기
Cursor를 처음 실행하면 Agent(에이전트) 화면이 먼저 열리는 경우가 많습니다. Agent 화면은 AI와 대화하는 데 특화된 레이아웃이고, 실습에서는 파일 목록·코드 편집·터미널이 함께 보이는 Editor(에디터) 화면을 주로 사용합니다. Git 설정(5단계)과 터미널 작업을 하려면 Editor로 바꿔 두는 것이 편합니다.
Editor로 전환하는 방법은 다음과 같습니다.
- Cursor 창 우측 상단에 있는 Editor window 또는 IDE 버튼을 클릭합니다. 또는 상단 메뉴 바에서 File → Open IDE(또는 Open Editor Window)를 선택해도 됩니다.
- 한 번 Editor 화면으로 바꾼 뒤부터는 키보드
Cmd + E로 Agent ↔ Editor를 빠르게 오갈 수 있습니다.
Editor 화면이 열리면 왼쪽에 파일 탐색기, 가운데에 코드 편집 영역, 아래에 터미널(Cmd + J)을 둘 수 있습니다. 설치 확인·Git 설정 단계에서는 Editor 화면에서 진행해 주세요.
5. Cursor 터미널에서 Git 설정
Git을 Cursor 안에서 바로 쓰려면, “내 이름과 이메일”을 Git에 한 번 알려 주어야 합니다. GitHub에 올릴 때 누가 작업했는지 기록되도록 하는 설정입니다.
5-1. 터미널 열기
- Cursor를 실행합니다. Agent 화면이 열려 있다면 위 4-3단계대로 Editor 화면으로 전환합니다.
- 키보드
Cmd + J를 누릅니다. 화면 아래쪽에 패널이 열립니다. - 패널 상단 탭에서 Terminal을 클릭합니다.
- 터미널 창에
%또는$로 시작하는 줄과 깜빡이는 커서가 보이면 준비 완료입니다.
5-2. Git 사용자 정보 설정
아래 명령어에서 "SIREAL", "sireal@example.com" 부분을 본인 이름·이메일로 바꿔, 한 줄씩 입력하고 Enter를 누릅니다.
git config --global user.name "SIREAL"
git config --global user.email "sireal@example.com"
git config --global init.defaultBranch main
git config --global credential.helper store
각 줄이 하는 일:
| 명령어 | 설명 |
|---|---|
| user.name | Git 커밋(저장 기록)에 표시될 이름. 영문 권장 |
| user.email | Git에 등록할 이메일. GitHub 쓸 예정이면 GitHub 가입 이메일과 맞추면 편합니다 |
| init.defaultBranch main | 새 프로젝트의 기본 브랜치 이름을 main으로 설정 |
| credential.helper store | GitHub 등 로그인 정보를 Mac에 저장해, 매번 비밀번호를 안 물어보게 함 |
따옴표 " 안에 이름·이메일을 넣는 것을 잊지 마세요. 입력 후 아무 메시지가 없이 다음 줄로 넘어가면 정상입니다.
5-3. 터미널 화면 정리 (선택)
clear
설치 확인
1~5단계 설치가 모두 끝났다면, Cursor 터미널에서 프로그램이 제대로 설치됐는지 확인합니다.
6. Node.js 설치 확인
Cursor 터미널에 아래 명령어를 입력하고 Enter를 누릅니다.
node -v
정상적으로 설치되었다면 v25.6.1처럼 v로 시작하는 버전 번호가 출력됩니다. 숫자가 조금 다르면 괜찮습니다. v와 숫자가 보이면 Node.js 설치 성공입니다.
7. npm 설치 확인
npm -v
11.9.0처럼 버전 번호가 출력되면 npm도 정상입니다.
8. Git·전체 설치 확인
Cursor 터미널에서 아래 명령어를 하나씩 입력합니다.
git -v
node -v
npm -v
각 명령마다 버전 정보가 출력되면 설치가 모두 완료된 것입니다. 예시:
- git version 2.47.0
- v25.6.1
- 11.9.0
숫자는 Mac마다 조금 다를 수 있습니다. “버전 번호가 나온다”는 것만 확인하시면 됩니다.
세 가지 모두 버전이 보이면 Mac 바이브코딩 실습 환경 준비가 끝났습니다. Cursor를 열고 바로 실습을 시작하시면 됩니다.
설치했는데 버전 정보가 나오지 않을 때
- Cursor를 완전히 종료한 뒤 다시 실행합니다. 메뉴 바 Cursor → Quit Cursor(또는
Cmd + Q)로 종료합니다. - 그래도 안 되면 Mac을 재시작합니다. Homebrew 설치 직후에는 PATH가 반영되지 않은 경우가 있습니다.
- Apple Silicon Mac에서
brew또는git명령이 안 되면, Homebrew 설치 마지막에 안내된 PATH 설정 명령을 다시 실행한 뒤 터미널을 껐다 켜 보세요. - 그래도 해결되지 않으면 Cursor 에이전트 패널을 열어 터미널 오류를 복사해 질문합니다.
Cursor 에이전트 패널 여는 방법:
- Cursor 창 우측 상단에서 톱니바퀴(설정) 바로 왼쪽 Agent(에이전트) 아이콘을 클릭합니다.
- 또는 키보드
Cmd + Option + B를 눌러 AI 채팅(에이전트) 패널을 열거나 닫습니다.
자주 겪는 문제
node, npm, git 명령어가 인식되지 않는 경우
- Cursor → Quit Cursor(
Cmd + Q)로 완전히 종료한 뒤 재실행합니다. node -v,npm -v,git -v를 다시 입력합니다.- 그래도 안 되면 Mac을 재시작합니다.
- Homebrew로 설치한 Git만 문제일 때는
brew install git을 다시 실행합니다. - Node.js만 문제일 때는 nodejs.org/ko에서 .pkg를 다시 설치합니다.
Homebrew 설치 중 오류가 나는 경우
- “Need sudo access” 메시지가 나오면 Mac 관리자 비밀번호를 입력합니다.
- 네트워크 오류가 나면 Wi-Fi 연결을 확인하고 다시 시도합니다.
- 회사 Mac에서 설치가 막히면 IT 담당자에게 Homebrew·Node.js·Cursor 설치 권한을 요청하세요.
brew: command not found
Apple Silicon Mac에서 Homebrew 설치 후 PATH 설정을 하지 않으면 발생합니다. 설치 마지막에 표시된 Next steps 명령 두 줄을 터미널에 실행한 뒤, 터미널을 껐다 켜 주세요.
Cursor 로그인이 안 되는 경우
- 회사 네트워크·VPN에서 cursor.com 접속이 차단될 수 있습니다. VPN을 끄거나, 다른 네트워크(핫스팟 등)에서 시도해 보세요.
- Google 로그인이 안 되면 GitHub 계정으로 시도해 보세요.
다음에 할 일
- Cursor를 실행하고, 새 폴더를 열어 실습 프로젝트를 시작합니다.
- Windows를 쓰는 분은 Windows 설치 가이드를 참고해 주세요.
- 설치 중 막히는 부분이 있으면 시리얼 블로그 댓글이나 네이버 카페에 질문을 남겨 주세요.
여기까지 완료하셨다면, Mac에서 바이브코딩을 시작할 준비가 끝났습니다.
작성: 전시진 | 시리얼(Sireal)
Comments are closed.