Cursor나 Claude Code 같은 AI 코딩 도구를 사용하다 보면 “터미널에서 이 명령어를 실행하세요”라는 말을 자주 만나게 됩니다.
처음에는 검은 화면에 글자만 가득해서 어렵게 느껴질 수 있지만, 터미널은 개발자가 컴퓨터에게 명령을 전달하는 또 하나의 방법일 뿐입니다.
이번 글에서는 터미널이란 무엇인지, CLI와 터미널의 차이, 그리고 바이브코딩에서 실제로 자주 사용하는 기본 명령어를 코딩을 처음 접하는 사람도 이해할 수 있도록 하나씩 알아보겠습니다.
1. 터미널이란?
터미널(Terminal)은 문자를 입력해서 컴퓨터에게 명령을 내리는 프로그램입니다.
우리가 평소 컴퓨터를 사용할 때는 대부분 마우스를 이용합니다. 폴더를 열려면 폴더를 더블 클릭하고, 파일을 삭제하려면 휴지통으로 드래그합니다.
하지만 터미널에서는 같은 작업을 마우스 대신 명령어를 입력해서 수행합니다.
마우스로 컴퓨터를 사용하는 것이 식당 메뉴판에서 음식을 직접 선택하는 방식이라면,
터미널은 직원에게 “이 메뉴를 주세요”라고 직접 말하는 방식과 비슷합니다.
예를 들어 현재 폴더 안에 어떤 파일이 있는지 확인하고 싶다면 macOS에서는 다음과 같은 명령어를 입력할 수 있습니다.
lsWindows PowerShell에서는 다음 명령어를 사용할 수 있습니다.
dir명령어를 실행하면 현재 폴더 안의 파일과 폴더 목록이 화면에 표시됩니다.
터미널은 특별한 개발자 전용 컴퓨터가 아닙니다.
우리가 평소 마우스로 하던 작업을 문자 명령으로 실행할 수 있게 해주는 프로그램이라고 이해하면 됩니다.
2. CLI란? 터미널과 무엇이 다를까?
터미널을 배우다 보면 거의 반드시 CLI라는 단어도 만나게 됩니다.
CLI는 Command Line Interface의 약자로, 한국어로는 명령줄 인터페이스 정도로 이해할 수 있습니다.
쉽게 말하면 사용자가 명령어를 입력하고 컴퓨터가 그 명령을 실행하는 사용 방식 자체를 의미합니다.
| 구분 | GUI | CLI |
|---|---|---|
| 조작 방식 | 마우스, 버튼, 메뉴 | 문자 명령어 |
| 예시 | 파일 탐색기, Finder | Terminal, PowerShell |
| 장점 | 직관적이고 배우기 쉬움 | 빠르고 반복 작업에 유리함 |
| 개발에서의 활용 | 파일 확인, 프로그램 설정 | 서버 실행, 패키지 설치, Git 사용 |
여기서 헷갈리기 쉬운 부분이 있습니다.
터미널은 명령어를 입력하는 프로그램이고, CLI는 명령어를 통해 프로그램을 사용하는 방식입니다.
터미널 = 명령어를 입력하는 창
CLI = 명령어를 입력해서 프로그램을 사용하는 방식
3. 바이브코딩에서는 왜 터미널을 사용할까?
“AI가 코딩을 대신해주는데 굳이 터미널까지 알아야 하나?” 라고 생각할 수 있습니다.
하지만 바이브코딩을 하다 보면 AI가 작성한 코드를 설치하고, 실행하고, 확인하는 과정에서 터미널을 자주 사용하게 됩니다.
↓
AI가 코드 작성
↓
필요한 패키지 설치
↓
터미널에서 개발 서버 실행
↓
브라우저에서 결과 확인
예를 들어 Cursor에게 다음과 같이 요청했다고 해보겠습니다.
AI가 코드를 만들어준 뒤 다음과 같이 안내할 수 있습니다.
npm install을 실행한 뒤 npm run dev로 개발 서버를 실행하세요.”여기서 터미널을 전혀 모르면 AI가 코드를 잘 만들어주더라도 그다음 단계에서 막히게 됩니다.
반대로 터미널의 기본 개념과 몇 가지 명령어만 알고 있다면 AI가 알려주는 명령을 이해하고 직접 실행할 수 있습니다.
AI가 알려준 명령어가 “무엇을 하기 위한 명령인지” 정도만 이해할 수 있으면 충분합니다.
4. 터미널은 어떻게 열까?
터미널을 사용하는 첫 번째 단계는 당연히 터미널을 여는 것입니다. 운영체제에 따라 사용하는 프로그램이 조금 다릅니다.
| 운영체제 | 대표 프로그램 | 여는 방법 |
|---|---|---|
| macOS | Terminal | Spotlight에서 Terminal 검색 |
| Windows | PowerShell / Windows Terminal | 시작 메뉴에서 Terminal 검색 |
| Linux | Terminal | 배포판의 앱 목록 또는 단축키 이용 |
Cursor나 VS Code 같은 코드 에디터를 사용하고 있다면 프로그램 안에서 바로 터미널을 열 수도 있습니다.
보통 메뉴에서 Terminal → New Terminal을 선택하거나 에디터 하단의 터미널 영역을 열면 됩니다.
바이브코딩 초보자라면 처음에는 별도의 터미널 프로그램보다 Cursor나 VS Code 안에 있는 내장 터미널을 사용하는 것이 편합니다.
코드와 터미널을 한 화면에서 함께 볼 수 있기 때문입니다.
5. 가장 먼저 알아야 할 터미널 명령어
터미널 명령어는 수백 개가 넘습니다. 하지만 바이브코딩을 시작하는 단계에서 모든 명령어를 알 필요는 없습니다.
처음에는 아래 몇 가지만 이해해도 충분합니다.
| 명령어 | 역할 | 쉽게 말하면 |
|---|---|---|
pwd |
현재 위치 확인 | 지금 내가 어느 폴더에 있는지 확인 |
ls |
파일 목록 확인 | 현재 폴더 안을 둘러보기 |
cd |
폴더 이동 | 다른 폴더로 이동 |
mkdir |
폴더 생성 | 새 폴더 만들기 |
clear |
화면 정리 | 터미널 화면 비우기 |
현재 위치 확인하기: pwd
pwdpwd는 현재 터미널이 어느 폴더를 기준으로 동작하고 있는지 보여줍니다.
터미널에서는 현재 위치가 매우 중요합니다. 같은 명령어라도 어떤 폴더에서 실행했느냐에 따라 결과가 달라질 수 있기 때문입니다.
현재 폴더 내용 확인하기: ls
ls현재 폴더 안에 있는 파일과 폴더 목록을 확인합니다.
Windows PowerShell에서는 dir도 많이 사용합니다.
폴더 이동하기: cd
예를 들어 Desktop이라는 폴더로 이동하려면 다음과 같이 입력합니다.
cd Desktop한 단계 위의 폴더로 이동하려면 다음 명령어를 사용합니다.
cd ..cd는 바이브코딩에서 매우 자주 사용됩니다. 프로젝트가 들어 있는 폴더로 이동한 뒤 명령어를 실행해야 하기 때문입니다.
“프로젝트 폴더로 이동한 뒤
npm install을 실행해주세요.”이 말은 결국 다음과 같은 순서입니다.
cd my-project
npm install6. npm install은 무엇을 하는 명령어일까?
바이브코딩으로 React나 Next.js 프로젝트를 만들다 보면 가장 자주 만나게 되는 명령어 중 하나가 바로 npm install입니다.
웹서비스를 만들 때 모든 기능을 처음부터 직접 만들지는 않습니다. 다른 개발자가 이미 만들어둔 기능을 가져와 사용하는 경우가 많습니다.
이렇게 가져다 사용하는 코드 묶음을 흔히 패키지(Package)라고 부릅니다.
그리고 Node.js 기반 프로젝트에서는 이러한 패키지를 관리할 때 주로 npm을 사용합니다.
npm install이 명령어는 프로젝트에 필요한 패키지를 확인하고 내 컴퓨터에 설치해줍니다.
프로젝트의
package.json이 “이 요리를 만들 때 필요한 재료 목록”이라면,npm install은 목록에 적힌 재료를 실제로 준비하는 과정이라고 볼 수 있습니다.GitHub에서 프로젝트를 내려받았거나 AI가 새 프로젝트를 만들어준 뒤 실행이 안 된다면, 가장 먼저
npm install이 필요한지 확인해볼 수 있습니다.7. npm run dev는 왜 실행할까?
패키지 설치가 끝났다면 AI가 다음 명령어를 실행하라고 하는 경우가 많습니다.
npm run dev이 명령어는 보통 개발용 서버를 실행하는 명령어입니다.
React, Next.js 같은 웹 프로젝트는 HTML 파일 하나를 더블 클릭한다고 바로 실행되는 경우가 많지 않습니다.
대신 개발 서버를 실행한 뒤 브라우저에서 접속합니다.
npm run dev정상적으로 실행됐다면 터미널에 다음과 비슷한 주소가 표시될 수 있습니다.
http://localhost:3000이 주소를 브라우저에서 열면 현재 개발 중인 웹사이트를 확인할 수 있습니다.
↓
npm install
↓
npm run dev
↓
localhost 주소 확인
↓
브라우저에서 결과 확인
실제로 초반에는 아래 세 단계만 익숙해져도 상당히 많은 프로젝트를 실행할 수 있습니다.
cd 프로젝트폴더npm installnpm run dev8. 터미널에서 오류가 나오면 어떻게 해야 할까?
터미널을 처음 사용하는 사람이 가장 당황하는 순간은 빨간색 오류 메시지가 나타날 때입니다.
하지만 바이브코딩에서는 이 오류 메시지가 오히려 중요합니다.
왜냐하면 오류 메시지를 AI에게 그대로 전달하면 AI가 문제를 분석하는 데 필요한 정보를 얻을 수 있기 때문입니다.
“npm run dev를 실행했는데 아래 오류가 발생했어.
원인을 분석하고 해결 방법을 알려줘.”
그리고 터미널의 오류 메시지를 함께 붙여넣습니다.
즉, 바이브코딩에서는 사용자가 모든 오류를 직접 해결할 필요가 없습니다.
대신 무슨 명령어를 실행했고 어떤 오류가 발생했는지를 AI에게 정확하게 전달하는 능력이 더 중요합니다.
오류 메시지를 복사할 때 API Key, 비밀번호, 토큰처럼 외부에 공개하면 안 되는 정보가 포함되어 있지는 않은지 확인하세요.
특히
.env 파일 안의 값은 그대로 공유하지 않는 것이 좋습니다.9. 터미널 명령어는 전부 외워야 할까?
결론부터 말하면 외울 필요가 없습니다.
과거에는 개발자가 명령어와 옵션을 직접 기억해야 하는 경우가 많았습니다. 하지만 AI 코딩 도구를 사용하는 지금은 필요한 명령어를 AI에게 바로 물어볼 수 있습니다.
또는 다음처럼 상황을 설명해도 됩니다.
AI는 상황에 맞는 명령어를 알려줄 수 있습니다.
따라서 초보자가 해야 할 일은 명령어를 암기하는 것이 아니라, 터미널에서 명령어를 실행하는 흐름에 익숙해지는 것입니다.
| 굳이 외우지 않아도 되는 것 | 이해하면 좋은 것 |
|---|---|
| 수많은 CLI 옵션 | 현재 어느 폴더에 있는지 |
| 복잡한 설치 명령어 | 명령어가 무엇을 실행하는지 |
| 긴 Git 명령어 | 오류가 나면 메시지를 확인하는 방법 |
| 프레임워크별 모든 명령 | AI에게 상황을 정확히 설명하는 방법 |
10. 초보자가 꼭 알아야 할 터미널 안전수칙
AI가 알려주는 명령어를 그대로 실행할 수 있다는 것은 편리하지만, 모든 명령어를 아무 생각 없이 실행하는 습관은 좋지 않습니다.
명령어는 실제로 파일을 삭제하거나 시스템 설정을 변경할 수도 있기 때문입니다.
명령어의 의미를 모르겠다면 AI에게 먼저 “이 명령어를 실행하면 무엇이 변경돼?”라고 물어보는 습관을 들이는 것이 좋습니다.
특히 파일 삭제, 관리자 권한, 시스템 설정 변경과 관련된 명령어는 조금 더 주의해야 합니다.
예를 들어 macOS나 Linux에서는 명령어 앞에 sudo가 붙는 경우가 있습니다.
sudo는 관리자 권한으로 명령을 실행한다는 의미이므로 명령어의 목적을 이해한 뒤 사용하는 것이 좋습니다.
“AI가
sudo가 포함된 명령어를 실행하라고 했는데 이 명령어가 어떤 파일과 설정을 변경하는지 설명해줘.”11. 바이브코딩 초보자가 먼저 연습할 5가지
터미널을 공부한다고 해서 복잡한 리눅스 명령어부터 공부할 필요는 없습니다.
바이브코딩을 목표로 한다면 아래 순서대로 직접 한 번씩 실행해보는 것이 좋습니다.
pwd를 실행하고 현재 어떤 폴더에 있는지 확인합니다.ls 또는 dir로 현재 폴더의 내용을 확인합니다.cd 명령어를 사용해 프로젝트 폴더로 이동합니다.npm install을 실행해 필요한 패키지를 설치합니다.npm run dev를 실행한 뒤 브라우저에서 결과를 확인합니다.12. 정리 - 터미널을 알면 바이브코딩이 훨씬 쉬워진다
터미널은 처음 보면 어렵게 느껴지지만 실제로는 컴퓨터에게 문자로 명령을 전달하는 도구입니다.
바이브코딩을 시작하는 단계에서는 수많은 터미널 명령어를 공부하거나 외울 필요가 없습니다.
우선 아래 정도만 이해하면 충분합니다.
① 터미널은 명령어를 입력하는 프로그램입니다.
② CLI는 명령어를 이용해 프로그램을 조작하는 방식입니다.
③
pwd, ls, cd 정도부터 익히면 됩니다.④ Node.js 프로젝트에서는
npm install과 npm run dev를 자주 사용합니다.⑤ 오류가 나오면 오류 메시지를 AI에게 전달해 해결할 수 있습니다.
⑥ 처음 보는 명령어는 의미를 확인한 뒤 실행하는 습관이 중요합니다.
이제 Cursor나 Claude Code가 “터미널에서 이 명령어를 실행해주세요”라고 말해도 예전처럼 막막하지 않을 것입니다.
다음 단계에서는 바이브코딩 과정에서 거의 반드시 만나게 되는 Git과 GitHub를 알아보겠습니다.
Git을 이해하면 AI가 코드를 잘못 수정하더라도 이전 상태로 돌아가거나, 프로젝트의 변경 기록을 관리하고 GitHub에 코드를 저장할 수 있게 됩니다.
🔗 바이브코딩 입문 시리즈