Skip to main content

​
Homebrew 설치

Homebrew는 macOS에서 패키지를 설치하고 관리하는 표준 도구입니다. 이후 문서의 대부분은 Homebrew를 기준으로 진행합니다.

​
사전 준비

  • macOS 13 이상
  • 인터넷 연결
  • 관리자 권한 계정

​
설치 과정

1

Command Line Tools 확인

터미널에서 아래 명령어를 실행하세요.
xcode-select -p
경로가 출력되지 않으면 다음 명령어로 먼저 설치합니다.
xcode-select --install
2

Homebrew 설치 스크립트 실행

아래 명령어를 그대로 실행하세요.
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
설치 중 비밀번호 입력이 필요할 수 있습니다.
3

PATH 환경변수 설정

설치가 끝나면 안내 문구에 맞춰 brew shellenv를 등록합니다.
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

​
설치 확인하기

brew --version
brew doctor
  • brew --version에 버전이 출력되면 설치가 완료된 것입니다.
  • brew doctor가 Your system is ready to brew.를 출력하면 정상입니다.

​
문제 해결

  • brew: command not found: 터미널을 완전히 종료한 뒤 다시 열고 위 PATH 설정 명령어를 다시 실행하세요.
  • Command Line Tools 오류: xcode-select --install 후 터미널을 재시작하세요.