맥 Homebrew 설치 후 `brew` 명령어 실행 안 될 때? PATH 설정 딱 정리

맥 Homebrew 설치 후 `brew` 명령어 실행 안 될 때? PATH 설정 딱 정리

Homebrew 설치를 성공적으로 마쳤다는 메시지를 봤는데, 막상 터미널에 brew라고 입력하면 command not found 에러만 보인다면 분명 답답할 것입니다. 설치가 제대로 된 건지, 아니면 내가 뭔가 놓친 건지 혼란스러울 수 있습니다.

이 문제는 대부분 시스템이 brew 명령어를 어디에서 찾아야 할지 모르는, 즉 PATH 환경변수 설정 누락 때문에 발생합니다.

이 글에서는 Homebrew 설치 후 brew 명령어가 정상적으로 동작하도록 PATH 환경변수를 올바르게 설정하는 모든 단계를 명확하게 안내합니다. 더 이상 헤매지 않고 Homebrew를 안정적으로 사용할 수 있게 될 것입니다.

brew 명령어가 command not found가 발생하는 핵심 원인

맥 터미널에서 어떤 명령어를 입력했을 때 시스템은 미리 정해진 특정 경로들에서 해당 실행 파일을 찾게 됩니다. 이 특정 경로들의 목록을 담고 있는 것이 바로 PATH 환경변수입니다. 예를 들어 ls나 cd 같은 기본 명령어들은 이미 PATH에 포함된 경로 안에 존재합니다.

Homebrew는 설치될 때 자체적인 실행 파일 경로(대부분 Apple Silicon 맥에서는 /opt/homebrew/bin, Intel 맥에서는 /usr/local/bin)를 가집니다. 하지만 이 경로가 여러분의 쉘 PATH 환경변수에 추가되지 않으면, 터미널은 brew라는 명령어가 어디에 있는지 알지 못해 command not found 에러를 뱉게 되는 것입니다.

이 문제는 Homebrew 설치 자체의 실패라기보다는, 설치 후 필요한 초기 환경 설정이 완료되지 않아 발생하는 경우가 90% 이상입니다.

Homebrew 설치 후 PATH 설정 메시지 확인하기

Homebrew는 설치를 마칠 때 매우 친절하게도, 다음 단계로 무엇을 해야 하는지 터미널에 명확히 안내 메시지를 출력합니다. 이 메시지에는 PATH 환경변수를 설정하는 방법이 포함되어 있습니다. 많은 사용자가 이 중요한 메시지를 확인하지 못하고 지나치곤 합니다.

만약 설치 직후 터미널 창을 닫아버렸거나, 너무 빠르게 스크롤이 올라가 메시지를 확인하지 못했다면, 당황할 필요 없습니다. Homebrew 설치 스크립트를 다시 실행하면 동일한 안내 메시지를 확인할 수 있습니다. 대략 3초 정도만 집중했으면 놓치지 않았을 중요한 정보입니다.

쉘 환경에 따른 PATH 환경변수 설정 방법

맥은 기본적으로 여러 종류의 쉘(Shell)을 사용할 수 있습니다. 가장 흔한 쉘은 Bash와 Zsh 두 가지이며, macOS Catalina 이후 버전부터는 Zsh가 기본 쉘로 지정되었습니다. 쉘 종류에 따라 환경변수를 설정하는 파일이 다르므로, 본인의 쉘 환경을 먼저 확인해야 합니다.

1. 현재 쉘 확인하기 — 터미널에서 다음 명령어를 입력합니다.

   echo $SHELL

   결과가 /bin/bash면 Bash 쉘을, /bin/zsh면 Zsh 쉘을 사용하고 있는 것입니다.

2. 해당 쉘 설정 파일 열기 — 텍스트 편집기(nano, vim 또는 open -e)로 설정 파일을 엽니다.
   • Bash 사용자: ~/.bash_profile (없으면 ~/.bashrc도 확인)
   • Zsh 사용자: ~/.zshrc

   # Zsh 사용자
   nano ~/.zshrc
   
   # Bash 사용자
   nano ~/.bash_profile

3. Homebrew 경로 추가하기 — 열린 파일의 맨 아래에 다음 한 줄을 추가하고 저장합니다.

   Homebrew 설치 시 출력된 메시지를 복사하는 것이 가장 정확하지만, 일반적인 경로는 다음과 같습니다.

   • Apple Silicon (M1/M2/M3 등): export PATH="/opt/homebrew/bin:$PATH"
   • Intel (x86_64): export PATH="/usr/local/bin:$PATH"

   예시 (Apple Silicon 기준):

   # Homebrew PATH 설정 (Apple Silicon)
   export PATH="/opt/homebrew/bin:$PATH"

   nano 에디터에서는 Ctrl + O (저장), Enter, Ctrl + X (종료) 순으로 사용합니다.

설정 적용 및 최종 확인

.bash_profile이나 .zshrc 파일을 수정했다고 해서 바로 변경 사항이 적용되는 것은 아닙니다. 쉘에게 “내가 파일을 수정했으니 다시 읽어봐라”라고 알려주거나, 새로운 쉘 세션을 시작해야 합니다. 다음 두 가지 방법 중 하나를 선택하여 적용할 수 있습니다.

1. 터미널 재시작 — 가장 간단하고 확실한 방법입니다. 현재 열려 있는 터미널 창을 모두 닫고, 새로운 터미널 창을 엽니다. 이렇게 하면 새로운 쉘 세션이 시작되면서 수정된 설정 파일을 자동으로 로드합니다.
2. source 명령어로 적용 — 터미널을 닫지 않고 바로 변경 사항을 적용하고 싶을 때 사용합니다.
   • Bash 사용자:

     source ~/.bash_profile

   • Zsh 사용자:

     source ~/.zshrc

3. brew 명령어 최종 확인 — 설정 적용 후, 이제 brew 명령어가 제대로 동작하는지 확인합니다.

   which brew

   이 명령어가 /opt/homebrew/bin/brew 또는 /usr/local/bin/brew와 같이 Homebrew 실행 파일의 경로를 출력하면 성공입니다. 이제 brew help 명령어도 정상적으로 실행될 것입니다.

이 3단계 과정을 거치면 대부분의 command not found 문제는 5분 이내에 깔끔하게 해결됩니다.