← → or Space to navigate
AI 코딩 입문 · Beginner Guide

Claude Code CLI로
나만의 프로그램 만들기

코딩을 1도 몰라도, 따라만 하면 되는 비기너 가이드

01 / 19
Goal

이 가이드로 할 수 있는 것

  • 1 Claude Code CLI가 뭔지 이해하고 내 컴퓨터에 설치하기
  • 2 한국어로 말해서 웹앱·도구를 직접 만들기
  • 3 만든 것을 인터넷에 무료로 배포하고, 내 데이터까지 분석하기
코딩 경험이 전혀 없어도 됩니다. 한국어로 말하면 Claude가 알아서 해줍니다.
02 / 19
Why CLI

챗봇 vs CLI

웹 챗봇

챗봇

  • 💬대화만 가능
  • 📋복사-붙여넣기 필요
  • 🔒내 파일에 접근 불가
추천

CLI

  • 💻내 컴퓨터에서 직접 실행
  • 📁파일 자동 생성/수정
  • 🧠프로젝트 전체를 이해
"챗봇은 레시피를 알려주는 셰프,
CLI는 직접 요리해주는 셰프"
03 / 19
Account

요금제 & 계정 준비

  • 📝 claude.ai에서 가입 — 구글 계정이나 이메일로 1분
  • ⚡ Pro($20/월) 또는 Max($100~200/월) 구독에 Claude Code가 포함 — 추가 결제 없이 사용
  • 🔑 또는 API 키(console.anthropic.com)로 쓴 만큼만 결제 — 가끔 쓰는 사람용
  • 💰 토큰이란? AI가 일하는 데 쓰는 연료. 구독엔 사용량 한도가 있고 주기적으로 초기화됩니다
⚠️ 무료 플랜에는 Claude Code가 포함되지 않습니다 — Pro 이상 구독 또는 API 키가 필요해요.
04 / 19
Prerequisites

준비물 — 생각보다 적습니다

  • 💻 터미널 — 글자로 명령하는 까만 창. 여는 법: 시작 메뉴(Win)·Spotlight(Mac)에서 터미널 검색 → 실행. ⚠️ Windows에서 PowerShell을 직접 열면 시작 폴더가 엉뚱하니 꼭 터미널로 여세요
  • 🌐 인터넷 + claude.ai 계정 — 사실상 준비물은 이게 전부입니다
🛠️ 막히면? 에러 메시지를 복사해서 claude.ai 챗봇에 붙여넣으면 해결법을 알려줍니다.
05 / 19
Setup

설치하기 — 복사 → 붙여넣기 → Enter

🪟 Windows

1시작 메뉴에서 터미널 검색 → 실행
2붙여넣고 Enter:
irm https://claude.ai/install.ps1 | iex

🍎 macOS

1Spotlight(⌘+Space)에서 터미널 검색 → 실행
2붙여넣고 Enter:
curl -fsSL https://claude.ai/install.sh | bash
⌨️ CLI는 키보드로만 조작합니다 — No Mouse. 위 명령어는 복사해서 붙여넣기만 하면 끝.
06 / 19
Troubleshooting

설치 중 에러? 당황하지 마세요

😨 이런 에러가 떠도 정상이에요
PS C:\Users\user> claude --version
claude : 'claude' 용어가 cmdlet, 함수, 스크립트 파일 또는 실행할 수 있는 프로그램 이름으로 인식되지 않습니다.
  + CategoryInfo : ObjectNotFound
  + CommandNotFoundException
✅ Claude 챗봇에 붙여넣기 → 해결
💬 claude.ai 챗봇
나: (위 에러 메시지를 그대로 붙여넣기)
Claude 챗봇: PATH에 .local\bin 이 빠졌네요. 아래 명령을 터미널에 넣어보세요.
[Environment]::SetEnvironmentVariable("Path", "$p;...\.local\bin", "User")
→ 새 터미널: claude --version → 2.1.181 ✓ 해결!
💬 한쪽에 Claude 챗봇(claude.ai)을 열어두시고 — 설치 중 에러가 나도 당황하지 말고, 에러 메시지를 그대로 복사해 챗봇에 붙여 넣으면 Claude가 해답을 알려줍니다.
07 / 19
First Run

로그인 & 첫 실행

1 터미널에 claude 입력 → Enter
2 브라우저가 열리면 claude.ai 계정으로 로그인 → "승인" 클릭
3 터미널로 돌아오면 준비 완료 — 한국어로 말 걸기 (로그인은 한 번만)
🛠️ command not found? → 터미널을 껐다 켜 보세요. 그래도 안 되면 에러를 챗봇에 붙여넣기.
Claude Code v2.1.185
Opus 4.8 (1M context) · Claude Max
~/work
> Try "edit <filepath> to..."
work | ctx: - | windows: 1000k | Opus 4.8·max   ◇ max · /effort
✅ 이 화면이 나오면 성공!
08 / 19
Basics

처음 써보기

$ claude

# 한국어로 자연스럽게 요청하면 됩니다

> index.html 파일을 만들어줘.
> 방금 만든 파일을 브라우저에서 열어줘.
> 내 자기소개 페이지로 만들어줘.
> 이름은 홍길동이고, 사진 동호회를 운영해.
  • ✨ Claude가 파일을 만들고, 수정하고, 실행까지 알아서 합니다
  • 🌏 영어를 몰라도 됩니다 — 한국어가 잘 통합니다
09 / 19
Options

알아두면 편한 실행 옵션

1 claude --resume — 이전 대화를 이어서 계속. 터미널을 닫았다 켜도 OK
2 claude --dangerously-skip-permissions — 매번 승인 안 눌러도 됨 (자동 실행)
3 claude --resume --dangerously-skip-permissions — 둘 다 합치면 가장 편한 작업 모드
4 /model — 실행 중 모델·성능 변경. opus를 고른 뒤 좌우 화살표 ← →로 Max Effort까지 올리면 최고 성능
# 실전에서 가장 많이 쓰는 조합
$ claude --resume --dangerously-skip-permissions
💡 생산성을 위해 --dangerously-skip-permissions는 켜두길 권장합니다. 진짜 위험한 명령은 켜둬도 한 번 더 물어봐요.
10 / 19
Superpowers

바이브 코딩의 노하우 집대성

전 세계 개발자들의 AI 협업 베스트 프랙티스를 모은 무료 스킬 팩 — 설치하면 Claude가 더 똑똑하게 일합니다.

🧪

TDD (테스트 먼저)

"이런 결과가 나와야 해"를 먼저 정해놓고 만듦 → 엉뚱한 결과 방지

🐛

디버깅 패턴

에러가 나면 체계적으로 원인을 추적 → 삽질 시간 감소

❓

되묻기 (Clarify)

모호한 요청은 먼저 확인 → 의도와 다른 결과 방지

📝

계획 수립

큰 작업은 단계별 계획을 세운 뒤 실행 → 체계적 진행

여러분이 직접 할 필요는 없습니다. Superpowers가 Claude에게 이런 습관을 심어줍니다.
📥 설치: Claude에게 "obra/superpowers 플러그인을 설치해줘" 라고 말하면 끝.
🔐 잘 안 되면 "그래도 해줘"라고 한 번 더 — 보안·권한 때문에 Claude가 명시적인 지시를 기다릴 때가 있거든요.
11 / 19
Hands-On 1

첫 웹앱 — 점심 메뉴 룰렛

Claude에게 이렇게 말해보세요
"점심 메뉴 랜덤 추천 웹앱을 만들어줘.
룰렛 휠이 돌아가는 애니메이션이 있으면 좋겠어.
메뉴를 추가/삭제할 수 있게 해줘."
1 Claude Code가 웹앱 코드를 생성 → index.html이 만들어짐
2 그 파일을 더블클릭하면 브라우저에서 바로 실행됩니다
3 마음에 안 들면? "버튼을 더 크게", "색을 파스텔로"처럼 한국어로 수정 요청
🎉 코딩 한 줄 없이, 진짜로 작동하는 웹앱이 내 컴퓨터에 생겼습니다.
12 / 19
Save

잠깐, 세이브 하셨나요?

만든 코드를 GitHub에 올려두면 어디서든 다시 쓸 수 있습니다. 게임으로 치면 세이브 포인트!

1 github.com 가입 — 무료 계정이면 충분
2 새 저장소(repository) 만들기 — 개인 작업물은 Private으로
3 Claude에게 한마디: "내 코드를 GitHub에 올려줘"
# Claude에게 이렇게 말하면 끝
> 이 프로젝트를 GitHub에 올려줘. private repo로 만들어줘.

# Claude가 알아서: git init → repo 생성 → push
✓ Repository created · Code pushed to GitHub
🔒 Private = 나만 보기 / Public = 누구나 보기. 개인 프로젝트는 Private부터 시작하세요.
13 / 19
Hands-On 2

웹앱을 Cloudflare로 배포

내 컴퓨터에서만 돌던 웹앱을, 인터넷에서 누구나 열 수 있는 진짜 주소로 만들어 봅시다.

1 Cloudflare 가입 — 무료 플랜으로 충분
2 Claude에게 한마디: "이 웹앱을 Cloudflare Pages에 배포해줘"
3 처음이면 브라우저에서 Cloudflare 로그인 1회 → Claude가 알아서 업로드
4 your-app.pages.dev 같은 진짜 주소가 생김 → 친구에게 링크 공유!
🌍 코딩 없이 만든 웹앱이, 전 세계에서 열리는 실제 URL로 동작합니다.
14 / 19
Hands-On 3

공개 데이터를 분석 + 차트로

Demo — 공개 데이터 링크 하나로 분석
"아래 타이타닉 승객 데이터를 받아서 분석해줘.
생존율을 객실 등급·성별로 나눠 막대그래프 웹페이지로 만들어줘."
https://raw.githubusercontent.com/datasciencedojo/datasets/master/titanic.csv
  • 🔍 Claude가 링크에서 CSV를 직접 내려받아 읽습니다
  • 📊 등급·성별 생존율을 계산 → 인터랙티브 차트(HTML)로 시각화
  • 🧮 SQL·엑셀 함수 몰라도 OK — "나이대별로도 나눠줘" 같은 추가 요청도 자유롭게
🔗 공개·무료 데이터라 키도 계정도 필요 없습니다 — 타이타닉은 데이터 분석 입문의 단골 예제예요.
💡 다른 주제가 좋다면 "재미있는 공개 CSV 하나 추천해서 분석해줘"라고 해도 됩니다.
15 / 19
Deploy

만든 것을 어디에 올릴까?

추천

Cloudflare Pages

  • 📝정적 사이트·웹앱 무료 호스팅
  • 🌐your-site.pages.dev
  • ✅Claude에게 "Cloudflare에 올려줘"
정적

GitHub Pages

  • 📄GitHub 저장소를 무료 웹사이트로
  • 🌐username.github.io
  • 📘문서·포트폴리오에 딱
# 가장 간단 — Claude에게 폴더를 주고 시키면 끝
> 이 폴더를 Cloudflare Pages에 배포해줘

# GitHub 연동 자동배포 흐름
Local → GitHub repo → Cloudflare/GitHub Pages → 내 도메인
16 / 19
Caution

주의사항 & 팁

  • 🔐 시크릿은 코드에 넣지 않기 — API 키, 비밀번호는 환경변수로 분리
  • ⚠️ 위험한 명령어 주의 — rm -rf, force push 등은 한 글자씩 읽고 승인
  • 💰 토큰/요금은 무한하지 않음 — 구체적으로 요청하고, 불필요한 반복 호출 주의
  • 🤝 막히면 즉시 질문 — 에러 메시지를 claude.ai 챗봇에 붙여넣으면 대부분 해결
📖 더 알고 싶다면 Claude Code 공식 문서를 참고하세요 (영문)
code.claude.com/docs
17 / 19
What's Next

오늘 이후에 해볼 것들

오늘 설치 → 첫 웹앱 → Cloudflare 배포 → 데이터 분석 ✅
혼자 도전 작은 도구 몇 개를 직접 만들어 배포해 보기
더 배우기 공식 문서 읽기 + /plugin으로 기능 확장
습관화 막히면 검색보다 먼저 Claude에게 물어보기
막히면 Claude에게 물어보세요. 그게 핵심입니다.
18 / 19
Thank you

이제, 직접 만들어 보세요

막히는 부분은 Claude에게 물어보면 됩니다.
작게 시작해서, 즐겁게 만들어 보세요!

19 / 19