직접 관리하는 Python 환경에 QZX를 설치하세요

설치할 때와 같은 Python을 사용하세요: python, python3 또는 py -3.13.

python -m qzx version --json
python -m qzx getCurrentDateTime --output-format iso --json

python -m pip install --upgrade qzx를 실행한 것과 정확히 같은 인터프리터를 사용하세요. 모듈로 실행하면 PATH에 qzx 실행 명령이 없어도 사용할 수 있습니다.

python3 또는 py -3.13으로 설치했다면 아래 모든 명령의 python을 같은 접두어로 바꾸세요. 중간에 인터프리터를 바꾸지 마세요.

재설치하기 전에 현재 인터프리터를 확인하세요. QZX를 설치한 환경을 활성화한 다음 pip와 패키지 위치를 확인합니다.

python -m pip --version
python -m pip show qzx

여기서 pip가 QZX를 찾지 못하면 이 인터프리터에 패키지가 없는 것입니다. qzx version --json과 모듈 명령의 버전이 다르면 서로 다른 설치를 참조합니다. 사용할 설치만 업데이트하세요. externally-managed-environment 오류가 나면 관리되는 Python을 강제로 변경하지 말고 직접 관리하는 환경이나 pipx를 사용하세요.

먼저 pipx list를 실행하세요. QZX가 목록에 있으면 pipx ensurepath를 실행하고 안내에 따라 터미널을 다시 열거나 환경을 새로 적용한 뒤 qzx version --json을 실행하세요. 목록에 없으면 위의 pipx 설치 방법을 사용하세요.

시스템 Python은 일반적으로 pipx로 격리된 패키지를 가져올 수 없습니다. python -m qzx는 pipx 복구 방법이 아닙니다. pipx run은 기존 설치가 아니라 임시 환경을 테스트합니다.