Homebrew 명령을 찾을 수 없으면 어떻게 해야 할까? 2026 Mac 초보자 해결

증상 → 가장 빠른 점검: brew를 찾지 못하면 먼저 Homebrew 설치가 끝났는지 확인하고, 그다음 현재 셸과 PATH 설정을 살펴보세요.
적용 대상: Mac에서 Homebrew를 설치한 뒤 처음 오류를 만난 학생, Python이나 프런트엔드 수업 도구를 설치하는 초보자에게 맞는 순서입니다.

설치가 끝나지 않았다면 공식 설치 안내를 확인해야 합니다. 설치는 완료됐는데 명령만 보이지 않는다면 재설치보다 셸 시작 설정을 먼저 확인하세요. 특정 터미널 창에서만 된다면 시작 설정이 적용되지 않았을 가능성이 있습니다. 권한을 무리하게 바꾸거나 출처를 모르는 복구 명령을 실행하지 마세요.

Homebrew 명령을 찾지 못하면 설치부터 다시 해야 할까요?

대개는 아닙니다. 오류가 어디서 시작되는지 확인하면 설치 중단, PATH 설정, 다른 프로그램의 실행 환경을 구분할 수 있습니다. PATH는 터미널이 실행할 프로그램을 찾을 때 확인하는 주소 목록과 같습니다.

먼저 오류 전문과 직전에 실행한 작업을 기록하세요. brew 자체를 찾지 못하는 문제와 brew가 실행된 뒤 작업이 실패하는 문제는 원인이 다릅니다. 같은 설치를 반복하면 원인을 가리기 어려워질 수 있습니다.

터미널이 Homebrew를 찾는 주소 확인하기

아래 명령을 하나씩 실행해 결과를 기록하세요. 첫 번째는 현재 셸에서 brew를 찾을 수 있는지, 두 번째는 로그인 셸의 종류를 확인하는 데 도움이 됩니다.

command -v brew
echo "$SHELL"
uname -m
printf '%s\n' "$PATH"

command -v brew가 경로를 출력하면 현재 셸이 명령을 찾은 것입니다. 아무것도 출력하지 않으면 설치가 끝나지 않았거나, 설치된 위치가 PATH에 포함되지 않았을 수 있습니다. echo "$SHELL"은 로그인 셸을 알려주는 값이므로, 터미널이나 편집기에서 실제로 선택된 셸과 다를 수 있습니다.

Homebrew 공식 문서는 설치 위치가 기기 구조에 따라 다르다고 안내합니다. Apple Silicon 기기의 기본 접두 경로는 /opt/homebrew, Intel 기기의 기본 접두 경로는 /usr/local입니다. 모든 Mac에 한 경로를 그대로 적용하지 말고 공식 설치 설명에서 기기와 설치 상태를 대조하세요.

경로가 존재하는지 확인하려면 해당 위치의 bin/brew 파일을 살펴볼 수 있습니다. 두 경로를 모두 확인하는 것은 진단용일 뿐, 발견한 경로를 무조건 설정에 넣으라는 뜻은 아닙니다.

ls -l /opt/homebrew/bin/brew
ls -l /usr/local/bin/brew

새 터미널을 열 때마다 명령이 사라지는 문제 해결하기

셸은 터미널이 명령을 읽고 실행하는 프로그램입니다. 셸 설정 파일은 터미널을 열 때 참고하는 준비 목록에 비유할 수 있습니다. 현재 창에서만 설정을 적용했다면 창을 닫은 뒤에는 효력이 사라질 수 있습니다.

Homebrew 공식 설치 안내는 설치 뒤 셸 환경에 필요한 설정을 추가하도록 설명합니다. zsh를 쓰고 있다면 해당 안내에 표시되는 brew shellenv 설정과 초기화 파일 위치를 확인하세요. 안내된 경로가 실제 설치 경로와 일치하는지 먼저 살펴야 합니다. Apple Silicon용 경로를 Intel 기기에 복사하거나, 반대로 적용하지 마세요.

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

위 예시는 /opt/homebrew에 설치된 경우에만 맞습니다. 다른 위치에 설치했다면 공식 안내를 따라 실제 경로를 사용하세요. 설정을 파일에 반영한 뒤에는 새 터미널을 열거나 현재 셸에서 해당 설정 파일을 다시 불러와야 합니다. zsh와 다른 셸은 읽는 초기화 파일이 다를 수 있으므로, 셸 이름을 확인하지 않은 채 여러 파일에 같은 줄을 반복해서 넣지 마세요. 자세한 기준은 Homebrew 설치 후 설정 안내에서 확인할 수 있습니다.

터미널에서는 되는데 VS Code에서는 안 되는 이유는 무엇인가요?

앱 안에 열린 터미널은 macOS의 기본 터미널과 시작 방식이나 셸 설정이 다를 수 있습니다. 따라서 한쪽에서 brew가 실행된다고 다른 쪽에서도 자동으로 발견되는 것은 아닙니다. VS Code는 터미널 프로필과 환경 설정을 별도로 다룰 수 있으므로, 터미널 프로필 설정과 터미널 환경 안내을 확인하세요.

다음 순서로 차이를 좁혀 보세요.

1. 기본 터미널에서 command -v brew 결과를 기록합니다.
2. VS Code 안에서 새 터미널을 열고 같은 명령을 실행합니다.
3. 두 터미널의 셸 종류와 PATH 출력이 다른지 비교합니다.
4. VS Code가 어떤 셸 프로필로 새 터미널을 여는지 확인합니다.
5. 셸 설정을 수정했다면 VS Code 터미널을 새로 열어 다시 시험합니다.

Shell Integration은 편집기 터미널 동작에 영향을 줄 수 있지만, Homebrew 설치 경로나 PATH를 임의로 고쳐 주는 기능은 아닙니다. VS Code의 셸 통합 설명을 참고하되, 문제를 해결하려고 모든 설정 파일에 같은 경로를 덧붙이지 마세요.

설정 수정과 설치 재확인 조건 나누기

아래 조건에 따라 다음 행동을 선택하세요.

• command -v brew가 경로를 보여 주면 설치를 반복하지 말고, 실패한 뒤속 명령의 오류를 따로 확인합니다.
• brew 파일은 있지만 command -v brew가 아무것도 보여 주지 않으면 설치 경로와 현재 셸의 PATH를 대조합니다.
• 설치 과정이 오류와 함께 끝났거나 파일 자체를 찾을 수 없다면, 공식 설치 안내와 문제 해결 문서에서 설치 상태를 확인합니다.
• 기본 터미널에서는 되지만 VS Code에서는 안 되면 Homebrew 재설치보다 편집기 셸 프로필과 환경 차이를 먼저 살핍니다.
• Permission denied 같은 권한 오류가 나오면 PATH 문제로 처리하지 말고, 오류 문구와 해당 작업의 공식 안내를 확인합니다.

권한 오류를 없애려고 보호된 폴더에 sudo를 쓰거나 폴더 전체의 권한을 재귀적으로 바꾸지 마세요. 출처를 확인하지 못한 스크립트를 실행하거나 학교 기기의 관리 설정을 우회하는 것도 피해야 합니다. Homebrew 명령의 사용법은 공식 명령 문서, 자주 묻는 설치 관련 경계는 공식 FAQ에서 확인할 수 있습니다.

수업 도구로 복구 여부를 확인하는 방법

수정한 뒤에는 설정이 현재 창에서만 작동하는지, 새 터미널에서도 적용되는지 확인해야 합니다. 수업에서 쓰는 도구를 실제로 실행해 봐야 단순히 brew를 찾는 데 그치지 않고 개발 환경까지 확인할 수 있습니다.

• [ ] 오류 전체와 직전에 실행한 명령을 기록했습니다.
• [ ] 설치가 완료됐는지와 brew 파일의 실제 위치를 확인했습니다.
• [ ] 셸 이름과 PATH를 점검하고 기기 구조에 맞는 경로인지 대조했습니다.
• [ ] 설정을 수정했다면 터미널을 새로 열고 command -v brew를 다시 확인했습니다.
• [ ] brew --version으로 Homebrew가 실행되는지 확인했습니다.
• [ ] 수업에서 설치한 명령을 실행해 실제 과제 도구가 작동하는지 확인했습니다.

Homebrew 공식 문서의 문제 해결 안내는 문제를 좁힐 때 참고할 기준입니다. 그래도 해결되지 않으면 셸 종류, 전체 오류, 실행한 명령, 이미 확인한 경로를 함께 정리하세요. 이 기록이 있으면 다음 점검에서 같은 작업을 되풀이하는 일을 줄일 수 있습니다.

기본 Mac에서 설정을 바로잡을 수 있다면 원격 환경으로 옮길 필요는 없습니다. 다만 학교 컴퓨터에서 설치 권한이 없거나 사용할 Mac 자체가 없다면, Windows 환경에서 macOS 전용 도구를 그대로 쓰기 어렵고 관리 제한을 임의로 우회해서도 안 됩니다. 원격 Mac은 네트워크 연결과 원격 조작에 의존하고 실제 기기처럼 곁에서 작업할 수 없으므로, 장기간 무거운 작업을 계속하거나 물리적으로 Mac을 써야 하는 경우에는 직접 보유하는 편이 나을 수 있습니다. 수업 기간에만 macOS 환경이 필요하다면 KVMFLUX의 이용 사례를 먼저 살펴보고, 원격 사용이 과제에 맞는 경우에만 이용 요금과 기간을 비교해 보세요.