클로드 바이브코딩 기초반/바이브코딩 가이드

부록

부록 C · 용어 사전

이 가이드에 나온 말 + 수업 밖에서 자주 보는 AI·코딩·세컨드브레인 말. 정의보다 비유로 적었습니다. Claude가 이 말을 쓰면 여기서 찾으세요.

AI와 대화

말 뜻
프롬프트 AI에게 보내는 요청문. 이 가이드에서는 '지시문'이라고도 씁니다
역할 · 맥락 · 출력형식 지시문의 세 요소. 어느 자리에서, 무슨 상황에서, 어떤 결과물로
환각 (할루시네이션) AI가 모르는 것을 아는 것처럼 그럴듯하게 지어내는 것. 숫자·날짜·법률·출처에서 잦음
교차검증 같은 질문을 다른 AI에게 던지거나 원문과 대조해 확인하는 것
컨텍스트 (기억 공간) 한 대화에서 AI가 기억하는 범위. 대화가 길어지면 차서 답이 흐려집니다. 새 대화·/clear로 비웁니다
아티팩트 claude.ai 채팅에서 옆에 뜨는 결과물 창. 1장의 계산기가 여기 뜹니다
프로젝트 claude.ai에서 지침과 자료를 담아 두는 방. 그 방의 모든 대화에 자동 적용
지침 프로젝트에 저장된 규칙. 역할·상황·규칙·출력형식 네 칸
Second Brain 내 자료를 한 곳에 모으고 AI가 찾을 수 있게 정리한 두 번째 뇌
Skill (SKILL.md) 반복 업무의 인수인계서. 순서와 양식을 담은 텍스트 파일
CLAUDE.md Claude Code가 대화 시작 때마다 읽는 폴더 규칙 파일. 신입 매뉴얼 한 장
.md (마크다운) 메모장으로 열리는 순수 텍스트. #은 제목, -은 목록

만들기

말 뜻
바이브코딩 코드를 직접 쓰지 않고 AI에게 말로 시켜 만들고, 확인하고, 고치는 방식
Claude Code 내 컴퓨터의 폴더 안에서 파일을 직접 만들고 고치는 Claude
VS Code Claude Code가 일하는 작업실. 파일 목록과 내용이 보이는 프로그램
확장 (Extension) VS Code에 붙이는 부가 기능. Claude Code 확장이 그중 하나
터미널 · 명령줄 (CLI) 글자로 명령을 치는 검은 창. 이 가이드에서는 Claude가 대신 칩니다
권한 모드 Claude Code가 파일을 고치기 전에 물을지 말지 정하는 설정. Manual · Edit automatically · Plan · Auto
Plan 모드 바로 만들지 않고 계획만 보여 주고 승인을 기다리는 모드
되감기 (rewind) 요청 전 상태로 대화·파일을 되돌리는 것
index.html 홈페이지의 첫 화면 파일. 가게 정문
폴더 = 작업 책상 Claude Code는 VS Code에 열린 폴더 하나 안에서만 일합니다
v1 돌아가는 첫 버전. 완벽한 버전이 아니라 실제로 쓰는 첫 버전
꼭 · 있으면 좋음 · 다음에 기능 우선순위 세 칸
입력 → 출력 서비스를 한 문장으로 설명하는 틀. "○○를 넣으면 ○○가 나온다"

공개하기

말 가게 비유 뜻
Git 버전 기록기 '최종_진짜최종(2)'를 없애는 도구. 저장할 때마다 기록이 남고 되돌릴 수 있음
GitHub 창고 Git 기록을 올려 두는 인터넷 창고
저장소 (repository) 창고 한 칸 프로젝트 하나의 파일과 기록이 들어 있는 곳
커밋 (commit) 창고 입고 기록 "언제 무엇을 바꿨는지" 한 줄과 함께 저장하는 것
푸시 (push) 창고에 올리기 내 컴퓨터의 저장을 GitHub에 올리는 것. "GitHub에 올려줘"
브랜치 (main) 기본 진열대 저장 기록의 줄기. 우리는 main 하나만 씁니다
Private / Public 잠근 창고 / 열린 창고 저장소를 남이 볼 수 있는지. 우리는 Private
.gitignore 창고 반입 금지 목록 GitHub에 올리지 않을 파일 이름 목록. .env 같은 비밀 파일
서버 24시간 문 여는 매장 건물 인터넷에 늘 켜져 있는 남의 컴퓨터
호스팅 매장 자리 임대 서버 자리를 빌려주는 서비스
Vercel 매장 창고(GitHub)를 지켜보다 자동으로 공개하는 호스팅 서비스
배포 (deploy) 진열 창고 물건을 매장에 내놓는 것. push하면 자동
URL · 주소 간판과 주소 ○○.vercel.app 같은 접속 주소
도메인 내 상호 간판 ○○.vercel.app 대신 내 이름의 주소. 사서 연결
Framework Preset 조립 방식 Vercel이 사이트 종류를 추측한 것. 우리는 Other
localhost 작업실 안 시제품 내 컴퓨터에서만 열리는 주소

보안

말 뜻
API 키 다른 회사 기능(AI·지도·문자)을 쓰는 열쇠 = 비밀번호. 파일·GitHub·채팅·캡처 어디에도 안 넣음
.env · 환경변수 비밀 키를 코드 밖에 따로 두는 파일·방법. GitHub에는 안 올림
개인정보 이름·연락처·주소처럼 사람을 특정하는 정보. 가리고 넣거나 넣지 않음
넣지 않기 · 가리고 넣기 · 확인 후 넣기 5장의 세 칸
RLS (행 단위 접근 제한) 데이터 창고에서 남의 데이터를 못 보게 막는 규칙. v4에서 나옴
Supabase 데이터 저장 창고 서비스. v4에서 나옴

화면

말 뜻
반응형 · 휴대폰 화면 화면 폭에 따라 배치가 바뀌는 것. F12 → Ctrl+Shift+M으로 미리 보기
섹션 한 장짜리 홈페이지의 한 덩어리. 첫 화면·소개·서비스·FAQ·연락처
카드 제목·설명·사진이 든 네모 한 칸
버튼 · CTA 누르면 행동이 일어나는 것. 전화·메일·신청
☰ 메뉴 (햄버거) 폰에서 접히는 위쪽 메뉴
F12 · 개발자 도구 브라우저의 속을 보는 창. Console 탭에 빨간 줄이 오류
F5 새로고침. 고칠 때마다
캐시 브라우저가 기억한 옛 화면. 바뀐 게 안 보이면 잠시 뒤 다시 새로고침

다음 단계 (18장)

말 뜻
MCP Claude Code에 바깥 도구(노션·DB·브라우저)를 연결하는 규격
훅 (hook) 특정 순간에 무조건 실행되는 명령. 규칙을 강제할 때
서브에이전트 조사를 맡길 별도의 Claude. 본 대화를 깨끗하게
플러그인 Skill·훅·MCP를 한 묶음으로 설치하는 것
루틴 · 예약 작업 정해진 시간에 자동으로 도는 작업

AI 기본기

말 뜻
LLM (대형 언어 모델) 아주 많은 글을 읽고 '다음에 올 말'을 맞히도록 학습한 AI. Claude·ChatGPT·Gemini의 바탕
생성형 AI 글·그림·영상·소리를 새로 만들어 내는 AI. 고르거나 판별만 하는 AI와 구분하는 말
GPT OpenAI가 만든 LLM 이름. ChatGPT가 이것으로 돌아감. 요즘은 AI 채팅 전체를 'GPT'라 부르기도 함
토큰 AI가 글을 읽고 쓰는 단위. 단어보다 잘게 쪼갠 조각. 기억 한도·사용량·요금이 토큰으로 계산됨
컨텍스트 윈도우 컨텍스트(기억 공간)에 한 번에 담을 수 있는 최대 크기. 토큰 수로 셈. 넘치면 앞 내용이 요약되거나 밀려남
시스템 프롬프트 대화 시작 전에 AI에게 미리 깔아 두는 지시. 사용자 눈에는 안 보임. 프로젝트 지침·CLAUDE.md가 비슷한 역할
컨텍스트 엔지니어링 AI가 일하기 전에 무엇을 읽게 할지 고르고 다듬는 일. 지시문 한 줄보다 '함께 넣는 자료'를 챙기는 쪽. 세컨드브레인 정리가 여기에 해당
온도 (Temperature) 답이 얼마나 들쭉날쭉할지 정하는 설정값. 낮으면 매번 비슷한 답, 높으면 다양하고 엉뚱한 답. 채팅 앱에는 이 칸이 없음
파라미터 AI 모델 안에 든 수많은 조절값. 학습으로 정해지고, 많을수록 큰 모델. '○○B'의 B는 10억 개. 코딩에서는 함수에 넘기는 입력값을 뜻하기도 함
학습 (트레이닝) 많은 자료를 보여 주며 모델의 파라미터를 맞춰 가는 과정. 모델을 만드는 회사가 하는 일. 내 대화 한 번이 그 자리에서 모델을 바꾸지는 않음
추론 (인퍼런스) 학습이 끝난 모델이 질문을 받아 답을 만드는 것. 우리가 채팅할 때 일어나는 일. '따져 보고 생각한다'는 뜻의 추론(reasoning)과는 다른 말
파인튜닝 이미 학습된 모델에 특정 분야 자료를 더 학습시켜 맞춤형으로 만드는 것. 자료와 비용이 듦. 이 수업은 파인튜닝 대신 지침·Skill로 맞춤
임베딩 글의 뜻을 숫자 목록으로 바꾼 것. 뜻이 비슷하면 숫자도 가까워서, 단어가 달라도 비슷한 내용을 찾을 수 있음
RAG (검색 증강 생성) 답하기 전에 관련 자료를 먼저 찾아 읽고, 그 내용을 근거로 답하는 방식. Claude가 세컨드브레인 폴더를 찾아보고 답하는 것과 비슷한 흐름
멀티모달 글뿐 아니라 그림·소리·영상까지 함께 다루는 AI. 사진을 올리고 "이거 뭐야?" 묻는 것이 가능
에이전트 한 번 답하고 끝나지 않고, 스스로 계획을 세워 도구를 쓰고 결과를 확인하며 일을 끝까지 하는 AI. Claude Code가 대표 예
툴 콜 (도구 호출) AI가 일하는 중에 바깥 도구(검색·파일 읽기·계산)를 불러 쓰는 것. Code 탭에서 Claude가 파일을 읽고 고칠 때마다 한 줄씩 보이는 것이 그 기록
오케스트레이션 여러 AI·도구·단계를 순서에 맞게 지휘해 하나의 일로 엮는 것. 오케스트라 지휘자처럼
워크플로우 일이 처리되는 정해진 순서. '자료 모으기 → 정리 → 검수 → 발행'처럼 단계를 적어 두면 Skill로 만들기 쉬움

그림·영상·목소리 AI

말 뜻
t2i (글→그림) Text to Image. 글로 설명하면 그림을 만들어 주는 것. ChatGPT·Gemini의 그림 만들기, 미드저니 등
t2v (글→영상) Text to Video. 글 설명만으로 짧은 영상을 만드는 것. Veo·Sora·Kling 등
i2v (그림→영상) Image to Video. 그림 한 장을 첫 장면으로 삼아 움직이는 영상을 만드는 것. t2v보다 인물·배경을 원하는 대로 잡기 쉬움
디퓨전 (Diffusion) 많은 그림·영상 AI가 쓰는 방식. 지지직한 잡음에서 시작해 잡음을 조금씩 걷어 내며 그림을 완성
시드 (Seed) 그림 생성의 출발점이 되는 번호. 같은 글·같은 설정·같은 시드면 거의 같은 그림이 나옴. 마음에 든 그림을 다시 뽑으려면 기록
LoRA (로라) 큰 모델에 덧붙이는 작은 추가 학습 파일. 특정 인물·화풍을 적은 수의 사진으로 익히게 할 때 씀
캐릭터 시트 한 인물을 앞·옆·뒤·표정별로 한 장에 모은 설정 그림. 여러 장면에서 같은 얼굴·옷을 유지하는 기준
인페인팅 그림의 일부만 칠해서 지정하고 그 부분만 새로 그리게 하는 것. 손가락·글자 고치기, 물건 지우기
업스케일 작은 그림·영상을 크게 키우면서 흐려지지 않게 디테일을 채워 넣는 것
TTS (글→목소리) Text to Speech. 글을 목소리로 읽어 주는 것. 영상 내레이션에 씀
STT (목소리→글) Speech to Text. 말을 글로 받아 적는 것. 회의 녹음 → 회의록. 클로바노트 등
보이스 클론 한 사람의 목소리 녹음을 익혀 그 목소리로 아무 글이나 읽게 하는 것. 남의 목소리는 본인 동의 없이 쓰지 않음

세컨드브레인

말 뜻
Vault (볼트) 세컨드브레인으로 쓰는 폴더 전체. 옵시디언에서 쓰는 이름. 내 자료가 다 들어 있는 금고
PKM (개인 지식 관리) Personal Knowledge Management. 배운 것·메모·자료를 모으고 정리해 다시 찾아 쓰는 습관과 방법
링크 · 위키링크 [[ ]] 노트끼리 잇는 표시. [[노트 이름]]처럼 대괄호 두 겹. 옵시디언에서 누르면 그 노트로 이동. 일반 마크다운 링크는 [보이는 글](주소) 모양
Frontmatter (머리말) .md 파일 맨 위 --- 두 줄 사이의 정보 칸. 제목·날짜·태그를 적어 두면 AI가 분류·검색에 씀. SKILL.md의 name·description도 여기
_INDEX.md (목차 파일) 폴더 안에 무엇이 어디 있는지 적은 목차. AI가 폴더를 다 뒤지지 않고 이것부터 읽어 길을 찾음. 이름 앞 _는 일반 자료와 구분하는 표시
_inbox (수신함) 어디 둘지 모르는 메모를 일단 던져 두는 폴더. 주기적으로 정리해 제자리로 옮김
_archive (보관함) 지금은 안 쓰지만 버리기 아까운 파일을 옮겨 두는 폴더. 지우지 않고 치워 두는 곳
_log.md (작업 로그) 언제 무엇을 했는지 날짜별로 한 줄씩 쌓는 기록 파일. 다음 대화의 Claude가 이걸 읽고 이어서 일함
박제 그때의 판단·근거·감정을 그대로 남기고 나중에 고치지 않는 기록. 결정 기록이 대표. 돌아볼 땐 새 파일에 따로 씀
Supersede (새 값으로 교체) 값이 바뀌면 현재 파일만 새 값으로 바꾸고, 옛 값은 history 폴더로 옮겨 남기는 방식. 자산·현황처럼 계속 바뀌는 정보에 씀
마스킹 민감한 정보의 일부를 *로 가리는 것. 010-****-1234처럼. 5장의 '가리고 넣기'
장기기억 대화가 끝나도 남는 기억. 대화 속 기억(컨텍스트)은 새 대화에서 사라지므로, 파일에 적어 두는 것이 가장 확실한 장기기억
기억 4층 (procedural · semantic · episodic · working) 자료를 성격별로 나눈 네 칸. 원칙·절차(잘 안 바뀜) · 사실(자산·지식, 가끔 갱신) · 사건(일기·결정, 그때 그대로) · 작업 중(분류 전 메모)
온톨로지 개념들이 서로 어떻게 이어지는지 정해 둔 지도. '고객 – 주문 – 상품'처럼. 폴더·태그 체계를 짤 때의 설계도
슬래시 명령 (/이름) 입력창에 /로 시작해 치는 단축 명령. /clear 같은 기본 명령도 있고, 내가 만든 Skill도 /스킬이름으로 부를 수 있음

코딩 기초 더

말 뜻
HTML 웹페이지의 뼈대를 적는 언어. 제목·글·사진·버튼이 어디에 있는지 정함
CSS 웹페이지의 꾸밈을 정하는 언어. 색·글씨 크기·배치·여백
자바스크립트 (JS) 웹페이지를 움직이게 하는 언어. 버튼 반응·계산·화면 바꾸기. 이름이 비슷한 Java와는 다른 언어
파이썬 (Python) 문법이 읽기 쉬운 프로그래밍 언어. 자동화·데이터 정리·AI 작업에 많이 씀. Claude가 내 컴퓨터에서 일을 처리할 때도 자주 씀
JSON 데이터를 {"이름": "값"} 모양으로 적는 텍스트 형식. 프로그램끼리 정보를 주고받을 때 가장 흔히 씀
YAML 이름: 값을 줄마다 적고 들여쓰기로 묶는 설정 파일 형식. Frontmatter가 이 형식
파일 확장자 파일 이름 끝 . 뒤의 글자. .html·.md·.py처럼 파일 종류를 알려 줌. 윈도우에서는 기본으로 숨겨져 있을 수 있음
경로 (path) 파일이 있는 위치를 폴더 순서대로 적은 주소. C:\Users\…\문서\메모.md처럼
폴더 구조 폴더 안에 폴더를 어떻게 나눠 두었는지의 모양. 잘 짜 두면 사람도 AI도 자료를 빨리 찾음
스크립트 정해진 일을 자동으로 처리하도록 적은 짧은 프로그램 파일. 파일 이름 바꾸기·자료 모으기 같은 반복 작업에
라이브러리 남이 미리 만들어 둔 기능 묶음. 가져다 쓰면 처음부터 만들 필요가 없음
프레임워크 프로그램의 기본 틀과 규칙을 정해 주는 큰 뼈대. 라이브러리는 내가 골라 부르고, 프레임워크는 그 틀 안에 내 코드를 채워 넣음. Next.js 등
패키지 라이브러리·도구를 설치하기 좋게 한 덩어리로 묶은 것. 버전과 함께 필요한 다른 패키지 정보가 들어 있음
Node · npm Node = 브라우저 밖에서도 자바스크립트를 돌리는 프로그램. npm = Node용 패키지를 내려받아 설치해 주는 도구
프론트엔드 사용자 눈에 보이고 손이 닿는 쪽. 화면·글·버튼. 가게로 치면 손님이 앉는 홀
백엔드 눈에 안 보이는 뒤쪽. 로그인 확인·데이터 저장·계산을 서버에서 처리. 가게로 치면 주방
데이터베이스 (DB) 많은 자료를 표처럼 정리해 저장하고 빨리 찾아 꺼내 쓰게 만든 저장소. 신청자 명단·주문 내역 등. Supabase가 그 서비스
API 프로그램끼리 정해진 방식으로 요청하고 답을 주고받는 창구. 날씨·지도·AI 기능을 내 사이트에서 가져다 쓸 때. 그 창구의 열쇠가 API 키
OAuth (권한 허용 로그인) 비밀번호를 넘기지 않고 "이 앱이 내 구글 계정의 ○○를 써도 된다"고 허락하는 방식. '구글로 로그인'·'권한 허용' 창이 이것
앱 비밀번호 내 진짜 비밀번호 대신 특정 프로그램 하나에만 주는 별도 비밀번호. 구글 계정에서 만들며 2단계 인증이 켜져 있어야 함. API 키처럼 어디에도 붙여 두지 않음
포트 한 컴퓨터 안에서 프로그램마다 나눠 쓰는 출입문 번호. localhost:3000의 3000이 포트 번호
클론 (clone) GitHub 저장소를 통째로 내 컴퓨터에 복사해 오는 것. 파일과 저장 기록이 함께 옴
풀 (pull) GitHub에 올라온 새 변경을 내 컴퓨터로 받아 맞추는 것. 푸시의 반대. 다른 컴퓨터에서 고쳤다면 "GitHub에서 받아 와줘" 먼저
버그 프로그램이 의도와 다르게 움직이는 오류. 화면이 깨지거나 버튼이 안 눌리는 것
디버깅 버그의 원인을 찾아 고치는 일. Claude에게 "무엇을 했더니 어떻게 됐다"를 그대로 알려 주면 빨라짐
에러 로그 문제가 생겼을 때 프로그램이 남기는 오류 기록. 빨간 글씨를 통째로 복사해 Claude에게 보여 주면 됨. 키·비밀번호가 보이면 가리고
Cron (크론) 정해진 시간마다 작업을 자동 실행하는 방식과 그 시간 표기법. 0 8 * * * = 매일 아침 8시. 루틴·예약 작업의 시간 설정에 쓰임