Python 설치 (Mac) 2026 - Homebrew로 5분 만에 끝내기
맥에서 파이썬을 처음 설치하면 대부분 같은 지점에서 막힌다. python을 쳤는데 command not found가 뜨거나, 설치를 했는데 pip가 없다고 하고, 어떤 글은 Homebrew를 쓰라 하고 어떤 글은 공식 인스톨러를 쓰라고 한다.
결론부터 정리하면 이렇다.
초보·입문자는 Homebrew로 설치하고, 프로젝트는 venv로 격리한다. 실무에서 여러 프로젝트를 오가면 uv를 쓴다.

이 글은 2026년 10월 기준 macOS에서 파이썬을 설치하는 가장 덜 험한 경로와, 설치 후 반드시 만나는 오류 5가지를 한 번에 정리한다.
1) 맥에는 파이썬이 이미 있다. 그런데 왜 또 설치하나
터미널을 열고 확인해보자.
python3 --version
대부분 Python 3.9.6 같은 값이 나온다. 이건 애플이 Xcode Command Line Tools에 넣어둔 시스템 파이썬이다.
문제는 세 가지다.
- 버전이 낡았다. 2026년 10월 현재 최신은 Python 3.15.0(2026-10-09 출시)이고, 3.13·3.14가 실무 주력이다. 3.9는 2025년 10월에 보안 지원이 끝났다.
- 건드리면 안 된다. 시스템 도구가 이 파이썬을 쓴다. 여기에 패키지를 막 깔면 macOS 업데이트나 개발 도구가 꼬인다.
- pip 설치가 막혀 있다. 최근 파이썬은 시스템 영역에 패키지를 설치하지 못하도록 잠가둔다(
externally-managed-environment).
그래서 내가 쓰는 파이썬을 따로 설치한다. 시스템 파이썬은 그대로 두고, 그 위에 새로 까는 것이다.
2) 설치 방법 3가지, 뭘 고르면 되나

| 방법 | 명령 | 장점 | 단점 | 추천 |
|---|---|---|---|---|
| 공식 인스톨러 | python.org에서 .pkg 다운로드 | 클릭 몇 번, 초보자 친화적 | 업데이트·버전 관리가 번거롭다 | 입문 첫날만 |
| Homebrew | brew install python | 업데이트·삭제가 쉽고 다른 도구와 일관적 | Homebrew 자체를 먼저 설치해야 한다 | 기본 추천 |
| uv | brew install uv | 압도적으로 빠르고 버전·가상환경을 한 도구로 관리 | 명령이 조금 다르다 | 실무·다중 프로젝트 |
정리하면 Homebrew로 파이썬을 설치하고, 가상환경은 venv(또는 uv) 조합이 가장 무난하다.
3) Homebrew로 설치하기 (5분)
3-1. Homebrew 먼저 설치
터미널에 아래 한 줄을 붙여넣는다.
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
설치가 끝나면 안내 문구에 따라 PATH를 잡아준다. 요즘 버전은 안내에 나오는 두 줄을 그대로 복사하면 된다.
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"
칩에 따라 경로가 다르다. Apple Silicon(M1~M4)은/opt/homebrew, Intel 맥은/usr/local이다. 설치 마지막에 출력되는 안내가 정답이니 그걸 따르면 된다.
확인:
brew --version
3-2. 파이썬 설치
brew install python
이 명령은 Homebrew가 관리하는 최신 안정 버전을 설치한다. 2026년 10월 기준 3.14 계열이 잡히는 경우가 많다. 특정 버전이 필요하면 버전을 지정한다.
brew install python@3.14
brew install python@3.15
3-3. 설치 확인
python3 --version
which python3
/opt/homebrew/bin/python3 또는 /usr/local/bin/python3가 나오면 성공이다. 시스템 파이썬(/usr/bin/python3)이 나온다면 PATH 순서가 잘못된 것이니 3-1의 shellenv 설정을 다시 확인한다.
4) python이 아니라 python3인 이유
맥에서 python을 치면 이렇게 나온다.
zsh: command not found: python
파이썬 2와 3이 공존하던 시절의 유산이다. 지금은 python이라는 이름을 아무도 보장해주지 않는다. 해결은 두 가지다.
방법 1 — 그냥 python3를 쓴다 (가장 안전)
python3 --version
python3 -m pip --version
방법 2 — python으로도 부르고 싶다면 별칭을 만든다
echo 'alias python=python3' >> ~/.zshrc
echo 'alias pip=pip3' >> ~/.zshrc
source ~/.zshrc
강의·블로그 예제가python으로 적혀 있어도, 실제로는python3로 실행하면 거의 그대로 동작한다. 습관은python3가 낫다.
5) pip는 python3 -m pip로 쓰는 습관
pip install requests는 위험할 수 있다. 내가 쓰는 파이썬이 아니라 다른 파이썬에 설치되는 사고가 흔하다. 아래 형태를 권한다.
python3 -m pip install --upgrade pip
python3 -m pip install requests
python3 -m pip는 "이 파이썬의 pip" 를 정확히 지정한다. 어느 파이썬에 깔렸는지 헷갈리는 일이 사라진다.
6) 가상환경(venv): 프로젝트마다 방을 따로
파이썬을 하나만 설치해도, 프로젝트마다 필요한 패키지 버전은 다르다. A 프로젝트는 pandas 2.x, B 프로젝트는 1.x를 쓸 수 있다. 이걸 한 곳에 다 깔면 반드시 충돌한다.
그래서 프로젝트 폴더마다 가상환경을 만든다.
mkdir myproject && cd myproject
python3 -m venv .venv
source .venv/bin/activate
프롬프트 앞에 (.venv)가 붙으면 활성화된 상태다. 이 상태에서 설치하면 그 폴더 안에만 깔린다.
python -m pip install requests
python -m pip freeze > requirements.txt
나갈 때는:
deactivate
다음에 다시 들어올 때는 source .venv/bin/activate만 실행하면 된다.
.venv폴더는 Git에 올리지 않는다..gitignore에.venv/를 추가하면 된다. 남에게는requirements.txt로 환경을 전달한다.
7) uv: 2026년 실무의 기본값이 되고 있는 도구
uv는 파이썬 패키지·가상환경·버전 관리까지 한 번에 처리하는 도구다. 체감 속도가 pip보다 훨씬 빠르고, 프로젝트마다 파이썬 버전까지 고정할 수 있다.
설치:
brew install uv
프로젝트 시작:
uv init myproject
cd myproject
uv add requests
uv run python main.py
uv add는 패키지를 설치하면서 pyproject.toml과 uv.lock에 기록한다. uv run은 가상환경을 알아서 맞춰 실행한다. activate를 깜빡해서 생기는 사고가 줄어든다.
특정 파이썬 버전을 쓰고 싶다면:
uv python install 3.14
uv venv --python 3.14
입문 단계에서 uv까지 한 번에 배우면 혼란스러울 수 있다. 처음엔 Homebrew + venv, 익숙해지면 uv 순서를 권한다.
8) 설치 후 반드시 만나는 오류 5개
① command not found: python
python3를 쓰거나 별칭을 만든다. (4번 항목)
② xcode-select: error: unable to get active developer directory
Command Line Tools가 없거나 경로가 깨진 경우다.
xcode-select --install
그래도 안 되면:
sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
③ error: externally-managed-environment
Homebrew 파이썬은 시스템 영역 설치를 막아둔다. 정상 동작이다.
python3 -m venv .venv
source .venv/bin/activate
python -m pip install 패키지명
가상환경 안에서 설치하면 해결된다. --break-system-packages는 최후의 수단이고 권하지 않는다.
④ pip: command not found
python3 -m ensurepip --upgrade
python3 -m pip --version
그래도 없으면 brew install python으로 다시 설치하는 편이 빠르다.
⑤ SSL 인증서 오류 (CERTIFICATE_VERIFY_FAILED)
python.org 인스톨러로 설치한 경우에 자주 나온다. 파인더에서 아래 파일을 실행하면 인증서가 설치된다.
/Applications/Python\ 3.15/Install\ Certificates.command
버전에 맞는 폴더명으로 바꿔 실행하면 된다. Homebrew 설치에서는 거의 발생하지 않는다.
9) VS Code와 연결하기
- VS Code에서 확장
Python(Microsoft)을 설치한다. - 프로젝트 폴더를 연다.
Cmd + Shift + P→Python: Select Interpreter→.venv안의 파이썬을 고른다.- 터미널에서
source .venv/bin/activate후python main.py로 실행한다.
인터프리터를 잘못 고르면 "패키지를 설치했는데 import가 안 된다"는 상황이 생긴다. VS Code 오른쪽 아래에 표시되는 파이썬 경로가 .venv인지 항상 확인하자.
10) 어떤 버전을 설치할까 (2026년 10월 기준)
| 버전 | 상태 | 추천 |
|---|---|---|
| 3.15 | 2026-10-09 출시, 최신 | 새 프로젝트·학습용 |
| 3.14 | 2025-10 출시, 안정 | 실무 기본 추천 |
| 3.13 | 2024-10 출시, 안정 | 라이브러리 호환 최우선 |
| 3.12 이하 | 구버전 | 기존 프로젝트 유지보수 |
라이브러리 생태계는 최신 버전을 바로 따라오지 않는다. 특별한 이유가 없다면 한 단계 뒤의 안정 버전(3.14) 이 사고가 적다.
11) 자주 묻는 질문
Q. Homebrew랑 python.org 인스톨러를 둘 다 설치해도 되나?
권하지 않는다. 같은 이름의 파이썬이 두 개 생겨 PATH가 꼬인다. 하나만 쓰자.
Q. sudo pip install은 왜 안 되나?
시스템 파이썬을 오염시킨다. 꼭 필요하면 가상환경을 만들자.
Q. 회사 맥에서 Homebrew 설치가 막혀 있다.
python.org 인스톨러로 설치하고, 프로젝트마다 venv를 쓰면 된다. 원리는 같다.
Q. 파이썬을 지우고 싶다.
Homebrew라면 brew uninstall python, 가상환경은 폴더 삭제로 끝난다. 시스템 파이썬은 지우지 말자.
정리: 오늘 할 일 체크리스트
- ☐ Homebrew 설치 (
brew --version확인) - ☐
brew install python실행 - ☐
python3 --version으로 버전 확인 - ☐ 프로젝트 폴더에서
python3 -m venv .venv - ☐
source .venv/bin/activate후python -m pip install - ☐ VS Code 인터프리터를
.venv로 선택
설치 자체는 5분이면 끝난다. 시간이 걸리는 건 그다음이다. 파이썬으로 무엇을 할지 정하는 게 진짜 시작이다. AI를 업무에 붙이는 쪽이라면 LLM이란 무엇인가부터 읽고, 코딩 도구를 고민 중이라면 AI 코딩 툴 비교를 함께 보면 좋다.
'IT' 카테고리의 다른 글
| pip install 오류 해결 - 자주 나는 에러 10개와 원인별 해결법 (2026) (0) | 2026.10.20 |
|---|---|
| LLM이란 무엇인가 - 토큰부터 컨텍스트까지, 한 번에 정리 (0) | 2026.10.18 |
| Claude 요금제 비교 2026 - Free·Pro·Max·Team, 나는 뭘 사야 할까 (0) | 2026.10.17 |
| AI 코딩 툴 비교 2026 - Cursor vs Claude Code vs GitHub Copilot, 뭘 써야 할까 (0) | 2026.10.15 |
| ChatGPT vs Claude, 2026년엔 뭘 써야 할까 (실사용 기준 정리) (0) | 2026.10.15 |














