PATH 환경변수 오류 해결법: 명령을 찾을 수 없을 때

📌 요약

대부분 터미널을 껐다 켜면 해결됩니다.
그래도 안 되면 프로그램이 설치된 폴더가 있는지 확인합니다.
마지막으로 환경 변수의 Path에 폴더를 한 줄만 추가합니다.

어떤 오류인가요

PATH 환경변수 오류 특징

터미널에 프로그램 이름을 입력했는데 찾을 수 없다는 문장이 나오면 PATH 오류일 가능성이 큽니다.

node 자리에 git, claude, python처럼 다른 프로그램 이름이 들어갈 수도 있습니다. 프로그램 이름은 달라도, 설치된 프로그램을 터미널이 찾지 못했다는 상황은 같습니다.

명령 프롬프트 오류 구문

명령 프롬프트에서는 이렇게 보입니다.

'node'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 배치 파일이 아닙니다.

PowerShell 오류 구문

PowerShell에서는 문구가 조금 다릅니다.

'node' 용어가 cmdlet, 함수, 스크립트 파일 또는 실행할 수 있는 프로그램 이름으로 인식되지 않습니다.

원인

PATH란?

쉽게 말하면, PATH는 컴퓨터가 프로그램을 찾아볼 폴더 목록입니다. 이 부분은 이해하신 게 맞습니다. 터미널은 PATH에 적힌 폴더를 순서대로 확인해서 프로그램 파일을 찾고 실행합니다.

오류 원인

오류가 나는 이유는 보통 둘 중 하나입니다.

1. 프로그램은 설치됐지만, 프로그램 폴더가 PATH 목록에 등록되지 않았습니다.
2. PATH가 바뀌었지만, 이미 열려 있던 터미널이 예전 설정을 가지고 있어 새 내용을 읽지 못했습니다.

대부분 컴퓨터를 재부팅할 필요는 없습니다. 먼저 터미널만 껐다 켜면 됩니다. 터미널 여는 법은 윈도우 PowerShell 여는 법과 기본 사용법에서 확인하세요.

해결 방법 1 — 터미널을 껐다 켜기

터미널 다시 열기

제일 먼저 이 방법부터 합니다. 프로그램을 설치한 직후라면 터미널이 예전 PATH를 가지고 있는 경우가 많습니다.

1. 열려 있는 PowerShell, 명령 프롬프트, Windows 터미널을 모두 닫습니다. Windows 터미널은 탭만 닫지 말고 창 전체를 닫습니다.
2. 시작 메뉴에서 평소 쓰던 터미널을 다시 엽니다.
3. 오류가 났던 명령어를 다시 입력합니다. 아래에서는 오류가 난 프로그램에 해당하는 한 줄만 실행합니다.

node --version
git --version
claude --version
python --version

새로 연 PowerShell에서 git --version을 실행하면 Git 버전 숫자가 정상적으로 출력됩니다

버전 숫자나 프로그램 안내가 나오면 해결된 것입니다. 이때는 환경 변수 화면을 더 건드리지 않아도 됩니다. 같은 오류가 계속 나오면 방법 2로 넘어갑니다.

해결 방법 2 — 정말 설치됐는지 확인하기

프로그램 폴더 확인

이번에는 프로그램 파일이 컴퓨터에 실제로 있는지 확인합니다. 아래 경로는 주소 표시줄에 하나씩 복사해서 확인합니다. 오류가 난 프로그램에 해당하는 한 줄만 복사하세요.

Node.js

C:\Program Files\nodejs\

Git

C:\Program Files\Git\cmd\

Python

C:\Users\사용자이름\AppData\Local\Programs\Python\

1. Windows 키와 E 키를 함께 눌러 파일 탐색기를 엽니다.
2. 주소 표시줄에 해당 경로를 붙여넣고 Enter 키를 누릅니다.
3. node.exe, git.exe처럼 프로그램 이름으로 끝나는 파일이 보이는지 확인합니다.

위쪽에는 Node.js 설치 폴더와 빨간 네모로 표시한 node.exe가, 아래쪽에는 Git 설치 폴더와 빨간 네모로 표시한 git.exe가 보입니다

폴더와 실행 파일이 보이면 프로그램은 설치된 상태입니다. 다음 방법에서 그 폴더 주소를 PATH에 추가합니다.

폴더가 없다면 바로 다른 폴더를 삭제하지 마세요. 설정 > 앱 > 설치된 앱에서 프로그램 이름을 먼저 검색합니다. 목록에도 없다면 설치가 끝나지 않은 경우이므로 그래도 안 되면으로 이동합니다.

해결 방법 3 — PATH 에 직접 추가하기

환경 변수 창 열기

찾은 프로그램 폴더를 PATH 목록에 한 줄 추가합니다. 컴퓨터 설정을 바꾸는 화면이므로, 아래 단계에서 기존 줄을 지우지 않는 것이 가장 중요합니다.

1. 시작 메뉴에서 환경 변수를 검색합니다.
2. 시스템 환경 변수 편집을 누릅니다. 시스템 속성 창이 열리면 고급 탭을 선택합니다.
3. 아래쪽의 환경 변수를 누릅니다.

시스템 속성의 고급 탭에서 환경 변수 버튼을 누르기 직전의 화면입니다

🚨 경고

기존 값을 지우면 안 됩니다. 환경 변수 창에는 다른 프로그램이 사용하는 설정도 들어 있습니다. 임의의 항목을 삭제하거나 이름을 바꾸지 마세요.

Path 항목 선택

4. 위쪽 사용자 변수 목록에서 Path를 선택하고 편집을 누릅니다. 사용자 변수에 Path가 없으면 아래쪽 시스템 변수의 Path를 선택할 수 있지만, 관리자 권한을 요구할 수 있습니다.

환경 변수 창에서 사용자 변수의 Path 항목을 선택하고 편집 버튼을 누릅니다

⚠️ 주의

Path 행만 선택합니다. TEMP, ComSpec 같은 다른 행을 고르지 말고, 기존 Path 값 전체를 지우고 다시 입력하지도 마세요.

Path에 한 줄 추가

5. Path 편집 창에서 새로 만들기를 누릅니다.
6. 방법 2에서 확인한 폴더 주소 한 줄만 붙여넣습니다. node.exe처럼 실행 파일까지 적지 말고, 파일이 들어 있는 폴더까지만 적습니다.

C:\Program Files\nodejs

Path 편집 창에서 기존 목록은 그대로 두고 새로 만들기 버튼으로 설치 폴더를 한 줄 추가합니다

🚨 경고

새로 만들기로 한 줄을 추가하는 것입니다. 기존 목록을 덮어쓰거나 다른 줄을 지우지 마세요. 확인을 누르기 전에 기존 줄이 그대로 있는지 한 번 더 봅니다.

7. Path 편집 창에서 확인, 환경 변수 창에서 확인, 시스템 속성 창에서 확인을 차례로 누릅니다.
8. 열려 있는 터미널을 모두 닫고 새로 엽니다.
9. 방법 1의 버전 확인 명령어를 다시 실행합니다.

⚠️ 주의

확인을 누르기 전에 추가한 폴더 주소에 오타가 없는지, 기존 값이 사라지지 않았는지 다시 보세요. 한 줄을 추가하는 것보다 기존 목록을 보존하는 것이 더 중요합니다.

그래도 안 되면

프로그램 다시 설치

프로그램 폴더가 없거나, 올바른 폴더를 PATH에 추가했는데도 새 터미널에서 찾지 못하면 설치가 꼬였을 수 있습니다.

1. 설정 > 앱 > 설치된 앱에서 오류가 난 프로그램 하나를 찾습니다.
2. 해당 프로그램의 메뉴에서 제거를 누릅니다. 이름이 비슷한 다른 프로그램이나 공용 구성 요소는 지우지 마세요.
3. 공식 설치 파일을 다시 받습니다. Node.js는 Node.js 설치법 (Windows), Git은 Git 설치법과 최초 설정의 설치 과정을 따라갑니다.
4. 설치 파일을 마우스 오른쪽 버튼으로 누르고 관리자 권한으로 실행을 선택합니다.
5. 설치 마법사가 끝나면 터미널을 모두 닫고 새로 연 뒤 버전을 다시 확인합니다.

🚨 경고

재설치할 때도 PATH의 기존 줄을 먼저 지우지 마세요. 설치 마법사가 PATH를 자동으로 등록하게 두고, 그래도 안 될 때만 방법 3으로 해당 폴더 한 줄을 추가합니다.

다음 단계

터미널을 여는 법은 윈도우 PowerShell 여는 법과 기본 사용법에서 확인하세요. Node.js 설치는 Node.js 설치법 (Windows), Git 설치는 Git 설치법과 최초 설정에서 이어서 볼 수 있습니다.

이 글을 포함한 설치·사용·문제해결 글은 시리즈 전체 흐름으로 이어집니다.

이 글에 나온 용어

처음 보는 단어가 있었다면 여기서 확인하세요. 이 시리즈에서 계속 나옵니다.

용어	읽는 법	쉬운 설명
PATH	패스	터미널에 node 라고 치면 컴퓨터가 그 프로그램을 어디서 찾아야 할지 알아야 합니다. 그 '찾아볼 폴더 목록'이 PATH입니다. 프로그램을 깔았는데 '명령을 찾을 수 없습니다'가 뜬다면 대부분 이 목록에 등록이 안 된 것입니다.
환경변수	-	프로그램들이 공통으로 참고하는 메모장 같은 것입니다. PATH가 가장 대표적인 환경변수입니다.
터미널	-	마우스로 아이콘을 누르는 대신 글자를 쳐서 컴퓨터에 시키는 프로그램입니다. 윈도우에서는 명령 프롬프트·PowerShell·Windows 터미널이 여기 해당합니다. 화면이 검고 글자만 있어서 무서워 보이지만, 하는 일은 파일 탐색기와 똑같습니다 — 폴더를 열고 프로그램을 실행합니다.
경로	-	C:\Users\길동\문서\메모.txt 처럼 파일의 위치를 나타내는 주소입니다. 영어로는 패스(path)라고 합니다. 터미널에서는 파일을 클릭할 수 없으니 이 주소를 직접 적어줘야 합니다.
절대경로	-	C:\Users\길동\문서\메모.txt 처럼 드라이브부터 끝까지 다 적은 주소입니다. 어디서 실행하든 같은 파일을 가리킵니다.
명령 프롬프트	-	cmd 또는 도스창이라고도 부릅니다. 윈도우에 아주 오래전부터 있던 터미널이라 자료가 많지만, 요즘 개발 도구는 PowerShell을 기준으로 설명하는 경우가 많습니다.
PowerShell	파워셸	명령 프롬프트보다 나중에 나온 윈도우 터미널입니다. 할 수 있는 일이 훨씬 많고, 요즘 윈도우에서는 이쪽이 기본입니다. 이 블로그의 명령어도 PowerShell 기준입니다.
관리자 권한	-	프로그램 설치처럼 컴퓨터 전체에 영향을 주는 작업에 필요합니다. 아이콘을 우클릭해서 '관리자 권한으로 실행'을 고르면 됩니다. 필요할 때만 쓰는 게 안전합니다.
설치 마법사	-	프로그램을 깔 때 뜨는 '다음 > 다음 > 완료' 창입니다. 영어로는 인스톨러(installer)나 셋업(setup)이라고 적혀 있습니다.
Windows 터미널	윈도우 터미널	크롬에 탭이 여러 개 있는 것처럼, 명령 프롬프트와 PowerShell을 탭으로 나란히 열어주는 프로그램입니다. 윈도우 11에는 기본으로 들어 있습니다. 터미널 자체가 아니라 터미널을 담는 그릇에 가깝습니다.
Node.js	노드제이에스	원래 자바스크립트는 웹브라우저 안에서만 돌아갔는데, 이걸 브라우저 밖에서도 돌게 만든 것이 Node.js입니다. Claude Code·Codex·Gemini CLI가 전부 이걸로 만들어져서, 먼저 깔아야 합니다.
Git	깃	문서의 '변경 내용 추적'을 아주 정교하게 만든 것입니다. 언제 무엇을 왜 바꿨는지 남기고, 필요하면 과거로 되돌릴 수 있습니다. AI에게 코드를 맡길 때 특히 중요합니다 — 마음에 안 들면 되돌리면 되니까요.
버전	-	20.11.0 처럼 점으로 나뉜 숫자입니다. 앞자리가 클수록 최신입니다. 가이드를 따라 할 때 버전이 다르면 화면이 조금 다를 수 있습니다.
cmd	씨엠디	Command Prompt의 앞글자를 딴 이름입니다. Windows에서 글자를 입력해 폴더를 확인하고 프로그램을 실행하는 창을 가리킵니다. 검색창에 cmd라고 입력하면 명령 프롬프트를 바로 찾을 수 있습니다.

📎 참고

용어를 한곳에 모아둔 전체 용어사전도 있습니다. 새 단어가 나올 때마다 계속 추가됩니다.