모든 세미나
SEMINAR · 0교시 · SETUP & BASICS

바이브 코딩 0교시
설치와 기본 조작

워크숍 첫 30분이 "설치가 안 돼요"로 사라지지 않도록,
오늘 미리 끝냅니다.

터미널 → 설치 → 로그인 → 첫 대화 → 기본 조작 → 막혔을 때 — 약 40분.

💬 오늘의 첫 관문 — 이 인사가 성공하면 절반
안녕! 방금 설치를 끝냈어.
잘 연결됐는지 짧게 인사해줘.

나머지 절반은 "고치고 · 멈추고 · 되돌리기"를 손에 익히는 것입니다.

오늘의 여정 · 설명 10% + 손 움직이기 90%

40분 뒤, 이 세 가지가 내 노트북에 남습니다

🧰 돌아가는 도구

내 노트북에서 실제로 실행되는 AI 코딩 도구. 설치 · 로그인 · 실습 폴더까지.

STEP 1–4

💬 첫 대화 + 첫 파일

AI가 내 폴더에 hello.html을 만들고, 그걸 내 눈으로 연 경험.

STEP 5

🎛️ 기본 조작

파일 짚어 시키기 · 멈추기 · 되돌리기 · 권한 모드 · 명령어 · 모델 — 마음 놓고 맡기는 데 필요한 최소한.

STEP 6

그리고 막혔을 때의 처방전 TOP 5 — 설치에 쓰는 40분이 워크숍 시간을 통째로 살립니다.
BIG PICTURE

준비물은 4가지 — 대부분 이미 갖고 있습니다

1 ⌨️ 터미널

도구와 대화할 창구. 이미 노트북에 있습니다 — 열기만 하면 됩니다.

→
2 ⚙️ Node.js

도구가 돌아가는 밑바탕. npm 설치 방식을 쓸 때만 필요합니다.

→
3 🤖 AI 코딩 도구

오늘의 주인공. 이 자료는 Claude Code 기준으로 안내합니다.

→
4 🔑 계정(로그인)

도구 뒤의 AI 모델을 쓸 자격. 회사 제공 계정이 있으면 그게 1순위.

실제로 새로 하는 일은 도구 설치 + 로그인 두 가지뿐입니다.

TOOL MAP

오늘은 도구 하나만, 끝까지 깝니다

도구모양특징오늘의 선택
사내 허용 도구회사마다 다름 우리 회사가 공식 배포하는 도구가 있다면 ✅ 있으면 최우선
Claude Code터미널(대화창) 이 시리즈의 기본 도구. 파일을 직접 읽고 쓰는 에이전트 ✅ 기본 추천
Cursor · Windsurf코드 에디터 에디터에 AI가 내장된 형태. 화면이 익숙하다는 장점 참고만
Codex CLI · Antigravity CLI터미널 다른 모델 계열의 터미널 에이전트 (Gemini CLI는 2026.06 개인용 종료 → Antigravity CLI) 참고만
도구를 여러 개 반쯤 까는 것보다, 하나를 끝까지(로그인 + 첫 대화) 가는 것이 오늘의 목표입니다.
PRE-FLIGHT CHECK

시작 전 3가지 확인 — 회사 노트북이면 특히

🖥️ 내 노트북에 설치 권한이 있나? 회사 노트북은 관리자 권한이 잠긴 경우가 많습니다 — 사내 소프트웨어 센터나 사내 IT 헬프데스크로 설치 경로 확인
🌐 사내망? 프록시? 개인망? 사내망은 프록시·인증서 때문에 다운로드가 막힐 수 있습니다. 개인 노트북 + 개인망이면 그냥 진행
📜 회사의 AI 도구 정책은? 허용 도구 목록·데이터 반출 규정이 있다면 그것이 이 슬라이드보다 우선합니다
⚠️ 회사 노트북 + 사내망은 변수가 가장 많습니다. 10분 넘게 막히면 붙잡지 말고 에러 화면을 찍어 IT에 문의 — 그게 표준 절차입니다.
STEP 1 / 6 · 실습

터미널 열기 — 이미 갖고 있습니다

🪟 WINDOWS

Win 키 → "터미널" 또는 "PowerShell" 검색 → 실행

Windows 10 이하는 PowerShell을 쓰세요.

🍎 MAC

Cmd + Space → "터미널" 입력 → Enter

터미널은 글자로 대화하는 창일 뿐입니다. 명령어를 외울 필요는 없습니다 — 오늘 이후로는 AI가 대신 쳐 줍니다.
✅ 완료 기준글자를 입력할 수 있는 창이 뜨고, 커서가 깜빡인다 막히면 → 옆 사람 화면으로 같이
STEP 2 / 6 · 실습 · 선택

Node.js — 있는지부터 확인

⌨️ 터미널에 입력 (Windows/Mac 공통)
node -v

✅ v22 이상 숫자가 나오면

통과입니다. 다음 STEP으로.

❌ "찾을 수 없음" 이라면

nodejs.org에서 LTS 버전 설치 → 터미널을 껐다 다시 켜고 재확인. 지금 바쁘면 건너뛰어도 됩니다.

참고 — 왜 "선택"인가요?

다음 STEP의 공식 설치 스크립트(방법 A)는 Node.js 없이 됩니다. npm 방식(방법 B)으로 깔 때만 v22 이상이 필요합니다. 실습·배포에서 두루 쓰이니 깔아 두면 이득입니다.

STEP 3 / 6 · 실습

Claude Code 설치 — 한 줄

🪟 WINDOWS PowerShell에 붙여넣기
irm https://claude.ai/install.ps1 | iex
🍎 MAC 터미널에 붙여넣기
curl -fsSL https://claude.ai/install.sh | bash

방법 B — Node.js가 이미 있다면 npm으로

npm install -g @anthropic-ai/claude-code

둘 중 하나만 성공하면 됩니다. 끝나면 터미널을 껐다 다시 켜세요.

🏢 사내망에서 다운로드가 막히면 억지로 우회하지 마세요 — 우리 회사의 공식 설치 경로가 우선입니다.
✅ 완료 기준새 터미널에서 claude --version 이 버전 숫자를 보여 준다 막히면 → 에러 5가지 (18장)

명령이 안 먹으면 code.claude.com/docs의 최신 안내를 따르세요. 터미널이 막혀 있다면 데스크톱 앱의 Code 탭에서도 같은 Claude Code를 쓸 수 있습니다.

STEP 4 / 6 · 실습

실습 폴더에서 열고, 로그인합니다

1 실습 폴더 만들기

바탕화면에 vibe-start 폴더를 하나 만듭니다.

→
2 폴더에서 터미널 열기

Windows: 폴더 우클릭 → "터미널에서 열기"
Mac: 터미널에 cd  입력 후 폴더를 드래그 → Enter

→
3 실행 & 로그인

claude 입력 → 처음이면 브라우저가 열리며 로그인을 요청합니다.

⌨️ 실행 명령 (공통)
claude

어떤 계정으로 로그인할지는 다음 장을 보세요. 브라우저가 안 열리면 터미널에 나온 URL을 복사해 직접 엽니다.

✅ 완료 기준환영 화면과 입력창(>)이 뜨고, 경로에 vibe-start가 보인다 막히면 → 에러 5가지 (18장)
ACCOUNT & BILLING

로그인은 회사 계정 → 구독 → API 키 순서로

순위방식비용이런 경우
1️⃣회사 제공 계정 회사 부담 우리 회사가 계정·게이트웨이를 제공한다면 무조건 이것 — 보안·비용이 이미 정리돼 있습니다
2️⃣Claude 구독 (Pro/Max) 월 정액 개인 학습용. 한도 안에서 마음껏 — 시작하기 가장 무난
3️⃣API 키 (종량제) 쓴 만큼 쓴 토큰만큼 과금. 예측이 어려워 입문자에게는 비추천

🏢 사내 AWS Bedrock 같은 게이트웨이라면 — 한 줄로 끝나지 않습니다

로그인 대신 환경변수 설정이 필요하고, 세션이 만료될 때마다 aws sso login 같은 재인증을 합니다. 값은 회사마다 다르니 사내 가이드를 그대로 따르세요.

🔑 API 키는 비밀번호와 같습니다. 채팅·메일·코드에 붙여넣지 말고, 새어 나갔다면 삭제가 아니라 재발급.
BILLING SENSE

비용은 토큰 단위 — 긴 대화가 가장 비쌉니다

🧮 토큰 = 글자 조각

주고받는 모든 글을 토큰으로 셉니다. 대화가 길수록, 읽는 파일이 클수록 늘어납니다.

⏳ 구독은 세션 한도 + 주간 한도

구독은 몇 시간 단위의 세션 한도와 주간 한도가 차고 다시 풀립니다. 한도에 닿아도 고장이 아닙니다. 남은 양과 풀리는 시각은 /usage.

💡 아끼는 습관 하나

주제가 바뀌면 새 대화(/clear)로. 긴 대화를 끌고 다니는 것이 토큰을 가장 많이 씁니다.

원리(컨텍스트 창)는 컨텍스트 덱에서 — 오늘은 "긴 대화 = 비용 + 품질 저하"라는 감만 가져가세요.

STEP 5 / 6 · 실습

첫 대화 — AI가 내 폴더에 파일을 만듭니다

💬 설치 확인 프롬프트 (복사해서 붙여넣기)
안녕! 방금 설치를 끝냈어. 잘 연결됐는지
짧게 인사해주고, 지금 폴더에
hello.html 파일로 "설치 성공!"이라고 크게 적힌
축하 페이지를 하나 만들어줘.

✅ 완료 기준 — 셋 다 보이면 통과

✓ AI가 한국어로 응답한다
✓ 폴더에 hello.html이 생겼다
✓ 더블클릭하면 브라우저에 축하 페이지가 뜬다
방금 여러분은 첫 바이브 코딩을 했습니다 — 말로 시켰고, AI가 파일을 만들었고, 내가 열어서 확인했습니다.

허락을 묻지 않고 파일을 만들어도 정상입니다 — 기본 권한 모드가 Auto(입력창 아래 ⏵⏵ auto)라서입니다. 바꾸는 법은 STEP 6에서.

STEP 6 / 6 · 기본 조작 ① · 실습

파일은 @로 짚고, 화면은 붙여넣고, 엉뚱하면 Esc

📎 @ 파일 짚기

@만 치면 폴더 안 파일이 검색됩니다. "그 파일 어디 있더라"를 설명할 필요가 없습니다.

🖼️ 이미지 붙여넣기

캡처한 화면을 드래그하거나 붙여넣기 — "이 화면처럼"이 말보다 정확합니다.

⛔ Esc 멈추기

방향이 틀리면 끝까지 기다리지 말고 바로 멈춘 뒤 다시 지시하세요.

💬 따라 해 보기 — @ 다음에 파일 이름을 고르세요
@hello.html 글씨를 더 크게 하고, 배경은 짙은 남색으로 바꿔줘.
✅ 완료 기준@를 치면 파일 목록이 뜨고, 브라우저 새로고침(F5)에 바뀐 색이 보인다
STEP 6 / 6 · 기본 조작 ②

명령어는 외우지 말고 /만 치세요 — 오늘은 6개면 충분

오늘부터 쓰는 6개
/help지금 쓸 수 있는 명령 보기 — 모르면 일단 이것
/clear주제가 바뀌면 새 대화로 — 답이 흐려질 때 1순위
/compact이어가야 할 땐 지난 대화를 요약해 자리 만들기
/rewind방금 고친 걸 되돌리기 — Esc 두 번으로도 열림
/usage남은 사용 한도 확인 (/cost 도 같은 명령)
/doctor뭔가 이상할 때 설치·연결 상태 진단
손에 익으면 6개 더
/resume어제 대화 이어가기 — 터미널을 닫아도 남아 있음
/init프로젝트를 훑어 규칙 파일(CLAUDE.md) 초안 만들기
/memory세션이 바뀌어도 기억할 규칙 파일 열어 고치기
/permissions자동 허용·거부할 명령 규칙 정하기
/model모델 바꾸기 — 다음다음 장
/agents서브에이전트 안내 — 만들기는 "리뷰 담당 서브에이전트 만들어줘"처럼 말로
✅ 완료 기준/를 치면 메뉴가 뜨고, /help 를 한 번 실행해 봤다 원리: /clear·/compact → context · CLAUDE.md → agent-skills
STEP 6 / 6 · 기본 조작 ③ · 실습

Shift+Tab 으로 "얼마나 맡길지"를 고릅니다

모드AI가 하는 것언제
Auto 기본값요청 범위 안의 수정·명령은 묻지 않고 진행, 위험해 보이는 건 멈춤연습 파일 · 내 실습 폴더
Manual파일 수정·명령마다 "할까요?"를 묻는다회사 실데이터 · 처음 보는 폴더
Plan아무것도 고치지 않고 계획만 세워 승인을 받는다큰 작업을 시키기 전
Bypass모든 확인을 건너뜀격리된 테스트 환경이 아니면 쓰지 않기
💬 따라 해 보기 — Shift+Tab 을 눌러 Plan 으로 바꾼 뒤
이 폴더에 자기소개 페이지 about.html 을 추가하려고 해. 어떤 순서로 만들지 계획만 세워줘.
✅ 완료 기준입력창 아래 모드 표시가 바뀌고, Plan 에서는 계획만 나오고 파일은 생기지 않는다
STEP 6 / 6 · 기본 조작 ④

모델은 기본값 그대로 — 바꿀 때는 세 경우뿐

평소 일의 대부분 — 기본 모델(2026.11 기준 Opus)로 충분합니다. 지금 무엇인지는 /model 로 확인.

더 깊이 · /effort

두세 번 고쳐도 같은 문제가 반복될 때, 설계 결정 · 중요한 변경을 검토받을 때 — 추론 깊이를 올립니다.

가벼운 모델 · Sonnet · Haiku

긴 로그 훑기 · 여러 파일 요약 · 단순 분류처럼 빠르고 싼 게 중요한 일.

큰 작업용 · Fable

한자리에서 끝나지 않는 큰 작업을 통째로 맡길 때. 직접 골라야 켜지고, 느리고 사용량을 많이 씁니다.

바꿨다면 끝나고 되돌리세요. 회사 계정은 관리자가 모델을 고정해 두었을 수 있습니다 — 그땐 그대로 쓰면 됩니다.

STEP 6 · 마무리 실습 · 5분

고치고 → 멈추고 → 되돌리기, 한 번씩 해 봅니다

1 ✏️ 고치기

@hello.html 맨 위에 오늘 날짜와 내 이름을 넣어줘

→ 새로고침해서 이름이 보이는지 확인

→
2 ⛔ 멈추기

hello.html 을 10쪽짜리 사이트로 키워줘

→ 작업이 시작되면 바로 Esc. "중단됨" 표시 확인

→
3 ↩️ 되돌리기

Esc 두 번(또는 /rewind) → ① 직후 지점을 고르고 코드까지 되돌리기

→ 새로고침해서 ①의 상태인지 확인

무엇을 배우나 — AI가 엉뚱하게 가도 멈출 수 있고, 되돌릴 수 있다. 그래서 마음 놓고 시켜도 됩니다.

막히면 — 되돌리기 목록이 비어 있으면 그냥 "방금 바꾼 거 원래대로 돌려줘"라고 말해도 됩니다.

✅ 완료 기준브라우저의 hello.html 이 ①(날짜·이름만 추가된) 상태로 돌아와 있다
TROUBLESHOOTING

자주 만나는 에러 5가지와 처방

'claude'을(를) 찾을 수 없습니다 터미널을 껐다 다시 켜기 — 설치 직후엔 새 창이어야 인식됩니다. 그래도 안 되면 재설치
certificate / SSL / proxy 에러 사내망 프록시가 원인 — 사내 인증서 등록 절차를 따르거나 사내 IT 헬프데스크 문의. 개인망에서 먼저 설치하는 것도 방법
EACCES / 권한이 거부되었습니다 Windows: PowerShell을 관리자 권한으로 실행 후 재시도 · Mac: 공식 설치 스크립트(방법 A)로 다시
Node 버전이 낮다는 메시지 nodejs.org에서 LTS로 재설치 → 터미널 재시작 → node -v 재확인 (또는 방법 A로)
로그인 브라우저가 안 열려요 터미널에 출력된 URL을 복사해 브라우저에 직접 붙여넣기 — 사내 보안 브라우저 설정이 원인인 경우가 많습니다
WHEN STUCK

그래도 막히면 — 복사 → 챗봇 → 옆 사람 → IT

1 📸 에러를 통째로 확보

빨간 글자를 해석하려 하지 말고, 전체를 복사하거나 화면을 찍으세요.

→
2 🌐 웹 챗봇에게 붙여넣기

도구가 아직 없으니, 사내 승인 챗봇에 에러를 그대로 붙여넣고 "이거 어떻게 고쳐?"

→
3 🙋 옆 사람 · 조교

같은 OS에서 이미 성공한 사람이 최고의 문서입니다.

→
4 🏢 IT 헬프데스크

권한·프록시·보안 프로그램은 사내 IT 헬프데스크의 영역 — 1번의 에러와 "몇 번째 STEP"을 함께 전달.

설치가 끝나면 2번이 설치한 도구 그 자체가 됩니다 — "에러는 통째로 복사해 붙여넣기"가 평생 습관입니다. 더 깊이는 → 디버깅 덱
SECURITY

시작 전 보안 약속 3가지

1️⃣ 회사 기밀·실데이터는 사내 승인 도구에서만 — 애매하면 넣지 않는다.
2️⃣ API 키·비밀번호는 코드·대화·커밋에 남기지 않는다 — 새어 나갔다면 삭제가 아니라 재발급.
3️⃣ 회사 정책이 이 자료보다 우선한다. 우리 회사의 허용 도구 목록·반출 규정을 먼저 확인하세요.

이 덱에서 하나 더: 실데이터가 든 폴더에서는 권한 모드를 Manual로. 오늘 실습은 전부 공개해도 되는 연습 파일입니다.
자세한 내용은 → 사내 환경에서의 AI — 보안과 거버넌스

KEEP FRESH

설치 명령은 바뀝니다 — 공식 문서를 더 믿으세요

🔄 버전 확인

느려졌거나 새 기능 소식을 들었다면 버전부터:

⌨️ 버전 확인
claude --version

대부분 자동 업데이트됩니다. 수동 갱신 방법은 공식 문서에서.

📅 이 자료의 기준일

이 슬라이드의 명령·화면은 2026년 11월 기준입니다.

안 먹으면 공식 문서를 따르세요 — 도구가 자료보다 빨리 바뀝니다.

바뀌는 것은 명령과 화면, 바뀌지 않는 것은 "말로 시키고 → 확인하고 → 고쳐 달라 한다"는 리듬입니다.
FINAL CHECK

이 장만 찍어 가세요 📸 — 완료 체크리스트

1 터미널을 열 수 있다 STEP 1
2 claude --version 이 버전을 보여 준다 STEP 2–3
3 실습 폴더에서 claude 실행 + 로그인 (회사 계정 > 구독 > API) STEP 4
4 첫 대화로 hello.html 을 만들고 브라우저로 열었다 STEP 5
5 @로 파일을 짚어 고치고, Esc로 멈추고, 되돌려 봤다 STEP 6
6 Shift+Tab으로 Plan·Manual 모드를 바꿔 봤다 STEP 6
7 막히면? 에러 복사 → 챗봇 → 옆 사람 → IT 순서 기억

7개가 모두 ✓ 이면 입문 세미나·워크숍에서 세팅으로 잃는 시간이 없습니다.

NEXT

환경은 끝났습니다 — 이제 진짜 시작

핵심 경로 — 지금 출발선에 서 있습니다:

🏃 5분 더 있다면

공개해도 되는 내 업무 파일 하나(예: 회의록 양식)를 복사본으로 실습 폴더에 넣고:
"@파일이름 에 뭐가 들어 있는지 세 줄로 설명하고, 개선점 하나만 제안해줘"

📚 01 기본기 — 막히면 펼쳐 볼 덱

AI에게 일 시키는 법 · Git & GitHub · AI와 함께 디버깅하기 · UI/UX 용어 사전

Q&A

질문 있으신가요?

로컬 발표 모드에서는 화면 아래 입력창으로 실시간 질문을 보낼 수 있습니다.
설치가 아직 안 끝난 분은 지금이 조교를 붙잡을 마지막 기회입니다.

📚 공식 문서

🎓 이 시리즈

이 자료는 회사명·헬프데스크 표기를 바꿔 재사용할 수 있습니다 — setup/index.html 상단의 SEMINAR_CONFIG에서 바꾸세요.