개발자 작업환경

윈도우 파이썬 설치 관리자 | py install로 버전을 넣고 뺍니다

Q: free-threaded 빌드도 설치할 수 있나요?

버전 뒤에 t를 붙이면 됩니다. 문서 예시는 py install 3.15t 입니다.

윈도우 파이썬은 이제 Python install manager로 설치합니다. py install, py list, py uninstall 사용법과 기존 설치 프로그램 지원 종료 일정, python 입력 시 스토어가 열릴 때 해결법을 파이썬 공식 문서로 확인했습니다.

by Lee발행: 2026-10-28

윈도우에서 파이썬을 새로 설치한다면 Python install manager를 받은 뒤 py install 명령에 원하는 버전을 붙여 설치하면 됩니다. 파이썬 공식 문서는 3.14부터 예전 전체 설치 프로그램(exe)을 사용 중단 예정으로 표시했고, 3.16부터는 아예 만들지 않는다고 밝혔습니다. 기존 py 런처도 같은 시점에 설치 관리자로 대체되었습니다. 설치 관리자는 마이크로소프트 스토어나 파이썬 공식 사이트에서 받을 수 있고 두 버전은 같습니다. 설치하면 python, py, pymanager 명령이 생기고, 여러 버전을 넣고 지우는 일도 같은 명령으로 처리합니다. 명령과 문제 해결 방법은 2026년 10월 28일에 연 파이썬 3.15 공식 문서 "Using Python on Windows" 기준입니다.

파이썬 설치 관리자 요약

설치 경로

스토어 또는 공식 사이트

버전 설치

py install 3.15

설치 목록

py list

예전 설치 프로그램

3.16부터 제공 안 함

왜 설치 방법이 바뀌었나요?

바로 답 | 파이썬 3.14부터 기존 전체 설치 프로그램이 사용 중단 예정이 되었고, 3.16부터는 Python install manager만 제공되기 때문입니다.

기존 전체 설치 프로그램은 3.14부터 사용 중단 예정이고 3.16 이후 버전에는 나오지 않습니다. 예전 py 런처도 3.14부터 설치 관리자로 대체되었습니다.

새 설치 관리자는 여러 파이썬 버전을 한 곳에서 설치, 업데이트, 삭제하고, 전역 python 명령은 설치된 버전 가운데 최신 버전을 실행합니다. 문서는 프로젝트마다 가상환경을 만들어 쓰라고 권합니다.

구분	예전 방식	Python install manager
설치 파일	버전별 exe 설치 프로그램	스토어 앱 또는 공식 사이트의 MSIX
여러 버전 관리	버전마다 설치 프로그램 실행	`py install`, `py uninstall`
설치 목록 확인	`py -0`	`py list` (`-0`, `-0p`도 호환 유지)
설정 파일	py.ini	`%AppData%\Python\pymanager.json` 등, py.ini는 무시
3.16 이후	제공 안 함	계속 제공

설치 관리자는 어떻게 설치하나요?

바로 답 | 마이크로소프트 스토어에서 Python install manager를 설치하거나, 파이썬 공식 다운로드 페이지에서 받은 MSIX를 실행하면 됩니다.

스토어 버전과 공식 사이트 버전은 같은 프로그램입니다. 설치가 끝나면 python, py, pymanager 명령을 쓸 수 있습니다. 예전 파이썬을 이미 설치했거나 PATH를 직접 고쳤다면, 문서 안내대로 기존 설치를 지우거나 PATH 수정을 되돌려야 새 명령이 제대로 잡힙니다.

여러 PC에 스크립트로 설치할 때는 윈도우에 기본으로 들어 있는 WinGet을 쓰면 됩니다. 예전 py와 이름이 겹칠 수 있어서 스크립트에서는 pymanager 명령을 쓰라고 문서가 권합니다.

WinGet으로 설치 관리자 설치 (파이썬 공식 문서 명령)
winget install 9NQ7512CXL7T -e --accept-package-agreements --disable-interactivity

버전 설치, 확인, 삭제 명령은 무엇인가요?

바로 답 | py install 버전으로 넣고, py list로 확인하고, py uninstall 버전으로 지웁니다.

자주 쓰는 명령 (파이썬 공식 문서 형식)
# 설치된 버전 목록
py list

# 버전 설치, 여러 개도 가능
py install 3.15

# 특정 버전으로 실행
py -V:3.15 script.py

# 버전 삭제
py uninstall 3.15

# 시작 메뉴 바로가기와 전역 명령 다시 등록
py install --refresh

# 도움말
py help install

py -V:태그 옵션은 다른 옵션보다 먼저 적어야 합니다. 기본으로 실행할 버전을 고정하고 싶다면 환경 변수 PYTHON_MANAGER_DEFAULT나 설정 파일의 default_tag를 쓰면 됩니다.

python3.15.exe 같은 버전별 명령을 바로 쓰고 싶다면 전역 별칭 폴더 %LocalAppData%\Python\bin을 사용자 PATH에 추가하세요. 버전별 Scripts 폴더도 따로 있어서, 패키지가 만든 실행 파일을 쓰려면 그 폴더도 PATH에 있어야 합니다.

이런 분께 맞아요

처음 파이썬을 설치하는 분

스토어에서 설치 관리자를 받고 py install로 필요한 버전만 넣으세요.

여러 버전을 오가는 분

py list로 확인하고 py -V:버전으로 골라 실행하면 됩니다.

예전 exe로 설치한 분

당장 지울 필요는 없지만, 3.16부터는 설치 관리자로 옮겨야 합니다.

python을 입력하면 스토어가 열리거나 명령을 못 찾으면?

바로 답 | 시작 메뉴에서 "앱 실행 별칭 관리"를 열고 Python (default) 항목이 켜져 있는지 확인하세요.

파이썬 공식 문서의 문제 해결 항목은 python이나 py가 "command not found"를 내거나 스토어를 열 때, 앱 실행 별칭에서 Python (default) 별칭이 켜져 있는지 보라고 안내합니다. 이미 켜져 있다면 껐다가 다시 켜서 새로고침하세요.

pip 명령을 못 찾는다면 python -m pip로 실행하는 방법을 문서가 권합니다. 가상환경 안에서는 .venv\Scripts\activate로 활성화하면 pip가 잡히고, 전역에서 쓰려면 py install --refresh를 실행한 뒤 출력에 나온 폴더를 PATH에 넣으세요.

설치 후 점검 체크리스트