미니콘다 설치하기 (Windows · macOS)

한 줄 요약

미니콘다(Miniconda) 는 파이썬과 가상환경을 관리해 주는 도구입니다. 이 절에서 설치하고, 다음 절에서 이 과정 전용 파이썬 방인 agentic 환경을 만듭니다. 딱 한 번만 하면 됩니다.

이미 아나콘다(Anaconda)나 미니콘다가 깔려 있다면 이 절은 건너뛰고 다음 절로 가세요. 터미널에서 conda --version 을 실행해 버전이 표시되면 설치돼 있는 것입니다.

파이썬 라이브러리는 버전이 서로 얽혀 있습니다. A 프로젝트는 langchain 0.3 을 쓰고 B 프로젝트는 langchain 1.3 을 쓴다면, 한 컴퓨터에 하나만 깔 수 있어 충돌합니다.

가상환경(virtual environment) 은 이 문제를 방을 나눠서 해결합니다.

가상환경은 프로젝트마다 방을 따로 쓰는 것이다

이 과정에서는 agentic 이라는 이름의 방을 하나 만들어 8장 내내 그 안에서만 작업합니다.

이걸 왜 알아야 하나 — 이걸 모르면 나중에 "분명히 설치했는데 ModuleNotFoundError" 가 났을 때, 원인이 엉뚱한 방에서 실행했기 때문이라는 걸 떠올리지 못합니다. 이 과정에서 가장 많이 나는 오류가 정확히 이것입니다.

https://www.anaconda.com/download/success 에 접속 → 페이지에서 Miniconda Installers 항목을 찾아 → Windows 64-bit 설치 파일을 받습니다.

아나콘다(Anaconda)가 아니라 미니콘다(Miniconda) 입니다. 아나콘다는 안 쓰는 라이브러리까지 몽땅 들어 있어 몇 GB나 됩니다. 미니콘다는 필요한 것만 나중에 골라 깔 수 있어 가볍습니다.

받은 .exe 파일을 실행하고 기본값 그대로 넘어갑니다. 설치 경로는 보통 이렇게 잡힙니다.

C:\Users\사용자명\miniconda3

설치 중간에 나오는 체크박스 중 "Add Miniconda3 to my PATH environment variable" 는 기본값(체크 해제)으로 두어도 됩니다. 아래 (3)에서 다른 방법으로 해결합니다.

설치가 끝나면 시작 메뉴에서 "Anaconda Prompt" 를 검색해 실행합니다. 이 창이 앞으로 여러분의 터미널입니다.

왜 그냥 명령 프롬프트(cmd)를 안 쓰나요? 위에서 PATH 체크를 안 했다면 일반 cmd 창에서는 conda 명령을 못 찾습니다. Anaconda Prompt는 conda 경로가 미리 잡힌 상태로 열립니다. 가장 확실한 방법입니다.

같은 페이지 https://www.anaconda.com/download/success 에서 Miniconda Installers → macOS 파일을 받습니다.

어떤 맥인지 모르겠다면 좌측 상단 사과 아이콘 → 이 Mac에 관하여 에서 "칩" 항목을 보세요. "Apple M..." 이면 애플 실리콘입니다.

받은 .pkg 파일을 더블클릭하고 기본값으로 진행합니다.

터미널(Terminal) 앱을 엽니다 (Command + Space → "터미널" 입력). 설치 직후 열려 있던 터미널에는 변경사항이 반영되지 않으므로, 터미널을 완전히 껐다가 다시 켜세요.

명령줄 맨 앞에 (base) 가 보이면 성공입니다.

(base) mac@MacBook ~ %

(base) 가 안 보인다면 아래를 한 번 실행하고 터미널을 다시 켭니다.

macOS 터미널에서 실행 — 이 명령은 macOS 전용입니다. Windows는 Anaconda Prompt를 쓰면 되므로 필요 없습니다.

~/miniconda3/bin/conda init zsh

터미널(Windows는 Anaconda Prompt)에서 다음을 칩니다.

터미널에서 실행 — Windows는 Anaconda Prompt, macOS는 터미널 앱. (아직 agentic 환경이 없어도 됩니다)

conda --version

이렇게 나오면 성공입니다. 숫자는 달라도 됩니다.

conda 25.5.1

'conda'은(는) 내부 또는 외부 명령... 이 아닙니다 또는 command not found: conda 가 나온다면 설치가 끝나지 않았거나 터미널을 다시 켜지 않은 것입니다. 터미널을 껐다 켜고 다시 시도해 보세요.

증상	원인	해결
`conda` 명령을 못 찾는다	터미널을 껐다 켜지 않음	터미널 완전 종료 후 재실행
(Windows) cmd에서만 안 된다	PATH 미등록	Anaconda Prompt 를 쓴다
(macOS) `(base)` 가 안 보인다	conda init 미실행	`~/miniconda3/bin/conda init zsh` 후 재실행
설치 파일이 여러 개라 헷갈린다	Anaconda와 Miniconda 혼동	Miniconda 항목에서 받는다