설치한 명령줄 도구가 터미널에서 이름만으로 실행되지 않으면 Path에 실행 파일이 있는 폴더가 포함돼 있는지 확인할 수 있습니다. 윈도우에는 현재 계정의 환경 변수와 컴퓨터 전체의 환경 변수가 있습니다. 도구를 어디에 설치했는지, 어느 계정에서 사용할지부터 보고 필요한 항목만 조정하세요.
Path가 찾는 것은 실행 파일이 있는 폴더
도구 설치 폴더에서 실행 파일의 위치를 확인합니다. 예를 들어 실행 파일이 도구 폴더의 bin 안에 있다면 Path에 넣을 후보는 보통 그 bin 폴더입니다. 파일 이름까지 넣거나 상위 폴더만 적으면 해당 명령을 찾지 못할 수 있습니다. 설치 프로그램이 자동으로 설정했는지도 확인하세요.
동일한 이름의 실행 파일이 여러 폴더에 있다면 예상과 다른 버전이 선택될 수 있습니다. 윈도우 명령 프롬프트에서 where.exe 뒤에 도구 이름을 입력하거나 PowerShell에서 Get-Command로 어떤 명령이 선택되는지 살펴봅니다. PowerShell에서는 함수와 별칭이 같은 이름으로 존재할 수 있으므로 결과의 유형과 경로를 함께 봅니다.
터미널마다 명령의 이름을 해석하는 방식이 다를 수 있습니다. 처음 오류가 났던 편집기나 터미널에서 다시 확인해 실제 사용하는 환경의 결과를 비교하세요.
현재 계정과 컴퓨터 전체 중 범위 선택하기
시작 메뉴에서 환경 변수를 검색하거나 시스템 속성의 고급 → 환경 변수 메뉴를 엽니다. 사용자 변수는 현재 계정 쪽 설정이고, 시스템 변수는 컴퓨터의 다른 사용자나 프로그램에도 영향을 줄 수 있습니다. 본인 계정에서만 쓰는 도구라면 사용자 Path에 넣는 것으로 충분한지 먼저 봅니다.
시스템 영역을 바꾸려면 관리자 권한이 필요할 수 있습니다. 시스템 전체에서 같은 경로가 필요할 때는 기존 앱과 서비스의 의존성도 고려해야 합니다. 회사 PC에서 편집이 제한되면 설정을 우회하는 대신 사용할 도구와 설치 경로를 담당자에게 전달하세요.
기존 항목을 덮지 않고 새 폴더만 추가하기
Path 편집 화면에서 기존 항목을 그대로 두고 필요한 폴더를 추가합니다. 비슷한 경로가 이미 있다면 철자와 버전을 확인하세요. 전체 내용을 통째로 바꾸면 윈도우나 다른 프로그램이 쓰는 경로도 함께 없어질 수 있습니다. 변경 전 자신의 항목을 기록해 두면 시험 후 되돌리기 쉽습니다.
문서나 메일에 적힌 낯선 폴더를 그대로 추가하지 마세요. Path는 명령 이름만 입력할 때 실행 대상을 고르는 데 사용됩니다. 누구나 파일을 쓰는 임시 폴더보다 공식 도구를 설치한 관리 가능한 위치를 선택하고, 명령이 어떤 파일을 실행할지 먼저 확인합니다.
새 터미널에서 실제 실행 경로 확인하기
이미 실행 중인 터미널이나 편집기는 이전 환경 값을 유지할 수 있습니다. 단순히 같은 앱에서 탭을 하나 추가하는 대신 필요하면 앱 전체를 닫고 다시 열어 보세요. 새 환경에서 도구가 실행되는지와 버전 출력이 예상한 것인지 확인합니다.
예를 들어 개인용 도구를 업데이트했는데 옛 버전이 계속 나온다면 새 위치만 넣고 끝내지 말고 검색 결과의 경로를 봅니다. 예전 설치본을 쓰는 작업이 없는지 확인한 뒤 불필요한 항목을 정리하면, 같은 이름으로도 어떤 버전이 실행되는지 설명하기 쉬워집니다.
명령이 계속 예전 버전으로 실행되는 경우
검색 결과에 실행 파일이 두 개 나온다면 각각 어떤 프로그램이 설치했는지와 수정 날짜를 확인합니다. 새 도구의 전체 경로를 직접 써서 버전을 한 번 확인하면 설치 자체가 정상인지 구별할 수 있습니다. 사용자 Path에 새 폴더가 있다는 사실만으로 어떤 실행 파일이 항상 먼저 선택된다고 단정하지 마세요. 현재 터미널이 실제로 보는 Path와 명령 조회 결과를 같이 확인합니다. 다른 프로그램이 옛 도구를 필요로 한다면 제거부터 하지 말고 해당 작업에서 버전이 명시된 경로를 사용해 비교합니다.