AI Recipe  |  Claude Code 완전 입문 가이드

쉽게 따라하는
클로드 코드

Claude Code AI 레시피.
기자 김연지가 처음부터 끝까지 가이드합니다.

Claude Code란? → 바로 시작하기
↗
01 · Claude란?

|초능력 AI 친구

카카오톡 오픈채팅에 있는 천재 친구처럼, 번역·요약·코딩까지 뭐든 즉답해주는 AI 어시스턴트입니다.

💬
대화 · Q&A
무엇이든 물어보세요. 복잡한 개념도 쉽게 설명해줍니다.
✍️
글쓰기
요약, 번역, 카피라이팅, 이메일 초안까지 척척 작성합니다.
🔍
분석 · 정리
긴 문서를 읽고 핵심만 뽑아 구조화해줍니다.
💻
코딩 (Claude Code)
파일을 직접 열고, 수정하고, 저장하는 코딩 전문 모드입니다.
02 · Claude Code란?

|직접 요리해주는 셰프

일반 Claude가 전화로 레시피를 알려준다면, Claude Code는 당신의 주방에 직접 와서 요리해주는 셰프입니다.

일반 Claude
레시피 알려주는 셰프 📞
  • 파일을 직접 볼 수 없음
  • 수동 복사·붙여넣기 필요
  • 실제 파일을 건드리지 못함
  • 지시만 내릴 수 있음
Claude Code
직접 요리해주는 셰프 👨‍🍳
  • 파일을 직접 열고 읽음
  • 폴더 전체를 검색
  • 파일을 수정하고 저장
  • 명령어를 직접 실행
구분 일반 Claude Claude Code
파일 접근 볼 수 없음 직접 열기 가능
작업 방식 수동 복붙 필요 폴더 검색·자동 처리
파일 수정 불가 수정·저장 가능
커뮤니케이션 지시만 명령 실행

"Cowork(데스크탑 앱 기능)을 쓰면 터미널 지식 없이도 클릭 몇 번으로 Claude Code를 자동변속기처럼 편하게 쓸 수 있습니다."

03 · 어디서 쓸 수 있나?

|5가지 사용 방법

쉬움 → 어려움 순서로 나열했습니다. 개발 지식이 없다면 Desktop App부터 시작하세요.

🌐
웹 브라우저
claude.ai/code 접속. 설치 불필요. 편의점 도시락처럼 바로 먹을 수 있어요.
가장 쉬움
🖥️
Desktop App
Cowork 기능 포함. 클릭으로 문서·파일 자동화. 카카오톡 설치처럼 한 번만 설치하면 끝.
초보자 추천
🧩
VS Code
코드 작성 중 실시간 Claude 도움. 한글 맞춤법 검사처럼 옆에서 실시간 보조.
코딩 입문자
🔷
JetBrains
IntelliJ, PyCharm, WebStorm 통합. 전문 개발자용 병원 장비 같은 존재.
전문 개발자
⌨️
터미널 / CLI
가장 강력한 방법. 재료부터 다듬는 셰프 방식 — 어렵지만 완전 통제 가능.
고급 사용자

나는 어떤 방법이 맞을까? — 개발 지식 없음 → Desktop App(Cowork) · 코딩 공부 중 → VS Code 확장 · 전문 툴 사용 → JetBrains · 터미널 능숙 → CLI

04 · 무엇을 할 수 있나?

|8가지 핵심 기능

공식 기능 8가지 — 지금 당장 활용할 수 있는 실무 예시와 함께 소개합니다.

🧹
반복 업무 자동화
함수 주석 추가, 릴리즈 노트 작성, 중복 코드 찾기.

프롬프트 예시: "모든 함수에 한국어 주석 달아줘"
🔨
기능 구현 & 버그 수정
로그인 유효성 검사 생성, TypeError 해결, 로딩 스피너 추가.

프롬프트 예시: "로그인 페이지 비밀번호 검증 버그 고쳐줘"
📝
Git 커밋 & PR 자동화
변경사항 커밋, 수정 내용 요약, PR 설명 초안 작성.

명령어: claude commit
🔌
외부 툴 연결 (MCP)
Slack, Jira, GitHub, Google Drive 연결.

프롬프트 예시: "Slack #general 채널에 배포 완료 메시지 보내줘"
⚙️
규칙 & 워크플로우 설정
CLAUDE.md 설정, Skills 생성, Hooks 설정으로 나만의 환경 구축.
👥
에이전트 팀 운용
로그인·상품목록·결제·디자인을 여러 Claude가 동시에 개발.
나루토 분신술처럼요.
⏰
반복 작업 스케줄링
매일 아침 PR 리뷰, 주간 코드 요약, 주기적 API 헬스체크 자동 실행.
📱
어디서든 작업
폰으로 작업 이어받기, Slack 명령, 대화 재개.
장소 제한 없이 연속 작업 가능.
05 · 빠른 시작

|8단계로 시작하기

지금 바로 따라해보세요. Pro, Max, Teams, Enterprise 구독 또는 API 계정이 필요합니다.

1

설치

Mac/Linux: curl -fsSL https://claude.ai/install.sh | sh
Windows PowerShell: irm https://claude.ai/install.ps1 | iex
Homebrew: brew install claude

2

로그인

터미널에서 claude 입력 → 브라우저 로그인 화면이 열립니다. Pro/Max/Teams/Enterprise 구독 또는 Console API 계정 필요.

3

프로젝트 폴더로 이동

cd 폴더경로 로 이동 후 claude 입력하면 해당 폴더 기준으로 시작됩니다.

4

첫 번째 질문

"이 프로젝트가 무엇을 하는지 설명해줘" — Claude가 폴더를 읽고 전체 구조를 파악합니다.

5

코드 수정 요청

"메인 파일에 hello world 함수 추가해줘" — Claude가 변경사항을 제안하고, 승인 시 직접 저장합니다.

6

Git 저장

claude commit — 변경 내용을 자동으로 분석해 설명적인 커밋 메시지를 만들어 저장합니다.

7

버그 수정

에러 메시지를 그대로 붙여넣으면 Claude가 원인을 찾아 자동으로 수정합니다.

8

추가 작업

단위 테스트 작성, 코드 리뷰 요청 등 자유롭게 확장하세요.
팁: "버그 고쳐줘"보다 "로그인 페이지 비밀번호 검증 버그 고쳐줘"처럼 구체적일수록 더 정확합니다.

명령어 기능
claude Claude Code 시작
claude "작업" 일회성 작업 실행
claude -p "질문" 답변 받고 종료
claude -c 이전 대화 이어하기
claude commit Git 커밋 생성
/clear 대화 기록 초기화
/help 명령어 목록 보기
/resume 이전 세션 재개
exit / Ctrl+C 종료
06 · 파일 종류 이해

|확장자가 뭔지 몰라도 OK

Claude Code가 다루는 파일 형식을 한 번만 익혀두면 대화할 때 훨씬 수월해집니다.

확장자 종류 용도
.docx Word 문서 텍스트 문서
.xlsx Excel 파일 스프레드시트
.html 웹페이지 브라우저에서 표시
.md 마크다운 문서·README·CLAUDE.md
.js JavaScript 웹 인터랙티비티
.css 스타일시트 디자인·레이아웃
.py Python 데이터 분석·자동화
.txt 일반 텍스트 기본 텍스트 파일
📄
.md (마크다운)이란?
카카오톡에서 **굵게**처럼 서식 기호를 쓰는 것과 같은 원리입니다.

# 제목 → 큰 제목으로 표시
**굵게** → 볼드 텍스트
- 항목 → 불릿 리스트
💡
왜 .md를 쓸까?
파일 용량이 작고, GitHub에서 예쁘게 표시되며, Claude Code의 표준 형식입니다.

CLAUDE.md, README.md, 뉴스레터 초안 등 Claude와 주고받는 거의 모든 문서가 .md 형식입니다.
07 · 핵심 개념

|알아야 할 7가지

Claude Code를 제대로 활용하려면 이 개념들을 이해해야 합니다.

📓

CLAUDE.md — Claude의 메모장

대화가 시작될 때마다 자동으로 읽히는 규칙 파일. 도리(니모)가 지갑에 메모를 넣어두듯, Claude가 매 세션 시작 시 이 파일을 읽고 규칙을 기억합니다.

# 프로젝트 규칙
- 항상 한국어로 답해줘
- TypeScript 사용
- 빌드: npm run build
- 탭 대신 스페이스 2칸
📞

세션 & 컨텍스트 윈도우

Claude와의 대화 1번 = 1 세션. 다음 날 새 대화를 시작하면 이전 내용은 기억 못합니다. 컨텍스트 윈도우는 Claude의 뇌 = 노트 한 장. 대화가 길어질수록 가장 오래된 내용부터 사라집니다.

🟢 초록(72% 미만) → 정상  |  🟡 노랑 → /clear 권장  |  🔴 빨강 → 새 세션 시작

⌨️

슬래시 명령어 — 단축 치트키

RPG 게임의 치트키처럼, /heal로 회복·/map으로 지도 표시하듯 단축 명령을 제공합니다. /를 입력하면 자동완성 목록이 표시됩니다.

🔌

MCP — 외부 툴 연결

Model Context Protocol. 노트북을 TV에 연결하려면 HDMI 케이블이 필요하듯, Claude를 Slack·GitHub·Notion에 연결하는 케이블입니다.
Cowork 데스크탑 앱 설정 → MCP 서버 추가로 쉽게 연결 가능.

⚡

Hooks — 자동 실행 트리거

스마트폰 자동화 앱처럼, "파일 수정 후 lint 자동 실행"을 설정해두면 매번 직접 요청할 필요가 없습니다. Hooks 없이는 수동으로 lint를 매번 요청해야 하고 빠뜨리기 쉽습니다.

🃏

Skills — 나만의 명령어

복잡한 워크플로우를 레시피 카드로 저장해두고 /slash 명령어로 한 번에 실행. /review-pr → PR 전체 리뷰 자동 진행. Cowork 마켓플레이스에서 미리 만들어진 Skills도 설치 가능.

👥

서브에이전트 — 나루토 분신술

여러 Claude가 동시에 일합니다. 리드 Claude가 전체를 조율하고, 서브에이전트 A는 로그인·B는 상품목록·C는 결제·D는 디자인을 병렬로 처리해 "쇼핑몰 사이트 만들어줘"를 순차 작업보다 훨씬 빠르게 완성합니다.

08 · Next Level

|Skills에서 멈추면 안 됩니다

대부분의 사람들이 Skills·에이전트에서 멈추고 더 큰 그림을 놓칩니다.

📱
실제 사례 — 카드뉴스 자동화 (devdesign.kr)
1단계 · 문제: 카드뉴스 수동 제작이 너무 번거로움

2단계 · Skill 도입: Claude Code로 자동화 → 잘 작동함

3단계 · 새 문제: 텍스트로 요청·피드백하는 방식이 불편함

4단계 · 앱으로 진화: Skill 엔진 위에 Electron 기반 데스크탑 UI 구축 → 경험이 완전히 달라짐

"Skills만 쓸 때와 전용 앱이 생겼을 때의 경험은 완전히 다릅니다."
🌐
자연스러운 확장
하나의 자동화가 다음 자동화로 이어집니다.

Obsidian 노트 연동
→ 인스타그램 자동 업로드
→ 콘텐츠 배포 자동화
→ 나만의 개인 OS

내 불편함을 자동화하다 보면 어느 순간 나만의 운영체제가 만들어집니다.
단계 하는 일 비유
1단계 Claude Code Skills 만들기 레시피 카드 만들기 🃏
2단계 에이전트로 자동화 셰프 고용하기 👨‍🍳
3단계 데스크탑 앱으로 패키징 식당 열기 🍽️
4단계 앱들을 연결 → 개인 OS 식당 제국 건설 👑

Skills에서 멈추면 전부 놓칩니다. 내 불편함을 하나씩 자동화하다 보면 그게 곧 나만의 개인 OS가 됩니다. 🚀

09 · 숨겨진 기능

|Top 10 Hidden Features

3개월 만에 검색량 5배 상승. ChatGPT·Gemini를 제치고 있는 Claude의 숨은 기능들입니다.

📊
01 · 시각화 (최신 업데이트)
실시간 인터랙티브 그래프, 평면도, 3D 모델 생성. 음식 사진 업로드 → 영양소 차트 자동 생성. 방 크기 입력 → 2D 평면도 + 가구 배치 최적화. ⚠️ 생성 파일은 즉시 다운로드 권장.
⚙️
02 · 커스텀 설정 (자주 놓침)
프로필 → 설정(좌측 하단). 직업·답변 스타일·취미·목표·MBTI 입력 → "커스텀 설정 프롬프트 2000자 작성해줘" 입력 → 복붙 완성. 메모리 생성·대화 검색 기능도 활성화 가능.
📁
03 · Projects (반복 작업 자동화)
한 번 가이드라인 설정 → 짧은 프롬프트만으로 동일 포맷 작업 반복 생성. 블로그 작성 프로젝트: 2000자 가이드라인 + 단락수·키워드·제목 형식 지정 → 소스만 올리면 자동 완성.
🧩
04 · Skills (상황 감지형 규칙)
사이드바 → 커스터마이즈 → 새 스킬 생성. Projects = 폴더 전체에 항상 적용. Skills = 특정 상황 감지 시 자동 활성화. "스레드 작성 스킬 프롬프트 만들어줘" → AI가 자동 생성.
🤖
05 · 모델 선택 가이드
Opus: 가장 똑똑, 복잡한 작업, 느림, 크레딧 많이 소비
Haiku: 가장 빠름, 단순 질문
Sonnet: 속도·능력 균형 → 일상 업무 최적 (가장 안전한 선택)
딥 리서치: 5~10분 웹 조사 → 보고서급 산출
📄
06 · 문서 생성 (Excel/PPT/Word)
"2페이지 Word 문서로 요약해줘" → 자동 생성. "프레젠테이션으로 만들어줘" → 자동 포맷 PowerPoint. 최신 업데이트: PPT/Excel 앱 내 직접 연동 → 프롬프트만으로 편집·디자인 수정 가능. ⚠️ 크레딧 소비 주의.
🖼️
07 · Artifacts (아티팩트 창)
대화 오른쪽에 실시간 코드·문서 미리보기. 사이드바에서 예시 활용 레퍼런스와 내 아티팩트 컬렉션 관리 가능.
🔌
08 · Connectors (MCP 통합)
사이드바 → 커스터마이즈 → 툴 연결. 개별 API 설정 없이 외부 플랫폼 통합. Gmail + Google Drive + Notion 연동 → 이메일 확인 → Notion 업로드 → 파일 수정 → Google 전송까지 한 번에.
🗺️
09 · 커스텀 설정 vs Projects vs Skills
커스텀 설정: 모든 대화에 항상 적용 — 나의 기본 성격·말투 설정
Projects: 선택한 폴더에만 적용 — 업무 태스크 규칙북
Skills: 특정 상황 감지 시 활성화 — 자동 트리거 매크로 버튼
💳
10 · 요금 정보
Pro Plan: 월 약 25,000원. 대부분 기능 접근 가능.
무료로 시작하고 싶다면 Gemini Free 먼저 사용해도 좋습니다.

3개월 만에 검색량 5배 상승. 이제 모든 기능을 제대로 쓸 준비가 됐습니다. 🚀
10 · 이해도 확인

|퀴즈로 마무리

4문제를 풀면서 오늘 배운 내용을 정리해보세요.

Q1
대화가 시작될 때마다 자동으로 읽히는 파일은?
README.md
✓ CLAUDE.md
index.html
HOOK.md
Q2
MCP의 역할은?
파일 저장
✓ Claude를 외부 서비스에 연결
코드 자동 실행
대화 녹음
Q3
여러 Claude가 동시에 일하는 기능은?
Skills
Hooks
✓ 서브에이전트
MCP
Q4
Hooks란?
Claude의 메모장
슬래시 단축 명령어
✓ Claude 작업 전후 자동 실행 트리거
외부 서비스 연결기

지금 바로 시작해보세요

개발 지식 0%여도 괜찮습니다. Desktop App으로 오늘부터 시작할 수 있어요.

5분 빠른 시작 가이드 →
11 · 용어집

|헷갈리는 개념 정리

모르는 용어가 나왔을 때 찾아보세요.

영문 한국어 한 줄 설명
Claude 클로드 Anthropic이 만든 AI 어시스턴트. ChatGPT의 경쟁 상대.
Claude Code 클로드 코드 Claude가 실제 파일을 열고 수정하는 코딩 전용 툴.
Cowork 코워크 비개발자도 클릭으로 Claude Code를 쓸 수 있는 데스크탑 앱 GUI 기능.
.md / Markdown 마크다운 #은 제목, **굵게**는 볼드. 카카오톡 서식 기호와 비슷한 텍스트 포맷.
CLAUDE.md 클로드 메모장 매 세션 자동으로 읽히는 규칙 파일. 도리의 지갑 메모.
Session 세션 Claude와의 대화 1회. 전화 통화 1번.
Context Window 컨텍스트 세션당 최대 기억 용량. 노트 한 장.
Auto-Memory 자동 메모리 Claude가 스스로 CLAUDE.md에 학습 내용을 기록하는 기능.
/Slash Commands 단축 명령어 /help, /clear 같은 키보드 단축키.
MCP 외부 툴 연결 Model Context Protocol. Claude를 Slack·GitHub에 연결하는 HDMI 케이블.
Hooks 자동 실행 트리거 파일 수정 전후 자동 실행 설정. 스마트폰 자동화 앱.
Skills 나만의 명령어 복잡한 워크플로우를 /명령어로 저장. 레시피 카드.
Sub-agents 서브에이전트 여러 Claude가 동시에 일하는 것. 나루토 분신술.
Git 버전 관리 코드 변경 이력 관리 시스템. 게임 세이브 포인트.
Commit 커밋 Git에 코드 변경사항을 저장. 세이브 포인트 하나.
Pull Request 풀 리퀘스트 코드 리뷰·병합 요청.
Terminal / CLI 터미널 텍스트로 컴퓨터를 제어하는 검은 화면.
.claude/ 클로드 설정 폴더 Skills·Hooks 설정이 저장되는 폴더.

공식 문서 더 보기 → code.claude.com/docs ↗