Ollama 설치 후 "명령어를 찾을 수 없습니다" 터미널 오류 고치는 법

최근 개인용 PC에서 직접 AI를 구동할 수 있게 해주는 Ollama(올라마)의 인기가 뜨겁습니다. 하지만 설치 프로그램을 다운로드하여 실행했음에도 불구하고, 명령 프롬프트(CMD)나 파워셸(PowerShell)에서 ollama run llama3와 같은 명령어를 입력하면 "'ollama'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 배치 파일이 아닙니다"라는 허무한 오류 메시지를 마주하게 됩니다.

이 오류는 Ollama 프로그램 자체가 설치되지 않은 것이 아니라, 윈도우 시스템이 Ollama 실행 파일이 어디에 있는지 찾지 못하는 '환경 변수(Path) 경로 미등록' 문제 때문에 발생합니다. 2026년 최신 윈도우 11 환경에서도 여전히 빈번하게 발생하는 이 문제를 컴맹도 따라 할 수 있을 만큼 쉽고 구체적으로 해결해 드립니다.

Ollama 명령어 인식 오류 핵심 요약 1. 증상: 터미널에서 ollama 입력 시 '명령어를 찾을 수 없음' 오류 발생 2. 주요 원인: 윈도우 시스템 환경 변수(Path)에 Ollama 설치 경로 누락 3. 해결 방법: 시스템 환경 변수 편집 → Path 항목에 설치 경로 직접 추가 4. 기본 설치 경로: %LOCALAPPDATA%\Programs\Ollama 5. 기대 효과: 어떤 터미널 환경에서도 즉시 Ollama 실행 및 모델 구동 가능

원인 분석

프로그램을 설치했는데 왜 터미널은 이를 인식하지 못할까요? 이유는 다음과 같습니다.

• 환경 변수(Path) 등록 누락: 윈도우는 명령어를 입력받으면 미리 지정된 'Path'라는 주소록에서 해당 프로그램을 찾습니다. 설치 중 일시적인 오류나 권한 문제로 이 주소록에 Ollama의 위치가 적히지 않은 경우입니다.
• 설치 후 재시작 미비: 환경 변수는 등록되었으나, 이미 열려 있던 터미널 창은 새로운 주소록을 읽어오지 못해 예전 정보를 유지하고 있을 수 있습니다.
• 사용자 권한 문제: 관리자 권한이 없는 계정에서 설치했을 때 시스템 전체 경로에 등록되지 못하는 경우가 발생합니다.

해결 방법

1단계: 터미널 완전히 껐다 켜기 (가장 먼저 할 일)

의외로 많은 분이 환경 변수 설정 없이 이 단계만으로 해결합니다. 윈도우는 새로 등록된 경로를 실시간으로 모든 창에 반영하지 않기 때문입니다.

1. 현재 열려 있는 모든 명령 프롬프트(CMD)나 파워셸 창을 닫습니다.
2. 다시 터미널을 실행하고 ollama --version을 입력해 봅니다.
3. 여전히 오류가 난다면 다음 단계로 넘어갑니다.

2단계: 윈도우 환경 변수에 설치 경로 직접 등록하기

수동으로 Ollama의 위치를 시스템 주소록(Path)에 적어주는 과정입니다.

1. 윈도우 시작 버튼을 누르고 '시스템 환경 변수 편집'을 검색하여 실행합니다.
2. [고급] 탭 하단의 [환경 변수] 버튼을 클릭합니다.
3. '사용자 변수' 항목에서 Path를 찾아 선택한 뒤 [편집]을 누릅니다.
4. 우측의 [새로 만들기]를 누르고 아래의 경로를 복사하여 붙여넣습니다.

%LOCALAPPDATA%\Programs\Ollama

5. [확인]을 눌러 모든 창을 닫습니다.

3단계: Ollama 백그라운드 서비스 확인

명령어는 인식되는데 연결이 안 된다면 서비스가 꺼져 있는 상태입니다.

1. 윈도우 우측 하단 시스템 트레이(시계 옆 화살표)에서 라마(Llama) 모양 아이콘이 있는지 확인합니다.
2. 아이콘이 없다면 시작 메뉴에서 Ollama를 직접 실행하여 서비스를 활성화합니다.
3. 터미널에서 다시 명령어를 입력해 봅니다.

그래도 해결되지 않을 때

환경 변수 설정 후에도 반응이 없다면 다음 대안을 시도하세요.

• 관리자 권한으로 실행: CMD나 파워셸을 실행할 때 마우스 우클릭 후 '관리자 권한으로 실행'을 선택하여 명령어를 입력해 보세요.
• 재설치 후 재부팅: 설치 파일이 손상되었을 수 있습니다. 제어판에서 삭제 후 공식 홈페이지에서 최신 파일을 받아 다시 설치하고 반드시 컴퓨터를 다시 시작하세요.

문제 예방 방법

• 기본 경로 사용: 설치 경로를 임의로 바꾸면 업데이트 시 경로가 꼬일 수 있으므로 가급적 기본 제공 경로를 유지하세요.
• 업데이트 체크: Ollama 아이콘을 우클릭하여 'Check for Updates'를 주기적으로 실행해 시스템 연동 버그를 방지하세요.

FAQ

Q. %LOCALAPPDATA% 가 무슨 뜻인가요?

A. 사용자마다 다른 윈도우 설치 경로를 자동으로 찾아주는 명령축약어입니다. 보통 C:\Users\사용자이름\AppData\Local 경로를 의미합니다.

Q. 명령어를 입력하면 'could not connect to ollama server'라고 떠요.

A. 이는 명령어 인식은 성공했으나 서비스가 꺼진 상태입니다. 3단계를 참고하여 Ollama 앱을 먼저 실행하세요.

마무리 요약

Ollama의 "명령어를 찾을 수 없습니다" 오류는 설치 문제가 아닌 윈도우 환경 변수 설정 문제입니다. 시스템 속성에서 Path를 편집하고 설치 경로를 추가하는 것만으로 간단히 해결할 수 있습니다. 이제 터미널을 열고 자유롭게 라마3(Llama3)나 젬마(Gemma) 같은 최신 AI 모델을 경험해 보시기 바랍니다!