macOS 터미널에서 code 명령어로 VS Code 여는 방법

vscodemacosterminalzshcli

터미널에서 code . 한 줄이면 현재 폴더가 VS Code로 바로 열립니다. 익숙해지면 없으면 불편할 정도로 자주 쓰게 되는데, 처음 설치하면 보통 이렇게 뜹니다.

TEXT
zsh: command not found: code

code 명령어가 아직 PATH에 등록되지 않아서 그렇습니다. 등록만 해주면 끝나니 차근차근 보겠습니다.

방법 1: VS Code 명령 팔레트에서 등록 (권장)

가장 간단하고 공식적인 방법입니다.

  1. VS Code를 엽니다.
  2. Cmd + Shift + P 로 명령 팔레트를 엽니다.
  3. Shell Command: Install 'code' command in PATH 를 입력하고 실행합니다.
  4. 터미널을 재시작합니다.

이 명령은 /usr/local/bin/code 에 심볼릭 링크를 만들어 줍니다. /usr/local/bin 은 기본적으로 PATH에 포함되어 있어서, 등록 후 바로 사용할 수 있습니다.

방법 2: PATH에 직접 추가

방법 1이 막히거나 직접 설정하고 싶다면, 셸 설정 파일에 VS Code의 bin 경로를 추가합니다. 요즘 macOS 기본 셸은 zsh이므로 ~/.zshrc 에 다음을 넣습니다.

Bash
export PATH="$PATH:/Applications/Visual Studio Code.app/Contents/Resources/app/bin"

저장한 뒤 설정을 다시 불러옵니다.

Bash
source ~/.zshrc

동작 확인

아래로 제대로 등록됐는지 확인합니다.

Bash
which code   # 경로가 출력되면 성공
code .       # 현재 폴더 열기
code ~/projects/my-app   # 특정 폴더 열기

안 될 때 자주 막히는 원인

설치했는데도 command not found: code 가 계속 뜬다면, 대부분 다음 두 가지 중 하나입니다.

1. 셸과 설정 파일이 안 맞는 경우

현재 셸이 zsh인데 ~/.bash_profile 이나 ~/.bashrc 에만 PATH를 등록한 경우입니다. 어떤 셸을 쓰는지 먼저 확인하세요.

Bash
echo $SHELL

/bin/zsh 가 나오면 설정은 ~/.zshrc 에 넣어야 합니다. /bin/bash 면 ~/.bash_profile 입니다.

2. VS Code 위치가 /Applications 가 아닌 경우

다운로드 폴더나 데스크톱에 VS Code를 둔 채로 실행하면 위 경로가 맞지 않습니다. VS Code를 /Applications 폴더로 옮긴 뒤 방법 1을 다시 실행하세요.

정리

  • 가장 쉬운 길은 명령 팔레트의 Shell Command: Install 'code' command in PATH
  • 안 되면 셸 종류(echo $SHELL)와 VS Code 설치 위치(/Applications)부터 확인
  • 등록 후 터미널 재시작은 필수

한 번 등록해두면 code . 가 손에 붙어서, 파인더로 폴더 찾아 드래그하던 시절로는 돌아가기 어렵습니다.