Homebrew 2026 설치 가이드: brew command not found/권한 오류까지 한 번에 해결(맥북)

맥북에 개발 환경을 깔 때 가장 먼저 막히는 곳이 Homebrew 설치입니다. 설치는 끝났는데 brew command not found가 뜨거나, 권한 오류(Permission denied)로 아무것도 설치가 안 되면 다음 글(깃/노드/파이썬/VSCode)이 전부 꼬여요. 이 글은 Homebrew 설치를 “한 번에 끝내는” 순서로 정리했습니다.

Homebrew가 뭔가요? 왜 “가장 먼저” 설치해야 하나요

Homebrew는 macOS에서 개발 도구를 설치/업데이트하는 패키지 매니저입니다. 예를 들어 git, node, python, ffmpeg 같은 도구를 “한 줄”로 설치하고 버전 관리까지 쉽게 해줍니다. 그래서 Homebrew 설치가 끝나야 다음 단계(깃 설치, Node.js 설치, Python 개발환경, VSCode 세팅)가 매끄럽게 이어집니다.

설치 전 체크: 이 2개만 확인하면 80%가 안 막힙니다

1) macOS 업데이트/용량/네트워크

• macOS는 최신(또는 최소 1~2개 버전 내) 권장
• 여유 저장공간: 최소 10GB 이상
• 회사/학교 네트워크에서 막히면 모바일 핫스팟으로 먼저 설치

2) Command Line Tools(CLTools) 유무 확인

Homebrew는 내부적으로 Xcode Command Line Tools를 사용합니다. 아래 명령으로 설치/확인하세요.

xcode-select --install

이미 설치돼 있으면 팝업이 안 뜨거나 “이미 설치됨” 느낌으로 조용히 넘어갈 수 있어요. 그럼 다음 단계로 가면 됩니다.

Homebrew 2026 설치: 공식 설치 명령(가장 안전한 방법)

터미널을 열고 아래 명령을 그대로 붙여넣어 실행합니다.

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

설치 중 비밀번호를 요구하면 macOS 로그인 비밀번호를 입력합니다(입력 중 화면에 표시되지 않는 게 정상). 설치가 끝나면 보통 마지막에 “다음 명령을 실행해서 PATH를 등록하라”는 안내가 같이 나옵니다. 이 안내를 놓치면 가장 흔한 에러인 brew command not found가 발생합니다.

▼ Homebrew 공식 설치 문서(영문) 바로가기 ▼

brew command not found 해결: (대부분) PATH 설정 문제입니다

Homebrew 설치가 끝났는데도 brew가 안 잡히면, 거의 항상 “쉘 시작 시 PATH에 brew 위치가 등록되지 않아서”입니다. 맥은 CPU에 따라 Homebrew 설치 경로가 다를 수 있어요.

구분	기본 Homebrew 경로	PATH 등록 명령(권장)
애플 실리콘(M1~)	/opt/homebrew	eval "$(/opt/homebrew/bin/brew shellenv)"
Intel 맥	/usr/local	eval "$(/usr/local/bin/brew shellenv)"

1) 내 맥이 어느 경로인지 빠르게 확인

which brew
brew --prefix

which brew가 아무것도 안 나오면, 아래 “쉘 프로필(.zprofile) 설정”부터 하세요.

2) zsh(기본 쉘) 프로필에 등록: .zprofile 권장

아래는 애플 실리콘(M1~) 기준입니다. Intel이면 경로만 /usr/local로 바꿔주세요.

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

이제 터미널을 완전히 종료했다가 다시 열고 아래가 동작하는지 확인합니다.

brew --version
brew doctor

여기까지 되면 Homebrew 설치는 “정상 완료”입니다.

권한 오류(Permission denied) 해결: sudo로 brew 실행하지 마세요

Homebrew는 원칙적으로 sudo 없이 사용하는 도구입니다. 그런데 과거에 sudo brew install 같은 걸 했다면 폴더 소유권이 꼬여서 “권한 오류”가 반복될 수 있어요. 증상은 대략 아래처럼 나옵니다.

• Permission denied
• chown: ... Operation not permitted
• Directory not writable

1) 가장 먼저: brew doctor로 원인 진단

brew doctor

출력 메시지에 따라 해결이 달라질 수 있지만, 초보가 가장 많이 겪는 건 “설치 경로 쓰기 권한” 문제입니다.

2) (Intel에서 특히 흔함) /usr/local 권한이 꼬였을 때

Intel 맥에서 Homebrew가 /usr/local에 설치된 경우, 아래처럼 소유권을 내 계정으로 되돌리면 해결되는 경우가 많습니다.

sudo chown -R "$(whoami)":admin /usr/local/*
sudo chown -R "$(whoami)":admin /Library/Caches/Homebrew

주의: 이 방법은 “정말로 /usr/local 소유권이 root로 바뀐 경우”에만 쓰는 게 안전합니다. 가능하면 먼저 brew doctor 결과를 확인하고, 안내 문구에 따라 최소 범위로 고치는 것을 권장합니다.

3) 애플 실리콘인데 권한 오류가 난다면

애플 실리콘은 기본 경로가 /opt/homebrew라서 /usr/local 권한 문제와 결이 다릅니다. 이 경우는 “PATH 등록이 안 됨 → brew를 이상하게 실행 → 권한 꼬임”으로 이어지는 경우가 많아서, 먼저 위의 brew command not found 해결(PAH 등록)을 끝내고 다시 brew doctor를 돌려보세요.

설치가 끝난 뒤 “바로” 해두면 좋은 기본 명령 5개

Homebrew 설치 직후 아래만 해두면, 다음 글(Node/Python/Git/VSCode)이 훨씬 편해집니다.

1. brew update : 패키지 목록 최신화
2. brew upgrade : 설치된 패키지 업그레이드
3. brew install git : 깃 설치(다음 글과 연결)
4. brew cleanup : 오래된 캐시/버전 정리(디스크 절약)
5. brew config : 내 환경 정보 확인(트러블슈팅에 유용)

초보가 자주 막히는 오류 Top 체크리스트

1) curl: (6) Could not resolve host

• DNS/네트워크 문제인 경우가 많습니다(회사/학교망)
• 모바일 핫스팟으로 설치 시도
• VPN/보안 프로그램 일시 중지

2) 설치는 됐는데 터미널 재실행하면 또 brew가 사라짐

• ~/.zprofile에 eval "$(brew shellenv)"가 들어갔는지 확인
• zsh인데 ~/.bash_profile에 넣으면 적용이 안 될 수 있음

3) “이미 설치돼 있다”면서도 정상 동작이 안 함

• which brew로 실제 brew 위치 확인
• brew --prefix로 설치 prefix 확인
• PATH에 같은 이름의 brew가 겹치는 경우(드묾)도 있어요

같이 보면 좋은 글

함께 보면 좋은 글

① VSCode 맥북 세팅(입문) 2026: 설치부터 한글 입력, 필수 확장 10개까지 한 번에

Homebrew 설치가 끝났다면, 다음은 VSCode입니다. 한글 입력/필수 확장 세팅까지 한 번에 맞추면 개발 시작 속도가 확 올라가요.

→ 바로 읽기

함께 보면 좋은 글

② 2026 맥북 구매·가격·보증 가이드: 지금 사도 되나 → 할인 → 애플케어 판단

개발용 맥을 새로 사는 중이라면 “기기 선택/할인/보증(애플케어)”을 먼저 정리해두는 게 장기적으로 가장 돈을 아낍니다.

→ 바로 읽기

함께 보면 좋은 글

③ 맥북 게임 성능 올리기 2026: 발열·전원모드·해상도·그래픽 설정으로 프레임 안정화

개발도 게임도 결국 “발열/전원/성능 관리”가 핵심이에요. 도커/빌드로 뜨거워지는 맥이라면 이 설정도 같이 챙겨두면 좋습니다.

→ 바로 읽기

FAQ: Homebrew 설치/오류 관련 자주 묻는 질문

Homebrew 설치 후 ‘brew command not found’가 계속 뜨는 이유는?

설치 자체는 끝났지만, 터미널이 시작될 때 Homebrew 경로가 PATH에 등록되지 않으면 brew를 찾지 못합니다. 애플 실리콘은 보통 /opt/homebrew, Intel은 /usr/local 경로가 기본이라 더 헷갈려요. ~/.zprofile에 eval "$(…/brew shellenv)"를 추가하고 터미널을 재실행하면 대부분 해결됩니다.

Permission denied/Directory not writable가 나오면 무조건 sudo로 해결하나요?

무조건 sudo로 밀어붙이면 오히려 소유권이 더 꼬일 수 있습니다. Homebrew는 기본적으로 sudo 없이 쓰는 도구라서, 먼저 brew doctor로 “어느 폴더가 문제인지” 확인하는 게 안전해요. Intel에서 /usr/local 소유권이 root로 바뀐 경우에만 chown으로 되돌리는 방식이 효과적이며, 애플 실리콘은 PATH/프로필 설정 문제부터 점검하는 편이 빠릅니다.

Homebrew 설치 후 업데이트/정리(용량 관리)는 어떻게 하는 게 좋아요?

기본 루틴은 “brew update → brew upgrade → brew cleanup” 세 줄이면 충분합니다. update는 목록 갱신, upgrade는 설치된 패키지 업데이트, cleanup은 오래된 버전/캐시 정리라서 디스크가 꽉 차는 걸 줄여줘요. 뭔가 이상하면 brew doctor로 진단하고, 설치 경로/환경 정보는 brew config로 확인하면 트러블슈팅이 빨라집니다.

다음 글 예고: Git 설치/초기 설정으로 이어갑니다

이제 Homebrew 설치가 정상이라면, 다음 단계는 Git 설치와 초기 설정(user.name/email, 기본 브랜치, 줄바꿈 LF/CRLF)입니다. Homebrew로 git을 깔고 터미널/VSCode에서 충돌 없이 쓰는 환경을 바로 이어서 만들 수 있어요.