클로드 코드
AI 레시피
코딩 한 줄 몰라도 괜찮아요 😊
그림과 비유로, 처음부터 끝까지 쉽게 설명해요!
🤖 클로드(Claude)란?
초똑똑한 AI 비서예요
미국 회사 Anthropic이 만든 인공지능이에요. 챗GPT처럼 뭐든 물어볼 수 있어요.
💻 클로드 코드(Claude Code)란?
클로드가 직접 내 컴퓨터 파일을 열고, 읽고, 수정하고, 저장까지 해주는 코딩 전문 도구예요.
❌ 일반 클로드
- 파일을 못 봐요
- 내가 코드를 복사해서 붙여넣어야 해요
- 실제 파일에 손을 못 대요
- 말로만 알려줘요
✅ 클로드 코드
- 파일을 직접 열어요
- 폴더 전체를 뒤져서 읽어요
- 코드를 고치고 저장까지
- 실제로 명령어도 실행해요
내가 파일을 하나하나 보여줄 필요 없이 클로드가 알아서 찾아요!
부엌에 직접 오는 요리사
일반 클로드가 "전화로 레시피 알려주는 요리사"라면,
클로드 코드는 "우리 집 부엌에 직접 와서 요리까지 해주는 요리사"예요.
🖥️ 코워크(Cowork)란?
자동 기어 자동차
클로드 데스크톱 앱 안에 있는 기능이에요.
어렵게 터미널(검은 화면)을 몰라도 클릭 몇 번으로 클로드 코드를 쓸 수 있어요.
🌍 어디서 쓸 수 있나요?
클로드 코드는 5가지 방법으로 쓸 수 있어요. 어디서 쓰든 같은 클로드 코드예요. 내 상황에 맞는 걸 고르면 돼요!
웹 브라우저 ✅ 가장 쉬움
claude.ai/code 에서 바로 접속
집에서 요리 안 해도 편의점 가면 바로 먹을 수 있잖아요? 웹도 그래요.
아무것도 설치 안 해도 인터넷만 되면 바로 클로드 코드를 쓸 수 있어요.
데스크톱 앱 (코워크 포함) 👍 초보 추천
클릭 몇 번으로 문서·파일·자동화 작업 가능. 개발 지식 0% OK.
카카오톡을 설치하면 쭉 쓸 수 있잖아요? 데스크톱 앱도 그래요.
한번 설치하면 바탕화면에서 바로 열 수 있고, 아이콘 클릭 → 바로 사용이에요.
VS Code 📚 코딩 배우는 분
코드를 작성하면서 바로 옆에서 클로드에게 물어볼 수 있어요.
워드에서 글 쓸 때 맞춤법 검사기가 밑줄 그어주잖아요?
VS Code에서 코드 쓸 때 클로드가 바로 옆에서 실시간으로 도와줘요.
JetBrains 💼 전문 개발자
대형 회사 개발자들이 주로 쓰는 고급 환경이에요.
병원 의사들이 일반 체온계 대신 정밀 의료기기를 쓰듯이,
전문 개발자들이 더 정밀한 개발 도구(JetBrains) 안에서 클로드를 써요.
터미널 (CLI) 🚀 고급자용
마우스 대신 키보드만으로 모든 걸 제어해요.
배달앱으로 시키면 쉽지만, 직접 요리하면 원하는 대로 다 만들 수 있잖아요?
터미널도 어렵지만 뭐든 마음대로 제어할 수 있는 가장 강력한 방법이에요.
⚠️ 처음엔 어렵게 느껴져도 괜찮아요. 코워크나 웹으로 먼저 시작해보세요!
→ 🌐 웹 (claude.ai/code) — 설치도 필요 없어요
✨ 뭘 할 수 있나요?
공식 문서 기준 8가지 기능이에요. 바로 써볼 수 있는 실제 프롬프트도 같이 넣었어요!
귀찮은 작업 자동화
기능 만들기 & 버그 수정
Git 커밋 & PR 자동화
외부 도구 연결 (MCP)
나만의 규칙 & 워크플로우
에이전트 팀 실행
반복 작업 예약 (스케줄)
어디서나 작업
🚀 처음 시작하는 법
터미널로 시작하는 방법이에요. 코워크(데스크톱 앱)를 쓰면 앱 실행 후 로그인만 하면 돼요!
⬇️ 설치하기
Mac/Linux: curl -fsSL https://claude.ai/install.sh | bash
Windows PowerShell: irm https://claude.ai/install.ps1 | iex
Homebrew: brew install --cask claude-code
🔑 로그인하기
터미널에서 claude를 입력하면 로그인 화면이 나와요.
Pro, Max, Teams, Enterprise 구독 또는 Console(API) 계정이 필요해요.
한번 로그인하면 다음부터 자동 연결!
📂 프로젝트 폴더로 이동
cd 내폴더경로 → claude 입력
환영 화면이 나오면 성공! 이전 대화를 이어하려면 /resume을 입력하세요.
❓ 첫 번째 질문 해보기
이 프로젝트는 무엇을 하나요? 라고 입력해보세요.
클로드가 알아서 파일들을 분석하고 설명해줘요!
✏️ 코드 변경 해보기
주 파일에 hello world 함수 추가해줘
클로드가 뭘 바꿀지 먼저 보여주고 승인을 물어봐요. 파일 수정 전 항상 허락 받음!
💾 Git으로 저장하기
변경 사항을 설명이 담긴 메시지로 커밋해줘
Git을 몰라도 말로 시키면 클로드가 알아서 해요!
🐛 버그 수정 해보기
사용자가 빈 양식을 제출할 수 있는 버그가 있어요, 수정해줘
에러 메시지가 있으면 그냥 붙여넣으면 돼요!
🎯 다른 것도 해보기
계산기 함수에 대한 단위 테스트 작성해줘
내 변경 사항을 검토하고 개선 사항 제안해줘
자주 쓰는 명령어
| 명령어 | 하는 일 |
|---|---|
| claude | 클로드 코드 시작 |
| claude "할 일" | 한 번만 시키기 (예: claude "빌드 오류 고쳐줘") |
| claude -p "질문" | 답 받고 바로 끝내기 |
| claude -c | 이전 대화 이어하기 |
| claude commit | Git 커밋 만들기 |
| /clear | 대화 기록 지우기 |
| /help | 명령어 목록 보기 |
| /login | 계정 로그인 또는 전환 |
| /resume | 이전 대화 이어서 하기 |
| exit / Ctrl+C | 종료하기 |
📁 파일 종류 이해하기
파일 이름 뒤의 .html, .md, .js 같은 글자를 "확장자"라고 해요. 파일이 어떤 종류인지 알려주는 표시예요.
웹페이지
브라우저에서 열면 예쁜 페이지. 이 가이드가 .html!
마크다운
규칙 있는 메모장. CLAUDE.md도 이 형식!
자바스크립트
웹페이지를 움직이게 만드는 코드
스타일시트
색깔·폰트·레이아웃 담당
파이썬
데이터 분석·자동화 코드
텍스트
그냥 글자만 있는 파일
📝 .md 파일(마크다운)이란?
📝 파일 안에서 (코드)
# 제목 **굵은** 텍스트 - 항목 1 - 항목 2
✨ 화면에 보이는 것
제목
굵은 텍스트
• 항목 1
• 항목 2
카카오톡 꾸미기 기호와 같아요
카카오톡에서 **굵게**라고 쓰면 굵게로 보이는 것처럼, .md도 특수기호로 글 서식을 만들어요.
📋 CLAUDE.md — 클로드의 메모장
CLAUDE.md는 클로드가 매 대화를 시작할 때 자동으로 읽는 필독 파일이에요.
도리의 메모지
영화 니모를 찾아서의 도리는 기억을 자주 잊어요.
하지만 지갑에 메모를 붙여두면 매번 꺼내서 읽을 수 있어요!
새 대화 시작
CLAUDE.md
자동으로 읽기
규칙 기억하고
작업 시작
대화 종료
(기억 리셋)
⤴ 다음 대화에서 이 과정을 반복해요!
📝 CLAUDE.md 예시
# 내 프로젝트 규칙 - 항상 한국어로 답변 - TypeScript 사용 - 빌드: npm run build - 테스트: npm test - 탭 대신 스페이스 2칸
✅ 쓸 수 있는 것들
- 코딩 스타일 규칙
- 자주 쓰는 명령어
- 프로젝트 구조 설명
- 금지 사항 목록
- 선호하는 라이브러리
자동 메모리 — 클로드가 스스로 메모!
작업하면서 배운 것을 스스로 CLAUDE.md에 기록해요. 내가 따로 안 알려줘도 돼요!
/memory로 확인 가능)⏱️ 세션과 컨텍스트란?
세션 = 전화 통화 1회
친구한테 전화해서 30분 수다 떨고 끊으면 = 세션 1개.
다음 날 다시 전화하면 새 세션. 어제 통화 내용은 기억 못 해요.
🧠 컨텍스트 윈도우 — 메모지 1장
대화가 길어질수록 메모지가 채워져요. 꽉 차면 오래된 내용부터 사라져요.
/clear로 정리하면 좋아요.⚡ /슬래시 명령어란?
RPG 게임 치트키
RPG 게임에서 /heal치면 회복, /map치면 지도가 뜨듯이,
클로드 코드에서 /로 시작하는 명령어로 기능을 바로 실행해요.
/를 입력하면 쓸 수 있는 명령어 목록이 자동으로 떠요. Skills를 만들면 내 명령어도 추가돼요!| 명령어 | 하는 일 |
|---|---|
| /help | 모든 명령어 목록 보기 |
| /clear | 대화 내용 지우기 (새로 시작) |
| /login | 계정 로그인 또는 전환 |
| /memory | 메모리(CLAUDE.md) 관리 |
| /resume | 이전 대화 이어서 하기 |
| /schedule | 반복 작업 예약 |
| /loop | 같은 프롬프트 반복 실행 |
🔌 MCP — 외부 도구 연결
MCP (Model Context Protocol)는 클로드가 외부 앱·서비스와 연결하기 위한 개방형 표준이에요.
연결 후: "구글 드라이브에서 오늘 공유된 문서 요약해줘" 같은 것도 가능!
HDMI 케이블 같은 것
노트북을 TV에 연결하려면 HDMI 케이블이 필요하듯이,
클로드를 Slack, GitHub에 연결하려면 MCP가 필요해요.
MCP를 연결하면 클로드가 할 수 있는 일이 훨씬 많아져요
🪝 Hooks — 자동 실행 설정
스마트폰 자동화 앱
"오전 7시 → 알람 울리기"처럼,
"클로드가 파일 수정 → 자동으로 코드 정리 실행" 같은 걸 설정해요.
파일 수정
자동 실행
자동 완료
"파일 수정 후 lint 실행해줘"라고 매번 말 안 해도 자동으로 돼요!
❌ Hooks 없이
- 파일 수정 후 매번 직접 말해야 해요
- 깜빡하면 누락!
✅ Hooks 설정 후
- 자동으로 lint·테스트·빌드 실행
- 빠뜨릴 일이 없어요
🧩 Skills — 나만의 명령어 만들기
레시피 카드
맛있는 김치찌개 만드는 법을 매번 검색하는 대신,
레시피 카드에 적어두면 언제든 꺼내서 쓸 수 있어요.
/명령어로 저장해두는 레시피 카드. /review-pr을 치면 PR 검토 절차 전체가 자동 실행!📂 skills/
📂 review-pr/
📄 SKILL.md
📂 deploy/
📄 SKILL.md
/review-pr 입력/deploy 입력코워크 마켓플레이스에서 Skills를 설치할 수도 있어요!
👥 서브에이전트 — 클로드 분신술
나루토 그림자 분신술
나루토가 "그림자분신술!"을 외치면 여러 명이 동시에 일하듯이,
여러 클로드가 동시에 작업해요!
전체 조율 & 결과 합치기
클로드 A
로그인 기능
클로드 B
상품 목록
클로드 C
결제 시스템
클로드 D
디자인
🚀 스킬에서 앱으로 — 나만의 OS 만들기
스킬·에이전트에서 멈추면 아까워요. 한 단계만 더 가면 완전히 다른 세계!
대부분 여기서 멈춰요 😅
스킬·에이전트 만들고 끝! — 근데 진짜 아까운 거예요
거기서 한 단계만 더 가면 완전히 다른 세계가 열려요.
🃏 카드뉴스 자동화 → 데스크톱 앱까지
devdesign.kr의 이야기
카드뉴스를 수작업으로 만드는 게 너무 귀찮았어요
Claude Code 스킬 만들어서 자동화 성공! 그런데…
텍스트로 요청하고 텍스트로 피드백하는 게 또 불편해요. 디자인 결과물을 터미널에서 수정하는 건 한계가 있거든요
엔진은 Claude Code 스킬 셋 그대로, Electron으로 UI만 씌웠어요.
버튼 하나로 카드뉴스가 나오고, 화면 보면서 바로 수정 가능!
🌱 앱을 만들면 자연스럽게 확장돼요
🎯 핵심 메시지
기자 김연지의 한 줄 정리
터미널 → 스킬 → 데스크톱 앱 → 나만의 OS. 이게 Claude Code의 진짜 로드맵이에요 🚀
| 단계 | 뭘 하나요? | 비유 |
|---|---|---|
| 1단계 | Claude Code로 스킬 제작 | 레시피 카드 만들기 |
| 2단계 | 에이전트로 자동화 | 요리사 고용하기 |
| 3단계 | 데스크톱 앱으로 포장 | 내 식당 오픈하기 🍽️ |
| 4단계 | 앱들 연결 → 나만의 OS | 내 요리 왕국 완성 👑 |
🔥 대부분 모르는 클로드 핵심 기능 10가지
3달 만에 검색량 5배! 챗GPT·제미나이를 압살 중인 클로드의 숨은 기능들 💪
📊 시각화 기능 최신 업데이트
말만 해도 그래프·평면도·3D 모델이 뚝딱!
⚙️ 맞춤 설정 대부분 놓치는 기본 세팅
나만을 위한 클로드로 업그레이드!
"맞춤설정에 입력할 프롬프트를 2천자로 작성해줘" 라고 하면
바로 복붙 가능한 지침이 뚝딱 생성돼요!
📁 프로젝트 기능 반복작업 자동화
한 번 설정하면 매번 같은 말 안 해도 돼요
1️⃣ "프로젝트 지침 2000자로 작성해줘" 입력
2️⃣ 원하는 형식(문단 수·키워드 빈도·제목 포함 등) 지정
3️⃣ 지침 복붙 후 자료만 올리면 → 글이 바로 생성!
🧩 스킬 기능 특정 상황 자동 발동
상황을 감지하면 알아서 켜지는 지침!
프로젝트 = 폴더 단위 지침 (이 폴더 안에서 항상 적용)
스킬 = 상황 단위 지침 (특정 상황 감지 시만 자동 발동!)
🗺️ 맞춤설정 vs 프로젝트 vs 스킬 — 한눈 비교
헷갈리면 이 표 하나로 끝!
| 종류 | 적용 범위 | 비유 |
|---|---|---|
| 맞춤설정 + 메모리 | 모든 대화에 항상 적용 | 내 기본 성격·말투 세팅 |
| 프로젝트 | 선택한 폴더 안에서만 | 업무용 작업 규칙서 |
| 스킬 | 특정 상황 감지 시만 | 자동 발동 매크로 버튼 |
🤖 모델 선택 가이드
어떤 클로드를 골라야 할까?
📄 엑셀 / PPT / 워드 파일 생성
말 한마디로 문서가 뚝딱!
→ 프롬프트만으로 자료 편집·디자인 수정이 앱 안에서 바로 가능!
🖼️ 아티팩트 (Artifacts)
대화 오른쪽에 뜨는 실시간 미리보기 창!
🔌 커넥터 (MCP 연동)
클로드를 외부 앱에 바로 연결!
지메일·구글 드라이브·노션 연결 →
✉️ 미확인 메일 확인, 문서를 노션에 바로 업로드,
노션 파일 불러와서 수정 후 구글로 전송 — 크로스 플랫폼 워크플로우!
💳 요금 안내
얼마면 돼요?
🎯 이해도 체크!
배운 내용 확인! 정답이면 🎉 파티가 열려요!
Q1. 클로드가 매 대화 시작할 때 자동으로 읽는 파일은?
Q2. MCP는 무엇을 위한 것인가요?
Q3. 여러 클로드가 동시에 작업하는 기능 이름은?
Q4. Hooks는 무엇인가요?
📚 전체 용어 정리
클로드 코드에서 만나는 모든 용어를 한눈에!
| 용어 | 한국 이름 | 한 줄 설명 |
|---|---|---|
| Claude | 클로드 | Anthropic이 만든 AI 어시스턴트. 챗GPT 같은 것. |
| Claude Code | 클로드 코드 | 클로드가 실제 파일을 열고 수정하는 코딩 전문 도구. |
| Cowork | 코워크 | 데스크톱 앱에서 비개발자도 쓸 수 있는 GUI 기능. |
| .md / Markdown | 마크다운 | #으로 제목, **로 굵기 표시하는 메모장 파일 형식. |
| CLAUDE.md | 클로드 메모장 | 클로드가 매 세션마다 읽는 필독 규칙 파일. 도리의 메모지. |
| Session | 세션 | 클로드와 나누는 한 번의 대화. 전화통화 1회. |
| Context Window | 컨텍스트 | 한 세션에서 클로드가 기억할 수 있는 최대 양. 메모지 1장. |
| Auto-Memory | 자동 메모리 | 클로드가 작업하며 배운 것을 스스로 CLAUDE.md에 기록. |
| /슬래시 명령어 | 단축 명령어 | 클로드 코드 안의 단축키. /help, /clear 등. |
| MCP | 외부 도구 연결 | Model Context Protocol. 클로드를 외부 서비스에 연결하는 HDMI 케이블. |
| Hooks | 자동 실행 트리거 | 클로드 작업 전후에 자동으로 실행되는 명령어. 스마트폰 자동화 앱 같은 것. |
| Skills | 나만의 명령어 패키지 | 복잡한 작업을 /명령어로 저장해두는 레시피 카드. |
| Sub-agents | 서브에이전트 | 여러 클로드가 동시에 작업. 나루토 분신술. |
| Git | 버전 관리 | 코드 변경 기록 시스템. 게임 세이브 포인트. |
| Commit | 커밋 | 코드 변경 내용을 Git에 저장. 세이브 포인트 1개. |
| Pull Request | 풀 리퀘스트 | 변경 코드를 검토받고 합쳐달라는 요청. |
| Terminal / CLI | 터미널 | 텍스트로 컴퓨터에 명령하는 검은 화면. |
| .claude/ | 클로드 설정 폴더 | Skills, Hooks 설정이 저장되는 폴더. |