다운가이드VS Code 설치 후 code 명령을 찾을 수 없을 때
시작 메뉴에서 편집기는 열리지만 PowerShell이나 명령 프롬프트에서 code를 인식하지 못하는 경우를 다룹니다.
이 페이지에서
1. 적용할 증상 구분
시작 메뉴에서는 VS Code가 열리는데 PowerShell의 code --version에 명령을 찾지 못했다는 메시지가 나오는 경우에 적용합니다. 편집기 자체가 실행되지 않는 문제나 확장 설치 실패와는 확인 대상이 다릅니다. 먼저 시작 메뉴에서 실행한 편집기의 도움말 정보를 확인하고 설치형인지 ZIP판인지, 여러 판이 함께 있는지 기록합니다.
2. 새 터미널에서 재확인
설치 전에 열어 둔 셸은 이전 PATH를 유지할 수 있습니다. 작성 중인 터미널 작업을 마치고 새 PowerShell 창을 열어 다시 확인합니다. VS Code 통합 터미널에서만 실패한다면 편집기를 완전히 닫았다가 다시 시작한 후 새 통합 터미널을 엽니다. 새 창에서 버전 정보가 나오면 기존 창의 환경이 갱신되지 않은 경우입니다.
code --version3. Windows가 찾는 명령 위치 확인
PowerShell에서는 where 자체가 다른 명령 별칭일 수 있어 Windows 검색 도구를 명시한 where.exe를 사용합니다. 결과에 code.cmd 등의 실제 경로가 나오면 어느 설치 폴더의 bin을 찾는지 확인하세요. 아무 경로도 나오지 않는다면 현재 프로세스가 해당 위치를 검색하지 못하는 상태입니다. 출력 경로에 개인 계정명이 포함될 수 있으므로 공개 문의에 그대로 올리기 전에 가립니다.
where.exe code4. User Setup과 ZIP 위치 구분
공식 Windows 설치 문서는 User Setup의 bin 경로를 사용자 로컬 앱 폴더 아래로 안내합니다. 실제 설치 위치가 그곳인지 탐색기에서 확인하세요. System Setup이나 ZIP을 사용했다면 경로가 다릅니다. 인터넷 예시의 사용자 이름이나 설치 경로를 그대로 붙여 넣지 말고 자신의 실행 파일이 있는 폴더를 기준으로 확인해야 합니다. 예전 ZIP 폴더가 PATH에 남아 있으면 다른 판을 실행할 수 있습니다.
5. 설치 옵션 또는 PATH 항목 복구
설치형은 공식 설치 프로그램에서 명령 검색 경로에 추가하는 옵션을 확인해 복구할 수 있습니다. 수동으로 환경 변수를 수정해야 한다면 현재 사용자 PATH의 내용을 먼저 기록하고, 확인한 bin 폴더 항목 하나만 추가합니다. 기존 PATH 전체를 한 경로로 덮어쓰면 다른 명령이 동작하지 않을 수 있습니다. 조직이 설정을 관리하는 PC는 담당자에게 요청하세요.
6. 결과 검증과 원래 설정 복구
변경 후 새 PowerShell에서 where.exe code와 code --version을 차례로 확인합니다. 예상한 설치 폴더와 버전이 나오면 연습용 폴더에서 code .을 실행해 탐색기에 그 폴더가 열리는지 확인하세요. 새 항목을 추가한 뒤 다른 명령이 실패하면 기록한 PATH와 비교해 이번에 바꾼 항목만 되돌립니다. 업무 경로를 정리한다는 이유로 관련 없는 항목까지 삭제하지 않습니다.
7. 계속 실패할 때 전달할 정보
VS Code 시작 메뉴 실행 여부, User Setup·System Setup·ZIP 중 설치 방식, where.exe code 결과, 새 외부 PowerShell과 통합 터미널에서의 차이, 실제 오류 문구를 함께 정리합니다. 폴더 접근 거부가 보인다면 명령 검색 실패와 구분해 권한 정책을 확인합니다. 지원 요청에는 개인 경로를 필요한 부분만 남기고, 환경 변수 전체나 인증 토큰을 첨부하지 마세요.
함께 확인할 설치·오류 해결
내 계정에 편집기를 설치한 다음 메뉴를 한국어로 바꾸고, 작업 폴더에서 편집기를 여는 방법을 확인합니다.
Git Bash에서 설치 상태를 확인하고 커밋에 남길 이름과 이메일이 어느 저장소에 적용되는지 점검합니다.
git 명령어 인식 오류가 나면 Git 설치 자체와 현재 셸의 PATH 설정을 구분해 점검합니다.
관련 프로그램
- 비주얼 스튜디오 코드 · 코드 편집, 터미널, Git 변경 사항 확인을 한 창에서 처리합니다.