Part 2.3 터미널 공포증 극복하기: 꼭 필요한 명령어만

까만 화면에 글자만 깜빡거리는 그것. 터미널.

처음 보면 무섭습니다.

괜찮아요. 바이브코딩할 때 쓰는 명령어는 5개 정도면 충분합니다. 오늘 그 5개만 확실하게 알려드리겠습니다.

터미널이 뭔가요?

마우스로 클릭하는 대신, 글자로 컴퓨터한테 명령하는 방식입니다.

예를 들어:

폴더 열기? 마우스로 더블클릭 하잖아요.
터미널에서는 cd 폴더이름이라고 치면 됩니다.

왜 이런 걸 쓰냐고요? 개발 도구들이 대부분 터미널 명령어로 작동하기 때문입니다. 설치, 실행, 빌드 같은 것들이요.

Cursor에서 터미널 여는 법:

상단 메뉴 → Terminal → New Terminal
단축키: Ctrl+` (백틱, 숫자 1 왼쪽에 있는 키)

명령어 1: cd (폴더 이동)

cd = Change Directory (디렉토리 변경)

가장 많이 쓰는 명령어입니다.

기본 사용법

cd 폴더이름

예시:

cd my-todo-app

이러면 my-todo-app 폴더 안으로 들어갑니다. (이미 my todo app이 있어야겠죠?)

자주 쓰는 패턴

한 단계 위로 가기:

cd ..

홈 폴더로 가기:

cd ~

경로 전체 지정하기:

cd /Users/내컴퓨터이름/Documents/projects

현재 어디 있는지 확인

pwd

이러면 현재 위치가 출력됩니다.

명령어 2: ls / dir (파일 목록 보기)

ls = List (목록)

현재 폴더에 뭐가 있는지 봅니다.

Mac/Linux

ls

Windows

dir

결과 예시

app/
public/
node_modules/
package.json
README.md

폴더는 끝에 /가 붙거나 다른 색으로 표시됩니다.

상세 정보 보기 (Mac/Linux)

ls -la

이러면 숨김 파일, 수정 날짜, 용량까지 다 보입니다.

명령어 3: npm install (패키지 설치)

(주의! npm뿐 아니라 yarn, pnpm도 있는데, 지금 단계에서 이것들을 구분짓는 건 큰 의미가 없습니다. 하나로 정해서 진행하면서 그 차이점을 llm에 물어보세요!)

npm = Node Package Manager

라이브러리(다른 사람이 만든 코드)를 설치하는 명령어입니다.

기본 사용법

프로젝트 폴더에서:

npm install

이러면 package.json에 적힌 모든 라이브러리를 한 번에 설치합니다.

GitHub에서 프로젝트를 받았거나, 다른 컴퓨터에서 작업할 때 제일 먼저 하는 것입니다.

특정 라이브러리 설치

npm install 라이브러리이름

예시:

npm install axios

이러면 axios라는 라이브러리가 설치됩니다.

설치 확인

설치된 라이브러리들은 node_modules 폴더에 들어갑니다. 이 폴더는 엄청 큽니다. 정상입니다.

명령어 4: npm run dev / npm start (실행)

프로젝트를 실행하는 명령어입니다. 아마 바이브코딩을 하면, llm이 알아서 다 설치를 진행해줄겁니다. 그때그때 package.json을 확인해서 명령어를 확인하세요.

Next.js 프로젝트

npm run dev

일반 React 프로젝트

npm start

뭘 써야 하는지 모르겠다면

package.json 파일을 열어보세요. scripts 부분을 보면 됩니다:

{
  "scripts": {
    "dev": "next dev",
    "build": "next build",
    "start": "next start"
  }
}

여기 있는 것들을 npm run 이름으로 실행할 수 있습니다.

npm run dev → 개발 모드 실행
npm run build → 배포용 빌드
npm run start → 빌드된 거 실행

실행되면 나오는 메시지

▲ Next.js 14.x.x
- Local: http://localhost:3000

이러면 브라우저에서 localhost:3000 접속하면 됩니다.

명령어 5: Ctrl+C (종료)

실행 중인 프로그램을 멈추는 단축키입니다.

npm run dev로 서버를 켰으면, 끌 때는 터미널에서 Ctrl+C를 누릅니다.

언제 쓰나요?

서버 끄고 싶을 때
뭔가 잘못 실행해서 멈추고 싶을 때
설치가 너무 오래 걸려서 취소하고 싶을 때

안 꺼지면?

Ctrl+C를 여러 번 누르거나, 터미널 창 자체를 닫으세요.

보너스: 자주 만나는 상황들

상황 1: "command not found"

npm: command not found

Node.js가 설치 안 됐거나, 터미널을 새로 열어야 합니다.

해결:

Node.js 설치 확인: nodejs.org
터미널 껐다가 다시 열기
Cursor 껐다가 다시 열기

상황 2: "permission denied"

permission denied

권한 문제입니다.

Mac/Linux 해결:

sudo npm install
// 주의! sudo는 말 그대로 '관리자' 권한으로 실행하는 겁니다. 반드시 주의하세요!

sudo는 관리자 권한으로 실행하는 겁니다. 비밀번호 입력하라고 하면 컴퓨터 비밀번호 치면 됩니다.

상황 3: "ENOENT: no such file or directory"

ENOENT: no such file or directory

파일이나 폴더가 없다는 뜻입니다.

해결:

ls로 현재 위치 확인
pwd로 어디 있는지 확인
올바른 폴더로 cd

상황 4: 뭔가 계속 출력되면서 멈추지 않음

Ctrl+C 누르세요.

로그가 계속 나오는 건 정상일 수 있습니다. 서버가 실행 중이면 로그가 계속 찍힙니다.

터미널 사용 팁

팁 1: 화살표 위/아래

이전에 쳤던 명령어를 다시 불러올 수 있습니다.

↑ 누르면 이전 명령어 ↓ 누르면 다음 명령어

매번 다 치지 않아도 됩니다.

팁 2: Tab 자동완성

cd my-까지 치고 Tab 누르면 my-todo-app으로 자동완성됩니다.

폴더 이름, 파일 이름 다 치지 않아도 됩니다.

팁 3: clear

화면이 지저분하면:

clear

화면이 깨끗해집니다. 내용이 삭제되는 건 아니고, 위로 스크롤하면 볼 수 있습니다.

팁 4: 여러 터미널 열기

Cursor에서 터미널 탭 옆에 + 버튼 있습니다.

서버 돌리면서 다른 명령어 쳐야 할 때 유용합니다.

정리: 외워야 할 것

명령어	용도	예시
cd 폴더	폴더 이동	cd my-todo-app
cd ..	상위 폴더로	cd ..
ls / dir	파일 목록	ls
npm install	패키지 설치	npm install
npm run dev	개발 서버 실행	npm run dev
Ctrl+C	종료	-

이 6개만 알면 바이브코딩하는 데 충분합니다.