LainyZine: 프로그래머 가이드 🐣

터미널에서 Visual Studio Code 실행하는 방법

Visual Studio Code는 Microsoft에서 오픈소스로 개발하고 있는 코드 에디터입니다. 현재 가장 인기 있는 코드 에디터로 윈도우, 맥, 리눅스 등 다양한 환경을 지원하고 있습니다.

Visual Studio Code를 터미널에서 실행하기 위해서는 code 명령어의 PATH 설정을 해야합니다. 윈도우의 경우 인스톨러로 설치할 때 PATH 설정을 진행합니다만, 맥에서는 단순히 복사만으로 설치가 되기 때문에 PATH가 기본적으로 설정되어있지 않습니다. 윈도우에서도 PATH 설정을 체크하지 않았다면 code 명령어를 사용할 수 없습니다. 이 글에서는 운영체제 별로 code 명령어를 PATH에 추가하고 터미널에서 실행하는 방법에 대해서 알아봅니다.

맥에서 Visual Studio Code의 PATH를 설정하는 방법

먼저 PATH가 정상적으로 설정되어있지 않다면, code 실행시 다음과 같이 에러가 발생합니다.

$ code
zsh: command not found: code

Code를 열고 Command + Shift + P를 입력해 커맨드 팔레트를 엽니다. PATH로 검색해서 다음 명령을 실행합니다.

code를 PATH에 추가해줍니다

터미널이나 iTerm2를 실행해서 code 명령어를 확인해봅니다. code -v를 실행하면 버전을 출력됩니다. code를 인자 없이 실행하면 VS Code가 실행됩니다.

$ code -v
1.59.0
379476f0e13988d90fab105c5c19e7abc8b1dea8
arm64

$ code

동작 원리는 간단합니다. “Install ‘code’ command in PATH” 명령어를 실행하면 /usr/local/bin 디렉터리 아래에 code 명령어에 심볼릭 링크 파일을 추가합니다. 실제로 이 파일을 지우고, 다시 명령어를 실행하면 다시 파일이 생성되는 것을 확인할 수 있습니다.

윈도우에서 Visual Studio Code의 PATH를 설정하는 방법

윈도우의 PATH 설정 방법은 맥과는 조금 다릅니다. 윈도우에서는 Visual Studio Code를 설치할 때, 추가 작업 선택에서 ’PATH에 추가’를 선택하면, 터미널에서 바로 code를 실행할 수 있습니다.

윈도우에서는 설치 과정에서 PATH 설정을 할 수 있습니다

이 체크를 하지 않았다면 별도로 PATH 설정을 해주어야합니다. 그런데 맥에 있었던 아래 명령어가 윈도우에는 없습니다.

윈도우에서는 Path 시스템 환경변수에 직접 code 명령어의 디렉터리를 추가해주어야합니다. Windows + S를 입력하고 ’환경 변수’를 검색합니다. 시스템 환경 변수 편집 설정을 실행합니다.

시스템 환경 변수 편집 설정을 엽니다

맨 아래에 보이는 환경 변수 버튼을 클릭합니다.

환경 변수 버튼을 클릭합니다

환경 변수는 크게 사용자 변수와 시스템 변수로 나뉩니다. 어디에 추가해도 무방합니다만, 여기서는 사용자 변수 Path에 Code의 경로를 추가해주겠습니다. 사용자 변수 목록에서 Path를 찾아 선택하고 편집을 선택합니다.

사용자 변수에서 Path를 찾아 편집을 클릭합니다

환경 변수 편집 창이 나타납니다. 새로 만들기를 클릭하면 빈 줄이 편집 상태가 됩니다. 다음 내용을 추가해주세요. 이 때 [USER]는 현재 시스템의 사용자 이름으로 변경해줍니다. 이 경로는 Code의 기본 설치 경로로 다른 경로에 설치했다면 해당 설치 경로를 지정해주어야합니다.

C:\Users\[USER]\AppData\Local\Programs\Microsoft VS Code\bin
Path 환경 변수에 VS Code의 실행 경로를 추가해줍니다

확인을 눌러 편집 창을 닫습니다. 다시 확인을 눌러 환경 변수 창도 닫아주세요. 여기까지 Path 설정을 마쳤습니다.

이제 Windows Terminal이나 PowerShell을 실행해서 code 명령어가 동작하는지 확인해봅니다. 이미 실행중인 터미널이 있다면 종료하고, 새로 실행해주세요. -v 옵션을 붙이면 버전을 보여주며, 인자없이 실행하면 VS Code를 실행합니다.

$ code -v
1.59.0
379476f0e13988d90fab105c5c19e7abc8b1dea8
x64

$ code

만약 정상 동작하지 않는다면 $Env:Path를 실행해서, 출력된 내용에 앞에서 추가한 VS Code 경로가 정상적으로 추가되었는지 확인해봅니다.

추천 문서

LainyZine은 쿠팡 파트너스 활동에 따른 수수료를 제공받습니다.