바이브 코딩(Vibe Coding) 환경

초보자들이 어려워하는 환경과 관련 용어

초보자들이 입문할 때 어려워하는 부분이 용어와 환경 설정입니다. 지난번 포스팅에서 용어에 대해 정리했기 때문에 이번에는 바이브 코딩 환경에 대해 알아보겠습니다.

1. 개발 환경 및 도구 (Where & How)

코드를 작성하고, 실행하며, 컴퓨터와 소통하는 공간과 방식에 대한 용어입니다. 개발 환경은 자신에게 맞는 환경을 골라서 사용하면 됩니다.

• 1.1. IDE (통합 개발 환경)[비유: 목수의 작업실, 요리사의 주방]
  • 코드를 작성하고 실행하는 전문적인 프로그램입니다.
  • VS Code (비주얼 스튜디오 코드): 전 세계적으로 가장 많이 쓰이는 대표적인 개발 도구로, 클로드 같은 AI 모듈을 연동해 쓸 수 있습니다.

• • 커서 (Cursor AI): VS Code와 유사한 형태이나, 처음부터 강력한 AI 채팅창이 탑재되어 나와 자연어로 즉시 코드를 짤 수 있는 AI 특화 통합 프로그램입니다.
  • 참고(안티그라비티 등): 개발을 도와주는 프로그램으로 내부 내장 터미널을 포함하고 있습니다.

• 1.2. 터미널/CLI (커맨드 라인 인터페이스) [비유: 사진 없는 카톡방]
  • 마우스 클릭(GUI) 대신 검은 창에 글자(텍스트)로 명령어를 직접 한 줄씩 타이핑하여 컴퓨터를 제어하고 소통하는 환경입니다. 윈도우의 명령 프롬프트(CMD)나 파워셀(PowerShell)이 이에 해당합니다.

• 1.3. GUI (그래픽 유저 인터페이스)
  • 윈도우 화면처럼 사용자가 아이콘이나 버튼을 마우스로 클릭하며 컴퓨터와 상호작용하는 대중적인 환경입니다.

2. AI 코딩 및 프롬프트 시스템 (AI & Prompt)

바이브 코딩의 핵심인 AI의 특징, 한계, 그리고 작동 원리에 대한 용어입니다.

• 2.1. 모델 (Model) [비유: 목수나 요리사의 실력 등급]
  • AI의 두뇌 역할을 하는 인공지능 프로그램 자체(예: Claude 3.5 Sonnet)를 뜻합니다. 어떤 모델을 선택하느냐에 따라 결과물의 완성도가 달라집니다.
• 2.2. 프롬프트 (Prompt) / LLM 프롬프트[비유: 작업 지시서, 음식 주문서]
  • 자연어로 AI에게 내리는 말이나 지시문입니다. 구체적으로 주문할수록 원하는 코드가 완벽하게 출력됩니다.

• 2.3. 컨텍스트 윈도우 (Context Window) [비유: 책상의 크기]
  • AI가 한 번에 기억하고 처리할 수 있는 대화와 정보의 총량입니다. 대화가 너무 길어져 이 공간이 꽉 차면 맨 처음 대화를 잊어버리기 시작합니다.
• 2.4. 토큰 (Token) [비유: 원고지 글자 수]
  • AI가 글을 읽고 처리하는 가장 작은 단어 및 글자 단위입니다. 한글은 영어보다 토큰을 더 많이 차지하여 대화창(컨텍스트 윈도우)이 더 빨리 차게 됩니다.

• 2.5. 할루시네이션 (Hallucination) [비유: 자신감 넘치는 거짓말]
  • AI가 전혀 없는 가짜 함수나 규칙을 진짜인 것처럼 교묘하게 답하는 '환각 현상'입니다. 따라서 AI가 짠 코드는 항상 검증이 필요합니다.

• 2.6. 클로드(Claude) 제품군 구분
  • 클로드(Claude): 앤트로픽의 기본 AI '모델' 자체입니다.
  • 클로드 코드(Claude Code): 터미널(CLI) 환경에서 작동하며, 파일 수정이나 웹 검색 등의 '도구(Tool)'를 결합해 코드 생성·실행을 자동화하는 개발자 타깃의 'AI 코딩 에이전트'입니다.
  • 클로드 데스크탑 앱: 일반 채팅, 로컬 파일을 다루는 '코워크(Co-work)', 그리고 클로드 코드의 GUI 버전인 '코드' 탭을 모두 모아두어 비개발자도 쓰기 쉽게 만든 앱입니다.

3. 에이전트 및 자동화 시스템 (Agent)

단순 질의응답을 넘어 AI가 스스로 판단하고 행동하게 만드는 최신 기술 구조입니다.

• 3.1. 에이전트 (Agent) [비유: 자율주행 자동차]
  • 큰 목표(예: "로그인 기능 만들어줘")를 주면 스스로 계획을 세워 파일을 만들고, 테스트하고, 에러까지 고쳐가며 연속적으로 자율 작동하는 똑똑한 모드입니다.
• 3.2. 멀티 에이전트 (Multi-Agent) & SDK [비유: 프로젝트 팀]
  • 하나의 AI가 전담하는 것이 아니라 기획자 AI, 개발자 AI, 검수자 AI 등이 역할을 나누어 서로 협업하는 최신 구조입니다.
• 3.3. 오케스트레이션 (Orchestration) [비유: 영화 감독]
  • 다양한 AI 작업과 여러 에이전트의 전체적인 실행 순서 및 흐름을 조율하고 설계하는 기술입니다.
• 3.4. 스킬 (Skill) [비유: 요리 레시피 카드]
  • 에이전트에게 학습시키는 재사용 가능한 구체적인 작업 방법(명령 세트)입니다.
• 3.5. 훅 (Hook) [비유: 센서 등 / 자동문 정비원]
  • "코드 저장 시 자동으로 오류 테스트 실행"처럼, 특정 이벤트(상황)가 발생할 때 자동으로 지정된 스크립트가 실행되도록 만드는 장치입니다.
• 3.6. MCP (모델 컨텍스트 프로토콜) [비유: USB-C 타입으로의 통일]
  • AI와 수많은 외부 도구(인터넷 검색, 파일 편집 등)를 파편화 없이 하나의 규격으로 편리하게 연결해 주는 최신 기술 표준 규격입니다.

4. 프로그램 구조 및 기획 (Structure & Design)

프로젝트를 시작할 때 정의하는 문서와 프로그램이 돌아가는 안팎의 영역입니다.

• 4.1. PRD (제품 요구사항 명세서) [비유: 여행 계획서]
  • 코딩 전, 무엇을(What), 누가(Who), 어떤 핵심 기능(Core)으로 만들지 미리 적어 두는 기획서입니다.
• 4.2. 룰 파일 (Rule File) [비유: 신입사원 업무 매뉴얼]
  • AI 비서에게 답변 언어나 코드 스타일 등을 미리 규정해 두는 규칙 파일(claude.md, cursorrules 등)입니다.

• 4.3. 프론트엔드 (화면 개발)
  • 웹사이트의 메뉴, 색상, 스마트폰 화면 등 사용자의 눈에 보이는 영역을 만드는 기술입니다 (HTML, CSS, 리액트, 플러터 등).
• 4.4. 백엔드 (서버 개발)
  • 사용자의 눈에는 보이지 않지만, 뒤에서 데이터를 처리하는 컴퓨터 프로그램 영역입니다 (스프링부트, 노드 JS 등).

5. 소스 관리, 테스트 및 배포 (Management & Deploy)

완성된 코드를 관리하고 오류를 고쳐 세상에 공개하는 단계입니다.

• 5.1. 소스 코드 및 개발 언어
  • AI나 개발자가 짠 코드를 말하며 자바, python, 자바스크립트 등이 이에 해당합니다.
• 5.2. 컴파일 & 빌드
  • 작성된 소스 코드를 컴퓨터가 이해하고 실행할 수 있도록 하나의 완벽한 프로그램 덩어리로 뭉쳐주는 과정입니다.
• 5.3. 디버그 (Debug) [비유: 병원 진료와 처방]
  • 코드의 에러(버그)를 찾아 고치는 과정입니다. 바이브 코딩에서는 에러 창의 빨간 글씨를 AI에게 복사해 붙여넣으면 알아서 처방해 줍니다.
• 5.4. 샌드박스 (Sandbox) [비유: 과학실의 안전 방폭 유리 상자]
  • AI가 제안한 코드가 내 실제 시스템을 망가뜨리지 않도록, 격리된 안전한 가상 공간 안에서 먼저 테스트해보는 구역입니다.

• 5.5. 깃(Git) & 깃허브(GitHub) [비유: 게임의 무한 세이브 포인트]
  • 내가 만든 코드의 수정 이력(역사)을 저장하고 관리하는 시스템 및 온라인 저장소입니다. AI와 협업 중 코드가 꼬였을 때 과거 안정적인 버전으로 되돌리는 '안전벨트' 역할을 합니다.
• 5.6. 디플로이 (Deploy / 배포) [비유: 가게 오픈]
  • 내 컴퓨터에서 만든 프로그램을 인터넷에 올려 전 세계 사람들이 접속할 수 있게 주소(URL)를 만드는 최종 단계입니다.
  • 로컬 호스트(Localhost): 외부 인터넷이 아닌 '내 컴퓨터 자체'를 뜻하며, 주로 개발 중 테스트 용도로 씁니다.
  • 배포 서비스(Cloudflare / Vercel): 어려운 진짜 서버 빌드 대신, 폴더를 드래그 앤 드롭하는 것만으로도 주소(URL)를 쉽게 만들어주는 서비스입니다.

지금까지 내용을 알기 쉽게 정리하면,

6. 통신 및 데이터교환 (Network & Data)

컴퓨터와 프로그램들이 서로 대화하는 방법입니다.

• 6.1. 포트 (Port)
  • 서버 프로그램이 실행될 때 배정받는 '방 번호'입니다. 웹사이트는 80번 방, 데이터베이스는 3306번 방처럼 지정된 번호를 찾아 정보를 교환합니다.
• 6.2. HTTP 프로토콜
  • 인터넷 세상에서 컴퓨터들이 정보를 주고받기 위해 맺은 전 세계 공통 약속입니다.
• 6.3. API [비유: 소프트웨어 리모컨]
  • 서로 다른 프로그램(예: 프론트엔드와 백엔드)끼리 데이터를 요청하고 주고받을 수 있게 열어 둔 통로입니다.
• 6.4. 데이터베이스(DB) & SQL
  • 중요한 회원 정보나 게시글을 안전하게 모아두는 저장소(MySQL 등)이며, 이곳에 명령을 내릴 때 쓰는 언어를 SQL이라고 합니다.
  • 서버가 응답을 줄 때는 보통 컴퓨터가 읽기 좋은 제이슨(JSON)이라는 글자 포맷을 활용합니다.

7. 자주 묻는 질문(FAQ) 5가지 요약

Q1. 클로드(Claude)와 클로드 코드(Claude Code)의 차이는 무엇인가요?

• 클로드: 앤트로픽의 기본 AI '모델'입니다.
• 클로드 코드: 이 클로드 모델을 기반으로 파일 수정, 웹 검색 등 다양한 '도구(Tool)'를 결합하여 코드 생성 및 실행까지 자동화하는 'AI 코딩 에이전트'입니다.

Q2. 클로드 데스크탑 앱과 클로드 코드는 무슨 차이인가요?

• 클로드 코드: 터미널(CLI) 환경에서 작동하며 주로 개발자를 타깃으로 삼은 도구입니다.
• 클로드 데스크탑: 웹 버전과 같은 '채팅', AI 에이전트가 로컬 파일을 다뤄주는 '코워크(Co-work)', 그리고 클로드 코드의 GUI 버전인 '코드' 탭을 모두 모아둔 앱입니다. 비개발자도 쉽게 쓸 수 있도록 구성되어 있습니다.

Q3. 터미널(Terminal)이란 무엇인가요?

• 라틴어 '끝점(Terminal)'에서 유래한 말로, 마우스 클릭 없이 컴퓨터에게 직접 텍스트 명령을 내리는 창을 뜻합니다.
• 윈도우(Windows)의 파워셸(PowerShell), CMD 등이 이에 해당합니다. 터미널을 쓰면 여러 창을 띄워 동시에 여러 개의 클로드 코드를 실행할 수도 있습니다.

Q4. CLI와 GUI는 어떻게 다른가요?

• GUI (그래픽 유저 인터페이스): 윈도우처럼 화면을 보고 마우스로 버튼을 클릭해 상호작용하는 환경입니다.
• CLI (커맨드 라인 인터페이스): 터미널처럼 명령어를 직접 입력하는 환경입니다. 텍스트 기반이라 어색할 수 있지만, 수백 개 파일의 이름을 한 번에 바꾸는 등의 반복 작업, 명령어 조합, 자동화 스크립트 작성에 매우 강력하여 개발자들이 선호합니다.

Q5. 안티그라비티나 VS Code에서 쓰는 것과 터미널에서 쓰는 것은 차이가 있나요?

• 안티그라비티(Antigravity)나 VS Code는 개발을 도와주는 통합 개발 환경(IDE) 프로그램입니다.
• 이 IDE 내부에도 '내장 터미널'이 포함되어 있기 때문에 IDE 안의 터미널에서 클로드 코드를 실행하는 것은 일반 터미널에서 실행하는 것과 근본적으로 완전히 동일합니다. 단지 비개발자가 코드가 수정되는 모습을 시각적으로 편하게 확인하기 위해 IDE와 함께 사용할 뿐입니다.