[Mac Terminal] VSCode에서 터미널 명령어 code 사용 설정 가이드

터미널에서 파일을 빠르게 열기 위해 사용하는 명령어 code는 VSCode 사용자들에게 필수적인 기능입니다. 하지만 기본적으로 설정되지 않은 경우 제대로 작동하지 않을 수 있습니다. 오늘은 터미널에서 code 명령어를 활성화하는 방법을 단계별로 정리해보겠습니다.

---

1. 왜 code 명령어가 안 될까?

 

macOS나 Linux 터미널에서 code ~/.zshrc 명령어를 실행하려고 했을 때, 오류가 발생하거나 명령어가 인식되지 않는 경우가 있습니다.

이는 **VSCode CLI(Command Line Interface)**가 설치되지 않았거나 $PATH 환경 변수에 등록되지 않았기 때문입니다. 이를 해결하려면 몇 가지 설정이 필요합니다.

---

2. code 명령어 활성화 방법

 

Step 1. VSCode에서 CLI 설치

 

1. VSCode 실행

먼저 Visual Studio Code를 실행합니다.

2. Command Palette 열기

상단 메뉴에서 View > Command Palette를 선택하거나 단축키 Shift + Command + P를 누릅니다.

3. CLI 설치 명령 실행

검색창에 아래 명령을 입력하고 선택합니다:

Shell Command: Install 'code' command in PATH

 

4. 설치 완료

성공 메시지가 표시되면 VSCode를 종료하고 터미널을 재시작합니다.

---

Step 2. CLI 설치 확인

 

터미널에서 code 명령어가 제대로 작동하는지 확인하려면 아래 명령어를 실행해보세요:

code --version

 

만약 VSCode 버전 정보가 출력되면 성공적으로 설치된 것입니다.

---

반응형

---

3. .zshrc 파일 열기

 

이제 터미널에서 code 명령어로 파일을 열 수 있습니다. 아래 명령어를 사용해 .zshrc 파일을 VSCode에서 열어보세요:

code ~/.zshrc

---

4. 문제가 여전히 발생한다면?

 

1. PATH 설정 문제

 

code 명령어가 여전히 인식되지 않는다면 $PATH 환경 변수에 /usr/local/bin 경로가 누락되었을 수 있습니다.

다음 명령어로 $PATH를 확인하세요:

echo $PATH

 

만약 /usr/local/bin이 포함되어 있지 않다면 .zshrc 파일을 열어 아래 내용을 추가한 후 저장합니다:

export PATH=$PATH:/usr/local/bin

 

변경 사항을 적용하려면 다음 명령어를 실행하세요:

source ~/.zshrc

 

2. VSCode 재설치

 

CLI 설치 후에도 작동하지 않으면, VSCode를 삭제 후 다시 설치한 뒤 위 단계를 반복합니다.

---

5. VSCode 없이 다른 편집기로 열기

 

VSCode CLI가 제대로 작동하지 않더라도, 다른 터미널 편집기를 사용하여 .zshrc를 수정할 수 있습니다:

• Nano:

nano ~/.zshrc

 

• Vim:

vim ~/.zshrc

 

TIP: Nano는 간단한 사용법으로 초보자에게 추천됩니다. Vim은 단축키 기반으로 익숙해지면 강력한 기능을 제공합니다.

---

6. 요약

 

VSCode의 code 명령어를 활성화하면 터미널에서 파일을 손쉽게 열고 작업할 수 있습니다. 다음 단계를 통해 문제를 해결하세요:

1. VSCode의 Command Palette에서 Shell Command: Install 'code' command in PATH 실행.

2. 설치 후 터미널에서 **code --version**으로 설치 확인.

3. 여전히 문제가 있다면 $PATH 확인 및 수정.

---

자주 묻는 질문(FAQ)

 

Q1. $PATH 수정이 뭔가요?

A: $PATH는 터미널에서 명령어를 실행할 때 사용할 파일 경로를 찾는 환경 변수입니다. code 명령어가 작동하려면 VSCode CLI가 설치된 /usr/local/bin이 $PATH에 포함되어야 합니다.

 

Q2. Nano와 Vim의 차이점은 뭔가요?

A: Nano는 초보자에게 적합한 간단한 텍스트 편집기이고, Vim은 고급 사용자를 위한 강력한 기능과 단축키를 제공합니다.

 

Q3. VSCode CLI 외에 다른 CLI 도구를 활성화할 수 있나요?

A: 네! 다양한 CLI 도구(예: git, node, python)를 $PATH에 등록해 사용할 수 있습니다.