Jupyter Notebook 설치 Conda 아나콘다 환경 준비 상세 더보기
데이터 분석 및 머신러닝 분야에서 주피터 노트북(Jupyter Notebook)은 코드를 작성하고 결과를 시각화하며 문서를 공유하는 데 필수적인 도구입니다. 특히, 파이썬 환경 관리를 위해 널리 사용되는 아나콘다(Anaconda) 배포판을 통해 주피터 노트북을 설치하고 관리하는 것은 가장 권장되는 방법입니다. 아나콘다는 Conda라는 패키지 및 환경 관리자를 내장하고 있어, 다양한 프로젝트별로 격리된 가상 환경을 쉽게 구축할 수 있게 해줍니다.
📚 함께 읽으면 좋은 글
2025년 현재, 아나콘다의 설치 과정은 더욱 사용자 친화적으로 개선되었으며, Conda 환경을 통한 주피터 노트북 관리는 여전히 가장 안정적이고 효율적인 방식으로 평가받고 있습니다. 이 가이드에서는 Conda를 이용하여 주피터 노트북을 설치하고, 기본적인 사용 환경을 설정하는 방법에 대해 단계별로 자세히 설명합니다.
가장 먼저 할 일은 아나콘다 배포판을 공식 웹사이트에서 다운로드하여 설치하는 것입니다. 이는 Conda 환경 관리자와 파이썬, 그리고 주피터 노트북을 비롯한 주요 데이터 과학 패키지를 한 번에 설치할 수 있게 해줍니다. 설치 시, 환경 변수(PATH) 등록 옵션을 신중하게 선택하는 것이 중요합니다.
Conda 환경 구축 및 가상 환경 생성 확인하기
아나콘다 설치를 완료했다면, 이제 Conda를 사용하여 프로젝트별 독립적인 환경을 구축할 차례입니다. 이는 프로젝트 A에서 필요한 패키지 버전이 프로젝트 B에서 필요한 버전과 충돌하는 것을 방지하는 데 매우 중요합니다. 터미널(또는 Anaconda Prompt)을 열고 다음 명령어를 사용하여 새로운 가상 환경을 생성할 수 있습니다.
가상 환경 생성 기본 명령어:
conda create -n <환경이름> python=<파이썬버전>예를 들어, 파이썬 3.10 버전을 사용하는 ‘my_project_env’라는 환경을 만들려면 다음과 같이 입력합니다:
conda create -n my_project_env python=3.10환경 생성이 완료되면, 다음 명령어로 해당 환경을 활성화합니다. 환경을 활성화해야만 그 환경에 필요한 패키지를 설치하고 해당 환경에서 주피터 노트북을 실행할 수 있습니다.
가상 환경 활성화 명령어:
conda activate <환경이름>활성화가 성공적으로 이루어지면 터미널 프롬프트 앞에 환경 이름이 표시됩니다 (예: (my_project_env) C:\Users...).
주피터 노트북 설치 및 커널 등록 상세 더보기
새로 생성하고 활성화한 가상 환경에 주피터 노트북을 설치해야 합니다. 다음 Conda 명령어를 사용하면 됩니다:
conda install jupyter notebook만약 특정 데이터 과학 패키지들을 함께 설치하려면, 처음 환경을 생성할 때 함께 지정하거나, conda install 명령어를 통해 추가로 설치할 수 있습니다. 예를 들어, numpy와 pandas를 설치하려면:
conda install numpy pandas일반적으로 아나콘다를 통해 설치하면 자동으로 주피터 노트북에 기본 커널로 등록됩니다. 하지만, 여러 가상 환경에서 주피터 노트북을 사용하려면 각 환경을 주피터에 커널로 등록하는 것이 좋습니다. 이를 위해 ipykernel 패키지를 설치하고 등록 명령어를 실행합니다.
conda install ipykernel python -m ipykernel install --user --name <환경이름> --display-name "<주피터표시이름>"이렇게 하면 주피터 노트북을 실행했을 때, 이 가상 환경을 선택하여 노트북을 실행할 수 있습니다. 예를 들어, ‘my_project_env’를 ‘Project Env (Python 3.10)’이라는 이름으로 등록하려면:
python -m ipykernel install --user --name my_project_env --display-name "Project Env (Python 3.10)"Jupyter Notebook 실행 및 기본 사용법 보기
주피터 노트북의 설치와 환경 설정이 끝났다면, 이제 실제로 노트북을 실행하여 코드를 작성할 수 있습니다. 활성화된 Conda 환경에서 다음 명령어를 터미널에 입력합니다.
jupyter notebook이 명령을 실행하면 웹 브라우저가 자동으로 열리면서 주피터 노트북의 대시보드 화면이 나타납니다. 만약 자동으로 열리지 않는다면, 터미널에 표시되는 URL (보통 http://localhost:8888/)을 복사하여 브라우저에 붙여넣으면 됩니다.
대시보드에서는 다음과 같은 작업을 수행할 수 있습니다:
- 새로운 노트북 파일(.ipynb) 생성: 오른쪽 상단의 ‘New’ 버튼을 클릭하고 원하는 커널(앞서 등록한 가상 환경 이름)을 선택합니다.
- 기존 노트북 파일 열기: 파일 목록에서 원하는 파일을 클릭합니다.
- 파일 및 폴더 관리: 파일을 업로드하거나, 폴더를 생성/이름 변경/삭제할 수 있습니다.
노트북 파일 내부에서는 ‘셀(Cell)’ 단위로 코드를 작성하고 실행하며, 텍스트와 설명을 Markdown 형식으로 작성할 수 있습니다. 노트북의 각 셀을 실행할 때 Conda 환경에 설치된 패키지와 파이썬 버전이 사용되므로, 프로젝트 환경의 격리가 유지됩니다. 이는 협업 및 재현성 측면에서 큰 이점을 제공합니다.
주피터 노트북을 종료할 때는, 노트북 파일에서 ‘File’ > ‘Close and Halt’를 선택하거나, 대시보드에서 해당 노트북을 체크하고 ‘Shutdown’을 누릅니다. 또한, 주피터 노트북을 실행한 터미널 창으로 돌아가 Ctrl+C를 두 번 눌러 서버를 완전히 종료해야 합니다.
Conda 환경 관리 심화 및 팁 보기
Conda는 주피터 노트북 설치뿐만 아니라 환경 관리를 위한 강력한 기능을 제공합니다. 2025년 기준, 데이터 과학 프로젝트의 복잡도가 증가함에 따라 Conda 환경을 효과적으로 관리하는 능력은 더욱 중요해졌습니다.
자주 사용하는 Conda 명령어:
| 명령어 | 설명 |
|---|---|
conda env list |
현재 시스템에 설치된 모든 Conda 환경 목록을 보여줍니다. |
conda deactivate |
현재 활성화된 Conda 환경을 비활성화하고 기본 환경으로 돌아갑니다. |
conda remove -n <환경이름> --all |
지정된 이름의 Conda 환경과 그 안에 설치된 모든 패키지를 삭제합니다. |
conda update --all |
현재 활성화된 환경의 모든 패키지를 업데이트합니다. |
특히, 프로젝트를 다른 사람과 공유하거나 배포할 때는 현재 환경의 모든 패키지 목록과 버전을 저장하는 것이 필수입니다. 다음 명령어를 사용하여 환경 파일을 생성할 수 있습니다.
conda env export > environment.yml이 environment.yml 파일을 받은 사람은 다음 명령어를 사용하여 동일한 환경을 쉽게 재현할 수 있습니다:
conda env create -f environment.yml이러한 Conda의 환경 재현성은 주피터 노트북 기반의 데이터 과학 프로젝트에서 협업의 핵심입니다. 2024년의 트렌드가 깃허브(GitHub)와 같은 버전 관리 시스템을 통한 환경 파일 공유를 강조했듯이, 2025년에도 이 방식은 표준으로 유지되고 있습니다.
FAQ Conda와 Jupyter Notebook 사용에 대한 질문 확인하기
Q1. 아나콘다를 설치했는데 Conda 명령어가 작동하지 않아요. 어떻게 해야 하나요?
A. 아나콘다 설치 시 ‘환경 변수(PATH) 등록’ 옵션을 선택하지 않았을 가능성이 높습니다. Windows의 경우 ‘Anaconda Prompt’를 실행하여 명령어를 사용하거나, 수동으로 시스템 PATH 환경 변수에 Conda 설치 경로를 추가해야 합니다. 설치 시 PATH 등록을 권장하지 않지만, 초보자라면 설치 후 ‘Anaconda Prompt’를 사용하는 것이 가장 안전하고 확실한 방법입니다.
Q2. Conda 환경에 주피터 노트북을 설치했는데, 주피터 노트북에서 새로 만든 환경이 보이지 않아요.
A. Conda 환경을 만들었어도, 해당 환경을 주피터 노트북이 인식하는 ‘커널’로 등록해야 합니다. 해당 환경을 활성화한 후, conda install ipykernel 명령어로 ipykernel을 설치하고, 이어서 python -m ipykernel install --user --name <환경이름> --display-name "<표시이름>" 명령어를 실행하여 커널로 등록해야 합니다.
Q3. Conda 환경과 pip는 어떤 관계인가요?
A. Conda는 패키지뿐만 아니라 환경 자체를 관리하는 범용적인 관리자이고, pip는 파이썬 패키지를 관리하는 도구입니다. Conda 환경 내에서 패키지를 설치할 때는 가급적 conda install을 사용하는 것이 좋지만, Conda 채널에 없는 패키지는 환경이 활성화된 상태에서 pip install을 사용하여 설치할 수 있습니다. 이 경우, 패키지는 현재 활성화된 Conda 환경에만 설치되어 격리됩니다.
Q4. Jupyter Lab과 Jupyter Notebook 중 무엇을 사용해야 하나요?
A. Jupyter Notebook은 전통적인 문서 기반의 인터페이스로 안정적이고 심플합니다. Jupyter Lab은 2025년 현재 주피터 프로젝트의 최신 세대로, 파일 브라우저, 터미널, 노트북, 코드 편집기 등을 하나의 통합된 인터페이스에서 제공합니다. 기능 면에서 Jupyter Lab이 더 우수하지만, 간단한 노트북 작업에는 Jupyter Notebook도 충분합니다. 둘 다 Conda 환경에서 쉽게 설치하고 사용할 수 있습니다.
Q5. 주피터 노트북이 특정 폴더만 열리는데, 시작 폴더를 변경하고 싶어요.
A. 주피터 노트북은 기본적으로 명령어를 실행한 폴더를 시작 디렉토리로 사용합니다. 시작 폴더를 변경하려면, 원하는 폴더로 이동하여 jupyter notebook 명령어를 실행하거나, 주피터 노트북 설정 파일(jupyter_notebook_config.py)을 수정하여 기본 시작 경로를 지정해야 합니다. 설정 파일을 수정하는 것이 영구적인 방법이지만, 초보자에게는 원하는 폴더에서 명령어를 실행하는 것이 더 간단합니다.