Python 설치와 실제 실행 확인

이 연구실을 실제 연구에 사용하려면 Python을 준비합니다. 이미 사용 가능한 Python 3이 있다면 무조건 다시 설치하지 않고 먼저 확인합니다. Python만 설치했다고 모든 분석 도구가 준비되는 것은 아닙니다.

Windows

1. https://www.python.org/downloads/ 에서 공식 Python Install Manager를 내려받아 설치합니다.

2. 시작 메뉴에서 PowerShell을 열고 python --version을 입력합니다. 관리 도구만 설치된 경우 Python 본체 설치가 이어질 수 있으며 인터넷 연결이 필요합니다.

3. Python 3.x.x가 표시되는지 확인합니다. 이어서 python -c "print('PYTHON_OK')"를 입력하여 PYTHON_OK가 나오는지 확인합니다.

4. python -m pip --version으로 추가 분석 도구를 설치할 기능도 확인합니다. 이미 설치된 환경에서 python이 안 되고 py만 된다면 같은 명령의 python을 py로 바꾸어 확인하고 이후에도 그 이름을 사용합니다.

공식 안내: https://docs.python.org/3/using/windows.html

Mac

1. https://www.python.org/downloads/macos/ 에서 정식 Python 3의 macOS installer(.pkg)를 내려받아 엽니다. 시험판은 선택하지 않습니다.

2. 설치 안내를 따릅니다. 완료 후 응용 프로그램의 Python 3.x 폴더에서 Install Certificates.command를 실행합니다. 인터넷 자료 조회에 쓰는 인증서를 준비하는 절차이며 연결이 필요합니다.

3. Command(⌘) + Space로 Spotlight를 열어 터미널을 검색한 뒤, python3 --version, 이어서 python3 -c "print('PYTHON_OK')"를 각각 입력합니다.

4. python3 -m pip --version도 확인합니다. macOS가 관리하는 기존 Python을 삭제하거나 덮어쓰지 않습니다.

공식 안내: https://docs.python.org/3/using/mac.html

Claude 앱에서도 확인해야 완료입니다

설치 후 Claude 앱(Claude App)을 완전히 종료했다가 다시 엽니다. Code 화면에서 research-team 폴더를 선택하고 아래 확인 문장을 보냅니다.

약 53초 · 실제 Mac의 Claude 앱 화면입니다. 요청 문장과 결과를 확대하고 한글 설명을 넣었습니다.

영상은 Code 화면에서 research-team 폴더가 이미 선택된 상태로 확인을 요청합니다. Claude의 결과 답변에는 Python 3.12.2, 계산 결과와 pip가 표시됩니다. 앞선 설치 영상의 Python 3.14.7과 사용 버전이 다르므로 실제 사용 위치를 확인하세요. 분석 도구 목록은 촬영한 컴퓨터의 예시이며 모든 사용자에게 기본 제공되는 구성은 아닙니다. 개별 실행 내역을 펼쳐 보는 장면은 포함되어 있지 않습니다.

Claude 앱 확인 영상 내려받기 (.mp4)

Claude에 보낼 문장

이 앱에서 Python 3을 실제로 실행해 버전과 실행 파일 위치를 확인해줘. 간단한 계산이 실행되는지와 같은 Python에서 pip가 실행되는지도 확인해줘. 설치나 분석은 아직 하지 말고 실제 결과를 알려줘.

AI는 해당 환경에서 동작한 명령으로 -c "import sys; print(sys.version); print(sys.executable); print(1+1)"와 -m pip --version을 실행한다. 버전 표시뿐 아니라 실제 계산 결과 2와 실행 위치를 확인한다. 사용자 터미널에서 성공했어도 앱에서 실패하면 준비 완료라고 하지 않는다. 이후 설정에도 확인한 동일한 Python 실행 파일을 사용한다. 실행 파일 경로에 공백이 있으면 환경에 맞게 경로 전체를 묶어 실행한다.

이 확인은 추가 설치·네트워크 조회·연구자료 접근을 요구하지 않는다. 다만 Windows 설치 관리 도구는 Python 본체가 없을 때 최초 실행 시 내려받기를 시도할 수 있다. 설치가 시작되면 결과를 숨기지 않고 사용자에게 알린다.

Codex 앱을 사용하는 분은 Codex 앱에서 연구팀 폴더를 열고 같은 확인을 요청합니다.

안 될 때

- 명령을 찾을 수 없음 / Store 화면만 열림: Python 실행 확인 실패다. 공식 설치가 끝났는지 확인하고 PowerShell·터미널·AI 앱을 다시 연다. Windows는 공식 문서의 Troubleshooting을 참고한다.

- 터미널은 되는데 앱은 안 됨: 성공한 Python 실행 파일 위치와 앱에서 실행한 위치를 비교한다. 다른 컴퓨터나 격리된 작업 환경이면 그곳에도 별도 준비가 필요하다. 재설치를 반복하지 않는다.

- pip가 없음: Python 실행과 추가 도구 준비를 구분해 보고한다. 공식 설치의 구성과 실제로 선택된 Python을 확인한다. 모든 기능 준비 완료로 표시하지 않는다.

- Mac에서 인터넷 인증서 오류: Install Certificates.command 완료 여부와 사용하는 Python 위치를 확인한다. 인증서 검사를 끄는 방식으로 해결하지 않는다.

- 설치 권한이 없음: 컴퓨터 관리자에게 설치를 요청한다. 실패 내용을 그대로 남기며 자동으로 준비됐다고 표시하지 않는다.

연구를 시작할 때 필요한 추가 준비

프로젝트별로 별도 분석 환경을 만들어 다른 연구의 도구와 섞이지 않게 한다. AI가 요청한 분석에 필요한 도구만 골라 준비하고 사용한 Python과 도구 버전을 기록한다. 이 단계는 프로젝트 준비와 구분한다. R을 쓰는 분석은 R도 별도로 필요하다. 모든 MedSci 도구를 한 번에 설치하거나 전체 자료실을 점검하지 않는다.

검증 범위: 공식 설치 문서를 근거로 한 안내다. 새 Windows·Mac 컴퓨터에서 설치부터 앱 안 실행까지의 전체 과정은 아직 별도로 검증해야 한다.