CLAUDE CODE · 첫걸음초보자 수업 · 추천 60분 · 2026.09.12
LESSON 01

말로 부탁하고,
내 손으로 확인하기

처음 만나는 Claude Code · 코딩을 몰라도 시작하는 기초 수업

이해하기 → 설치하기 → 만들기 → 확인하기

오늘의 작품은
내 소개 웹페이지 한 장입니다.

준비물: 노트북 · 인터넷 · 사용할 수 있는 Claude 계정
이 자료 자체는 인터넷 없이 열 수 있지만, 설치·AI 사용에는 인터넷이 필요합니다.
강사용 설명 · 진행 팁

추천 진행은 60분입니다. 개념 10분, 설치·로그인 15분, 실습 20분, 오류·안전·복습 15분. 실제 초등학생 대상이면 계정 이용 연령과 학교 정책을 확인하고 강사 시연 중심으로 진행하세요. 이 자료는 설명 난이도를 초6 수준으로 맞춘 것입니다.

LESSON 02

Claude와 Claude Code는 무엇이 다를까요?

Claude는 AI의 이름, Claude Code는 그 AI가 작업 도구를 쓰게 해 주는 프로그램입니다.

대화 중심의 Claude

“소개 페이지를 어떻게 만들까?”

설명과 아이디어를 주고받아요.

작업을 돕는 Claude Code

“이 폴더에 소개 페이지를 만들어 줘.”

허용된 도구로 파일을 읽고, 고치고, 명령을 실행할 수 있어요.

비유: 상담해 주는 친구 ↔ 작업 도구를 가진 조수
다른 Claude 화면에도 도구 기능이 있어요. 여기서는 터미널에서 쓰는 Claude Code를 배웁니다.
강사용 설명 · 진행 팁

Claude Code는 터미널 외에도 데스크톱과 편집기 등 여러 화면에서 쓸 수 있습니다. 오늘은 한 가지 길인 터미널 CLI로 통일합니다. AI가 내 컴퓨터 모든 일을 무조건 할 수 있는 것은 아닙니다. 권한, 설정, 연결된 도구에 따라 달라집니다.

LESSON 03

먼저, 컴퓨터의 기본 단어

파일은 공책 한 권, 폴더는 공책을 넣는 가방이라고 생각해 보세요.

파일 · File
내용을 담은 한 개의 자료. 예: index.html
폴더 · Folder
파일을 모아 두는 공간. 오늘은 연습용 가방 하나만 써요.
경로 · Path
파일이나 폴더가 있는 주소. 예: Documents/claude-practice
프로젝트 · Project
한 작품을 만드는 데 필요한 파일과 폴더의 묶음.
브라우저 · Browser
웹페이지를 보는 앱. Chrome, Edge, Safari 등이 있어요.
편집기 · Editor
파일 내용을 고치는 앱. 오늘은 필수 설치가 아니에요.
강사용 설명 · 진행 팁

실제 폴더와 HTML 파일을 탐색기 또는 Finder에서 보여 주세요. 브라우저는 완성된 페이지를 보여 주고, 편집기는 그 페이지의 설명서인 코드를 보여 줍니다.

LESSON 04

터미널은 ‘글자로 누르는 리모컨’

마우스로 버튼을 누르는 대신, 짧은 글을 입력하고 Enter를 눌러요.

터미널 · Terminal
글자로 컴퓨터와 대화하는 창.
명령어 · Command
컴퓨터에게 하는 정해진 부탁. mkdir는 폴더 만들기예요.
셸 · Shell
입력한 명령을 해석하는 프로그램. PowerShell, zsh 등이 있어요.
CLI · 씨엘아이
명령어를 입력해서 사용하는 방식. 이름을 외울 필요는 없어요.
두 입력 장소를 구분하세요.
터미널: claude, cd 같은 명령어
Claude Code 안: “파란색 소개 페이지를 만들어 줘” 같은 부탁
강사용 설명 · 진행 팁

터미널과 셸을 같은 개념이라고 단정하지 마세요. 초보자에게 가장 큰 실수는 Claude 안에 설치 명령을 넣거나, 셸에 한국어 부탁을 입력하는 것입니다. 화면의 위치를 매번 말로 확인합니다.

LESSON 05

AI에게 부탁할 때 쓰는 단어

AI는 똑똑한 조수지만, 틀릴 수도 있어요.

AI 모델
말을 이해하고 답을 만드는 핵심 엔진. 같은 도구라도 모델이 달라질 수 있어요.
프롬프트 · Prompt
AI에게 전달하는 부탁과 설명.
컨텍스트 · Context
AI가 이번 일을 이해하기 위해 참고하는 대화와 자료. 책상 위 참고 노트 같아요.
토큰 · Token
AI가 글을 나누어 처리하는 작은 조각. 글자 수와 정확히 같지는 않아요.
에이전트 · Agent
목표를 받고 도구로 작업한 뒤 결과를 살피는 AI 방식.
권한 · Permission
파일 수정이나 명령 실행을 해도 되는지 정하는 허락.
강사용 설명 · 진행 팁

토큰은 요금과 사용량을 이해하기 위한 보충 단어입니다. 숫자 계산까지 가르칠 필요는 없습니다. 컨텍스트에는 한계가 있고 AI가 예전 대화를 항상 정확히 기억하지는 않습니다.

LESSON 06

웹페이지는 세 가지 역할로 만들어요

몸을 세우고, 옷을 입히고, 움직임을 더해요.

HTML

내용과 구조
제목 · 문단 · 버튼

CSS

모양과 꾸미기
색 · 크기 · 배치

JavaScript

동작과 반응
버튼을 누르면 글 바꾸기

안녕! 나는 별이야

아래 버튼의 동작은 JavaScript가 담당해요.

강사용 설명 · 진행 팁

입력칸은 이 교재 안의 체험입니다. 실제 Claude에 연결되지 않습니다. 웹 기초 보충: 프론트엔드는 사용자가 보는 화면, 백엔드는 뒤에서 요청을 처리하는 부분, DB는 데이터를 저장하는 곳입니다. 오늘은 HTML 한 파일만 만들고 서버와 DB는 사용하지 않습니다.

LESSON 07

설치 전, 이것부터 확인해요

설치는 프로그램을 넣는 일, 로그인은 내 계정으로 들어가는 일이에요.

Claude Code 이용에는 지원되는 구독(Pro·Max·Team·Enterprise), Console 계정 등 적합한 이용 경로가 필요해요. 무료 채팅 계정만 있으면 된다고 생각하지 마세요. 조직 계정은 관리자 허용이 필요할 수 있어요.
강사용 설명 · 진행 팁

강의 전날 강사 컴퓨터에서 로그인까지 완료해 두세요. Console/API는 구독과 다른 사용량 기반 결제 경로이므로 초보 수업에서 섞지 않습니다. 요금과 한도는 바뀔 수 있으니 계정 화면과 공식 문서를 확인합니다. 비밀번호나 API 키를 수업 화면에 보여 주지 마세요. 설치 실패자는 시연에 함께 참여하게 합니다.

LESSON 08

Windows: PowerShell에서 설치해요

아래 명령은 Claude Code 안이 아니라, Windows PowerShell 창에 입력합니다.

  1. 시작 메뉴에서 PowerShell을 검색해 열어요.
    보통 앞부분에 PS C:\…가 보여요. CMD와 혼동하지 마세요.
  2. 공식 설치 명령을 붙여 넣고 Enter를 눌러요.
irm https://claude.ai/install.ps1 | iex
  1. 설치가 끝나면 PowerShell을 닫고 다시 열어요.
  2. 아래 명령으로 설치 여부를 확인해요.
claude --version
숫자로 된 버전이 표시되면 설치 확인 성공!
이 명령은 공식 사이트의 설치 프로그램을 내려받아 실행합니다. 출처가 모르는 명령은 따라 하지 마세요. 관리자 실행은 일반적으로 필요하지 않아요.
강사용 설명 · 진행 팁

붙여 넣기는 Ctrl+V를 사용합니다. 공식 최신 문서에서는 Git for Windows를 선택 설치로 안내하며, 없으면 PowerShell 도구를 사용합니다. Git Bash가 필요한 경우 강사가 Git for Windows 공식 경로를 안내하세요. 보안 차단을 만났다고 백신이나 실행 정책을 무조건 해제하지 않습니다.

LESSON 09

Mac: 터미널에서 설치해요

아래 명령은 Claude Code 안이 아니라, Mac 터미널 창에 입력합니다.

  1. Command(⌘) + Space를 누르고 Terminal 또는 터미널을 검색해요.
  2. 공식 설치 명령을 ⌘ + V로 붙여 넣고 Enter를 눌러요.
curl -fsSL https://claude.ai/install.sh | bash
  1. 설치가 끝나면 터미널을 닫고 다시 열어요.
  2. 설치가 되었는지 확인해요.
claude --version
이 수업은 공식 네이티브 설치 방식을 씁니다.
Node.js나 npm을 먼저 설치할 필요는 없어요. 설치 중 보이는 안내를 읽고, 모르는 오류는 강사에게 보여 주세요.
강사용 설명 · 진행 팁

명령의 기호와 띄어쓰기를 고치지 말고 그대로 사용합니다. curl은 내려받는 도구이고, 세로줄은 다음 도구로 넘기는 기호입니다. bash는 내려받은 설치 스크립트를 실행합니다. 이 설명은 아무 사이트의 스크립트나 실행해도 된다는 뜻이 아닙니다.

LESSON 10

새 연습 폴더를 만들고 시작해요

현재 폴더는 AI와 내가 함께 작업할 책상이에요.

먼저 탐색기/Finder에서 문서 폴더를 열고 claude-practice라는 새 폴더를 만드세요. 같은 이름이 이미 있다면 다른 새 이름을 쓰세요.

터미널에서는 다음 방법도 사용할 수 있어요. 한 줄씩 Enter를 누릅니다.

mkdir claude-practice
cd claude-practice
claude
mkdir = 새 폴더 만들기 / cd = 그 폴더로 이동하기
위 명령은 현재 위치에 폴더를 만들어요. 탐색기에서 이미 만든 폴더로 들어갈 때는 cd "실제 폴더 경로"만 쓰세요.
강사용 설명 · 진행 팁

두 방법 중 하나를 선택하세요. 명령 방식의 시작 위치가 문서 폴더라는 보장은 없습니다. pwd(현재 위치)는 Mac 및 PowerShell에서 확인할 수 있습니다. ls(Mac) 또는 dir(PowerShell)로 내용도 확인합니다. 경로를 모르면 터미널에 cd와 공백을 쓰고 폴더를 끌어 넣거나 경로를 복사해 큰따옴표로 감싸는 방법을 시연합니다. 홈 폴더 전체나 회사 저장소에서 실습하지 않습니다.

LESSON 11

로그인과 첫 번째 허락

로그인은 브라우저에서, 작업은 다시 터미널에서 해요.

  1. claude를 실행하면 안내에 따라 계정을 선택해요.
  2. 브라우저가 열리면 자기 계정으로 로그인해요.
  3. 인증을 마친 뒤 터미널로 돌아와요.
  4. 폴더를 신뢰할지 물으면 내가 만든 빈 연습 폴더인지 확인하고 선택해요.
  5. 아래 첫 부탁을 입력해요.
나는 처음 사용하는 사람이야.
지금 작업 폴더가 어디인지 알려 줘.
아직 파일을 만들거나 수정하지 말고, 네가 할 수 있는 일을 쉽게 설명해 줘.
선택 화면은 화살표 키로 이동하고 Enter로 결정하는 경우가 많아요. 화면에 보이는 안내를 먼저 읽으세요.
강사용 설명 · 진행 팁

메뉴 이름과 화면 순서는 버전에 따라 달라질 수 있습니다. API 결제 경로를 무심코 선택하지 않도록 확인합니다. 조직 계정에서 사용 권한이 없으면 관리자에게 문의하고 다른 사람 계정을 공유하지 않습니다.

LESSON 12

좋은 부탁은 네 가지를 담아요

무엇을 · 어떤 모습으로 · 어디까지 · 어떻게 확인할지

너무 막연한 부탁

“멋진 거 만들어 줘.”

AI가 내가 원하는 것을 추측해야 해요.

따라 하기 쉬운 부탁

“내 소개 페이지를 만들어 줘. 밝은 파란색으로, index.html 한 파일에. 휴대폰에서도 글이 잘 보이는지 확인해 줘.”

강사용 설명 · 진행 팁

역할을 길게 꾸미는 것보다 목표와 완료 기준을 명확히 하는 것이 중요합니다. 아래 자동 문장은 교재가 조합하는 예시이며 Claude의 답변이 아닙니다. 작은 부탁 하나씩 하고 눈으로 확인하는 습관을 강조하세요.

LESSON 13

실습 ① 내 소개 페이지 만들기

실제 이름 대신 별명을 사용해도 좋아요. 전화번호·주소·비밀번호는 넣지 않아요.

이 연습 폴더에 내 소개 웹페이지를 만들어 줘.
1. 별명은 별이, 좋아하는 것은 독서와 축구야.
2. 밝은 파란색 배경과 큰 글씨를 사용해 줘.
3. HTML, CSS, JavaScript를 index.html 한 파일에 넣어 줘.
4. “응원 받기” 버튼을 누르면 응원 문구가 나타나게 해 줘.
5. 외부 이미지, 외부 라이브러리, 설치 작업은 사용하지 마.
6. 다른 파일은 수정하거나 삭제하지 마. 인터넷에 공개하지도 마.
먼저 만들 계획을 짧게 설명하고, 내가 확인하면 만들어 줘.
  1. 계획이 내 부탁과 맞는지 읽어요.
  2. 맞으면 “좋아, 이 계획대로 만들어 줘”라고 답해요.
  3. 도구 실행 허락이 나오면 대상 파일과 하는 일을 확인해요.
AI가 “완성!”이라고 말했다고 끝이 아니에요. 진짜 파일과 화면을 확인해야 해요.
강사용 설명 · 진행 팁

이것은 실습용 프롬프트입니다. 페이지가 실제로 생성되었다는 결과 예시가 아닙니다. “계획만 설명”이라는 말은 시스템 권한 제한과 같지 않으므로 권한 화면도 확인합니다. 모르는 명령을 요청하면 거절하고 왜 필요한지 질문하세요.

LESSON 14

실습 ② 열어 보고, 하나씩 고치기

만들기 → 열어 보기 → 눌러 보기 → 다시 부탁하기

  1. 연습 폴더의 index.html을 더블클릭해 브라우저로 열어요.
  2. 별명과 취미가 맞는지 읽어요.
  3. “응원 받기” 버튼을 눌러 반응을 확인해요.
  4. 브라우저 창을 좁혀 글이 잘리는지 확인해요.
  5. 한 가지를 고친 뒤 브라우저에서 새로고침해요.
제목 글씨를 더 크게 바꿔 줘.
응원 버튼과 다른 내용은 그대로 유지해 줘.
수정한 부분과 내가 확인해야 할 것을 알려 줘.
완료 기준: 파일이 있다 · 내용이 맞다 · 버튼이 작동한다 · 좁은 화면에서도 읽힌다
내 컴퓨터에서 열기는 인터넷 공개(배포)와 달라요. 이 실습에서는 공개하지 않아요.
강사용 설명 · 진행 팁

새로고침은 Windows Ctrl+R, Mac Cmd+R입니다. 코드가 글자로 보이면 브라우저의 파일 열기를 사용하고, index.html.txt가 아닌지 파일 확장자 표시 설정으로 확인하세요. 결과가 다르더라도 실패가 아니라 수정 요청을 연습하는 기회입니다.

LESSON 15

오늘 쓰는 기능만 기억해요

명령어를 모두 외울 필요는 없어요.

/help
Claude Code 안에서 도움말 보기.
/clear
새 주제로 시작할 때 대화 비우기. 만든 파일을 삭제하는 기능은 아니에요.
/exit
Claude Code를 종료하고 터미널로 돌아가기.
Esc
Claude가 작업 중일 때 중단하기. 이미 실행된 작업까지 취소되는 것은 아니에요.
claude
터미널에서 다시 시작하기. 새 대화에서는 작업 목표를 다시 설명하세요.
CLAUDE.md
프로젝트 안내문 파일. “한국어로 설명하기, 외부 공개 전 물어보기” 같은 작업 규칙을 적어요.
규칙을 글로 써 두는 것과 실제 권한 제한은 달라요. 중요한 파일은 별도 백업하고, 허락 화면도 계속 확인하세요.
강사용 설명 · 진행 팁

CLAUDE.md는 보충 주제입니다. Markdown은 제목과 목록 등을 간단한 기호로 적는 문서 형식입니다. Git은 변경 이력을 관리하는 도구, 커밋은 저장 지점에 가깝습니다. MCP는 외부 도구 연결 규약, API는 프로그램끼리 요청과 응답을 주고받는 약속입니다. 오늘은 설치하지 않습니다.

LESSON 16

막혔을 때는 오류가 힌트예요

아무 명령이나 더 입력하지 말고, 어디에서 막혔는지 알려 주세요.

claude를 찾을 수 없다고 해요
터미널을 닫고 다시 열어 보세요. 계속되면 설치 안내의 PATH 설정을 강사와 확인하세요. PATH는 프로그램을 찾는 주소 목록이에요.
irm을 모른다고 해요
CMD가 아닌 PowerShell을 열었는지 확인하세요.
로그인·한도·결제 오류가 나요
계정의 Claude Code 이용 권한과 사용량을 확인하세요. 비밀번호를 채팅에 붙여 넣지 마세요.
페이지가 안 바뀌어요
파일 저장 여부, 연 파일의 경로를 확인하고 새로고침하세요.
버튼이 작동하지 않아요
무엇을 눌렀고 어떤 결과가 나왔는지 설명해 주세요.
index.html에서 “응원 받기”를 눌렀는데 아무 변화가 없어.
기대하는 결과는 응원 문장이 나타나는 거야.
원인을 찾아 이 문제만 고치고, 확인 방법을 알려 줘.
강사용 설명 · 진행 팁

PATH 오류는 OS별 공식 terminal guide 링크에 정확한 해결법이 있습니다. 권한 오류를 해결한다고 무조건 관리자 실행, sudo, 보안 해제를 권하지 마세요. 오류 메시지나 화면을 공유할 때 API 키, 이메일, 개인 경로 등 민감한 내용을 가립니다.

LESSON 17

안전하게 쓰는 다섯 가지 약속

AI는 조수, 최종 확인자는 나예요.

  1. 연습 폴더에서만 시작해요. 중요한 원본 파일은 따로 백업해요.
  2. 개인정보와 비밀키를 넣지 않아요. 친구 정보도 허락 없이 넣지 않아요.
  3. 허락 화면을 읽어요. 삭제·전송·공개·결제는 멈추고 확인해요.
  4. 결과를 직접 시험해요. AI의 말보다 실제 화면을 믿어요.
  5. 사용량을 확인해요. 계속 부탁하면 한도에 닿거나 결제 방식에 따라 비용이 생겨요.
“전부 자동 승인”하는 설정으로 바꾸지 마세요.
모르면 이렇게 말해요: “아직 실행하지 말고, 이 작업이 왜 필요한지 설명해 줘.”
강사용 설명 · 진행 팁

AI가 외부 문서의 나쁜 지시를 따라 할 위험도 있습니다. 출처 모르는 폴더와 파일은 수업에 사용하지 마세요. 백업과 되돌리기는 모든 외부 작업을 취소해 주지 않습니다. 인터넷 전송이나 배포는 되돌리기보다 사전 확인이 중요합니다.

LESSON 18

마지막 확인! 내가 판단해 볼까요?

정답보다 이유를 설명할 수 있으면 성공이에요.

각 문제의 답을 고르면 이유가 나타나요.

강사용 설명 · 진행 팁

세 문제를 먼저 혼자 생각하게 하고, 옆 사람에게 이유를 말하게 하세요. 정답을 골랐어도 무엇을 확인해야 하는지 말하지 못하면 앞의 실습 완료 기준으로 돌아갑니다.

LESSON 19

오늘의 한 장 요약

작게 부탁하고, 직접 확인하고, 하나씩 고쳐요.

새 폴더 → claude → 구체적인 부탁 → 허락 확인 → 직접 테스트

수업이 끝나면 할 수 있는 일

공식 자료 · 확인일 2026-09-11

화면·요금제·명령 지원은 버전에 따라 달라질 수 있습니다. 설치나 권한이 막히면 위 공식 문서를 확인하세요. 교재 속 체험은 실제 AI와 연결되지 않습니다.
강사용 설명 · 진행 팁

마지막 과제: 별명과 취미를 바꾼 새 소개 페이지를 만들고, 확인한 세 가지를 설명하세요. 설치가 안 된 수강생은 좋은 프롬프트 작성과 강사 화면 테스트로 학습 목표를 대체합니다. 설치 명령을 자료 검수 과정에서 실행한 것은 아니며, 각 OS 공식 문서 기준입니다.