Claude Code는 언뜻 보기에 어려워 보일 수 있습니다.
Terminal, MCP, hooks, Skills, API 같은 용어가 한꺼번에 등장해서 처음 1시간 동안은 쉽게 길을 잃곤 합니다.
이 글에서는 Claude Code를 "선생님이 중학생 두 명을 가르치는 수업"으로 정리해 보겠습니다.
이 글을 다 읽고 나면, 기본 조작, 외부 연동, Skills, 메모리(Memory), hooks, MCP, API를 어떤 순서로 배워야 하는지 이해하게 됩니다.
헤더 이미지는 AI로 생성했습니다. 프롬프트는 이 글에서 확인할 수 있습니다.
Claude Code는 "답변하는 AI"가 아닌 "행동하는 AI"입니다
Claude Code는 단순히 질문에 답하는 것을 넘어, 사용자 컴퓨터 내에서 작업을 수행하는 AI입니다.
공식 문서에서는 파일을 편집하고, 명령어를 실행하며, git 작업을 수행하고, MCP와 통합할 수 있는 에이전트형 개발 도구로 설명됩니다.
이 개념만 이해하면, 모든 기능이 서로 연결됩니다.
선생님이 칠판에 이렇게 적었습니다:
"채팅 AI는 조언을 해주는 선생님입니다. Claude Code는 교실에서 함께 작업을 수행하는 반장입니다."
미나가 질문합니다:
"그럼 Claude Code는 프로그래밍을 할 줄 아는 사람만 쓸 수 있는 건가요?"
선생님이 고개를 저었습니다.
"처음에는 코드를 작성하는 도구로 유명해졌어요. 하지만 본질은 폴더를 읽고, 파일을 수정하고, 절차를 실행하는 AI입니다. 글쓰기, 문서 작업, 웹 페이지 제작, 연구 노트, 교재 만들기에도 사용할 수 있습니다."
렌이 말합니다:
"그러니까 ChatGPT한테 '에세이를 써줘'라고 말하는 대신, Claude Code한테 '이 폴더를 보고, 수정하고, 확인해줘'라고 말할 수 있는 거네요."
바로 그렇습니다.
Claude Code를 가르칠 때는 다음 세 가지 범주만으로 충분합니다:
- 읽기(Read)
- 수정하기(Fix)
- 확인하기(Check)
예를 들어, 선생님이 학교 축제 웹 페이지를 만드는 수업을 한다면 Claude Code에게 이렇게 요청할 것입니다.
여기서 중요한 점은 AI에게 단순한 "답변"을 요구하는 것이 아니라, 일련의 작업(task)을 전달하는 것입니다.
목차
- Claude Code는 "답변하는 AI"가 아닌 "행동하는 AI"입니다
- 기본 조작: "요청, 확인, 수정"
- 메모리(Memory): 선생님의 인계 노트
- Skills: 특수 기술 카드
- Hooks: 종소리와 순찰 교사
- MCP: 수학여행 버스
- API 및 SDK: Claude Code를 부품처럼 사용하기
- 시작을 위한 30분 실습 메뉴
기본 조작: "요청, 확인, 수정"
Claude Code의 기본은 요청(Request), 확인(Confirm), 수정(Fix)의 흐름입니다.
어려운 명령어를 외우는 것보다 이 대화 패턴을 익히는 것이 훨씬 빠른 길입니다.
처음에는 "한 번에 완성"보다는 "함께 수정해 나간다"는 마음가짐으로 사용하세요.
선생님이 두 학생에게 첫 번째 패턴을 알려줬습니다.
미나가 안도하는 표정으로 말합니다:
"갑자기 모든 걸 다 바꿔버릴까 봐 겁났거든요. 일단 제안부터 하게 하면 되는 거네요."
선생님이 대답합니다:
"맞아요. Claude Code가 마음대로 작업하게 두기보다 확인 지점을 만드는 게 더 안전합니다."
기본 사용법은 다음 다섯 가지로 구성됩니다:
claude로 대화 시작claude "요청 내용"으로 초기 요청 전달claude -p "요청 내용"으로 일회성 비대화형 실행/help로 사용 가능한 명령어 확인/status로 상태 확인
하지만 중학생들에게 처음부터 모든 것을 가르칠 필요는 없습니다. 첫 수업에서는 그냥 claude 를 열고 한마디만 하면 충분합니다.
렌이 말합니다:
"첫마디가 그게 전부라면, 별로 안 무섭네요."
선생님이 계속 말합니다:
"맞아요. 사용법을 물어보면서 Claude Code를 사용할 수 있습니다. 이해가 안 되면 사용법 자체를 물어보세요."
기본 조작의 목표는 명령어 암기가 아닙니다. AI에게 맡길 작업의 범위를 사람이 결정하는 것입니다.
메모리(Memory): 선생님의 인계 노트
메모리(Memory)는 Claude Code가 매번 읽어야 하는 전제 조건을 기록하는 공간입니다.
공식 문서에서는 사용자 또는 프로젝트에 따라 다른 지시 파일을 사용하는 시스템으로 설명됩니다. 교실에 비유하자면 선생님들 간의 인계 노트와 같습니다.
선생님이 칠판에 CLAUDE.md 라고 적었습니다.
미나가 묻습니다:
"이게 뭐예요?"
선생님이 대답합니다:
"Claude Code가 작업을 시작하기 전에 읽는 교실 규칙 책자입니다."
학교 축제 프로젝트의 경우 이렇게 작성할 수 있습니다.
렌이 말합니다:
("그러면 매번 이걸 말할 필요가 없겠네요.")
선생님이 고개를 끄덕입니다.
"맞아요. 매번 같은 내용을 설명하고 있다면 Memory에 넣으세요."
Memory에 적합한 정보는 다음과 같습니다:
- 프로젝트 목표
- 작성 스타일이나 디자인 규칙
- 자주 사용하는 명령어
- 건드리면 안 되는 파일
반대로, Memory에 적합하지 않은 정보도 있습니다:
- 오늘만 필요한 요청
- 확정되지 않은 아이디어
- 비밀번호나 API 키
- 개인 정보
중학생에게 설명한다면 이렇게 전달하면 됩니다:
"Memory는 AI를 똑똑하게 만드는 마법이 아니에요. 매번 잊지 말아야 할 규칙을 적어두는 노트입니다."
이 설명이면 충분합니다.
Skills: 특수 기술 카드
Skills는 자주 사용하는 작업 절차를 호출 가능한 형식으로 만든 것입니다.
공식 문서에서는 SKILL.md를 중심으로 템플릿, 예제, 스크립트, 참고 자료를 정리하는 시스템으로 설명됩니다. 교실에서는 필요할 때만 꺼내 쓰는 특수 기술 카드와 같습니다.
선생님이 세 장의 카드를 그렸습니다:
- 독후감 확인
- 학교 축제 페이지 만들기
- 영어 단어 시험 만들기
미나가 묻습니다:
"프롬프트 모음집이랑 뭐가 다른가요?"
선생님이 대답합니다:
"프롬프트 모음집은 매번 붙여 넣는 종이 쪽지입니다. Skills는 Claude Code의 도구 상자에 보관하는 카드입니다."
Skill의 기본 구조는 다음과 같습니다:
SKILL.md에 언제 사용하는지, 무엇을 하는지, 무엇을 읽어야 하는지를 작성합니다. Claude Code는 대화 내용에 맞는 Skill을 자동으로 사용하거나, 사용자가 /skill-name으로 호출할 수 있습니다.
렌이 말합니다:
"그러니까 선생님이 항상 사용하는 첨삭 규칙을 Skill로 만들 수 있겠네요."
바로 그렇습니다.
독후감 Skill의 경우 이렇게 설계할 수 있습니다.
여기서 중요한 것은 모든 것을 Skill로 만들 필요가 없다는 점입니다. 한 번만 필요한 요청은 그 자리에서 바로 물어보는 것으로 충분합니다.
Skill로 만들어야 할 작업은 다음 기준을 충족합니다:
- 여러 번 반복됨
- 절차가 정해져 있음
- 판단 기준이 있음
- 참고 자료나 템플릿이 있음
- 사람에 따라 품질 차이가 나기 쉬움
선생님이 마지막으로 말했습니다:
"Skills는 AI에 재능을 추가하는 것이 아닙니다. 인간의 절차를 재사용 가능한 형식으로 바꾸는 것입니다."
Claude Code 사전 사이트도 활용해 보세요.
Hooks: 종소리와 순찰 교사
Hooks는 Claude Code의 작업 전후에 자동으로 실행되는 메커니즘입니다.
공식 문서에서는 PreToolUse나 PostToolUse 같은 특정 이벤트에 따라 명령어나 프로세스를 실행하는 설정으로 설명됩니다. 교실에서는 종소리와 순찰 교사에 비유할 수 있습니다.
미나가 묻습니다:
"종소리요?"
선생님이 대답합니다:
"네. 수업 시작 전에 울리고, 제출 전에 울리죠. 위험한 곳에 가려고 하면 막아주기도 합니다.それが hooks입니다."
예를 들어, Claude Code가 파일을 다시 쓰기 전에 다음과 같은 순찰을 수행할 수 있습니다:
.env파일을 건드리려고 하는가?- 중요한 설정 파일을 망가뜨리려고 하는가?
- 다시 쓴 후에 테스트를 실행해야 하는가?
- 텍스트 서식을 지정해야 하는가?
- 로그를 남겨야 하는가?
렌의 눈이 반짝입니다:
"AI가 실수하려고 할 때 막을 수 있네요!"
선생님이 약간 엄격한 어조로 말합니다:
"하지만 hooks는 강력한 도구입니다. 셸 명령어를 자동 실행할 수 있기 때문에, 제대로 이해하지 않고 추가하면 위험합니다."
중학생에게 hooks를 설명할 때는 처음부터 설정을 작성하게 할 필요가 없습니다. 역할만 알려주면 됩니다:
작업 전: 위험한 작업 차단. 작업 후: 테스트 또는 검사 실행. 완료 시: 미완료 작업 확인.
실제로는 다음 순서로 도입하세요:
- 먼저 수동으로 확인한다.
- 같은 확인이 여러 번 나타나면 체크리스트로 만든다.
- 체크리스트가 안정화되면 hook으로 만든다.
갑자기 자동화하지 마세요. 사람이 이해하지 못하는 검사를 자동화하면, 실패도 자동화됩니다.
선생님이 칠판에 적었습니다:
"Hooks는 편리한 로봇이 아니라, 당신이 정한 규칙을 따르는 순찰 교사입니다."
MCP: 수학여행 버스
MCP(Model Context Protocol)는 Claude Code를 외부 서비스 및 데이터에 연결하는 메커니즘입니다.
공식 문서에서 MCP는 AI 도구와 외부 데이터 소스를 연결하기 위한 개방형 표준으로 설명됩니다. 교실에서는 교실 밖으로 나가기 위한 수학여행 버스에 비유할 수 있습니다.
선생님이 교실 그림을 그렸습니다. 밖에는 도서관, 교무실, 시청, 박물관을 그렸습니다.
렌이 말합니다:
"Claude Code가 교실 밖으로 나갈 수 있나요?"
선생님이 대답합니다:
"그런イメージ입니다. MCP를 연결하면 Claude Code가 GitHub, Sentry, PostgreSQL, Slack, Google Drive, Figma 같은 외부 정보에 접근할 수 있습니다."
물론, 모든 것을 마음대로 보게 두는 것은 아닙니다. 연결 서버, 인증, 권한을 직접 결정합니다.
Claude Code의 MCP 설정에서는 HTTP 서버나 로컬에서 실행되는 stdio 서버를 추가할 수 있습니다.
미나가 걱정스럽게 말합니다:
"외부에 연결하는 건 좀 무서운데요."
선생님이 대답합니다:
"그런 느낌이 맞습니다. MCP는 편리하지만, 연결할수록 AI가 접근할 수 있는 정보가 늘어납니다. 그러니 읽기 전용부터 시작하세요."
MCP를 가르치는 순서는 다음과 같습니다:
- 먼저 로컬 파일만 사용한다.
- 다음으로 안전한 읽기 전용 데이터에 연결한다.
- 그다음 GitHub나 티켓 관리 시스템에 연결한다.
- 마지막으로 쓰기 작업이나 프로덕션 데이터를 고려한다.
MCP의 가치는 AI가 더 똑똑해지는 것이 아닙니다. AI가 작업에 필요한 자료를 스스로 가져올 수 있다는 점에 있습니다.
선생님이 요약합니다:
"MCP는 AI에게 외부 세계를 보여주는 버스입니다. 하지만 어디까지 갈 수 있는지는 선생님이 결정합니다."
API 및 SDK: Claude Code를 부품처럼 사용하기
API(Application Programming Interface)와 SDK(Software Development Kit)는 Claude Code를 앱이나 자동화 프로세스에 통합하는 방법입니다.
공식 문서에서 Claude Code SDK는 CLI, TypeScript, Python에서 사용할 수 있는 시스템으로 설명됩니다. 교실에서는 반장이 교실 밖의 작업에도 참여할 수 있게 하는 방법입니다.
렌이 묻습니다:
"API가 대체 뭐예요?"
선생님이 대답합니다:
"사람이 화면에서 대화하는 대신, 프로그램에서 Claude Code에게 작업을 요청할 수 있는 입구입니다."
예를 들어, 일반적인 사용법은 이렇습니다. 이 경우 사람이 터미널에서 한 번 요청하는 방식입니다.
SDK를 사용하면 앱이나 배치 프로세스 내에서 Claude Code를 호출할 수 있습니다. Python SDK는 claude-code-sdk로 제공되며, TypeScript SDK도 사용 가능합니다.
미나가 묻습니다:
"그럼 초보자가 먼저 해야 할 일인가요?"
선생님이 대답합니다:
"아니요. 먼저 해야 할 일이 아닙니다."
API와 SDK는 다음 단계에서 사용합니다:
- 매일 같은 작업을 자동으로 실행하고 싶을 때
- CI에서 리뷰나 테스트를 지원하고 싶을 때
- 내부 도구에서 Claude Code를 호출하고 싶을 때
- 여러 프로세스를 병렬로 실행하고 싶을 때
- 결과를 JSON으로 받고 싶을 때
중학생들에게는 이렇게 설명할 수 있습니다:
"Claude Code의 기본은 반장을 직접 불러서 부탁하는 것입니다. 방송실에서 자동으로 요청을 보내는 것이 API와 SDK입니다."
편리하지만, 처음부터 사용하면 혼란스러울 수 있습니다. 순서는 다음과 같습니다: 기본 → Memory → Skills → MCP → hooks → 그다음 API.
시작을 위한 30분 실습 메뉴
Claude Code의 모든 것을 한 번에 배울 필요는 없습니다.
처음 30분 동안 할 일을 좁히면 두려움이 사라집니다. 중학생을 가르칠 때는 먼저 작은 성공 경험을 만들어 주세요.
선생님이 마침내 30분 수업 메뉴를 제시했습니다.
미나가 말합니다:
"이 정도면 수업 시간에 할 수 있겠어요!"
렌이 말합니다:
"그러면 MCP나 hooks는 나중에 배워도 되네요."
선생님이 대답합니다:
"네. 순서가 중요합니다. 바로 외부 연동이나 자동 실행으로 가면 무슨 일이 일어나는지 알 수 없게 됩니다."
첫 번째 세 가지 목표는 다음과 같습니다:
- Claude Code에게 폴더를 설명하게 한다.
- 작은 파일을 수정하게 한다.
- 수정 이유를 설명하게 한다.
이 정도만 할 수 있어도 Claude Code의 본질을 파악한 것입니다. 그 후에는 필요에 따라 진행하면 됩니다:
- 매번 같은 내용을 설명하기 번거롭다면 → Memory
- 매번 같은 작업을 반복한다면 → Skills
- 외부 자료를 보여주고 싶다면 → MCP
- 검사를 자동화하고 싶다면 → hooks
- 시스템에 구축하고 싶다면 → API 및 SDK
Claude Code는 기능을 암기하는 도구가 아닙니다. 작업을 어떻게 넘겨줄지 발전시키는 도구입니다.
선생님이 마지막으로 말했습니다:
"AI를 잘 활용하는 사람은 AI에 정통한 사람이 아닙니다. 작업을 나누고, 규칙을 전달하고, 확인을 수행할 수 있는 사람입니다."
이것이 Claude Code를 중학생에게 가르칠 때 가장 중요한 결론입니다.
관련 글
[초보자 환영] Claude Code 개인 지원
*선착순 10명 얼리버드 자리는 매진되었습니다.
Claude Code 디자인 패턴
~폴더 구조, Skills, 데이터베이스, 콘텐츠 생성 흐름 완전 공개~
문의, 개인 상담, 기업 교육 요청:
