macOS: zsh: command not found: brew

안녕하세요, BlueByte입니다. 설치 직후 brew가 "command not found"라 해도 재설치하지 마세요 — Homebrew는 거기 있고, 셸이 어디를 볼지 모를 뿐입니다. Apple 실리콘에선 기본 PATH가 포함하지 않는 곳에 있습니다. 오늘은 그게 문제인지 확인하고 한 번에 영구히 추가하는 순서로 가보겠습니다.

이 오류가 뜻하는 것

Homebrew 설치 직후 실행이 실패합니다:

zsh: command not found: brew

Homebrew는 설치돼 있습니다 — 그 위치가 PATH에 없어 셸이 못 찾을 뿐입니다. 설치 관리자가 출력 끝에 필요한 두 줄을 찍는데, 그걸 놓치거나 그 줄을 실행 안 한 새 터미널을 열면 이렇게 됩니다.

셸이 brew를 못 찾는 이유

Apple 실리콘 Mac에서 Homebrew는 기본 PATH에 없는 /opt/homebrew에 설치됩니다. 구형 Intel Mac은 보통 PATH에 있는 /usr/local이라 — 같은 설치가 Intel에선 "그냥 되고" Apple 실리콘에선 깨진 듯 보입니다. 되던 설정이 깨지는 다른 이유: PATH 줄을 엉뚱한 파일(비대화식 맥락의 ~/.zshrc 등)에 넣었거나, bash에서 zsh로 바꾼 뒤 더는 안 쓰는 셸에 넣은 경우.

PATH 문제인지 확인하고, brew 위치 찾기

Homebrew가 실제로 설치됐고 어디인지 확인하고, 어떤 셸·아키텍처인지 봅니다:

ls /opt/homebrew/bin/brew /usr/local/bin/brew 2>/dev/null
echo $SHELL
uname -m

uname -m의 arm64는 Apple 실리콘(/opt/homebrew), x86_64는 Intel(/usr/local). $SHELL은 어느 프로필을 고칠지 알려줍니다. ls는 바이너리를 찾는데 셸이 못 찾으면 순전히 PATH 문제입니다.

Homebrew를 PATH에 영구히 추가

1. 지금 이 셸에 Homebrew를 추가:

eval "$(/opt/homebrew/bin/brew shellenv)"

이 터미널에서 즉시 brew가 동작합니다.

2. 모든 새 셸에 영구 적용하려면 같은 줄을 zsh 프로필에 추가:

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

3. Intel Mac이면 /usr/local/bin/brew를 씁니다:

eval "$(/usr/local/bin/brew shellenv)"

실제 사례: 새 M-시리즈 MacBook

새 M-시리즈 MacBook에 Homebrew를 설치하고 설치 관리자의 터미널을 닫은 뒤 새 터미널을 여니 brew --version이 "command not found"라 합니다. ls /opt/homebrew/bin/brew가 바이너리 존재를 보이고 uname -m이 arm64라 PATH 문제일 뿐입니다. echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile을 실행하고 새 터미널을 여니 which brew가 /opt/homebrew/bin/brew를 반환합니다. 줄이 로그인 프로필에 있어 이후 모든 셸이 찾습니다.

새 터미널이 찾는지 확인

새 터미널을 열어 brew가 잡히고 PATH에 있는지 확인:

which brew        # /opt/homebrew/bin/brew
brew --version

새 터미널이 찾으면 — 방금 고친 그 터미널만이 아니라 — 프로필 변경이 이후 모든 세션에 적용된 것입니다.

다시 겪지 않으려면

설치 직후 shellenv 줄을 프로필에 한 번 추가하고 ~/.zprofile(최신 macOS는 zsh)에 두세요. 여러 기기에 dotfiles를 동기화하면 Intel과 Apple 실리콘이 각각 올바른 경로를 로드하도록 경로를 가드하세요.

진짜 brew 오류와의 구분

"command not found: brew"는 PATH 문제 — 프로그램은 있는데 셸이 못 찾음. brew가 찾아져 실행되지만 작업이 실패하는 "Permission denied"나 formula 설치 실패 같은 Homebrew 오류와 다릅니다. 셸이 brew를 아예 못 찾으면 그건 PATH 문제이니 shellenv 줄을 추가하세요.