워크숍 첫 30분이 "설치가 안 돼요"로 사라지지 않도록,
오늘 미리 끝냅니다.
터미널 열기 → 도구 설치 → 로그인 → 첫 대화 → 막혔을 때 대처까지 — 30분.
안녕! 방금 설치를 끝냈어. 잘 연결됐는지 짧게 인사해줘.
← 이 대화가 되는 노트북을 만드는 것이 오늘의 전부입니다.
내 노트북에서 실제로 실행되는 AI 코딩 도구. 설치 · 로그인 · 작업 폴더까지.
STEP 1–4
"잘 연결됐는지 인사해줘" — 첫 응답을 내 눈으로 확인한 경험.
STEP 5
자주 나오는 에러 5가지의 처방전과, 그래도 안 될 때 누구에게 무엇을 보여줄지.
트러블슈팅
도구와 대화할 창구. 이미 노트북에 있습니다 — 열기만 하면 됩니다.
도구가 돌아가는 밑바탕(런타임). npm 설치 방식을 쓸 때 필요합니다.
오늘의 주인공. 이 자료는 Claude Code 기준으로 안내합니다.
도구 뒤의 AI 모델을 쓸 자격. 회사 제공 계정이 있으면 그게 1순위.
4가지 중 이미 갖고 있는 것도 많습니다. 오늘은 빠진 조각만 채웁니다.
| 도구 | 모양 | 특징 | 오늘의 선택 |
|---|---|---|---|
| Claude Code | 터미널(대화창) | 이 시리즈의 기본 도구. 파일을 직접 읽고 쓰는 에이전트 | ✅ 기본 추천 |
| 사내 허용 도구 | 회사마다 다름 | 우리 회사가 공식 배포하는 도구가 있다면 | ✅ 있으면 최우선 |
| Cursor · Windsurf | 코드 에디터 | 에디터에 AI가 내장된 형태. 화면이 익숙하다는 장점 | 참고만 |
| Codex CLI · Gemini CLI | 터미널 | 다른 모델 계열의 터미널 에이전트 | 참고만 |
Win 키 → "터미널" 또는 "PowerShell" 검색 → 실행
파란색/검은색 글자 창이 뜨면 성공. Windows 10 이하는 PowerShell을 쓰세요.
Cmd + Space → "터미널" 입력 → Enter
흰색/검은색 입력창이 뜨면 성공.
node -v
통과입니다. 이 슬라이드는 끝 — 다음 STEP으로.
nodejs.org에서 LTS 버전을 내려받아 설치 → 터미널을 껐다 다시 켜고 재확인.
참고 — Node.js가 왜 필요한가요?
npm 방식으로 도구를 설치할 때의 밑바탕입니다. 다음 STEP의 공식 설치 스크립트를 쓰면 Node.js 없이도 되는 경우가 있지만, 실습·배포에서 두루 쓰이므로 깔아두면 두고두고 이득입니다.
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의 최신 설치 안내를 따르세요.
바탕화면에 vibe-start 폴더를 하나 만듭니다.
Windows: 폴더에서 우클릭 → "터미널에서 열기"
Mac: 터미널에 cd 입력 후 폴더를 드래그
claude 입력 → 처음이면 브라우저가 열리며 로그인을 요청합니다.
claude
로그인 화면에서는 다음 슬라이드의 계정 기준대로 선택하세요. 브라우저가 안 열리면 터미널에 표시된 URL을 복사해 직접 여는 방법도 있습니다.
| 순위 | 방식 | 비용 | 이런 경우 |
|---|---|---|---|
| 1️⃣ | 회사 제공 계정 | 회사 부담 | 우리 회사가 계정·게이트웨이를 제공한다면 무조건 이것 — 보안·비용 문제가 이미 해결돼 있습니다 |
| 2️⃣ | Claude 구독 (Pro/Max) | 월 정액 | 개인 학습용. 한도까지 마음껏 쓰는 방식 — 시작하기 가장 무난 |
| 3️⃣ | API 키 (종량제) | 쓴 만큼 | 쓴 토큰만큼 과금. 예측이 어려워 입문자에게는 비추천 |
AI는 주고받는 모든 글을 토큰으로 계산합니다. 대화가 길수록, 읽는 파일이 클수록 토큰이 늘어납니다.
구독 요금제는 보통 몇 시간 단위로 사용 한도가 차고 다시 풀립니다. 한도에 닿으면 쉬었다 하면 됩니다 — 고장이 아닙니다.
주제가 바뀌면 새 대화로 시작하세요. 긴 대화를 끌고 다니는 것이 토큰을 가장 많이 씁니다.
더 깊은 원리(컨텍스트 창)는 컨텍스트 세미나에서 다룹니다 — 오늘은 "긴 대화 = 비용"이라는 감만 가져가면 충분합니다.
안녕! 방금 설치를 끝냈어. 잘 연결됐는지 짧게 인사해주고, 지금 폴더에 hello.html 파일로 "설치 성공!"이라고 크게 적힌 축하 페이지를 하나 만들어줘.
빨간 글자를 해석하려 하지 말고, 전체를 복사하거나 화면을 찍으세요.
도구가 아직 없으니, 브라우저의 Claude·챗봇에게 에러를 그대로 붙여넣고 "이거 어떻게 고쳐?" — 임시 조수입니다.
같은 OS에서 이미 성공한 사람이 최고의 문서입니다.
권한·프록시·보안 프로그램 문제는 사내 IT 헬프데스크의 영역 — 1번에서 확보한 에러를 그대로 전달.
오늘 실습은 전부 공개해도 무방한 연습용 파일로만 진행합니다 — 그래서 마음 편히 실험할 수 있습니다.
도구가 이상하게 느려지거나 새 기능 소식을 들었다면:
claude --version
대부분 자동 업데이트되지만, 수동 갱신 명령은 공식 문서에서 확인하세요.
6개가 모두 ✓ 이면 입문 세미나·워크숍에서 단 1분도 세팅으로 잃지 않습니다.
추천 학습 경로 — 여러분은 지금 출발선에 서 있습니다:
방금 만든 hello.html을 열어두고 이렇게 시켜보세요:
"배경을 밤하늘로 바꾸고 별이 반짝이게 해줘" — 수정 루프의 첫 경험입니다.
컨텍스트 · LLM 지식 관리 · Agent Skills — 도구가 익숙해진 뒤에 보면 훨씬 잘 읽힙니다.
로컬 발표 모드에서는 화면 아래 입력창으로 실시간 질문을 보낼 수 있습니다.
설치가 아직 안 끝난 분은 지금이 조교를 붙잡을 마지막 기회입니다.
이 자료는 회사명·헬프데스크 표기를 바꿔 재사용할 수 있습니다 — setup/index.html 상단의 SEMINAR_CONFIG에서 바꾸세요.