워크숍 첫 30분이 "설치가 안 돼요"로 사라지지 않도록,
오늘 미리 끝냅니다.
터미널 → 설치 → 로그인 → 첫 대화 → 기본 조작 → 막혔을 때 — 약 40분.
안녕! 방금 설치를 끝냈어. 잘 연결됐는지 짧게 인사해줘.
나머지 절반은 "고치고 · 멈추고 · 되돌리기"를 손에 익히는 것입니다.
내 노트북에서 실제로 실행되는 AI 코딩 도구. 설치 · 로그인 · 실습 폴더까지.
STEP 1–4
AI가 내 폴더에 hello.html을 만들고, 그걸 내 눈으로 연 경험.
STEP 5
파일 짚어 시키기 · 멈추기 · 되돌리기 · 권한 모드 · 명령어 · 모델 — 마음 놓고 맡기는 데 필요한 최소한.
STEP 6
도구와 대화할 창구. 이미 노트북에 있습니다 — 열기만 하면 됩니다.
도구가 돌아가는 밑바탕. npm 설치 방식을 쓸 때만 필요합니다.
오늘의 주인공. 이 자료는 Claude Code 기준으로 안내합니다.
도구 뒤의 AI 모델을 쓸 자격. 회사 제공 계정이 있으면 그게 1순위.
실제로 새로 하는 일은 도구 설치 + 로그인 두 가지뿐입니다.
| 도구 | 모양 | 특징 | 오늘의 선택 |
|---|---|---|---|
| 사내 허용 도구 | 회사마다 다름 | 우리 회사가 공식 배포하는 도구가 있다면 | ✅ 있으면 최우선 |
| Claude Code | 터미널(대화창) | 이 시리즈의 기본 도구. 파일을 직접 읽고 쓰는 에이전트 | ✅ 기본 추천 |
| Cursor · Windsurf | 코드 에디터 | 에디터에 AI가 내장된 형태. 화면이 익숙하다는 장점 | 참고만 |
| Codex CLI · Antigravity CLI | 터미널 | 다른 모델 계열의 터미널 에이전트 (Gemini CLI는 2026.06 개인용 종료 → Antigravity CLI) | 참고만 |
Win 키 → "터미널" 또는 "PowerShell" 검색 → 실행
Windows 10 이하는 PowerShell을 쓰세요.
Cmd + Space → "터미널" 입력 → Enter
node -v
통과입니다. 다음 STEP으로.
nodejs.org에서 LTS 버전 설치 → 터미널을 껐다 다시 켜고 재확인. 지금 바쁘면 건너뛰어도 됩니다.
참고 — 왜 "선택"인가요?
다음 STEP의 공식 설치 스크립트(방법 A)는 Node.js 없이 됩니다. npm 방식(방법 B)으로 깔 때만 v22 이상이 필요합니다. 실습·배포에서 두루 쓰이니 깔아 두면 이득입니다.
irm https://claude.ai/install.ps1 | iex
curl -fsSL https://claude.ai/install.sh | bash
방법 B — Node.js가 이미 있다면 npm으로
npm install -g @anthropic-ai/claude-code
둘 중 하나만 성공하면 됩니다. 끝나면 터미널을 껐다 다시 켜세요.
명령이 안 먹으면 code.claude.com/docs의 최신 안내를 따르세요. 터미널이 막혀 있다면 데스크톱 앱의 Code 탭에서도 같은 Claude Code를 쓸 수 있습니다.
바탕화면에 vibe-start 폴더를 하나 만듭니다.
Windows: 폴더 우클릭 → "터미널에서 열기"
Mac: 터미널에 cd 입력 후 폴더를 드래그 → Enter
claude 입력 → 처음이면 브라우저가 열리며 로그인을 요청합니다.
claude
어떤 계정으로 로그인할지는 다음 장을 보세요. 브라우저가 안 열리면 터미널에 나온 URL을 복사해 직접 엽니다.
| 순위 | 방식 | 비용 | 이런 경우 |
|---|---|---|---|
| 1️⃣ | 회사 제공 계정 | 회사 부담 | 우리 회사가 계정·게이트웨이를 제공한다면 무조건 이것 — 보안·비용이 이미 정리돼 있습니다 |
| 2️⃣ | Claude 구독 (Pro/Max) | 월 정액 | 개인 학습용. 한도 안에서 마음껏 — 시작하기 가장 무난 |
| 3️⃣ | API 키 (종량제) | 쓴 만큼 | 쓴 토큰만큼 과금. 예측이 어려워 입문자에게는 비추천 |
🏢 사내 AWS Bedrock 같은 게이트웨이라면 — 한 줄로 끝나지 않습니다
로그인 대신 환경변수 설정이 필요하고, 세션이 만료될 때마다 aws sso login 같은 재인증을 합니다. 값은 회사마다 다르니 사내 가이드를 그대로 따르세요.
주고받는 모든 글을 토큰으로 셉니다. 대화가 길수록, 읽는 파일이 클수록 늘어납니다.
구독은 몇 시간 단위의 세션 한도와 주간 한도가 차고 다시 풀립니다. 한도에 닿아도 고장이 아닙니다. 남은 양과 풀리는 시각은 /usage.
주제가 바뀌면 새 대화(/clear)로. 긴 대화를 끌고 다니는 것이 토큰을 가장 많이 씁니다.
원리(컨텍스트 창)는 컨텍스트 덱에서 — 오늘은 "긴 대화 = 비용 + 품질 저하"라는 감만 가져가세요.
안녕! 방금 설치를 끝냈어. 잘 연결됐는지 짧게 인사해주고, 지금 폴더에 hello.html 파일로 "설치 성공!"이라고 크게 적힌 축하 페이지를 하나 만들어줘.
✅ 완료 기준 — 셋 다 보이면 통과
허락을 묻지 않고 파일을 만들어도 정상입니다 — 기본 권한 모드가 Auto(입력창 아래 ⏵⏵ auto)라서입니다. 바꾸는 법은 STEP 6에서.
@만 치면 폴더 안 파일이 검색됩니다. "그 파일 어디 있더라"를 설명할 필요가 없습니다.
캡처한 화면을 드래그하거나 붙여넣기 — "이 화면처럼"이 말보다 정확합니다.
방향이 틀리면 끝까지 기다리지 말고 바로 멈춘 뒤 다시 지시하세요.
@hello.html 글씨를 더 크게 하고, 배경은 짙은 남색으로 바꿔줘.
| 오늘부터 쓰는 6개 | |
|---|---|
| /help | 지금 쓸 수 있는 명령 보기 — 모르면 일단 이것 |
| /clear | 주제가 바뀌면 새 대화로 — 답이 흐려질 때 1순위 |
| /compact | 이어가야 할 땐 지난 대화를 요약해 자리 만들기 |
| /rewind | 방금 고친 걸 되돌리기 — Esc 두 번으로도 열림 |
| /usage | 남은 사용 한도 확인 (/cost 도 같은 명령) |
| /doctor | 뭔가 이상할 때 설치·연결 상태 진단 |
| 손에 익으면 6개 더 | |
|---|---|
| /resume | 어제 대화 이어가기 — 터미널을 닫아도 남아 있음 |
| /init | 프로젝트를 훑어 규칙 파일(CLAUDE.md) 초안 만들기 |
| /memory | 세션이 바뀌어도 기억할 규칙 파일 열어 고치기 |
| /permissions | 자동 허용·거부할 명령 규칙 정하기 |
| /model | 모델 바꾸기 — 다음다음 장 |
| /agents | 서브에이전트 안내 — 만들기는 "리뷰 담당 서브에이전트 만들어줘"처럼 말로 |
| 모드 | AI가 하는 것 | 언제 |
|---|---|---|
| Auto 기본값 | 요청 범위 안의 수정·명령은 묻지 않고 진행, 위험해 보이는 건 멈춤 | 연습 파일 · 내 실습 폴더 |
| Manual | 파일 수정·명령마다 "할까요?"를 묻는다 | 회사 실데이터 · 처음 보는 폴더 |
| Plan | 아무것도 고치지 않고 계획만 세워 승인을 받는다 | 큰 작업을 시키기 전 |
| Bypass | 모든 확인을 건너뜀 | 격리된 테스트 환경이 아니면 쓰지 않기 |
이 폴더에 자기소개 페이지 about.html 을 추가하려고 해. 어떤 순서로 만들지 계획만 세워줘.
평소 일의 대부분 — 기본 모델(2026.11 기준 Opus)로 충분합니다. 지금 무엇인지는 /model 로 확인.
두세 번 고쳐도 같은 문제가 반복될 때, 설계 결정 · 중요한 변경을 검토받을 때 — 추론 깊이를 올립니다.
긴 로그 훑기 · 여러 파일 요약 · 단순 분류처럼 빠르고 싼 게 중요한 일.
한자리에서 끝나지 않는 큰 작업을 통째로 맡길 때. 직접 골라야 켜지고, 느리고 사용량을 많이 씁니다.
바꿨다면 끝나고 되돌리세요. 회사 계정은 관리자가 모델을 고정해 두었을 수 있습니다 — 그땐 그대로 쓰면 됩니다.
@hello.html 맨 위에 오늘 날짜와 내 이름을 넣어줘
→ 새로고침해서 이름이 보이는지 확인
hello.html 을 10쪽짜리 사이트로 키워줘
→ 작업이 시작되면 바로 Esc. "중단됨" 표시 확인
Esc 두 번(또는 /rewind) → ① 직후 지점을 고르고 코드까지 되돌리기
→ 새로고침해서 ①의 상태인지 확인
무엇을 배우나 — AI가 엉뚱하게 가도 멈출 수 있고, 되돌릴 수 있다. 그래서 마음 놓고 시켜도 됩니다.
막히면 — 되돌리기 목록이 비어 있으면 그냥 "방금 바꾼 거 원래대로 돌려줘"라고 말해도 됩니다.
빨간 글자를 해석하려 하지 말고, 전체를 복사하거나 화면을 찍으세요.
도구가 아직 없으니, 사내 승인 챗봇에 에러를 그대로 붙여넣고 "이거 어떻게 고쳐?"
같은 OS에서 이미 성공한 사람이 최고의 문서입니다.
권한·프록시·보안 프로그램은 사내 IT 헬프데스크의 영역 — 1번의 에러와 "몇 번째 STEP"을 함께 전달.
이 덱에서 하나 더: 실데이터가 든 폴더에서는 권한 모드를 Manual로. 오늘 실습은 전부 공개해도 되는 연습 파일입니다.
자세한 내용은 → 사내 환경에서의 AI — 보안과 거버넌스
느려졌거나 새 기능 소식을 들었다면 버전부터:
claude --version
대부분 자동 업데이트됩니다. 수동 갱신 방법은 공식 문서에서.
7개가 모두 ✓ 이면 입문 세미나·워크숍에서 세팅으로 잃는 시간이 없습니다.
핵심 경로 — 지금 출발선에 서 있습니다:
공개해도 되는 내 업무 파일 하나(예: 회의록 양식)를 복사본으로 실습 폴더에 넣고:
"@파일이름 에 뭐가 들어 있는지 세 줄로 설명하고, 개선점 하나만 제안해줘"
로컬 발표 모드에서는 화면 아래 입력창으로 실시간 질문을 보낼 수 있습니다.
설치가 아직 안 끝난 분은 지금이 조교를 붙잡을 마지막 기회입니다.
이 자료는 회사명·헬프데스크 표기를 바꿔 재사용할 수 있습니다 — setup/index.html 상단의 SEMINAR_CONFIG에서 바꾸세요.