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

터미널에서 code . 한 줄이면 현재 폴더가 VS Code로 바로 열려요. 그런데 VS Code를 처음 설치하고 입력하면 보통 이렇게 떠요.

TEXT

zsh: command not found: code

code 명령어가 아직 PATH에 등록되지 않아서 그래요. 등록하는 방법을 하나씩 볼게요.

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

가장 간단하고, VS Code가 공식으로 안내하는 방법이에요.

이 명령은 /usr/local/bin/code 에 심볼릭 링크를 만들어요. /usr/local/bin 은 기본으로 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을 다시 실행해 보세요.