macOS 오류 수정 · 3 min read · Oct 08, 2025
macOS에서 Zsh 명령어를 찾을 수 없다는 오류 수정 방법

가끔 Mac의 터미널에서 명령어를 사용하려고 할 때 “명령어를 찾을 수 없음”이라는 오류 메시지가 표시될 수 있습니다.
macOS Catalina부터 Apple은 터미널에서 사용하는 기본 시스템을 ‘bash’에서 ‘zsh’로 변경했습니다. 이 오류의 가장 일반적인 원인 중 하나는 셸이 실행하려는 명령어를 찾을 수 없기 때문입니다.
따라서 Mac이 macOS Catalina 또는 최신 버전을 실행 중이라면 “zsh: command not found: brew”와 같은 오류를 볼 수 있습니다.
다음과 같은 방법으로 터미널 및 기타 방법을 통해 Zsh 명령어를 찾을 수 없다는 오류를 수정해 보겠습니다.
목차
- Zsh 명령어를 찾을 수 없는 오류의 일반적인 원인
- Zsh 명령어를 찾을 수 없는 오류 수정 방법? - 1. 구문 확인
- .zshrc 파일에서 $Path 환경 설정
- 패키지가 설치되어 있는지 확인
- Zsh 프로필 생성
- Mac 재설치/복원
- Mac에서 Zsh 명령어로 전환하는 방법
- macOS에서 명령어를 찾을 수 없는 오류 해결
Zsh 명령어를 찾을 수 없는 오류의 일반적인 원인
명령어가 올바르게 철자되지 않아 오류가 발생합니다.
Zsh(Z 셸) 명령어를 실행하기 위한 잘못된 PATH 변수.
올바른 패키지가 설치되지 않았습니다.
Zsh 명령어에 대한 최근의 잘못된 구성.
Zsh 명령어를 찾을 수 없는 오류 수정 방법?
1. 구문 확인
오타나 철자 오류로 인해 명령어를 찾을 수 없다는 오류가 발생하는 경우가 많습니다. 수동으로 입력할 때 의도하지 않은 문자가 입력될 수 있습니다.
명령어에 오류가 있는지 다시 확인해야 합니다. 명령어를 직접 터미널에 복사하는 것을 추천합니다.
2. .zshrc 파일에서 $Path 환경 설정
파일 시스템의 경로는 특정 위치를 가리킵니다. 마찬가지로 터미널 명령어의 경우, PATH 시스템 변수($PATH)는 실행 가능한 프로그램이 저장된 디렉토리를 보여줍니다.
$PATH 덕분에 Mac은 명령어를 실행할 때 이러한 파일을 쉽게 찾을 수 있으며, 전체 경로 대신 ‘ls’와 같은 명령어 이름만 사용할 수 있습니다.
따라서 명령어를 찾을 수 없는 오류를 피하기 위해 $PATH를 설정해야 합니다.
- Command + Spacebar를 눌러 Spotlight 검색을 엽니다.

- 터미널로 이동합니다.

- 다음 명령어를 붙여넣고 enter를 누릅니다.
export PATH="/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin
이렇게 하면 macOS에서 zsh 명령어를 찾을 수 없는 오류가 수정됩니다.
3. 패키지가 설치되어 있는지 확인
패키지가 설치되지 않은 경우 명령어를 찾을 수 없다는 오류가 발생할 수 있습니다. 패키지가 설치되어 있는지 확인하는 방법은 다음과 같습니다.
Homebrew의 경우
- 다음 명령어를 입력하고 enter를 눌러 설치된 모든 패키지를 나열합니다.
brew list
Python 패키지의 경우
- 설치된 Python 패키지를 보려면 다음 명령어를 입력하고 enter를 누릅니다.
pip list
4. Zsh 프로필 생성
Zsh에서 .zshrc 파일이 생성되지 않았거나 특정 구성이 누락된 경우 명령어를 찾을 수 없다는 오류가 발생할 수 있습니다. 다른 명령어를 입력하기 전에 Zsh 프로필을 생성하는 방법은 다음과 같습니다.
- 터미널에 다음 명령어를 입력하고 enter를 눌러 홈 디렉토리로 이동합니다.
cd ~/- 그 후, 다음 명령어를 입력하여 Zsh 프로필을 생성합니다.
touch .zshrc
- 이제 Zsh 프로필을 확인하기 위해 열어보겠습니다.
open .zshrc- 텍스트 편집기에서 zshrc 파일이 열리면 Zsh 프로필이 생성되었음을 확인할 수 있습니다.

5 . Mac 재설치/복원
명령어를 찾을 수 없는 오류를 수정하기 위한 모든 옵션을 소진한 경우, 새로 시작할 때입니다. macOS를 재설치하는 것은 Zsh 명령어를 찾을 수 없는 오류를 수정하는 해결책이 될 수 있습니다.
특히 오류가 손상된 시스템 파일이나 잘못 구성된 설정과 같은 더 광범위한 시스템 문제로 인한 경우, macOS 재설치에 대한 Apple의 공식 가이드를 사용할 수 있습니다.
또한 Time Machine을 사용하여 macOS를 백업한 경우, Zsh 명령어 오류가 발생하지 않았던 컴퓨터로 복원할 수 있습니다. 이 경우에도 Time Machine을 통한 macOS 복원에 대한 공식 가이드를 사용할 수 있습니다.
Mac에서 Zsh 명령어로 전환하는 방법?
macOS Catalina 및 이후 버전에서는 Zsh가 기본 셸로 이미 설정되어 있어야 합니다. 확인하거나 전환하는 방법은 다음과 같습니다:
현재 셸 확인:
터미널에서 현재 셸을 확인하려면 echo $SHELL을 입력합니다. /bin/zsh와 같은 결과가 반환되면 Zsh가 이미 기본 셸입니다.
Zsh로 변경(필요한 경우):
터미널에 chsh -s /bin/zsh 명령어를 입력합니다. 이 변경을 확인하기 위해 비밀번호를 입력해야 할 수도 있습니다.
터미널 재시작:
마지막으로 터미널을 닫고 다시 엽니다. 이렇게 하면 Zsh를 사용하는 새 세션이 시작됩니다.
macOS에서 명령어를 찾을 수 없는 오류 해결
따라서 macOS에서 명령어를 찾을 수 없는 오류를 수정하는 방법은 다음과 같습니다. HomeBrew 또는 Macport와 같은 패키지 관리자를 사용하면 Zsh와 함께 작업이 더 쉬워질 수 있습니다.
오류를 해결하기 위해 올바른 명령어를 입력해야 합니다.
새 게시물을 받은 편지함에서 받기
스팸은 없습니다. 언제든지 구독 해지 가능합니다.