바이브코딩 맥 개발환경을 제대로 세팅하고 싶으신가요? macOS는 개발자 친화적인 운영체제지만, 처음 시작할 때 무엇을 어떤 순서로 설치해야 하는지 막막할 수 있습니다. 이 글에서는 Homebrew 하나로 Git, Node.js, VS Code까지 한 번에 설치하는 방법을 단계별로 안내합니다. Apple Silicon(M1/M2/M3/M4) 맥 사용자도 걱정 마세요 — 모든 상황을 다룹니다.
• macOS 사용자 (Intel 또는 Apple Silicon 모두 해당)
• 바이브코딩을 처음 시작하려는 비전공자
• 터미널을 처음 열어보는 분도 OK
📑 목차
🍺 Homebrew란? — macOS의 만능 패키지 매니저
Homebrew는 터미널 명령 한 줄로 개발 도구를 설치·업데이트·삭제할 수 있는 패키지 매니저입니다. brew install 이름 한 줄이면 끝이라서, 공식 사이트에서 .dmg 파일을 하나하나 다운로드할 필요가 없습니다.
brew install은 CLI 도구를, brew install --cask는 GUI 앱(VS Code 등)을 설치합니다.
🔧 사전 준비: Xcode Command Line Tools 설치
Homebrew를 설치하기 전에 Xcode Command Line Tools가 필요합니다.
xcode-select --install팝업 창이 뜨면 “설치”를 클릭합니다. 약 5~10분 소요됩니다.
xcode-select -p
# 결과: /Library/Developer/CommandLineToolsmacOS를 메이저 업데이트하면 Xcode Command Line Tools가 초기화될 수 있습니다. 오류가 나면 다시 실행하세요.
🍺 Homebrew 설치하기
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"비밀번호를 묻는 프롬프트가 나타나면 Mac 로그인 비밀번호를 입력합니다 (화면에 아무것도 표시되지 않는 것이 정상).
brew --version
# 결과: Homebrew 4.x.x
🍎 Apple Silicon(M1/M2/M3/M4) 주의사항
Apple Silicon Mac은 Homebrew 설치 경로가 다릅니다.
| 구분 | Intel Mac | Apple Silicon Mac |
|---|---|---|
| Homebrew 경로 | /usr/local/bin/brew |
/opt/homebrew/bin/brew |
| 추가 설정 | 필요 없음 | PATH 추가 필요 |
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc
source ~/.zshrc
📦 Git 설치
brew install git
git --version
git config --global user.name "내이름"
git config --global user.email "내이메일@example.com"
🟢 Node.js 설치
brew install node
node --version
npm --version
💻 VS Code 설치
brew install --cask visual-studio-code
code --versionVS Code 실행 후 ⌘ + Shift + P → “Shell Command: Install ‘code’ command in PATH”를 실행하면 터미널에서 code .을 사용할 수 있습니다.
🖥️ Terminal.app 기초 사용법
Spotlight(⌘ + Space)에서 “Terminal”을 검색하면 바로 실행됩니다.
| 명령어 | 설명 |
|---|---|
pwd |
현재 위치 확인 |
ls |
파일·폴더 목록 |
cd |
폴더 이동 |
mkdir |
폴더 만들기 |
clear |
화면 지우기 |
🛤️ PATH 문제 해결하기
# 현재 PATH 확인
echo $PATH
# Homebrew PATH 설정 (Apple Silicon)
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc
source ~/.zshrcmacOS Catalina 이후 기본 셸이 zsh입니다.
.bash_profile이 아닌 .zshrc에 설정하세요.
✅ 설치 검증 체크리스트
echo "=== 바이브코딩 맥 개발환경 체크 ===" && \
echo "Homebrew: $(brew --version | head -1)" && \
echo "Git: $(git --version)" && \
echo "Node.js: $(node --version)" && \
echo "npm: $(npm --version)" && \
echo "VS Code: $(code --version | head -1)" && \
echo "=================================="모든 항목에 버전 번호가 출력되면 바이브코딩 맥 개발환경 세팅 완료입니다. 🎉
🚨 자주 발생하는 macOS 오류와 해결법
❌ “command not found: brew”
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc
source ~/.zshrc
❌ “xcrun: error: invalid active developer path”
xcode-select --install
❌ “Permission denied” during brew install
sudo chown -R $(whoami) /opt/homebrew
⚡ 실전 팁 모음
# Homebrew 업데이트 루틴 (주 1회 권장)
brew update && brew upgrade && brew cleanup| 명령어 | 설명 |
|---|---|
brew list |
설치된 패키지 목록 |
brew info node |
특정 패키지 정보 |
brew doctor |
문제 진단 |
brew uninstall node |
패키지 삭제 |
맥 말고 전체 환경을 처음부터 잡는 흐름은 개발환경 세팅 전체 가이드에 운영체제별로 정리돼 있어요.
⚠️ 면책 고지
여기까지 따라오셨다면 macOS에서 바이브코딩을 시작할 모든 준비가 끝났습니다!
❓ 자주 묻는 질문 (FAQ)
Homebrew 설치에 인터넷이 필요한가요?
네, Homebrew 설치와 패키지 다운로드 모두 인터넷 연결이 필요합니다.
Apple Silicon Mac인데 Intel용 앱도 설치할 수 있나요?
네, Rosetta 2가 자동으로 변환해줍니다. Homebrew로 설치하는 대부분의 도구는 이미 네이티브 버전을 지원합니다.
Homebrew 없이 Git, Node.js를 설치할 수 있나요?
가능합니다. 공식 사이트에서 .pkg 파일을 다운로드하면 됩니다. 하지만 Homebrew가 설치·업데이트·삭제가 훨씬 간편합니다.
brew install node 대신 nvm을 써야 하나요?
입문 단계에서는 brew install node로 충분합니다. 여러 프로젝트에서 다른 버전이 필요해지면 그때 nvm을 도입하세요.
macOS 업데이트 후 brew가 안 됩니다.
먼저 xcode-select –install로 Command Line Tools를 재설치하세요. 그래도 안 되면 brew doctor를 실행합니다.
Windows와 Mac 중 바이브코딩에 더 좋은 OS가 있나요?
macOS가 터미널 환경이 자연스럽지만, Windows도 WSL로 동일한 환경을 구축할 수 있습니다. 본인이 가진 컴퓨터가 가장 좋은 선택입니다.
Homebrew 설치 중 “Password:” 뭘 입력하나요?
Mac 로그인 비밀번호를 입력합니다. 입력 시 화면에 아무것도 표시되지 않는 것이 정상입니다.
VS Code 대신 다른 에디터를 써도 되나요?
물론입니다. Cursor(brew install –cask cursor), Zed 등 원하는 에디터를 사용해도 됩니다.
🔗 관련 글 더 보기
📚 참고 자료
IT 기획 10년차 / 비전공자를 위한 바이브코딩 블로그 운영 / vibe-start.com 제작
Building VibeStart — the fastest path for non-devs into AI coding. Launching on Product Hunt 2026-05-26.
