code 명령: PATH에 없을 때 등록하는 두 가지 방법

터미널에서 VS Code로 뭔가를 열려고 code .을 쳤는데 command not found: code가 떴습니다. VS Code는 이미 깔려 있었습니다. /Applications/Visual Studio Code.app에 앱 자체는 멀쩡히 있었고, 문제는 그 앱을 실행하는 code 명령이 PATH 어디에도 없다는 것이었습니다.

VS Code는 앱을 /Applications에 넣는다고 해서 code 명령까지 저절로 PATH에 들어오지 않습니다. which code로 확인해서 못 찾으면 앱은 있는데 명령만 없는 상태라고 보면 됩니다.

고치는 두 가지 방법

첫 번째는 VS Code 안에서 하는 방법입니다. ⌘⇧P로 명령 팔레트를 열고 Shell Command: Install 'code' command in PATH를 찾아 실행합니다(한국어 UI에서는 셸 명령: PATH에 'code' 명령 설치). 이 명령이 /usr/local/bin/code에 심볼릭 링크를 만들어 줍니다.

두 번째는 관리자 권한 없이 ~/.zshrc에 한 줄을 추가하는 방법입니다.

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

추가한 뒤 source ~/.zshrc로 지금 셸에 바로 반영합니다. 새 터미널을 열 때마다 자동으로 적용되니 한 번만 해두면 됩니다.

자주 쓰는 형태

명령	동작
code .	현재 폴더를 새 창으로 연다
code 파일	파일 하나를 연다
code -r .	지금 열려 있는 창에서 연다
code -n .	항상 새 창을 연다
code -d a b	두 파일을 비교한다
code -w 파일	편집기를 닫을 때까지 터미널이 기다린다

-w는 편집기가 닫힐 때까지 호출한 쪽이 멈춰 있어야 하는 경우, 예를 들어 git이 커밋 메시지 편집기를 열어 두고 기다려야 하는 상황에 씁니다.

비밀값을 다룰 때도 이 명령을 씁니다

Claude Code 세션에서 API 키 같은 비밀값을 받을 때가 그렇습니다. 채팅창에 붙여넣게 하면 값이 대화 기록에 영구히 남으니, scratchpad에 빈 템플릿 파일 하나를 만들어 두고 ! code 경로로 편집기를 열어 그 안에 붙여넣게 합니다. !는 Claude Code 프롬프트에서 셸 명령을 실행하는 접두어입니다. 파일에 값을 저장한 뒤에는 원문 대신 마스킹한 형태로만 확인하고, 다 쓰면 파일을 지웁니다.