여러 사용자가 명령 프롬프트(Command Prompt)에서 Anaconda 명령을 실행하려고 할 때 "'conda'은(는) 내부 또는 외부 명령, 실행 가능한 프로그램 또는 배치 파일이 아닙니다"라는 오류 메시지를 접하고 있습니다.
'conda'가 내부 또는 외부 명령으로 인식되지 않는 오류의 원인
직접 오류를 재현해 보고 다른 사용자들의 사례를 분석하여 이 문제를 조사한 결과, 이 오류 메시지를 유발하는 주요 원인은 다음과 같습니다:
- Conda 환경 변수(PATH)가 설정되지 않음 – 가장 흔한 원인입니다. 최신 Anaconda 빌드는 다른 소프트웨어와의 충돌을 방지하기 위해 Conda를 시스템 환경 변수에 자동으로 추가하지 않습니다.
- 환경 변수(PATH)가 잘못 추가됨 – 사용자가 환경 변수를 수동으로 추가하는 과정에서 실수하여 발생하는 경우도 많습니다.
- Anaconda 버전이 Anaconda Navigator보다 오래됨 – 일부 사용자는 Conda를 최신 버전으로 업데이트한 후 오류가 사라졌다고 보고했습니다.
방법 1: Anaconda를 최신 버전으로 업데이트
여러 사용자가 Conda를 최신 버전으로 업데이트한 후 명령 프롬프트에서 conda 명령을 정상적으로 실행할 수 있게 되었다고 보고했습니다. 최신 Anaconda Navigator와 구버전 Conda를 함께 사용할 때 이 문제가 발생할 수 있습니다. 해결 절차는 다음과 같습니다:
- 화면 왼쪽 하단의 시작 메뉴에서 "anaconda"를 검색한 후 Anaconda Prompt를 클릭합니다.
- Anaconda Prompt에서 아래 명령어를 하나씩 입력하고 각각 Enter 키를 눌러 Conda를 최신 버전으로 업데이트합니다:
conda update conda
conda install anaconda - 업데이트가 완료될 때까지 기다린 후 Anaconda Prompt를 닫고 새 CMD 창을 엽니다. Conda 명령이 정상적으로 실행되는지 확인합니다.
그래도 여전히 "'conda'은(는) 내부 또는 외부 명령, 실행 가능한 프로그램 또는 배치 파일이 아닙니다" 오류가 발생한다면 아래의 다음 방법으로 넘어가세요.
방법 2: 설치 과정에서 PATH 환경 변수에 Anaconda 추가하기
이 문제를 자동으로 해결하는 가장 빠른 방법은 Anaconda를 다시 설치하면서 PATH 환경 변수에 자동으로 추가해 주는 고급 옵션을 활성화하는 것입니다. 단, 이 방법은 특정 애플리케이션이 Anaconda 설치와 충돌할 가능성이 있다는 점에 유의하세요.
참고: 컴퓨터에 Anaconda가 설치되어 있지 않다면 바로 3단계로 이동하세요.
- Windows 키 + R을 눌러 실행 대화 상자를 연 후 "appwiz.cpl"을 입력하고 Enter 키를 눌러 프로그램 및 기능을 엽니다.
- 프로그램 및 기능에서 목록을 스크롤하여 Anaconda 배포판을 찾습니다. 마우스 오른쪽 버튼으로 클릭한 후 제거를 선택하고 화면의 지시에 따라 시스템에서 제거합니다.
- Anaconda 공식 다운로드 페이지에 접속하여 운영체제에 맞는 아이콘을 클릭해 최신 Anaconda 배포판을 다운로드합니다.
- Anaconda와 함께 사용할 Python 버전을 선택하고 해당 Download 버튼을 클릭합니다.
- 설치 파일을 실행하고 첫 화면에서 Next를 클릭한 후 라이선스 계약서(License Agreement)에 동의합니다.
- 설치 유형을 선택하고 Next를 다시 클릭합니다.
- 대상 폴더(Destination Folder)를 선택하고 Next를 클릭합니다. 기본 위치를 그대로 사용하는 것을 강력히 권장합니다.
- 중요한 단계입니다. 고급 설치 옵션(Advanced Installation Options) 화면에서 Add Anaconda to my PATH environment variable(Advanced Options 아래) 항목을 체크한 후 Install을 클릭합니다.
- 설치가 완료되면 명령 프롬프트에서 "conda"를 입력합니다. 더 이상 오류 메시지가 나타나지 않아야 합니다.
이 방법이 효과가 없거나 Anaconda 전체를 다시 설치하지 않는 다른 방법을 찾고 있다면 다음 방법으로 넘어가세요.
방법 3: Conda 경로 수동으로 추가하기
Anaconda 전체를 제거하는 데 시간을 들이고 싶지 않다면 Conda 관련 환경 변수를 직접 업데이트(또는 확인)할 수 있습니다. 다만 그 전에 Conda가 설치된 정확한 위치를 먼저 파악해야 합니다.
아래 가이드에 따라 환경 변수에서 Conda PATH를 확인하고 수정하세요:
- 시작 메뉴에서 "anaconda prompt"를 검색한 후 Anaconda Prompt를 클릭하고 프로그램이 열릴 때까지 기다립니다.
- Anaconda Prompt에서 아래 명령어를 입력하고 Enter 키를 눌러 Conda의 위치를 확인합니다:
where conda
- 2단계에서 확인된 두 번째 경로를 복사하되, 실행 파일 이름은 제외합니다. 예: C:\Users\madro\Anaconda3\Scripts
- Windows 키 + R을 눌러 실행 대화 상자를 열고 "sysdm.cpl"을 입력한 후 Enter 키를 눌러 시스템 속성(System Properties) 창을 엽니다.
- 시스템 속성 창에서 고급(Advanced) 탭으로 이동한 후 환경 변수(Environment Variables...)를 클릭합니다.
- *사용자 이름*의 사용자 변수 창에서 Path 변수를 선택하고 편집(Edit) 버튼을 클릭합니다.
- 환경 변수 편집 창에서 새로 만들기(New) 버튼을 클릭한 후 아래 두 경로를 차례로 추가합니다:
C:\Users\*YourUser*\Anaconda3\Scripts
C:\Users\*YourUser*\Anaconda3참고: *YourUser*는 예시 플레이스홀더일 뿐이므로 실제 사용자 이름으로 바꿔야 합니다. 또한 구버전 Anaconda를 사용 중이라면 경로의 버전 번호도 알맞게 수정하세요.
방법 4: 환경 변수에 추가하지 않고 우회하는 방법
Anaconda 경로를 환경 변수에 추가하고 싶지 않다면, 명령 프롬프트에서 먼저 Anaconda 설치 폴더로 이동한 후 Conda 명령을 입력하는 방식으로 오류를 피할 수 있습니다.
단, 새 명령 프롬프트를 열 때마다 이 과정을 반복해야 하므로 실용성은 떨어진다는 점에 유의하세요.
이 방법으로 진행하기로 했다면 다음 절차를 따르세요:
- Windows 키 + R을 눌러 실행 대화 상자를 연 후 "cmd"를 입력하고 Enter 키를 눌러 명령 프롬프트를 엽니다.
- CMD 창에서 CD 명령 뒤에 Anaconda 설치 폴더 경로를 입력합니다. 기본 위치에 설치했다면 다음과 비슷한 형태일 것입니다:
CD C:\Users\*YourUser*\Anaconda3\Scripts
- 아래 명령어를 실행하여 Anaconda가 명령 프롬프트에서 정상적으로 작동하는지 테스트합니다:
conda --version
