Mac 터미널에서 Homebrew를 사용하려다 "zsh: command not found: brew" 오류 메시지를 마주한 적이 있나요? 이 오류는 대부분 터미널 앱이 Homebrew 실행 파일의 위치를 찾지 못할 때 발생합니다. 다행히 몇 가지 간단한 방법만 알면 쉽게 해결할 수 있습니다. 지금부터 하나씩 살펴보겠습니다.
1. Homebrew 재설치하기
Homebrew를 다시 설치하면 손상되었거나 오래된 파일이 제거되고 깨끗한 최신 버전이 새로 설치됩니다. Homebrew를 제거하려면 다음 단계를 따라 하세요.
- Mac에서 터미널을 연 뒤, 아래 명령어를 붙여 넣고 Return 키를 눌러 Homebrew를 삭제합니다.
brew uninstall --force homebrew - 이어서 아래 명령어를 입력하고 Return 키를 눌러 Homebrew를 다시 설치합니다.
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
이 과정을 거치면 최신 버전의 Homebrew가 다운로드되어 설치됩니다. 터미널 앱을 재시작한 후에는 brew 명령어를 문제없이 사용할 수 있을 것입니다.
2. PATH 환경 변수에 brew 추가하기
오류가 발생하는 또 다른 흔한 원인은 설치 과정에서 Homebrew가 PATH 변수에 제대로 등록되지 않아, 셸이 실행 파일의 위치를 찾지 못하는 경우입니다.
이 문제는 터미널에서 직접 PATH에 Homebrew 경로를 추가해 해결할 수 있습니다. 명령어는 Mac의 프로세서 종류에 따라 조금씩 다르므로, 자신의 Mac에 맞는 명령어를 복사해 터미널에 붙여 넣으세요.
Apple 실리콘(M1/M2/M3) 칩을 탑재한 Mac이라면 다음 명령어를 입력합니다.
export PATH="/opt/homebrew/bin:$PATH"인텔 프로세서를 사용하는 Mac이라면 아래 명령어를 대신 입력하세요.
export PATH="/usr/local/bin:$PATH"설정이 끝났다면 다음 명령어로 Homebrew가 PATH 변수에 성공적으로 추가되었는지 확인할 수 있습니다.
echo $PATH이 명령어는 터미널이 찾을 수 있는 모든 실행 파일 경로를 화면에 표시합니다. 목록에 Homebrew 경로가 포함되어 있다면, 터미널이 실행 파일을 정상적으로 인식하고 있는 것입니다.
3. Xcode 커맨드 라인 도구 설치하기
Xcode 커맨드 라인 도구(Command Line Tools)는 Apple이 개발하고 관리하는 패키지로, Xcode IDE에 포함된 디버거, 컴파일러 등 필수 개발 도구들을 모아 놓은 것입니다. 많은 사용자들이 Xcode 커맨드 라인 도구가 설치되어 있지 않으면 Homebrew가 작동하지 않는다고 보고했습니다. 터미널에 다음 명령어를 입력하고 Return 키를 누르면 설치할 수 있습니다.
xcode-select --install설치가 완료된 후에는 아래 명령어로 정상적으로 설치되었는지 확인할 수 있습니다.
xcode-select -p설치가 성공적으로 끝났다면 명령어 입력 시 다음과 같은 출력 결과가 나타납니다.
/Library/Developer/CommandLineTools마무리
Homebrew는 다양한 유용한 앱을 손쉽게 설치하고 관리할 수 있게 해주는, macOS 파워 유저라면 반드시 갖춰야 할 필수 유틸리티입니다. "zsh: command not found: brew" 오류가 발생한다면 위에서 소개한 문제 해결 방법 중 하나로 대부분 해결할 수 있습니다. 이제 macOS에서 가장 강력한 패키지 관리자를 마음껏 활용해 보세요.
참고: 이 글은 2022년부터 기술 저술을 시작해 MakeUseOf와 XDA Developers에서 Apple, Android, AI 및 오픈소스 관련 콘텐츠를 집필해 온 Raghav Sethi가 작성했으며, 2024년 8월 11일에 업데이트되었습니다.