macOS에서 'brew: command not found' 오류 해결법 – 홈브루 경로 문제 빠르게 고치기

본 사이트에는 제휴 링크가 포함되어 있습니다. Amazon Associate로서 자격을 갖춘 구매를 통해 추가 비용 없이 수수료를 받습니다.

Mac에서 "brew: command not found" 오류를 만났다면, 터미널에서 경로(PATH)만 제대로 잡아주면 금방 해결할 수 있습니다.

이 오류는 특히 Homebrew(홈브루)를 이용해 소프트웨어 패키지를 관리하려는 macOS 사용자들에게 매우 흔하게 발생하는 문제입니다.

오류의 근본 원인은 대체로 Homebrew 설치가 올바르게 되지 않았거나, $PATH 환경 변수가 꼬였거나, 시스템 업데이트로 인해 설정이 변경된 경우입니다.

이 가이드에서는 추측 없이 바로 적용할 수 있는 쉬운 해결 방법들을 단계별로 안내해 드립니다.

Mac에서 brew: command not found 오류가 발생하는 이유

Mac에서 "brew: command not found" 오류는 macOS용 패키지 관리자인 Homebrew에 필수적인 brew 명령어를 시스템이 찾지 못할 때 주로 발생합니다.

이 오류가 나타나는 일반적인 원인은 다음과 같습니다.

1. 잘못된 설치: Homebrew가 제대로 설치되지 않으면 시스템이 brew 명령어를 인식하지 못합니다. 불완전하거나 손상된 설치가 이 문제를 유발할 수 있습니다.
2. PATH 문제: Homebrew 실행 파일이 시스템의 $PATH 환경 변수에 포함되어 있지 않으면 brew 명령이 작동하지 않습니다. $PATH는 시스템이 실행 파일의 위치를 찾는 데 사용되는 변수로, 잘못 설정되면 brew 명령을 찾을 수 없게 됩니다.
3. 기본 환경 설정 변경: 셸을 커스터마이징했거나 .zshrc, .bashrc 파일을 크게 수정했다면, 기본 환경이 변경되어 시스템이 brew 명령을 찾지 못할 수 있습니다.
4. Zsh 명령어 오타: Zsh를 셸로 사용 중이라면 명령어를 잘못 입력하거나 문법 오류가 있을 때 이 오류가 발생할 수 있습니다. 명령줄 입력에 오타가 없는지 꼭 확인하세요.
5. 패키지 미설치: 의외로 Homebrew가 실제로 설치되어 있지 않은 경우에도 이 오류가 발생합니다. 기본으로 설치되어 있다고 가정하면 안 되며, 먼저 다운로드 후 설치해야 합니다.
6. 시스템 업데이트: 때때로 macOS 업데이트가 환경 설정이나 파일 위치를 변경하여 이 오류를 일으킬 수 있습니다. 최근 업데이트가 시스템 구성을 바꿔 brew 명령이 인식되지 않게 되었을 가능성이 있습니다.
7. 접근 권한 문제: 경우에 따라 Homebrew 관련 디렉터리나 파일에 대한 접근 권한이 부족해서 문제가 생길 수 있습니다. 여러 사용자가 같은 시스템을 사용하거나 한 Mac에서 다른 Mac으로 데이터를 옮긴 후에 주로 발생합니다.

오류의 근본 원인을 파악하는 것이 해결의 첫걸음입니다. 원인을 알면 그에 맞는 문제 해결 절차를 따라가면 됩니다.

Mac에서 brew: command not found 오류 해결 방법: 핵심 요약

가장 빠른 해결책은 Homebrew가 제대로 설치되어 있는지 확인하는 것입니다. 터미널을 열고 which brew를 입력하세요. 아무것도 출력되지 않으면 Homebrew가 설치되지 않은 것이므로, 아래 명령어로 간단히 설치할 수 있습니다.

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

가장 빠른 해결책을 살펴봤으니, 이제 문제의 원인을 더 깊이 파고들고 다양한 상황에 맞는 해결 방법들을 알아보겠습니다.

오류를 수정하기 전에 근본 원인을 이해하는 것이 중요합니다. 그 기반 위에서 상황별로 체계적으로 문제를 해결할 수 있습니다. 그럼 지금부터 이 성가신 오류를 완전히 없애는 방법을 시작해 보겠습니다.

해결 방법 1: 명령어 문법 확인하기

의외로 단순한 오타나 문법 오류가 "brew: command not found" 메시지의 원인일 수 있습니다.

문법 오류는 사소해 보이지만 전체 작업을 막을 수 있습니다. 명령 입력 실수는 흔한 일이므로, 복잡한 문제 해결에 들어가기 전에 항상 문법부터 다시 확인하는 것이 좋습니다.

확인 방법은 다음과 같습니다.

1. Spotlight 검색으로 터미널 앱을 실행합니다.

1. 명령어를 입력하고 오타, 불필요한 공백, 누락된 문자가 있는지 꼼꼼히 살펴봅니다. brew를 정확히 입력했는지, breq나 brews처럼 잘못 입력하지 않았는지 확인하세요.
2. 복잡한 명령어라면 공식 Homebrew 문서를 참고하거나 brew help를 입력해 도움말을 확인함으로써 문법이 맞는지 검증할 수 있습니다.
3. 문법이 확실해지면 수정된 명령어를 실행합니다.

해결 방법 2: Zsh용 Homebrew 재설치하기

Zsh를 사용 중인데 "brew: command not found" 오류가 발생했다면, Zsh에 맞게 Homebrew를 다시 설치하는 것이 가장 간단한 해결책 중 하나입니다.

초기 설치가 Zsh와 잘 통합되지 않았거나, 다른 셸에서 Zsh로 전환하면서 호환성 문제가 생겼을 수 있습니다.

이 방법은 Zsh를 기본 셸로 사용하는 사용자에게 특히 유용하지만, Bash 등 다른 셸 사용자에게도 응용할 수 있습니다.

Zsh용 Homebrew를 재설치하는 방법은 다음과 같습니다.

1. 깨끗하게 시작하기 위해 기존 Homebrew 설치를 제거하는 것이 좋습니다.
2. Homebrew를 제거하려면 터미널을 열고 아래 명령어를 입력한 뒤 Enter 키를 누릅니다.

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

1. 제거가 완료되면 아래 명령어로 확인할 수 있습니다.

which brew

1. 아무것도 출력되지 않으면 제거가 성공적으로 완료된 것입니다.
2. 이제 새 Zsh 터미널 창을 열고 Homebrew 설치 스크립트를 실행합니다.

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

1. 이렇게 하면 최신 버전의 Homebrew가 설치됩니다. 터미널을 닫았다가 다시 연 후 brew 명령어를 문제없이 사용할 수 있어야 합니다.

해결 방법 3: PATH 변수에 Brew 추가하기

Homebrew를 설치했는데도 "brew: command not found" 오류가 계속된다면, Homebrew 디렉터리가 시스템의 PATH 변수에 등록되지 않았기 때문일 수 있습니다. 컴퓨터는 PATH 변수를 통해 터미널에 입력한 명령어의 위치를 찾습니다.

보통 Homebrew는 설치 과정에서 자동으로 PATH에 자신의 디렉터리를 추가하지만, 어떤 이유로든 이 과정이 생략되면 이 오류 메시지가 나타날 수 있습니다.

수동으로 PATH에 brew를 추가하는 방법은 다음과 같습니다.

Bash 사용자의 경우:

아래 명령어로 디렉터리를 PATH에 직접 추가할 수 있습니다.

echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.bash_profile

이때 /usr/local/bin은 실제 Homebrew가 설치된 디렉터리로 교체해야 할 수 있습니다. 예를 들어 일부 macOS 시스템에서는 /opt/homebrew/bin에 위치합니다.

Zsh 사용자의 경우:

비슷한 방식으로 진행합니다.

echo 'export PATH="/usr/local/bin:$PATH"' >> $HOME/.zshrc

변경 사항을 확인하려면 아래 명령어를 실행합니다.

brew --version

Homebrew 버전이 출력되면 PATH가 성공적으로 업데이트된 것입니다.

설정을 깔끔하게 유지하려면 Homebrew 설치 디렉터리를 .zshrc 파일에 직접 추가하는 것이 좋습니다.

1. nano ~/.zshrc 명령어로 .zshrc 파일을 엽니다.

1. 다음 줄을 추가합니다: export PATH="$PATH:/opt/homebrew/bin"

1. Command + X를 누른 후 Enter 키를 눌러 파일을 저장합니다.

1. source ~/.zshrc를 실행해 변경 사항을 즉시 적용합니다.

이렇게 하면 새로 시작하는 모든 터미널 세션에서 Homebrew를 사용할 수 있습니다.

PATH에 Homebrew를 추가한다는 것은 컴퓨터에게 brew 명령어의 위치를 알려주는 것입니다. 많은 사용자에게 효과가 있는 일반적인 해결책입니다. 그래도 문제가 있다면 다음 방법으로 넘어가 보겠습니다.

해결 방법 4: M1 Mac에 ARM 버전 설치하기

M1 Mac을 사용 중인데 "brew: command not found" 문제가 발생한다면, M1 아키텍처에 맞게 설계된 ARM 버전의 Homebrew를 설치해야 할 수 있습니다.

M1 Mac은 인텔 Mac과 다른 칩 아키텍처를 사용하므로, 적절한 버전의 Homebrew를 설치하는 것이 큰 차이를 만듭니다.

M1 Mac에 ARM 버전을 설치하는 방법은 다음과 같습니다.

1. M1 Mac에서 터미널 앱을 엽니다.
2. cd ~를 입력하고 Enter 키를 눌러 홈 디렉터리에 있는지 확인합니다.

1. ARM 전용 버전의 Homebrew를 설치하려면 아래 명령어를 입력하고 Enter 키를 누릅니다.

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

1. 이 명령은 ARM 호환 버전의 Homebrew를 자동으로 설치합니다.
2. 필요하다면 아래 명령어를 입력하고 Enter 키를 눌러 Homebrew 실행 파일 위치를 PATH 환경 변수에 추가합니다.

echo 'export PATH="/opt/homebrew/bin:$PATH"' >> ~/.zshrc

1. 아래 명령어를 실행해 변경 사항을 즉시 적용합니다.

source ~/.zshrc

1. 새 터미널 창을 열고 brew --version을 입력해 설치를 확인합니다. 버전 번호가 표시되면 ARM 버전의 Homebrew가 성공적으로 설치된 것입니다.

이 단계를 따르면 M1 Mac의 아키텍처에 최적화된 올바른 버전의 Homebrew를 사용할 수 있습니다.

해결 방법 5: Mac에 Xcode 설치하기

때로는 Mac에 특정 개발자 도구가 없어서 "brew: command not found" 오류가 발생할 수 있습니다. 그중 하나가 Xcode인데, Xcode에 포함된 커맨드라인 도구는 Homebrew와 많은 패키지의 사전 요구 사항입니다.

Mac에 Xcode를 설치하는 방법은 다음과 같습니다.

1. 응용 프로그램 폴더 또는 Spotlight 검색으로 터미널 앱을 실행합니다.

1. 아래 명령어를 입력하고 Enter 키를 누릅니다.

xcode-select --install

1. 설치 확인을 요청하는 팝업 창이 나타납니다. 설치를 클릭해 진행합니다.

1. 화면의 안내에 따라 설치를 완료합니다. 이 과정에서 macOS에 필요한 커맨드라인 개발자 도구가 다운로드 및 설치됩니다.
2. 설치가 완료되면 아래 명령어로 확인할 수 있습니다.

xcode-select -p

1. /Applications/Xcode.app/Contents/Developer 같은 경로가 출력되면 설치가 성공한 것입니다.

Xcode와 커맨드라인 도구를 설치하면 "brew: command not found" 오류의 근본적인 원인을 해결할 수 있습니다. Mac에서 개발 작업을 할 계획이라면 특히 유용한 방법으로, Xcode는 다른 많은 패키지의 기반이 되는 도구이기도 합니다.

작업을 마친 후 Xcode를 제거하고 싶다면 별도의 가이드를 참고해 단계별로 진행하세요.

해결 방법 6: Homebrew 설치 상태 바로잡기

그래도 "brew: command not found" 문제가 계속된다면 Homebrew 설치 자체를 바로잡는 것이 좋습니다. 잘못되었거나 불완전한 설치가 원인인 경우가 많습니다.

Homebrew 설치를 바로잡는 단계는 다음과 같습니다.

1. Mac에서 터미널 앱을 엽니다.
2. 터미널에 아래 내용을 입력하고 Enter 키를 누릅니다.

export PATH="/opt/homebrew/bin:$PATH"

1. 재시작 후에도 이 변경 사항이 유지되도록 하려면 아래 명령어를 입력하고 Enter 키를 누릅니다.

echo 'export PATH="/opt/homebrew/bin:$PATH"' >> $HOME/.zshrc

이 명령어들을 실행한 후 터미널에서 아무런 피드백이 없는 것이 정상입니다.

모든 것이 올바르게 설정되었는지 확인하려면 brew help를 입력하세요. Homebrew 명령어 목록이 출력되면 설치가 성공적으로 바로잡힌 것입니다.

해결 방법 7: 캐시 삭제하기

때로는 캐시가 어질러져 Homebrew 기능에 방해가 되어 "brew: command not found" 오류가 발생할 수 있습니다. 캐시를 삭제하면 문제를 일으키는 오래되거나 손상된 파일 관련 문제를 해결할 수 있습니다.

Mac에서 Homebrew 캐시를 삭제하는 방법은 다음과 같습니다.

1. 응용 프로그램 폴더 또는 Spotlight 검색으로 터미널 앱을 엽니다.
2. 아래 명령어를 입력하고 Enter 키를 누릅니다.

hash -r

주의: 이 명령은 모든 캐시된 파일을 삭제하므로, 실행하기 전에 올바른 디렉터리에 있는지 반드시 확인하세요.

1. 오류가 발생한다면 Homebrew가 제대로 설치되지 않았거나 인식되지 않는 것일 가능성이 높습니다.

자주 묻는 질문

Mac의 Zsh 셸이란 무엇인가요?

Mac의 Zsh 셸은 사용자를 위한 명령줄 인터페이스 역할을 하는 고급 인터랙티브 셸입니다. macOS Catalina 이후 버전에 기본 탑재되어 있으며, Bash를 대신해 기본 셸이 되었습니다. Zsh는 자동 완성, 향상된 스크립팅 기능, 폭넓은 커스터마이징 옵션 등 강력한 기능을 제공해 개발자들에게 인기가 많습니다.

Mac에서 brew 명령어란 무엇인가요?

Mac의 brew 명령어는 macOS 전용 무료 오픈소스 패키지 관리자인 Homebrew를 가리킵니다. 명령줄에서 소프트웨어 패키지를 쉽게 설치, 업데이트, 관리할 수 있게 해 줍니다. Homebrew는 개발자 도구, 라이브러리, 심지어 Mac App Store에서 구할 수 없는 일부 애플리케이션 설치에도 널리 사용됩니다.

"brew command not found"는 무슨 뜻인가요?

"brew: command not found" 오류는 명령줄을 통해 소프트웨어를 설치할 때 사용하는 Homebrew 패키지 관리자를 시스템이 찾지 못할 때 Mac에서 발생합니다. 잘못된 설치, 누락된 PATH 변수 또는 기타 시스템 수준의 불일치 때문에 생길 수 있습니다.

Brew는 Mac에서 안전한가요?

네, Homebrew는 Mac에서 안전하다고 널리 평가받습니다. 수많은 개발자 커뮤니티의 검증을 거친 오픈소스 패키지 관리자입니다. Homebrew는 체크섬을 사용해 다운로드한 패키지의 무결성을 검증하며, 안전한 설치·업데이트·관리 방법을 제공하므로 macOS 사용자들이 신뢰하는 도구입니다.

Mac에서 brew 경로는 어떻게 설정하나요?

Mac에서 Homebrew 경로를 설정하려면 일반적으로 셸의 PATH 환경 변수를 업데이트해야 합니다. Zsh의 경우 .zshrc 같은 셸 프로필 파일에 export PATH="/opt/homebrew/bin:$PATH"를 추가한 뒤, source ~/.zshrc를 실행해 변경 사항을 적용하세요. 이렇게 하면 터미널에서 brew 명령어가 인식됩니다.

결론

Mac에서 "brew: command not found" 오류를 해결하는 일은 결코 어렵지 않습니다. 이 가이드에서 소개한 해결 방법들을 활용하면 단순한 문법 오류부터 복잡한 설정 문제까지 체계적으로 진단하고 해결할 수 있습니다. 각 해결책이 서로 다른 원인을 다루고 있으므로, Homebrew를 빠르게 정상 상태로 되돌릴 가능성이 높아집니다.프로 팁: brew update와 brew upgrade를 정기적으로 실행해 Homebrew를 최신 상태로 유지하면 성능이 최적화되고 오류도 줄어듭니다.

Mohit 소개