Windows 11에서 PATH에 추가하기: GUI, CMD, PowerShell 방법

Command PromptLicenceHouse
Add to PATH in Windows 11: GUI, CMD and PowerShell Methods – LicenceHouse guide

Windows 11에서 PATH에 폴더를 추가하려면 시스템 환경 변수 편집을 검색하고 환경 변수를 선택합니다. 사용자 변수에서 Path > 편집 > 새로 만들기를 선택하고 폴더 경로를 붙여넣은 다음 각 창에서 확인을 선택합니다. 그런 다음 새 터미널을 여십시오. 이미 열려 있던 창에는 변경 사항이 반영되지 않습니다.

방법 적합한 용도 위험 수준
환경 변수 대화 상자 대부분의 사용자, 명확한 목록 보기 낮음
PowerShell [Environment]::SetEnvironmentVariable 스크립트 및 반복 가능한 설정 교체가 아닌 추가 방식이라면 낮음
CMD setx 간단하고 짧은 변수 PATH의 경우 높음(1,024자 잘림)
set PATH=...(CMD) 또는 $env:Path(PowerShell) 임시, 현재 창에만 적용 없음, 창을 닫으면 사라짐

Windows 11의 PATH 변수란 무엇입니까?

PATH는 세미콜론으로 구분된 폴더 목록을 담고 있는 환경 변수입니다. python이나 git 같은 명령을 입력하면 Windows는 이 폴더들을 순서대로 검색하여 일치하는 프로그램을 찾습니다. PATH에 폴더를 추가하면 매번 전체 파일 경로를 입력하지 않고도 어느 터미널 위치에서나 해당 폴더의 도구를 실행할 수 있습니다.

실제로 Windows는 두 개의 PATH 목록을 유지합니다. 사용자 PATH는 해당 계정에만 적용되며 관리자 권한이 필요하지 않습니다. 시스템 PATH는 PC의 모든 계정에 적용되며 관리자 승인이 필요합니다. 프로그램이 시작되면 Windows는 시스템 항목을 먼저, 사용자 항목을 그 뒤에 두어 두 목록을 합칩니다.

원인과 결과: 시스템 항목이 먼저 오기 때문에 시스템 PATH 폴더에 있는 프로그램이 사용자 PATH에 있는 동일한 이름의 프로그램보다 우선합니다. 그래서 다른 Python처럼 도구의 두 번째 버전을 설치해도 "효과가 없는" 것처럼 보일 수 있습니다. 이전 버전이 먼저 발견되기 때문입니다. 아래에서 설명하는 where 명령을 사용하면 Windows가 실제로 사용하는 사본을 확인할 수 있습니다.

설정을 사용하여 PATH에 폴더를 추가하는 방법은 무엇입니까?

시작에서 시스템 환경 변수 편집을 검색하여 열고 환경 변수를 선택합니다. 사용자 변수에서 Path를 선택한 다음 편집, 새로 만들기를 선택하고 폴더 경로를 붙여넣습니다. 세 창 모두에서 확인을 선택하여 저장합니다. PC의 모든 계정에 해당 폴더가 필요한 경우에만 시스템 변수 섹션을 사용하십시오.

  1. 추가할 폴더 경로를 복사합니다. 파일 탐색기에서 폴더를 마우스 오른쪽 단추로 클릭하고 경로로 복사를 선택한 다음, 붙여넣을 때 따옴표를 제거합니다.
  2. 시작을 선택하고 environment를 입력한 다음 시스템 환경 변수 편집을 선택합니다. Windows 키 + R을 눌러 sysdm.cpl을 실행한 후 고급 탭을 열어도 됩니다.
  3. 환경 변수를 선택합니다.
  4. 사용자 이름의 사용자 변수에서 Path를 선택한 다음 편집을 선택합니다. Path 항목이 없다면 새로 만들기를 선택하고 이름을 Path로 지정한 후 폴더를 값으로 붙여넣습니다.
  5. 새로 만들기를 선택하고 폴더 경로(예: C:\Tools\bin)를 붙여넣은 후 Enter를 누릅니다.
  6. 이 폴더가 동일한 이름의 프로그램이 있는 다른 폴더보다 우선해야 한다면 위로 이동을 사용합니다.
  7. 편집 창, 환경 변수 창, 시스템 속성 창에서 각각 확인을 선택합니다.

Microsoft의 무료 PowerToys 앱에도 환경 변수 편집기가 포함되어 있어, 경로를 자주 관리한다면 프로필과 더 깔끔한 목록 보기를 사용할 수 있습니다.

자주 보는 사례: 프로그램이 들어 있는 폴더가 아닌 C:\Tools\bin\tool.exe 같은 프로그램 파일 자체의 경로를 추가하는 경우입니다. PATH 항목은 폴더여야 합니다. .exe로 끝나는 경로는 무시되며 명령을 여전히 찾을 수 없습니다.

Windows 11에서 PATH에 추가한 후 사용하는, 명령이 표시된 노트북 터미널 창

PowerShell로 PATH에 추가하는 방법은 무엇입니까?

.NET 메서드 [Environment]::SetEnvironmentVariable을 사용하여 기존 사용자 PATH에 폴더를 영구적으로 추가합니다. 먼저 현재 값을 읽고 세미콜론과 폴더를 추가한 다음 User 대상으로 다시 씁니다. 이 방법은 setx의 길이 제한을 피하고 다른 항목을 확장하거나 다시 쓰지 않습니다.

사용자 PATH에 폴더를 추가하려면(관리자 권한 불필요) 다음을 실행합니다.

$old = [Environment]::GetEnvironmentVariable("Path", "User")
[Environment]::SetEnvironmentVariable("Path", "$old;C:\Tools\bin", "User")

시스템 PATH에 추가하려면 PowerShell을 관리자 권한으로 열고 두 줄 모두에서 "User" 대신 "Machine"을 사용합니다.

심화 참고: $env:Path에서 새 값을 만들지 마십시오. PowerShell 세션에서 $env:Path는 시스템과 사용자 목록이 합쳐진 값을 담고 있습니다. 이를 사용자 변수에 다시 쓰면 모든 시스템 항목이 중복됩니다. 위와 같이 GetEnvironmentVariable로 특정 범위를 읽으십시오.

창을 닫을 때까지만 유지되는 임시 변경에는 $env:Path += ";C:\Tools\bin"을 사용합니다. Microsoft의 about_Environment_Variables 참조에서 세션 변수와 영구 변수의 차이를 설명합니다.

setx로 PATH에 추가해야 합니까?

일반적으로는 권장하지 않습니다. setx 명령은 1,024자보다 긴 값을 잘라낸 뒤 잘린 텍스트를 저장하므로, PATH 항목이 많은 PC에서는 기존 폴더가 알림 없이 삭제될 수 있습니다. 또한 %PATH%를 전달하면 사용자 항목과 시스템 항목이 합쳐집니다. PATH를 변경할 때는 대신 환경 변수 대화 상자나 PowerShell을 사용하십시오.

온라인에서 흔히 볼 수 있는 명령은 다음과 같습니다.

setx PATH "%PATH%;C:\Tools\bin"

이 명령에는 두 가지 문제가 있습니다. 첫째, %PATH%는 시스템과 사용자 PATH가 합쳐진 값으로 확장되므로 전체 목록이 사용자 PATH에 기록되어 항목이 중복됩니다. 둘째, Microsoft의 setx 문서에 따르면 1,024자보다 긴 값은 잘립니다. 개발자 컴퓨터의 PATH는 이보다 긴 경우가 많습니다.

명령 프롬프트에서 안전한 방법은 현재 창에만 적용되는 임시 변경인 set PATH=%PATH%;C:\Tools\bin을 사용하거나, 영구 변경의 경우 위의 PowerShell 방법을 사용하는 것입니다. 이미 setx를 실행하여 항목이 사라졌다면 환경 변수 대화 상자를 열고 누락된 폴더를 직접 다시 추가하십시오. 변경 전의 시스템 복원 지점을 사용해도 이전 값을 복원할 수 있습니다.

폴더가 PATH에 추가되었는지 확인하는 방법은 무엇입니까?

열려 있는 모든 터미널을 닫고 새 터미널을 연 다음, where 뒤에 프로그램 이름을 붙여 실행합니다(예: where python). Windows가 새 폴더의 경로를 표시하면 PATH가 정상적으로 작동하는 것입니다. 명령 프롬프트에서는 echo %PATH%로, PowerShell에서는 $env:Path -split ';'로 전체 목록을 출력할 수도 있습니다.

  • 명령 프롬프트: echo %PATH%는 합쳐진 목록을 한 줄로 출력합니다.
  • PowerShell: $env:Path -split ';'는 한 줄에 폴더 하나씩 출력하므로 훨씬 읽기 쉽습니다.
  • 프로그램 찾기: 명령 프롬프트의 where tool 또는 PowerShell의 where.exe tool은 일치하는 모든 항목을 PATH 순서대로 나열합니다. 첫 번째 결과가 실제로 실행되는 프로그램입니다.

PowerShell에서 단순히 where만 입력하면 Where-Object의 별칭이므로 .exe를 포함하십시오. where 명령 참조에서 다른 스위치를 확인할 수 있습니다.

PATH 변경이 작동하지 않는 이유는 무엇입니까?

가장 흔한 이유는 PATH를 변경할 때 터미널, 편집기 또는 앱이 이미 열려 있었기 때문입니다. 프로그램은 시작할 때 환경 변수를 읽으므로 이전 목록을 그대로 유지합니다. 터미널을 닫았다가 다시 열거나 VS Code 같은 앱을 완전히 다시 시작하십시오. 로그아웃한 후 다시 로그인하면 모든 항목이 한 번에 새로 고쳐집니다.

다음 확인 사항을 순서대로 진행하십시오.

  1. 앱을 다시 시작합니다. 코드 편집기의 통합 터미널은 편집기의 환경을 상속하므로 터미널 탭만이 아니라 편집기 전체를 다시 시작하십시오.
  2. 폴더를 확인합니다. 항목이 따옴표나 불필요한 공백 없이 .exe가 들어 있는 폴더를 가리키는지 확인합니다.
  3. 순서를 확인합니다. 프로그램 이름으로 where.exe를 실행합니다. 다른 사본이 먼저 표시되면 항목을 위로 이동하거나 이전 항목을 제거합니다.
  4. 범위를 확인합니다. 관리자 메시지를 승인하지 않고 시스템 PATH를 편집했다면 변경 사항이 저장되지 않았을 수 있습니다. 대화 상자를 다시 열어 확인하십시오.
  5. 별칭을 확인합니다. Windows에는 python.exe 등에 대한 앱 실행 별칭이 포함되어 있어 명령을 가로챌 수 있습니다. 설치된 프로그램 대신 Microsoft Store가 열린다면 설정 > 앱 > 고급 앱 설정 > 앱 실행 별칭에서 해당 별칭을 끄십시오.

자주 보는 사례: "PATH에 추가" 옵션을 제공하는 설치 프로그램이 설치를 실행한 계정에만 항목을 추가하는 경우가 있습니다. 같은 PC의 다른 사용자가 도구를 실행할 수 없다면 대신 시스템 PATH에 폴더를 추가하십시오. 도구는 찾지만 시작하자마자 닫히거나 충돌한다면 더 이상 PATH 문제가 아닙니다. 이벤트 뷰어 가이드에서 그 시점에 기록된 애플리케이션 오류를 찾는 방법을 안내합니다.

이 모든 방법은 Windows 11 Home과 Pro에서 동일하게 작동합니다. 같은 컴퓨터에서 기본 제공 Hyper-V, Windows Sandbox 또는 원격 데스크톱 호스트도 필요한 개발자라면 Windows 11 Pro가 필요합니다. Pro와 Home 비교에서 차이점을 자세히 설명합니다.

자주 묻는 질문

PATH를 편집한 후 Windows를 다시 시작해야 합니까?

전체를 다시 시작할 필요는 없습니다. 환경 변수 대화 상자에서 확인을 선택하면 새 창에서 업데이트된 PATH를 바로 읽습니다. 하지만 터미널, 코드 편집기, 파일 탐색기 자체를 포함하여 이미 실행 중이던 앱은 이전 값을 유지합니다. 이러한 앱을 닫았다가 다시 열거나, 로그아웃한 후 다시 로그인하십시오.

사용자 PATH와 시스템 PATH의 차이점은 무엇입니까?

사용자 PATH는 해당 계정에만 속하며 관리자 권한 없이 편집할 수 있습니다. 시스템 PATH는 PC의 모든 계정에 적용되며 변경하려면 관리자가 필요합니다. Windows는 프로그램이 시작될 때 시스템 항목을 사용자 항목보다 앞에 두어 두 목록을 합치므로, 이름이 겹치면 시스템 폴더가 우선합니다.

Windows 11에서 PATH에 길이 제한이 있습니까?

개별 환경 변수는 최대 32,767자까지 담을 수 있으므로 대화 상자와 PowerShell 방법은 긴 PATH 목록도 문제없이 처리합니다. 잘 알려진 1,024자 제한은 더 긴 값을 잘라내는 setx 명령에 해당합니다. 그래서 개발자 컴퓨터에서 PATH를 편집할 때 setx는 위험한 선택입니다.

PATH에서 폴더를 제거하는 방법은 무엇입니까?

환경 변수 대화 상자를 열고 사용자 또는 시스템 변수에서 Path를 선택한 후 편집을 선택합니다. 제거할 폴더를 선택하고 삭제를 선택한 다음 각 창에서 확인을 선택합니다. 그런 다음 새 터미널을 열고 프로그램 이름으로 where.exe를 실행하여 Windows가 더 이상 해당 위치에서 프로그램을 찾지 않는지 확인하십시오.

PATH에 %SystemRoot% 같은 퍼센트 기호가 표시되는 이유는 무엇입니까?

이는 다른 환경 변수에 대한 참조이며, Windows가 PATH를 읽을 때 확장됩니다. 예를 들어 %SystemRoot%는 C:\Windows가 됩니다. Windows가 다른 위치에 설치되어 있어도 항목이 올바르게 유지됩니다. 모든 참조를 확장하여 PATH를 다시 쓰는 도구는 향후 변경에 대한 이러한 유연성을 없애므로 피하십시오.

관련 가이드

이 가이드의 링크

링크 유형 도움이 되는 이유
Windows 11 Pro 내부 개발자를 위한 Hyper-V, Sandbox, 원격 데스크톱 호스트 추가
Windows 11 Pro와 Home 비교 내부 에디션 차이점을 자세히 설명
이벤트 뷰어 가이드 내부 PATH를 수정한 후에도 충돌하는 도구 진단
setx 명령 참조 외부 1,024자 잘림 확인
about_Environment_Variables 외부 PowerShell의 세션 및 영구 변수 처리 방식
where 명령 참조 외부 실제로 실행되는 프로그램 사본 확인
PowerToys 환경 변수 외부 PATH 관리를 위한 더 편리한 편집기
태그: Command prompt, Environment variables, Path, Powershell, Windows 11