증상 → Homebrew 설치 후 brew를 찾을 수 없으면, 먼저 설치 완료 여부와 터미널의 셸 설정부터 확인하세요.
가장 빠른 해결 → 설치 경로가 실제로 있는지 확인한 뒤, 설치 프로그램이 안내한 설정을 적용하고 새 터미널에서 다시 검사하세요.

이 안내는 처음 Homebrew를 설치한 학생, Windows에서 맥으로 옮겨 와 개발 도구를 준비하는 초보자에게 적합합니다.
학교에서 관리하는 맥이나 원격 맥을 사용한다면, 기기 설정을 임의로 바꾸기 전에 권한 조건도 확인하세요.

설치 직후의 상태 확인

설치가 끝났다는 메시지를 봤는지, 설치 과정에서 오류가 멈췄는지 먼저 구분하세요. 터미널에 표시된 마지막 안내와 전체 오류 문구를 복사해 두면 원인을 좁히기 쉽습니다. 곧바로 설치 명령을 다시 실행하면 중복 설치나 경로 혼선을 만들 수 있습니다.

설치가 끝났는데도 터미널에서 brew를 못 찾는 까닭은 무엇인가요?
설치가 완료되어도 현재 터미널이 Homebrew 실행 파일의 위치를 모르면 명령을 찾지 못할 수 있습니다. Homebrew 설치 안내에는 설치 후 셸 설정을 갱신하는 절차가 포함되므로, 설치 화면에 나온 마무리 안내를 놓치지 않았는지 확인하세요. Homebrew 공식 설치 안내는 설치 후 설정과 shellenv 사용법을 설명합니다.

여기서 셸은 터미널에 입력한 명령을 해석하는 프로그램입니다. 경로는 셸이 명령을 찾을 때 살펴보는 위치 목록입니다. 경로 목록에 Homebrew 위치가 빠지면, 파일이 있어도 brew만 입력해서 실행되지 않을 수 있습니다.

현재 상태 다음에 할 일
설치 프로그램이 오류를 표시하며 중단됨 오류 내용을 기록하고 설치 단계가 완료됐는지 확인합니다.
설치 완료 안내와 추가 설정 안내가 표시됨 안내에 나온 셸 설정을 적용했는지 확인합니다.
설치 완료 여부가 불분명함 재설치부터 하지 말고 아래 명령과 실제 설치 위치를 확인합니다.

설치 과정의 안내는 본인 컴퓨터의 셸과 설치 위치에 맞춰 표시됩니다. 다른 사람의 설정 명령을 그대로 붙여넣지 말고, 화면에 나온 경로와 대조하세요.

현재 터미널에서 명령 찾기

터미널에 아래 명령을 차례로 입력하세요.

command -v brew
brew --version

command -v brew는 현재 셸이 brew 명령을 찾는지 확인합니다. 경로가 출력되면 실행 파일을 찾은 것입니다. brew --version에서 버전 정보가 나오면 명령이 실행된 것입니다. 두 명령 모두 결과가 없다면, 바로 Homebrew가 설치되지 않았다고 단정하지 마세요. 현재 셸의 경로 설정만 빠졌을 수도 있습니다. 두 명령의 용도는 Homebrew 공식 명령 안내에서 확인할 수 있습니다.

맥에 Homebrew가 이미 설치됐는지 어떻게 확인하나요?
설치할 때 안내된 위치에 실행 파일이 있는지 확인하세요. 기본 설치 위치를 쓰는 맥이라면 아래 경로를 참고할 수 있지만, 사용자 지정 위치나 학교 설정을 썼다면 실제 안내가 우선입니다.

test -x /opt/homebrew/bin/brew
test -x /usr/local/bin/brew

두 명령은 해당 경로에 실행 가능한 파일이 있는지 확인합니다. 아무 출력이 없어도 파일이 있다는 뜻은 아닙니다. Apple Silicon 맥의 기본 설치 접두 경로는 /opt/homebrew, Intel 맥은 /usr/local로 안내되어 있습니다. 이는 기본값이지 모든 기기의 실제 설치 위치를 보장하지는 않습니다. Homebrew 공식 자주 묻는 질문에서 기본 위치를 확인하고, 본인 설치 안내와 비교하세요.

실제 설치 위치와 접두 경로

설치 접두 경로는 Homebrew 파일들이 모이는 기본 위치입니다. 기본값과 다른 곳에 설치했거나 기기 관리자가 설정을 바꿨다면, 그 맥에서 확인한 경로를 기준으로 해야 합니다.

기기 환경 공식 안내에 나온 기본 설치 접두 경로 확인할 점
Apple Silicon 맥 /opt/homebrew 설치 안내에 표시된 실제 경로와 일치하는지 확인합니다.
Intel 맥 /usr/local 예전 설정이나 별도 설치 경로가 남아 있지 않은지 살펴봅니다.
사용자 지정 또는 학교 관리 환경 설치 때 안내된 위치 위의 기본값을 그대로 적용하지 말고 관리자 안내를 따릅니다.

Homebrew 명령 안내에는 설치 접두 경로를 확인하는 brew --prefix도 나와 있습니다. brew가 실행되는 상태라면 다음 명령으로 실제 위치를 확인할 수 있습니다.

brew --prefix

아직 brew가 인식되지 않는다면, 설치 안내에 나온 경로를 확인하세요. Homebrew 공식 설치 문제 안내와 공통 문제 안내는 경로 문제와 여러 설치본이 함께 있을 때의 점검 기준을 제공합니다.

셸 설정 파일 확인

Homebrew가 설치된 위치에 있는데도 명령을 찾지 못하면, 현재 터미널이 어떤 셸 설정을 읽는지 확인하세요. 기본 셸과 터미널에서 실제로 쓰는 셸이 다를 수 있으므로, Apple의 기본 셸 변경 안내와 터미널 설정을 함께 참고하세요.

Homebrew 셸 설정은 어느 파일에서 확인해야 하나요?
한 파일을 모든 맥에 공통으로 적용하면 안 됩니다. zsh와 bash처럼 셸 종류에 따라 읽는 시작 파일이 다를 수 있고, 설치 프로그램이 사용자 환경에 맞는 파일과 명령을 안내합니다. 설치가 끝날 때 표시된 설정 파일을 열어 brew shellenv 설정이 있는지 확인하세요. Homebrew 설치 후 설정 안내를 기준으로 삼고, Apple 터미널 사용 안내에서 터미널 사용 방법을 확인할 수 있습니다.

셸 설정에서 확인할 항목 확인 방법 피해야 할 조치
현재 쓰는 셸 터미널 설정과 셸 정보를 확인합니다. 파일 이름만 보고 셸을 추측하지 않습니다.
설치 프로그램이 안내한 파일 해당 파일에 shellenv 설정이 있는지 살펴봅니다. 설정 파일 전체를 새 내용으로 덮어쓰지 않습니다.
설정에 적힌 설치 경로 실제 brew 실행 파일 위치와 대조합니다. 출처를 모르는 스크립트를 추가하지 않습니다.

설정을 추가해야 한다면 설치 프로그램이 안내한 경로와 명령을 그대로 확인한 다음, 기존 파일의 다른 내용을 보존하세요. 인터넷에서 찾은 명령을 무조건 붙여넣거나 관리자 권한을 임의로 높일 필요는 없습니다.

새 터미널에서 다시 검증

설정을 수정한 뒤에는 터미널 창을 닫고 새 창을 열어 확인하세요. 현재 창에서만 임시로 적용된 설정인지, 새로 시작한 셸에서도 유지되는지 구분할 수 있습니다. Apple 터미널 일반 설정 안내에서 터미널 시작 동작을 확인할 수 있습니다.

새 터미널에서도 brew가 안 되면 무엇을 다시 확인해야 하나요?
현재 셸, 설치 프로그램이 안내한 설정 파일, 실제 설치 접두 경로를 하나씩 대조하세요. 설정이 맞아 보이는데도 해결되지 않으면 Homebrew 공식 문제 해결 안내의 진단 절차를 확인하고, 오류 문구를 함께 살펴보세요. 학교에서 관리하는 기기라 설정을 바꿀 권한이 없다면 권한을 확대하지 말고 관리자에게 문의하세요.

  • 설치 경로에 실행 파일이 있고 설정 파일에도 올바른 shellenv 항목이 있으면, 새 터미널에서 command -v brew와 brew --version을 다시 실행합니다.
  • 설치 경로에 파일은 있지만 설정 항목이 없다면, 설치 프로그램이 안내한 설정을 확인하고 적용한 뒤 새 창에서 검증합니다.
  • 설치 위치와 설정 경로가 서로 다르면, 실제 위치를 먼저 확인하고 설정을 고칩니다. 기본 경로를 무조건 복사하지 않습니다.
  • 학교 관리 정책으로 파일이나 설정을 바꿀 수 없다면, 직접 우회하지 말고 담당자에게 허용된 설치 방법을 확인합니다.

새 터미널에서 명령이 인식되지 않는다면, 설치 명령을 반복하기 전에 설정 파일과 설치 위치가 서로 일치하는지부터 확인하세요.

학습 환경에 맞는 다음 단계

문제가 셸 설정 하나라면 이 안내에 따라 고치는 편이 가장 간단합니다. 하지만 사용 중인 컴퓨터에서 macOS 개발 도구를 설치할 수 없거나 학교 정책상 환경을 구성할 수 없다면, 문제는 Homebrew만으로 해결되지 않습니다. 현재 환경을 계속 쓰면 수업에서 필요한 맥 전용 도구를 준비하지 못할 수 있고, 권한이 제한된 컴퓨터에서는 설정을 바꾸는 과정 자체가 막힐 수 있습니다.

반대로 개인 맥을 구매하면 로컬에서 계속 쓸 수 있지만, 처음 배우는 단계에서 비용을 부담해야 합니다. 수업 기간에만 macOS가 필요하다면 원격 맥을 대여해 실제 터미널에서 Homebrew와 과제 도구를 확인하는 방법도 있습니다. 다만 특정 물리 장치가 필요하거나 장기간 안정적으로 무거운 작업을 해야 한다면 로컬 맥이 더 적합할 수 있습니다. 원격 환경을 알아보려면 MACCOME의 이용 안내에서 이용 가능한 방향을 살펴본 뒤, 맥 미니 주문 안내에서 이용 조건을 확인하세요. 현재 기기의 셸 설정이 원인이라면 대여를 결정하기 전에 공식 절차로 바로잡는 것이 우선입니다.