맥 Homebrew 설치했는데 명령어 오류? 초보자를 위한 사용법

맥에 Homebrew를 설치하려고 터미널 명령어를 복사 붙여넣기 했는데, 갑자기 패스워드를 묻거나 알 수 없는 오류 메시지가 떠서 당황했던 경험, 혹시 있으신가요?

이런 문제는 대부분 맥 시스템의 보안 정책, 관리자 권한 문제 또는 환경 변수(PATH) 설정이 제대로 이루어지지 않아 발생합니다.

이 글에서는 Homebrew를 성공적으로 설치하고, 기본적인 사용법부터 흔히 겪는 명령어 오류까지, 초보자도 쉽게 따라 할 수 있도록 단계별 해결책을 제시합니다.

Homebrew, 왜 개발자 필수 도구인가요?

Homebrew는 맥(macOS) 사용자를 위한 오픈소스 패키지 관리자입니다. 쉽게 말해, 윈도우에서 프로그램을 설치할 때 설치 파일을 일일이 다운로드하지 않고 앱스토어에서 클릭 한 번으로 설치하듯이, Homebrew는 터미널에서 간단한 명령어로 다양한 개발 도구를 설치하고 관리할 수 있게 해줍니다.

Node.js, Python, Git, MySQL 등 수많은 개발 관련 소프트웨어를 수동으로 설치하고 버전 업데이트를 관리하는 것은 매우 번거로운 일입니다. Homebrew는 이러한 과정을 자동화하여, 단 몇 초 만에 필요한 도구를 설치하고 항상 최신 상태로 유지할 수 있도록 도와줍니다. 덕분에 개발자는 핵심 작업에 더 집중할 수 있게 됩니다.

Photo by Myburgh Roux on Pexels

맥에 Homebrew 3단계로 완벽하게 설치하기

Homebrew 설치는 매우 간단하지만, 몇 가지 주의할 점이 있습니다. 특히 패스워드 입력과 PATH 환경 변수 설정은 많은 초보자가 놓치기 쉬운 부분입니다. 아래 3단계를 따라 하면 대부분의 문제를 피할 수 있습니다.

1. Xcode Command Line Tools 설치 — Homebrew는 맥 개발 환경의 핵심 도구인 Xcode Command Line Tools를 필요로 합니다. 터미널에 다음 명령어를 입력하여 설치합니다:
   xcode-select --install
   설치 메시지가 나타나면 안내에 따라 진행해 주세요. 이미 설치되어 있다면 “command line tools are already installed” 메시지가 뜹니다.
2. Homebrew 설치 명령어 실행 — 이제 터미널에 다음 명령어를 그대로 복사하여 붙여넣고 엔터를 누릅니다:
   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
   이 명령어는 Homebrew 공식 설치 스크립트를 실행합니다. 중간에 맥 사용자 비밀번호를 묻는 프롬프트가 나타나는데, 이는 Homebrew가 시스템 파일을 변경할 권한이 필요하기 때문입니다. 비밀번호를 입력해도 화면에 아무것도 표시되지 않으므로 침착하게 입력 후 엔터를 누르면 됩니다. 설치는 네트워크 상황에 따라 2~5분 정도 소요될 수 있습니다.
3. PATH 환경 변수 설정 — 설치가 완료되면 Homebrew에서 설치한 프로그램들을 터미널이 인식할 수 있도록 PATH 환경 변수를 설정해야 합니다. 터미널의 마지막 메시지를 잘 보면, Homebrew가 직접 PATH 설정을 위한 명령어를 알려줍니다. 일반적으로 다음 명령어를 `~/.zprofile` (zsh 쉘 사용 시) 또는 `~/.bash_profile` (bash 쉘 사용 시) 파일에 추가하라고 안내합니다:
   echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
   위 명령어를 실행한 후에는 터미널을 완전히 종료했다가 다시 실행하거나, source ~/.zprofile 명령어로 변경 사항을 적용해야 합니다. 이 과정은 Homebrew를 설치한 프로그램들이 “command not found” 오류 없이 실행되도록 하는 핵심 단계입니다.

Photo by Nemuel Sereti on Pexels

Homebrew 핵심 명령어, 이것만 알면 충분합니다

Homebrew를 완벽하게 설치했다면 이제 강력한 패키지 관리 기능을 활용할 차례입니다. 다음은 Homebrew를 사용할 때 가장 자주 쓰이는 핵심 명령어들입니다. 이 명령어들만 알아도 Homebrew 사용의 90% 이상을 마스터했다고 할 수 있습니다.

이 명령어들을 통해 개발 환경을 효율적으로 관리할 수 있습니다. 예를 들어, 새로운 프로젝트를 시작할 때 필요한 도구를 `brew install`로 쉽게 설치하고, 주기적으로 `brew update`와 `brew upgrade`를 통해 최신 환경을 유지하는 것이 좋습니다.

Photo by Lewis Kang’ethe Ngugi on Pexels

Homebrew 설치 후 만나는 흔한 오류와 해결책

Homebrew 설치를 마치고 가장 흔하게 마주치는 오류는 바로 “command not found” 메시지입니다. 이 외에도 몇 가지 일반적인 문제가 발생할 수 있는데, 당황하지 않고 아래 해결책을 따라 하면 대부분 해결됩니다.

1. “command not found: brew” 오류
이 오류는 터미널이 `brew` 명령어를 어디서 찾아야 할지 모른다는 의미입니다. 대부분 PATH 환경 변수 설정이 제대로 되지 않았을 때 발생합니다. 2단계에서 설명한 PATH 설정을 다시 한번 확인해야 합니다. 특히, `~/.zprofile` 또는 `~/.bash_profile` 파일을 편집한 후에는 반드시 터미널을 재시작하거나 `source ~/.zprofile` (또는 `~/.bash_profile`) 명령어를 실행하여 변경 사항을 적용해야 합니다.

2. “Xcode Command Line Tools” 관련 오류
Homebrew는 Xcode Command Line Tools가 필수적입니다. 이 도구가 없거나 손상되었을 경우 설치 또는 업그레이드 시 오류가 발생할 수 있습니다. 터미널에 `xcode-select –install`을 다시 실행하여 설치를 시도하거나, 이미 설치되어 있다면 `sudo rm -rf /Library/Developer/CommandLineTools` 명령어로 기존 도구를 삭제한 후 재설치해 보세요.

3. 권한(Permissions) 관련 오류
가끔 Homebrew가 설치 디렉터리에 파일을 생성하거나 수정할 권한이 없다고 오류가 발생하기도 합니다. 이런 경우 `sudo chown -R $(whoami) /opt/homebrew` (Apple Silicon 맥의 경우) 또는 `sudo chown -R $(whoami) /usr/local` (Intel 맥의 경우) 명령어를 사용하여 사용자에게 Homebrew 디렉터리에 대한 소유권을 부여할 수 있습니다. 단, `sudo` 명령어 사용 시에는 신중해야 합니다.