이번 편에서는 터미널을 열고 Homebrew를 설치하는 전 과정을 실제 명령어와 예상 출력을 병행하며 진행합니다. 각 단계마다 예상 출력과 비교핵 보세요.
이 글에서 할 것
- 터미널을 열고 Homebrew를 설치하기
- .zshrc 파일에 Homebrew 경로 설정하기
- 설치가 제대로 되었는지 확인하기
시작하기 전에 확인할 것
필요한 것:
- 맥북 (Intel 또는 Apple Silicon)
- 인터넷 연결
- 관리자 권한 (맥북 로그인 비밀번호)
소요 시간: 약 10-15분
Step 1: 터미널 열기
Spotlight로 열기:
Command + Space 누르기- "terminal" 입력
- Enter 누르기
Launchpad로 열기:
- Launchpad 아이콘 클릭
- "기타" 폴 열기
- 터미널 클릭
확인: 검은 화면에 흰 글씨가 나오면 성공!
Homebrew는 C 언어로 작성된 프로그램을 컴파일할 때 필요한 도구들을 사용합니다. Apple의 개발 도구를 먼저 설치해야 합니다.
명령어 입력
xcode-select --install
입력하면 설치 안내 팝업이 나타납니다.
진행: "설치" 클릭 → 약관 동의 → 설치 진행 (5-10분)
이미 설치된 경우:
xcode-select: note: install requested for command line developer tools
→ 이미 설치된 경우, OK! 다음 단계로 진행하세요.
설치 확인
xcode-select -p
예상 출력:
/Library/Developer/CommandLineTools
위 경로가 출력되면 성공!
Step 3: Homebrew 설치
공식 설치 명령어
터미널에 정확히 복사해서 붙여넣기:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
이 명령어의 의미:
| 부분 |
의미 |
/bin/bash |
Bash 쉘로 실행 |
-c |
다음 문자열을 명령어로 실행 |
curl -fsSL |
인터넷에서 파일 다운로드 (f: 실패 시 조용히, s: 진행 숨김, S: 에러는 표시, L: 리다이렉트 따라가기) |
| URL |
Homebrew 설치 스크립트 |
설치 과정에서 만날 수 있는 상황
상황 A: 비밀번호 요청
→ 맥북 로그인 비밀번호 입력
⚠️ 주의: 화면에 아무것도 표시되지 않습니다! (보안상의 이유). 그냥 입력하고 Enter 누르세요.
상황 B: Enter 키 요청
→ Enter(RETURN) 키 누르기
상황 C: 설치 진행
→ 5-10분 대기
상황 D: 설치 완료
→ "Installation successful!" 메시지 확인!
Step 4: 설치 확인
버전 확인
brew --version
예상 출력:
Homebrew 4.4.12
(버전 숫자는 다를 수 있습니다)
도움말 확인
brew help
명령어 목록이 나오면 성공!
Step 5: .zshrc 파일 설정 (Apple Silicon Mac 필수)
왜 필요한가?
Apple Silicon Mac(M1/M2/M3)에서는 Homebrew가 /opt/homebrew에 설치됩니다. 하지만 터미널은 기본적으로 /usr/local/bin만 찾습니다. .zshrc 파일에 Homebrew 경로를 추가해야 터미널이 Homebrew를 찾을 수 있습니다.
현재 상황 확인
which brew
결과에 따른 진행:
/opt/homebrew/bin/brew = 제대로 설치됨 (성공). Step 6으로 넘어가세요.brew not found 또는 zsh: command not found: brew = 찾을 수 없음 (실패). 계속 진행하세요.
.zshrc 파일 확인
ls -la ~/.zshrc
파일이 없는 경우: touch ~/.zshrc로 생성
파일이 있는 경우: cp ~/.zshrc ~/.zshrc.backup로 백업
Homebrew 경로 추가
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc
이 명령어의 의미:
| 부분 |
의미 |
echo '...' |
문자열 출력 |
>> ~/.zshrc |
.zshrc 파일 끝에 추가 (덮어쓰기 아님!) |
brew shellenv |
Homebrew 환경변수를 설정하는 명령어 생성 |
eval "$(...)" |
생성된 명령어를 실행 |
Step 6: 설정 적용
현재 터미널 세션에 적용
source ~/.zshrc
의미: .zshrc 파일의 설정을 현재 터미널에 즉시 적용. 터미널을 재시작하지 않아도 됨.
Step 7: 최종 확인
brew 경로 확인
which brew
Apple Silicon Mac 예상 출력:
/opt/homebrew/bin/brew
Intel Mac 예상 출력:
/usr/local/bin/brew
brew doctor (건강 검진)
brew doctor
예상 출력 A:
Your system is ready to brew.
→ 완벽! 문제 없음.
예상 출력 B:
Warning: ... (어떤 경고)
→ "working fine"이라면 무시핵 됩니다.
터미널 재시작 테스트
- 터미널 완전히 닫기 (Command + Q)
- 터미널 다시 열기
brew --version 입력
버전이 나오면 완전 성공!
설치가 잘 되었는지 확인
빠른 진단 명령어 모음:
xcode-select -p
brew --version
which brew
brew doctor
uname -m
정상 출력 예시:
/Library/Developer/CommandLineTools
Homebrew 4.4.12
/opt/homebrew/bin/brew
Your system is ready to brew.
arm64
자주 생기는 실수
실수 1: "zsh: command not found: brew"
원인:
.zshrc에 Homebrew 경로가 추가되지 않음- 또는 경로가 잘못됨
해결:
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc
source ~/.zshrc
Intel Mac인 경우 경로가 다름:
echo 'eval "$(/usr/local/bin/brew shellenv)"' >> ~/.zshrc
source ~/.zshrc
실수 2: "Permission denied"
증상: Operation not permitted 또는 권한 관련 오류
원인: Homebrew에 sudo를 사용하려고 함
해결: Homebrew 명령에는 보통 sudo를 붙이지 않습니다.
실수 3: "Already up-to-date"
증상: 업데이트 중 "Already up-to-date" 메시지
해결: 이건 문제가 아닙니다! 이미 최신 버전이라는 의미입니다.
실수 4: "Failed to connect to raw.githubusercontent.com"
원인: 네트워크 연결 문제 또는 DNS 문제
해결: 잠시 후 다시 시도하거나 네트워크를 바꿔서 재실행합니다.
실수 5: Intel Mac과 Apple Silicon Mac 구분
확인 방법:
uname -m
결과:
arm64 = Apple Silicon (M1/M2/M3)x86_64 = Intel Mac
각각 .zshrc 설정 경로가 다릅니다 (위에서 설명).
여기까지 했으면 성공
완료 기준:
다음에 할 것:
# 프로그램 설치 예시
brew install git
brew install node
brew install --cask visual-studio-code
다음 편 안내
Homebrew 설치를 완료하셨다면, 이제 실제로 프로그램을 설치하고 관리하는 방법을 배워봅시다.
Homebrew 시리즈 3편: 패키지 설치와 관리에서는 brew install로 프로그램을 설치하고, brew upgrade로 업데이트하고, brew uninstall로 제거하는 방법을 실습합니다.
💬 댓글
이 글에 대한 의견을 남겨주세요