기본 개념
11개 용어AI와 자연어로 대화하며 코드를 작성하는 프로그래밍 방식. 전통적인 코딩 문법을 몰라도 아이디어를 소프트웨어로 구현할 수 있다.
AI에게 전달하는 요청이나 지시문. 명확하고 구체적으로 작성할수록 원하는 결과를 얻을 확률이 높아진다.
AI가 요청을 이해하는 데 필요한 배경 정보. 현재 코드, 프로젝트 구조, 이전 대화 내용이 포함된다.
데이터를 저장하는 이름 붙은 공간. 숫자, 텍스트, 참/거짓 등 다양한 값을 담을 수 있다.
const userName = "홍길동"특정 작업을 수행하는 코드 묶음. 입력을 받아 처리하고 결과를 반환한다. 재사용 가능하다.
function calculateTotal(price, tax)텍스트 데이터 타입. 따옴표로 감싸서 표현한다.
"안녕하세요" 또는 'Hello World'여러 개의 데이터를 순서대로 저장하는 자료구조. 인덱스로 접근한다.
const fruits = ["사과", "바나나", "오렌지"]키-값 쌍으로 데이터를 저장하는 자료구조. 관련 정보를 그룹화할 때 사용한다.
{ name: "홍길동", age: 25 }데이터를 주고받을 때 사용하는 텍스트 형식. 사람이 읽기 쉽고 대부분의 프로그래밍 언어에서 지원한다.
JavaScript에 타입 시스템을 추가한 언어. 코드 작성 시 오류를 미리 잡아준다.
function greet(name: string): string라이브러리는 가져다 쓰는 코드 부품, 프레임워크는 앱의 뼈대까지 정해주는 큰 틀. 바이브 코딩에서는 AI가 골라주지만 이름은 알아두면 대화가 쉽다.
프론트엔드
12개 용어사용자가 직접 보고 상호작용하는 화면 부분. HTML, CSS, JavaScript로 구성된다.
UI를 구성하는 재사용 가능한 독립적인 조각. 버튼, 카드, 네비게이션 바 등이 컴포넌트가 될 수 있다.
<Button />, <Card />, <Header />Meta(Facebook)가 만든 UI 라이브러리. 컴포넌트 기반으로 효율적인 화면 업데이트가 가능하다.
React 기반의 풀스택 프레임워크. 서버 사이드 렌더링, 라우팅, API 등을 기본 제공한다.
컴포넌트가 기억하고 있는 데이터. 변경되면 화면이 자동으로 다시 렌더링된다.
const [count, setCount] = useState(0)부모 컴포넌트가 자식 컴포넌트에게 전달하는 데이터. 읽기 전용이다.
<Button color="blue" size="large" />React에서 상태와 생명주기 기능을 사용할 수 있게 해주는 함수들.
useState, useEffect, useContext유틸리티 클래스 기반의 CSS 프레임워크. 미리 정의된 클래스로 빠르게 스타일링할 수 있다.
className="bg-blue-500 text-white p-4"다양한 화면 크기(모바일, 태블릿, 데스크톱)에 맞게 레이아웃이 자동 조정되는 디자인.
md:flex-row sm:flex-colURL에 따라 다른 페이지/컴포넌트를 보여주는 것. SPA에서 페이지 전환을 처리한다.
/about → About 페이지, /products/123 → 상품 상세데이터를 화면에 표시하는 과정. CSR(클라이언트), SSR(서버), SSG(정적 생성) 방식이 있다.
페이지 전체를 새로고침하지 않고 필요한 부분만 업데이트하는 웹 애플리케이션 방식.
백엔드
11개 용어서버 측 로직을 처리하는 부분. 데이터 저장, 인증, 비즈니스 로직 등을 담당한다.
프로그램 간 데이터를 주고받는 인터페이스. 프론트엔드가 백엔드에 요청할 때 사용한다.
HTTP 메서드(GET, POST, PUT, DELETE)를 활용한 API 설계 방식. 가장 널리 사용된다.
API가 요청을 받는 특정 URL 주소. 각 기능별로 다른 엔드포인트를 가진다.
/api/users, /api/products/:idJavaScript를 서버에서 실행할 수 있게 해주는 런타임. 프론트엔드와 같은 언어로 백엔드 개발이 가능하다.
요청과 응답 사이에서 실행되는 함수. 인증 체크, 로깅, 에러 처리 등에 사용된다.
사용자가 누구인지 확인하는 과정. 로그인, 회원가입, 세션 관리 등을 포함한다.
사용자 인증 정보를 담은 토큰. 서버에 세션을 저장하지 않아도 인증 상태를 유지할 수 있다.
비동기 작업을 동기 코드처럼 작성할 수 있게 해주는 문법. API 호출, 파일 읽기 등에 사용.
const data = await fetch('/api/users')서버 관리 없이 코드만 배포하는 방식. 요청이 있을 때만 실행되어 비용 효율적이다.
외부 서비스를 쓸 자격을 증명하는 비밀번호. 코드에 그대로 적거나 깃허브에 올리면 남이 내 돈으로 쓴다. 환경 변수에 보관한다.
OPENAI_API_KEY=sk-... 는 .env 파일에만데이터베이스
8개 용어데이터를 구조화하여 저장하는 시스템. 사용자 정보, 게시글, 주문 내역 등을 보관한다.
Firebase의 오픈소스 대안. PostgreSQL 기반으로 인증, 스토리지, 실시간 기능을 제공한다.
데이터베이스의 구조 설계도. 어떤 테이블에 어떤 필드가 있는지 정의한다.
데이터베이스에 데이터를 요청하거나 조작하는 명령문. SQL 언어를 사용한다.
SELECT * FROM users WHERE age > 20데이터의 기본 4가지 작업. 생성(Create), 조회(Read), 수정(Update), 삭제(Delete).
데이터베이스를 객체처럼 다룰 수 있게 해주는 도구. SQL 없이 데이터를 조작할 수 있다.
데이터베이스 스키마 변경을 버전 관리하는 것. 테이블 추가, 필드 변경 등의 이력을 관리한다.
npx prisma migrate dev테이블 간의 연결. 1:1, 1:N, N:M 관계가 있다. 사용자-게시글처럼 데이터를 연결한다.
배포/인프라
10개 용어개발한 애플리케이션을 서버에 올려 다른 사람들이 접근할 수 있게 하는 것.
Next.js를 만든 회사의 호스팅 플랫폼. Git 연동으로 자동 배포되며 무료 플랜이 넉넉하다.
웹사이트나 애플리케이션을 인터넷에서 접근 가능하게 서버 공간을 제공하는 서비스.
웹사이트의 고유한 주소. IP 주소 대신 기억하기 쉬운 이름을 사용한다.
API 키, 비밀번호 등 코드에 직접 노출하면 안 되는 설정값. .env 파일에 보관한다.
DATABASE_URL=postgres://...코드 변경 시 자동으로 테스트하고 배포하는 파이프라인. Git push만 하면 자동 배포된다.
소스 코드를 실행 가능한 형태로 변환하는 과정. 최적화, 번들링, 컴파일이 포함된다.
npm run build웹사이트 통신을 암호화하는 보안 프로토콜. 주소창에 자물쇠 아이콘이 표시된다.
전 세계에 분산된 서버 네트워크. 사용자와 가까운 서버에서 콘텐츠를 제공해 속도가 빠르다.
애플리케이션을 컨테이너라는 격리된 환경에서 실행하는 기술. 어디서든 동일하게 동작한다.
Git/버전관리
8개 용어코드의 변경 이력을 추적하고 관리하는 버전 관리 시스템. 협업과 백업에 필수다.
Git 저장소를 호스팅하는 웹 서비스. 코드 저장, 협업, 오픈소스 프로젝트 참여가 가능하다.
프로젝트의 모든 파일과 변경 이력을 저장하는 공간. 줄여서 repo라고 부른다.
코드 변경사항을 저장하는 단위. 변경 내용을 설명하는 메시지와 함께 기록한다.
git commit -m "로그인 기능 추가"독립적으로 작업할 수 있는 코드의 분기점. 기능 개발 후 메인 브랜치에 병합한다.
변경사항을 메인 브랜치에 병합해달라고 요청하는 것. 코드 리뷰를 거친 후 병합된다.
Push: 로컬 → 원격 업로드. Pull: 원격 → 로컬 다운로드. Clone: 저장소 복제.
git push, git pull, git clone머지: 브랜치를 합치는 것. 충돌: 같은 부분을 다르게 수정했을 때 발생하며 수동 해결 필요.
AI 코딩
22개 용어대규모 텍스트 데이터로 학습한 AI 모델. GPT-6, 클로드, 제미나이 계열이 있다.
AI가 텍스트를 처리하는 단위. 대략 영어 4글자, 한글 1-2글자 정도. 비용 계산 기준이 된다.
AI가 한 번에 기억할 수 있는 최대 토큰 수. 차면 앞 대화가 요약되거나 잘린다. 클로드 코드에서는 /context로 얼마나 찼는지 본다.
AI가 사실이 아닌 정보를 마치 사실인 것처럼 생성하는 현상. 항상 결과를 검증해야 한다.
파일을 읽고 고치고 명령을 실행하는 것까지 스스로 하는 AI. 답만 주는 챗봇과 달리 행동할 수 있는 도구를 가졌다. 코딩용이면 코딩 에이전트라 부른다.
AI 기능이 내장된 코드 에디터. VSCode 기반으로 자연어로 코드를 생성하고 수정할 수 있다.
앤트로픽의 코딩 에이전트. 터미널, VS Code, 데스크톱 앱, 웹에서 쓰며 코드베이스를 읽고 파일을 고치고 명령을 실행한다. 프로젝트 지시문은 CLAUDE.md에 둔다.
claude 입력으로 시작AI를 외부 도구와 데이터에 연결하는 공개 표준. 슬랙, 노션, 데이터베이스, 브라우저를 AI가 직접 다루게 해준다. 클로드 코드와 코덱스 모두 지원.
/mcp로 연결 상태 확인외부 문서를 검색해서 AI 응답에 활용하는 기술. 최신 정보나 특정 문서 기반 답변이 가능하다.
오픈AI의 코딩 에이전트. CLI, IDE 확장, 클라우드, 챗GPT 앱에서 쓴다. 프로젝트 지시문은 AGENTS.md에 둔다.
프로젝트 폴더에 두는 지시문 파일. 세션을 시작할 때마다 에이전트가 먼저 읽는다. 코딩 규칙, 폴더 구조, 하지 말 것을 적는다.
프롬프트 한 줄이 아니라, AI가 보는 정보 전체(규칙 파일, 열어둔 파일, 도구, 이전 결과)를 설계하는 일. 에이전트 결과 차이는 대부분 여기서 난다.
파일을 고치기 전에 조사하고 계획만 보여주는 권한 모드. 읽기와 검색은 하되 수정은 승인 뒤에 한다.
Shift+Tab 또는 /plan에이전트가 행동하기 전에 물어볼지 정하는 설정. 매번 묻는 기본 모드부터 편집은 자동 승인, 계획만, 거의 안 묻는 모드까지 단계가 있다.
Shift+Tab으로 순환메인 대화와 별도 컨텍스트를 가진 보조 에이전트. 큰 탐색이나 검토를 맡기고 요약만 돌려받아 메인 컨텍스트를 아낀다.
반복하는 작업 절차를 SKILL.md 파일로 묶어 둔 것. 필요할 때 에이전트가 알아서 불러오거나 /이름으로 직접 부른다.
/review-pr, /deploy-staging에이전트의 특정 시점(파일 수정 뒤, 명령 실행 전, 세션 시작)에 자동으로 도는 사용자 정의 동작. 리액트 훅과는 다른 뜻.
컨텍스트가 차면 앞선 대화를 요약해 자리를 비우는 동작. 요약되면서 대화로만 준 지시는 빠질 수 있어, 중요한 규칙은 규칙 파일에 적는다.
/compact프롬프트를 보낼 때마다 만들어지는 복구 지점. 에이전트가 파일을 망쳤을 때 코드나 대화를 그 시점으로 되돌린다. 깃과는 별개.
Esc 두 번 또는 /rewind같은 저장소를 다른 폴더와 브랜치로 하나 더 열어 두는 깃 기능. 에이전트 여럿을 동시에 돌릴 때 서로 파일을 건드리지 않게 한다.
claude -w모델에게 파일 접근, 명령 실행, 권한 확인, 작업 반복 고리를 붙여 일하게 만드는 틀. 클로드 코드가 하네스이고 그 안의 클로드가 모델이다.
만들 것의 목적, 사용자, 기능, 안 만들 것을 적은 기획 문서. 바이브 코딩에서는 이 문서를 먼저 쓰고 AI에게 주면 덜 헤맨다.
기본 명령어
7개 명령어프로젝트를 초기화하고 CLAUDE.md 파일을 생성한다. 새 프로젝트 시작 시 가장 먼저 실행하는 명령어.
/init 실행현재까지의 대화 기록을 모두 초기화한다. 새로운 주제로 대화를 시작하거나 컨텍스트를 정리할 때 사용.
/clear로 리셋대화 내용을 요약하여 컨텍스트를 가볍게 유지한다. 긴 대화로 토큰이 부족할 때 유용.
/compact이전 세션을 이어서 계속 작업한다. 중단했던 작업을 다시 시작할 때 사용.
/resume조사와 계획만 하는 플랜 모드로 들어간다. 큰 기능을 시작할 때 먼저 켠다.
/plan 뒤에 할 일을 설명코드나 대화를 이전 체크포인트로 되돌린다. 에이전트가 엉뚱하게 고쳤을 때 쓴다.
Esc 두 번으로도 열린다세션의 모델을 바꾼다. 가벼운 일은 빠른 모델, 어려운 일은 큰 모델로.
/model 입력 후 선택개발 도구
9개 용어통합 개발 환경. 코드 작성, 실행, 디버깅을 한 곳에서 할 수 있는 도구.
텍스트 명령어로 컴퓨터를 조작하는 인터페이스. 개발자 필수 도구다.
npm install, git pushJavaScript 패키지를 설치하고 관리하는 도구. 라이브러리 설치, 스크립트 실행에 사용한다.
npm install axios프로젝트 정보와 의존성을 정의하는 설정 파일. 프로젝트의 "신분증" 같은 역할을 한다.
프로젝트가 동작하기 위해 필요한 외부 패키지들. package.json에 명시된다.
npm install로 의존성 설치설치된 패키지들이 저장되는 폴더. 용량이 크므로 Git에 올리지 않는다.
코드 품질 검사(린터)와 스타일 자동 정리(포매터) 도구. 일관된 코드 작성을 도와준다.
개발 모드: 빠른 리로드, 상세 에러. 프로덕션: 최적화된 배포용 빌드.
npm run dev vs npm run build내 컴퓨터 안에서만 열리는 임시 주소. 뒤에 붙는 숫자가 포트. 배포 전에는 이 주소로 결과를 확인한다.
http://localhost:3000에러/디버깅
10개 용어코드의 오류를 찾아 수정하는 과정. console.log, 브레이크포인트 등을 활용한다.
브라우저나 터미널에 메시지를 출력하는 함수. 디버깅의 기본 도구다.
console.log("현재 값:", data)요청한 페이지나 리소스를 찾을 수 없음. URL 오타, 삭제된 페이지 등이 원인.
서버 내부에서 오류가 발생함. 백엔드 코드 문제, DB 연결 실패 등이 원인.
다른 도메인 간 데이터 요청이 보안 정책에 의해 차단됨. 서버 설정으로 해결한다.
undefined: 값이 할당되지 않음. null: 의도적으로 비어있음을 표시.
코드 문법이 잘못됨. 괄호, 세미콜론, 따옴표 누락이 주요 원인.
Unexpected token 에러 메시지잘못된 타입의 값을 사용했을 때 발생. 문자열에 숫자 메서드 사용 등.
TypeError: xxx is not a functionimport한 모듈이나 패키지를 찾을 수 없음. npm install 누락, 경로 오타가 원인.
npm install 실행 또는 import 경로 확인해당 포트를 이미 다른 프로세스가 사용 중. 이전 서버를 종료하거나 포트를 변경한다.
실전 팁
바이브 코딩 꿀팁에러 메시지를 그대로 복사해서 AI에게 물어보면 대부분 해결책을 알려준다. 당황하지 말고 복붙하자.
"전체 앱 만들어줘"보다 "로그인 버튼 만들어줘"가 훨씬 좋은 결과를 낸다. 작게 나눠서 요청하자.
AI가 만든 코드가 의도대로 동작하는지 항상 테스트한다. 브라우저에서 직접 클릭해보고 확인하자.
"이게 무슨 뜻이야?", "왜 이렇게 했어?"라고 물어보면 AI가 친절하게 설명해준다. 부끄러워하지 말자.
관련 파일을 열어두거나, 현재 상황을 설명해주면 AI가 더 정확한 답변을 할 수 있다.
작동하는 상태에서 자주 커밋해두면 문제가 생겼을 때 되돌릴 수 있다. 보험이라고 생각하자.
git commit복잡한 기능은 바로 코딩하지 말고 플랜 모드로 먼저 계획을 받자. AI가 조사와 계획만 하고, 승인한 뒤 파일을 고친다.
Shift+Tab 또는 /planAI가 코드를 잘못 수정했을 때 당황하지 말자. Undo나 Revert 기능으로 이전 상태로 쉽게 복구할 수 있다.
Cmd+Z / Ctrl+Z, 클로드 코드는 Esc 두 번 또는 /rewind