Claude Code 강의 가이드

강의 준비부터 실습까지
여기서 다 확인하세요

사전 준비 안내와 터미널 기본 명령어를 정리했어요.
막히시면 오픈채팅으로 편하게 연락 주세요!

1Git for WindowsWindows만
2VS Code공통
3Claude Code CLI공통
🍎
Mac 사용자
2가지 설치

VS Code + Claude Code CLI 설치만 하시면 됩니다.

🪟
Windows 사용자
최대 3가지 설치

Git for Windows (지난 강의 설치자 제외) + VS Code + Claude Code CLI

1
사이트 접속 후 다운로드
git-scm.com 바로가기 →
2
설치
"Download for Windows" 클릭 → .exe 실행 → "Next" 계속 → 완료. 설치 후 실행하거나 뭔가 입력하실 필요 없어요.
1
공식 사이트 접속
code.visualstudio.com 바로가기 →
2
설치
🍎 Mac .dmg 열기 → VS Code 아이콘을 응용 프로그램 폴더로 드래그
🪟 Windows .exe 실행 → "Next" 계속 → 완료
3
실행 확인
VS Code 실행 → 파란 화면 뜨면 성공! 바로 닫아도 됩니다.
1
터미널 열기
🍎 Mac Cmd + Space → "terminal" 입력 → 엔터
🪟 Windows 시작 버튼 → "PowerShell" 검색 → 클릭
2
설치 명령어 입력 후 엔터
🍎 Mac
curl -fsSL https://claude.ai/install.sh | bash
🪟 Windows (PowerShell)
irm https://claude.ai/install.ps1 | iex
3
브라우저에서 Claude.ai 계정으로 로그인
설치 완료 후 브라우저가 자동으로 열려요. API 키·크레딧 충전 불필요!
4
설치 완료 뜨면 바로 실행
Complete! 뜨면 바로 입력
claude
🪟 Windows — 새 터미널 열면 또 오류날 때
영구 PATH 등록이 안 된 거예요. 한 번만 하면 이후엔 괜찮아요.
⚠️

가장 확실한 방법: 관리자 권한으로 재설치
PowerShell 우클릭 → 관리자 권한으로 실행 → Win키 검색 후 Ctrl+Shift+Enter

관리자 PowerShell에서 재설치
irm https://claude.ai/install.ps1 | iex
그래도 안 되면 — Windows에게 claude 위치 알려주기 (한 번만 하면 됨)
[Environment]::SetEnvironmentVariable("PATH", $env:PATH + ";$env:USERPROFILE\.local\bin", "User")
4️⃣

PowerShell 완전히 닫고 새로 열기 → claude 입력!

⚠️

가장 확실한 방법: 관리자 권한으로 재설치
일반 PowerShell로 설치하면 권한 문제로 PATH 등록이 안 되는 경우가 많아요!

1️⃣

PowerShell 우클릭 → 관리자 권한으로 실행

2️⃣ 재설치
irm https://claude.ai/install.ps1 | iex
3️⃣

PowerShell 완전히 닫고 새로 열기 → claude 입력!

그래도 안 되면:
1️⃣

PowerShell에 아래 명령어 붙여넣고 엔터 (지금 세션만 임시 적용)

임시 적용
$env:PATH += ";$env:USERPROFILE\.local\bin"
2️⃣

PowerShell 껐다 켜도 유지되게 적용

영구 적용
[Environment]::SetEnvironmentVariable("PATH", $env:PATH + ";$env:USERPROFILE\.local\bin", "User")
3️⃣

PowerShell 완전히 닫고 새로 열기 → claude 입력!

Claude Pro 이상 계정이면 추가 비용 없이 바로 사용 가능해요. 기존 계정 그대로 쓰시면 됩니다.

💡

Claude Code 쓰는 데 딱 필요한 명령어만 골랐어요. Mac은 터미널, Windows는 PowerShell에서 입력하세요.

📍
pwd
지금 내가 어느 폴더에 있는지 확인
Mac / Windows 공통
pwd
📂
ls / dir
현재 폴더 안의 파일·폴더 목록 보기
🍎 Mac
ls
🪟 Windows
dir
🚶
cd
다른 폴더로 이동
바탕화면으로
cd ~/Desktop
특정 폴더로
cd 폴더이름
한 단계 위로
cd ..
📁
mkdir
새 폴더 만들기
Mac / Windows 공통
mkdir 내프로젝트
✏️
mv / ren
파일 이름 바꾸기 또는 이동
🍎 Mac
mv 원래이름.html 새이름.html
🪟 Windows
ren 원래이름.html 새이름.html
📋
cp / copy
파일 복사
🍎 Mac
cp 원본.html 복사본.html
🪟 Windows
copy 원본.html 복사본.html
🌐
open / start
파일을 브라우저나 앱으로 열기
🍎 Mac
open index.html
🪟 Windows
start index.html
🤖
claude
Claude Code 실행 / 종료
실행
claude
종료
Ctrl + C
🔥

꿀팁: 폴더·파일 이름 타이핑 중 Tab 키를 누르면 자동완성이 돼요. 긴 이름 다 안 쳐도 됩니다!

Claude Code 전용 — 명령어 몰라도 됩니다
🤖

Claude Code 안에서는 그냥 한국어로 말하면 돼요. 명령어 외울 필요 없어요!

💬
자연어로 폴더 이동
cd 명령어 몰라도 그냥 말하면 됨
Claude Code 채팅창에 입력
momnomad.com 폴더로 이동해줘
또는 직접 입력
cd ~/Documents/momnomad.com
🪟
새 탭 / 새 창 열기
터미널을 여러 개 띄울 때
🍎 Mac — 새 탭 (같은 창 안에)
Cmd + T
🍎 Mac — 새 창
Cmd + N
🪟 Windows — 새 창
우클릭 → "새 창 열기"
💡

새 탭·창은 홈 디렉토리(~)에서 시작해요. 원하는 레포로 이동하려면 아래처럼 하세요.

📁
새 창에서 원하는 레포로 이동 후 실행
이동 + Claude Code 실행을 한 번에
레포로 이동 후 Claude 실행
cd ~/Documents/내레포폴더 && claude
또는 한 줄씩 순서대로
cd ~/Documents/내레포폴더
🚪
Claude Code 종료
대화를 끝내고 터미널로 돌아오기
방법 1 — 명령어로 종료
/exit
방법 2 — 강제 종료
Ctrl + C
🧠
중요 내용 메모리에 저장
Claude가 다음에도 기억하게 하기
# 으로 시작하면 메모리에 바로 저장
# 이 프로젝트는 쿠팡 파트너스 블로그야
저장된 메모리 확인
/memory
컨텍스트 초기화 (새로 시작)
/clear
💡

CLAUDE.md에 써두는 게 가장 확실해요. 프로젝트 폴더에 있으면 Claude가 매번 자동으로 읽어요.

🔥

꿀팁: 폴더·파일 이름 타이핑 중 Tab 키를 누르면 자동완성이 돼요. 긴 이름 다 안 쳐도 됩니다!

😅

명령어 외울 필요 없어요! 잊어버렸을 땐 두 가지 방법이 있어요.

1. 이 페이지 열어두고 복사 버튼 눌러서 붙여넣기
2. claude.ai 채팅창에 "바탕화면으로 이동하는 터미널 명령어 알려줘" 하고 물어보면 바로 알려줘요

Claude Code 터미널 안에서는 명령어 대신 그냥 한국어로 말해도 됩니다. "바탕화면으로 이동해줘"라고 입력하면 알아서 해줘요.

다양한 CLI 설치하기
💡

터미널에서 다양한 도구를 설치해서 쓸 수 있어요. Claude Code처럼 명령어 한 줄이면 됩니다.

📦
패키지 매니저별 설치 방법
Mac / Windows 각각 다른 방법 사용
🍎 Mac — Homebrew로 설치
brew install 패키지이름
🪟 Windows — winget으로 설치
winget install 패키지이름
공통 — npm으로 설치
npm install -g 패키지이름
자주 쓰는 CLI 예시
vercel
웹사이트 배포
codex
GPT 코딩 도구
gh
GitHub 터미널 관리
supabase
DB/백엔드
netlify
웹사이트 배포
claude
Claude Code
GitHub 스킬 포크 & 클론해서 설치
🍴
커뮤니티 공유 스킬 가져다 쓰기
포크 → 클론 → Claude 스킬 폴더에 넣기
1️⃣

GitHub에서 마음에 드는 스킬 레포 접속 → 오른쪽 상단 + 버튼 → Fork → 내 계정으로 복사됨

2️⃣ 내 컴퓨터로 클론
git clone https://github.com/내계정/스킬레포이름
3️⃣ Claude 스킬 폴더로 복사
cp -r 스킬레포이름 ~/.claude/skills/
4️⃣ Claude Code 재시작
Ctrl+C → claude
💡

ChatGPT 아시죠? 그 GPT도 MCP로 연결하면 Claude가 GPT한테 직접 일 시킬 수 있어요.
은희님 터미널에 이미 연결된 codex가 바로 그 예시예요!

claude mcp list 로 현재 연결된 MCP 목록 확인 가능해요.

컨텍스트 관리 — 터미널 안 꺼지게 하는 법
⚠️

대화가 길어지면 Claude Code가 저절로 꺼지거나 느려져요. 중간중간 정리해주는 게 필수예요!

🧹
컨텍스트 관리 명령어
Claude Code 채팅창에서 입력
현재 얼마나 찼는지 확인
/context
압축 (중요한 것만 남기고 줄이기)
/simplify
요약해서 줄이기 (/simplify와 비슷)
/compact
완전 초기화 (새로 시작)
/clear
💡

/context → 작업 중 "얼마나 남았지?" 확인
/simplify → 70~80% 찼을 때. 작업 이어가면서 정리
/clear → 작업 끝내고 새 작업 시작할 때

⚠️ /clear 하면 대화 기록 날아가요! 중요한 내용은 CLAUDE.md에 저장해두고 지우세요.

💤
잠금화면 vs 절전모드
cron 자동화 쓸 때 알아야 할 것
✅ 잠금화면 (화면만 꺼짐) cron 작동
⚠️ 절전모드 (Sleep) cron 멈춤
❌ 전원 끔 cron 멈춤
💡

Mac 절전모드 방지: 시스템 설정 → 배터리 → 절전 모드 진입 방지 체크

그래도 불안하면 → Railway 서버에 올리면 컴퓨터 꺼져도 24시간 돌아가요!

실제 경험담
"비개발자,
코딩의 '코'자를 모르던
47세도 해냈습니다"
아래 순서 그대로만 따라하시면 됩니다.
코딩 몰라도 됩니다. 말로 시키면 돼요.
💡

오늘 강의 목표: 로컬(내 컴퓨터)에서 열리는 내 사업 소개 웹페이지 1개 완성. 인터넷에 올리는 배포는 다음 단계예요.

1
claude.ai 채팅창에서 기획
만들고 싶은 걸 말로 설명하면 돼요
이렇게 입력해보세요
나는 웨딩 컨설턴트야. 내 서비스를 소개하는 한 페이지짜리 홈페이지를 만들고 싶어. 따뜻하고 신뢰감 있는 느낌으로, 베이지 계열 색상으로 해줘.
2
구성 확인 & 수정
Claude가 제안한 구성을 보고 수정하기
마음에 들면 그대로, 아니면 이렇게
3번 섹션 빼줘
고객 후기 섹션 추가해줘
📦

스택이 뭔가요? 집 지을 때 재료를 고르는 것처럼, 웹페이지도 어떤 재료로 만들지 정해요.

HTML — 파일 하나짜리 간단한 페이지. 오늘 만드는 것
Astro — 여러 페이지 있는 사이트. lboss2.com이 이걸로 만들어짐
Next.js — 회원가입·결제 같은 기능 필요할 때. 뚝딱툴·사주워크북이 이거
Supabase — 데이터베이스·로그인 기능. "내 앱의 창고 + 보안문"
Cloudflare — 배포·도메인·보안. "내 사이트를 인터넷에 올려주는 집배원"

오늘은 HTML로 감각 익히고, 실제 서비스 만들 땐 여기서 스택도 함께 결정하면 됩니다.

3
CLAUDE.md 만들어달라고 요청
AI 팀원들이 읽을 규칙서예요
지금 우리가 결정한 내용으로 CLAUDE.md 파일 만들어줘
💡

오른쪽에 파일이 생기면 다운로드 버튼 눌러서 저장해두세요.

4
폴더 만들고 CLAUDE.md 넣기
내 프로젝트 공간을 만드는 거예요
터미널에서 바탕화면에 폴더 만들기
mkdir ~/Desktop/내사업홈페이지
💡

폴더 만들면 다운로드된 CLAUDE.md를 이 폴더 안으로 드래그해서 넣어주세요.

나중에 여러 프로젝트 생기면? 바탕화면 말고 Documents/projects 안에 모아두는 걸 추천해요. 관리가 훨씬 편해요.

5
터미널에서 폴더로 이동 후 claude 실행
이제 AI 팀원들을 부를 시간!
cd ~/Desktop/내사업홈페이지
claude
6
한마디로 끝!
Claude Code 채팅창에 입력
CLAUDE.md 읽고 웹페이지 만들어줘
🎉

index.html 파일이 생성돼요. open index.html 치면 브라우저에서 바로 확인!

🔥

이게 전부예요. 기획은 채팅창에서 말로, 실행은 터미널에서 한 줄로. 코딩 한 줄도 안 짜도 됩니다.

💡

왜 터미널에서 파일을 만드나요?

claude.ai 채팅창 → 아티팩트로만 보여줌. 파일 하나씩 다운로드해야 함
터미널 Claude Code → 파일을 폴더에 바로 저장!

팀원 명세서 13개를 채팅창에서 만들면 13번 다운로드해야 해요.
터미널에서는 "전부 만들어줘" 한마디에 폴더에 한 번에 저장됩니다.

💡 익숙해지면 이렇게 하세요 — 처음부터 터미널에서 시작!

지금은 claude.ai에서 기획 → 터미널로 이동하는 순서로 배웠어요.
하지만 익숙해지면 처음부터 터미널에서 claude 열고 바로 기획까지 다 할 수 있어요.

mkdir ~/Desktop/my-project && cd ~/Desktop/my-project && claude

Claude Code 창 열리면 바로:
"나는 OO 사업자야. 내 홈페이지 만들고 싶어. 먼저 구성 제안해줘."

기획부터 파일 생성까지 한 곳에서 끝! AI창이랑 터미널 왔다갔다 안 해도 됩니다.

Step 7 — 완성 후 코드 검증 (필수 습관!)
💡

집 짓고 나서 안전 점검하듯, 코드도 완성 후 검증이 필수예요. 지금은 파일 하나라 간단하지만 나중에 파일 10개 넘어가면 스파게티 코드로 꼬여요. 처음부터 이 습관 들이세요!

1️⃣
방법 1: Claude Code에게 직접 요청
가장 쉬움. 바로 됨
방금 만든 index.html 검증해줘. 오류, 중복 코드, 모바일 깨짐, 불필요한 코드 제거해줘. 개선할 점 3가지도 알려줘.
2️⃣
방법 2: /kkirikkiri 플러그인
불필요한 코드 자동 제거 & 정리
마켓플레이스 먼저 등록 후 설치
/plugin marketplace add 마켓플레이스URL
설치
/plugin install kkirikkiri
실행
/kkirikkiri
💡

끼리끼리처럼 개인이 올린 플러그인은 공식 마켓이 아닌 별도 마켓플레이스에 있어요. 공유받은 URL을 먼저 등록해야 찾을 수 있어요.

3️⃣
방법 3: 새 터미널에서 Codex로 검증
다른 시각으로 독립 검증. 복잡한 프로젝트에 유용
새 터미널 열고 (Cmd+T)
cd ~/Desktop/내사업홈페이지
codex
index.html 검증해줘. 스파게티 코드, 중복, 충돌 가능성 체크하고 불필요한 부분 정리해줘.
꼭 알아야 할 용어 3가지
💾
커밋 (Commit) = 저장
게임 세이브 포인트. "여기까지 저장!"
git commit -m "홈페이지 첫 버전 완성"
⬆️
푸시 (Push) = 업로드
내 컴퓨터 → GitHub(인터넷 창고)에 올리기
git push
🌐
배포 (Deploy) = 공개
GitHub 코드를 실제 인터넷 주소로 공개. Vercel, Cloudflare가 해줌
💡

순서: 코드 완성 → 커밋(저장) → 푸시(업로드) → 배포(공개)
글 쓰고 → 임시저장 → 업로드 → 발행 순서와 같아요!

플러그인 · 스킬 · MCP 설치 방법
🧩
플러그인 설치
기능 묶음. Claude Code 안에서 설치
공식 마켓 플러그인
/plugin install bmad@bmad-method
개인 마켓 — 먼저 등록
/plugin marketplace add 마켓플레이스URL
그 다음 검색
/plugin marketplace search 키워드
설치
/plugin install 플러그인이름
스킬 설치 (GitHub 포크부터)
커뮤니티 공유 스킬 가져다 쓰기
1️⃣

GitHub에서 마음에 드는 스킬 레포 접속 → 오른쪽 상단 + 버튼 클릭 → Fork 선택 → 내 계정으로 복사됨

2️⃣ 내 컴퓨터로 클론
git clone https://github.com/내계정/스킬레포이름
3️⃣ Claude 스킬 폴더로 복사
cp -r 스킬레포이름 ~/.claude/skills/
4️⃣ Claude Code 재시작
Ctrl+C → claude
💡

오픈채팅에서 "이 스킬 좋아요" 하고 GitHub 링크 공유하면, 포크해서 내 걸로 만들고 설치하면 됩니다!

🔌
MCP 설치
Model Context Protocol — AI가 외부 도구와 대화하는 규칙
💡

MCP가 뭔가요? Claude가 GitHub, Notion, NotebookLM 같은 외부 서비스를 직접 사용할 수 있게 연결해주는 통역사예요.

MCP 없이: "GitHub 코드 어떻게 됐어?" → Claude가 모름
MCP 있으면: Claude가 GitHub 직접 읽고 답해줌

설치 예시 (Context7)
claude mcp add context7 -- npx -y @upstash/context7-mcp@latest
설치 목록 확인
claude mcp list
⚠️

설치 후 Claude Code 재시작 필수! Ctrl+C 종료 후 claude 다시 실행해야 적용돼요.

오케스트라 — 여러 AI 동시에 분업시키기
🎼

오케스트라란? 지휘자(리드 에이전트)가 여러 단원(서브 에이전트)에게 역할을 나눠서 동시에 일을 시키는 방식이에요. 혼자 다 하면 느린 일을 여러 팀원이 나눠서 빠르게 처리해요.

🤖
각 AI별 잘하는 역할
터미널 여러 개 열어서 분업 가능
🟣
Claude — 기획, 검토, 문서 작성, 긴 컨텍스트
🟢
Codex (GPT) — 빠른 코드 생성, 수학, 알고리즘, 검증
🔵
NotebookLM — 내 자료 기반 Q&A, 강의 자료 정리
🟡
Gemini — 최신 정보 검색, 멀티모달
💡

핵심: AI들이 직접 대화하는 게 아니라 파일을 매개로 바통을 넘겨요. Claude가 plan.md 만들면 → Codex가 읽고 코드 짬 → Claude가 검토.

🎯
실전 분업 예시
터미널 2개 열어서 진행
터미널 1 — Claude (기획)
수면 분석 기능 기획해줘. 결과를 plan.md로 저장해줘.
터미널 2 — Codex (구현)
plan.md 읽고 코드 짜줘.
⚠️

두 터미널이 같은 파일을 동시에 수정하면 충돌나요. 반드시 순서대로 — 1번 끝나면 2번 시작!

📚
추천 도구: Context7 + BMAD
오케스트라 시작점으로 좋은 조합
Context7 — 최신 공식 문서 주입. 프롬프트 끝에 한마디만
CLAUDE.md 읽고 웹페이지 만들어줘. use context7
BMAD — 기획자/개발자/디자이너 에이전트 팀 한 번에 세팅
/plugin install bmad@bmad-method
🙏

멀티 AI 실전 협업은 아직 배워가는 영역이에요. 실제 앱 개발하면서 써보고 이 페이지에 업데이트할게요. 함께 배워가요!

Swarm — 에이전트들이 서로 대화하는 단계
🌊

Swarm = Agent Teams (공식 명칭)

오케스트라에서 한 단계 더 진화한 방식이에요.

🆚
서브에이전트 vs Swarm 차이
에이전트끼리 대화 가능 여부가 핵심
서브에이전트
혼자 일하고 결과만 팀장에게 보고. 에이전트끼리 직접 대화 불가
Swarm (Agent Teams)
팀원들이 서로 직접 메시지 주고받으며 협력. 프론트엔드 에이전트가 백엔드 에이전트한테 직접 물어볼 수 있어요
활성화 방법 (settings.json에 추가)
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
⚠️

아직 실험적 기능이에요. 토큰을 3~4배 더 써요. 복잡한 대형 프로젝트에 쓸 때 효과적이에요.

💡 은희님은 이미 Swarm 단계로 운영 중!

CLAUDE.md — 중요 규칙 저장하는 법
📝
CLAUDE.md에 규칙 저장하기
프로젝트 폴더에 있으면 Claude가 매번 자동으로 읽어요
방법 1 — Claude Code에게 말로 시키기 (가장 쉬움)
중요 규칙은 CLAUDE.md에 저장해줘
방법 2 — # 으로 세션 메모리에 저장
# 이 프로젝트는 쿠팡 파트너스 블로그야
저장된 메모리 확인
/memory
💡

방법 1 (CLAUDE.md) → 프로젝트 영구 저장. 가장 확실해요.
방법 2 (#) → 세션 메모리. 폴더 바뀌면 날아갈 수 있어요.

중요한 규칙, 프로젝트 설정은 항상 CLAUDE.md에 저장하세요!

🚀
API만 연결하면
펼쳐지는 신세계
Swarm 구조까지 갖추면 이런 일들이 가능해져요
✍️ 콘텐츠 자동화
인스타, 스레드, 블로그 글 자동 발행
📋 업무 자동화
노션 페이지 자동 업로드, 구글시트 자동 기록
📊 데이터 분석
블로그 글별 조회수 트래킹 → 콘텐츠 방향 자동 조정
🔍 SEO 자동화
황금키워드 자동 추출 → 블로그 주제 자동 추천
수강생들이 가장 좋아하는 활용법 TOP 2
🎭
Playwright — 블로그 글 자동 발행
글 쓰고 발행까지 손 하나 안 대도 됩니다
1
Claude가 글 초안 작성 + QA 통과
2
이미지 API (Unsplash / DALL-E 등) 연결 → 글에 이미지 자동 배치
3
Playwright가 네이버 블로그에 자동 로그인 → 제목/본문/이미지 자동 입력 → 발행
Claude Code에 요청하는 방법
Playwright로 네이버 블로그에 글을 자동 발행하는 스크립트 만들어줘. 이미지는 Unsplash API로 자동으로 가져와서 글에 넣어줘.
📋
노션 API — 팀원 역할 배분 + 텔레그램 보고
노션이 콘텐츠 관제탑이 됩니다
1
노션 콘텐츠 캘린더/업무 목록에 할 일 추가
2
AI 팀원이 노션 API로 업무 읽고 규칙대로 처리
3
완료되면 텔레그램으로 자동 보고 + 노션에 결과 업로드
Claude Code에 요청하는 방법
노션 API 연결해서 콘텐츠 캘린더를 읽고 할 일을 팀원에게 배분하고 완료되면 텔레그램으로 보고하는 시스템 만들어줘.
🌱

오늘 배운 것들이 이 모든 것의 출발점이에요.

오늘 만든 팀이 발전하면 — 자고 일어났을 때 콘텐츠가 발행되어 있고, 성과가 분석되어 있고, 다음 전략이 제안되어 있는 상태가 됩니다.

지금 시작하세요. 완벽하지 않아도 됩니다.

2교시 실습
나만의 AI 팀을
지금 만들어봅니다
사람 채용하듯, AI 팀원을 뽑는 거예요.
처음엔 3~4명으로 시작해도 충분해요.
STEP 1 — 터미널 열고 시작 (5분)
💡

바로 터미널에서 시작해요. 폴더 만들고 Claude Code 실행하면 그 안에서 모든 걸 다 할 수 있어요. 파일도 바로 저장되고, 팀도 바로 만들어져요.

💻
폴더 만들고 Claude Code 실행
이 한 줄이면 준비 완료!
🍎 Mac
mkdir ~/Desktop/my-ai-team && cd ~/Desktop/my-ai-team && claude
🪟 Windows
mkdir $env:USERPROFILE\Desktop\my-ai-team; cd $env:USERPROFILE\Desktop\my-ai-team; claude

Claude Code 창이 열리면 준비 완료! 이제 한국어로 바로 입력하면 됩니다.

STEP 2 — 내 사업 브리핑 (20분)
💡

AI 팀을 만들기 전에, AI한테 내 사업을 알려줘야 해요. 사람을 채용할 때도 회사 소개를 하잖아요. AI도 똑같아요. 내 사업을 모르면 엉뚱한 팀이 만들어져요.

✍️
Claude Code에 내 사업 입력하기
아래 형식 그대로 채워서 붙여넣기
프롬프트 템플릿
나는 [업종] [N년 차] 사업자야. 현재 하고 있는 일: [주요 업무] 고객: [타겟 고객] 채널: [블로그, 인스타, 카카오 등] 고민: [가장 큰 고민 1~2개] 이 사업을 AI 에이전트 팀으로 운영하고 싶어.
강사 시범 예시
나는 웨딩플래너 19년 차 사업자야. 현재 하고 있는 일: 웨딩 컨설팅, 마케팅 교육, 디지털 상품 판매 고객: 예비 신랑신부 + 자영업자 채널: 네이버 블로그 3개, 인스타 2개, 오픈채팅방 600명 고민: 혼자서 콘텐츠, 고객응대, 재무까지 다 해야 해 이 사업을 AI 에이전트 팀으로 운영하고 싶어.
💡

완벽하게 안 써도 됩니다. Claude가 부족한 부분은 추가 질문해요. "고민"을 구체적으로 쓸수록 팀 구조가 정확해져요.

+ 자동화하고 싶은 것도 모두 적어주세요! 지금 하고 있는 일 중 반복되는 것, 시간 잡아먹는 것, 매일 해야 하는 것을 다 털어놓으세요.

예: 매일 블로그 글 쓰기 / 인스타 피드 작성 / 오픈채팅 팁 발행 / 고객 첫 답변 / 주간 매출 정리 등

STEP 3 — 팀 구조 설계 (20분)
💡

팀 구조를 처음부터 다 알 필요 없어요. Claude한테 제안받는 거예요. 제안 목록 보고 "이건 빼줘", "이건 합쳐줘", "이것도 추가해줘" 하면서 골라가면 됩니다.

👥
팀 설계 요청
업무별로 제안받고 선택하기
프롬프트
내 사업을 AI 에이전트 팀으로 운영하려면 업무별로 어떤 팀원이 필요한지 제안해줘. 각 업무 영역별로 팀원 역할을 나눠서 내가 선택할 수 있게 목록으로 보여줘. 조건: 1. 전략 조력자(팀장) 1명 + 실무 팀원으로 구성 2. 팀장은 내 지시를 받아서 적합한 팀원에게 전달 3. 각 팀원은 담당 채널과 업무가 명확해야 해 4. 표로 보여줘
🔍

강사 팀 실제 예시:
wedding_business / finance / personal_manager / community_ops / customer_response

처음 7명으로 시작 → 쓰면서 다듬어서 통합/최적화 진행 중이에요.
한 번에 완벽할 필요 없어요. 쓰면서 키우는 거예요.

STEP 4 — 팀원 명세서 작성 (30분)
💡

사람 채용할 때 직무기술서 쓰는 것과 같아요. 이 명세서가 곧 AI의 성격과 규칙이 됩니다.

이미 md 파일 있는 분 → 기존 파일 그대로 팀원으로 편입. 없는 것만 새로 만들면 돼요.
md 파일 없는 분 → 지금 만들면 됩니다!

💡 터미널에서 만들면 "전부 만들어줘" 한마디에 팀원 전체 명세서가 폴더에 한 번에 저장돼요.

📋
팀원 1명씩 명세서 작성
YAML 파일로 저장
프롬프트 (팀원 1명당)
[팀원 이름]의 상세 명세서를 만들어줘. 포함할 내용: 1. 페르소나 — 정체성, 말투, 원칙 2. 담당 채널과 발행 빈도 3. 절대 지켜야 할 규칙 (3~5개) 4. 절대 하면 안 되는 것 (3~5개) 5. 일일 업무 흐름 6. 보고 대상과 정보 수신 대상 7. KPI (성과 지표) YAML 파일로 저장해줘.
나머지 팀원 한 번에 만들기
나머지 팀원도 같은 형식으로 전부 만들어줘.
⚠️

금지 사항을 명확히! "방법/꿀팁/비법 단어 금지" 이런 식으로 구체적으로 써야 AI가 엉뚱한 걸 안 해요. AI는 한 번 규칙 정해주면 다시는 안 틀려요.

STEP 5 — 텔레그램 봇 연결 (20분)
💡

팀이 만들어졌으면 지시하고 보고받을 창구가 필요해요. 카카오톡처럼 쓸 수 있는 텔레그램 봇을 만들 거예요. 코딩 몰라도 됩니다. Claude한테 시키면 됩니다.

🤖
텔레그램 봇 만들기
3단계로 완성
1️⃣

봇 토큰 받기:
텔레그램 앱 → @BotFather 검색 → /newbot 입력
봇 표시 이름 입력 (한글 가능, 예: 하니AI팀)
봇 유저네임 입력 (영문+숫자, 반드시 bot으로 끝나야 함, 예: haniii2_bot)
→ 중복이면 다른 이름으로 변경 (숫자 붙이면 됨)
→ Done! 뜨면 토큰 복사 (비밀번호와 같음, 안전한 곳에 저장!)

2️⃣

내 Chat ID 찾기:
텔레그램에서 @RawDataBot 검색 → /start 입력
Chat ID 숫자가 바로 나와요 (예: 6972067463)
→ 이 숫자가 봇 코드에 넣을 내 ID예요!

⚠️ @userinfobot은 응답 안 하는 경우 있어요. @RawDataBot 추천!

3️⃣ Claude에게 봇 코드 요청
텔레그램 봇을 만들어줘. 요구사항: 1. 내가 메시지 보내면 전략 조력자가 적합한 팀원에게 전달 2. 팀원이 완료하면 텔레그램으로 결과 전송 3. 나만 쓸 수 있게 내 ID만 허용 4. 봇 토큰과 Chat ID는 .env 파일에 저장해줘 5. 봇 토큰: [복사한 토큰] 6. 내 텔레그램 Chat ID: [RawDataBot에서 받은 숫자] Python으로 만들어줘.
4️⃣

테스트: 봇한테 "안녕" 보내보세요. 전략 조력자가 응답하면 성공!

💡 Python 파일 실행은 Claude Code가 알아서 해줘요. 직접 실행할 필요 없어요.

안 될 때 체크리스트:
· 봇 토큰 .env 파일에 제대로 들어갔나요?
· Chat ID 숫자 맞나요? (@RawDataBot 다시 확인)
· 그래도 안 되면 → Claude한테 "봇이 응답 안 해, 확인하고 고쳐줘"

🚨

"안녕" 해도 먹통일 때 — Claude CLI에서 바로 해결하기

Claude Code 채팅창에 아래 내용 입력하면 원인 찾아서 고쳐줘요.

Claude CLI에 입력
텔레그램 봇이 "안녕" 해도 응답이 없어. 에러 로그 확인하고 원인 찾아서 고쳐줘.
💡

CLI 설치/연동 꿀팁!

Railway, GitHub, Python 등 뭔가 연동할 때 — 직접 사이트 가서 설치하실 필요 없어요.

API 가입/키 발급 → 직접 해야 함 (보안상 Claude가 못 함)
나머지 설치/연동 → Claude CLI한테 시키면 자동으로 해줌!

예시:

Railway CLI 설치
Railway CLI 찾아서 설치해줘
GitHub CLI 설치
GitHub CLI 찾아서 설치해줘
Python 환경 설정
Python 환경 설정해줘
STEP 6 — 자동화 세팅 (20분)

cron이 뭔가요?
알람처럼 "매일 몇 시에 이걸 실행해줘"를 등록해두는 시스템이에요.

한 번 등록해두면 내가 아무것도 안 해도 알아서 돌아가요.
⚠️ 단, 컴퓨터가 켜져 있어야 해요. 꺼지면 cron도 멈춰요.

💡

매번 "블로그 써줘" 지시하기 힘들잖아요. 매일 아침 알아서 블로그를 쓰고, 저녁에 보고를 올리게 만들 거예요.

cron 자동화 설정
자고 일어나면 블로그가 와있어요
프롬프트
매일 자동으로 실행되는 스케줄 만들어줘. 스케줄: · 매일 오전 7시: 블로그 초안 생성 → 텔레그램 전송 · 매일 오전 8시: 오늘의 마케팅 팁 → 텔레그램 전송 · 매일 저녁 9시: 오늘 업무 브리핑 → 텔레그램 전송 · 매주 월요일 9시: 주간 보고 cron으로 설정하고, 실행 스크립트도 만들어줘.
⚠️

cron은 Mac/Linux에서 동작해요. Windows는 작업 스케줄러 사용.
처음엔 2~3개만 자동화하고 점점 늘려가세요!

🚀
다음 단계: Railway 서버에 올리기
컴퓨터 꺼도 24시간 자동으로 돌아가요
Claude에게 요청
이 텔레그램 봇을 Railway에 배포해줘. 컴퓨터 꺼져도 24시간 돌아가게 해줘. 환경변수에 토큰이랑 Chat ID 넣는 법도 알려줘.
💡

Railway 무료 플랜으로 충분해요. 월 $5 이하.
이 강의 내용 따라오신 분이라면 30분이면 됩니다!

자주 묻는 질문
API 비용이 얼마나 나와요?

하루 블로그 5편 + 팁 1편 + 브리핑 기준 일 1~2달러 수준이에요. 월 3~5만 원 정도. 사람 한 명 채용하는 것 대비 생각해보시면 됩니다.

블로그 글 품질이 괜찮아요?

처음엔 70점이에요. 근데 규칙을 하나씩 추가하면 올라가요. 강사도 피드백하면서 규칙을 28개 만들었고, 지금은 검수 통과율 80점 이상이에요. 쓰면서 키우는 거예요.

팀원이 엉뚱한 걸 하면요?

명세서에 "절대 하면 안 되는 것"을 추가하면 돼요. 사람도 실수하면 피드백 주잖아요. AI도 똑같아요. 다만 AI는 한 번 규칙 정해주면 다시는 안 틀려요.

🔥

저도 처음엔 7명으로 시작해서 지금 13명이에요. 한 번에 완벽하게 만들 필요 없어요. 매일 쓰면서 키우는 거예요.

지금 저희 팀에서는 이렇게 하고 있습니다
완성된 AI팀이
하루에 하는 일
보고 그대로 따라 만드세요
전체 팀 구성 (10명)
👑
대표 (나)
텔레그램으로 지시 & 승인. 하루 15분.
🎯
전략 조력자 — 조조 (팀장)
팀 라우팅 · 브리핑 · KPI 분석 · 위험 신호 경고 · 의사결정 지원
✍️
콘텐츠팀 (4명)
자영업자 · 웨딩 · 자녀교육 콘텐츠 · 커뮤니티 운영
⚙️
실행팀 (2명)
사주/디지털 상품 · 웨딩 비즈니스
📋
운영팀 (3명)
재무 관리 · 개인/가족 매니저 · 고객응대
매일 자동으로 돌아가는 흐름
06:40
황금키워드 자동 발굴 (월요일)
네이버 API 3종 · 검색량+발행량+트렌드 분석 → 텔레그램 보고 → 대표 승인
07:00
블로그 5편 자동 생성
황금키워드 자동 배정 · 5단 퍼널 + 28개 규칙 · QA 70점 이상 통과
07:00
스레드 5개 · 인스타 카드뉴스 생성
대표 승인 후 시간대별 자동 발행 (09:17 / 10:22 / 11:52 / 12:53 / 15:40)
07:05
마케팅 팁 · 모닝 브리핑
톡방 복붙 + 노션 자동 업로드 · 오늘 일정 + 기념일 + 할 일
매30분
Watchdog 자동 감시
실패 감지 → 자동 재시도 3회 → 3회 실패 시 대표에게 알림
21:00
일일 브리핑
팩트 기반 · 오늘 실제 데이터 보고
승인 구조
✅ 자동 승인
블로그 발행 (QA 70점+)
마케팅 팁
브리핑
에이전트 간 위임
⚠️ 대표 승인 필요
인스타 발행
스레드 발행
이메일 발송
5만원 이상 지출
텔레그램 명령어 모음
/status
오늘 현황
/report
주간 보고
/pending
승인 대기 목록
/approve N
승인
/finance
재무 요약
/queue
큐 현황
기술 스택
🔧

Claude Code (CLI) + Python + 텔레그램 봇 + cron
네이버 API 3종 (검색광고 + 검색 + 데이터랩)
노션 API + 인스타그램 Graph API
Playwright (크롤링)
파일 기반 상태 관리 (JSON, 서버 불필요)

"혼자 하는 사업,
이제 AI랑 같이 합니다."
팀 만드는 데 걸린 시간
약 2시간
매일 절약되는 시간
5~6시간
여러분도 오늘 만들었습니다.
집에 가서 내일 아침 7시에 텔레그램을 열어보세요.
마케팅 교육
황금키워드 찾는
완전 가이드
경쟁은 적고 수요는 꾸준한 키워드.
한 번 상위 노출되면 장기간 트래픽이 들어옵니다.
황금키워드란?
황금도 공식
검색량 ÷ 발행량
이 숫자가 높을수록 황금!
✅ 황금 예시 — 검색량 300 / 발행량 1,000 → 비율 0.3
❌ 레드오션 — 검색량 500 / 발행량 30,000 → 비율 0.016
🔍
월 검색량 최소
300 이상
에버그린
1년 전후
💡

에버그린 판별법: "1년 전에도 이 질문을 했을까? 1년 후에도 할까?" 둘 다 YES면 에버그린!

발행량 절대값보다 비율이 핵심이에요. 검색량 300 이상 중에서 황금도(비율)가 높은 것을 우선으로 추리면 됩니다.

황금키워드 발굴 6대 기법
1
네이버 자동완성 + 연관검색어
키워드 + 가나다 한 글자씩 붙이기. "자영업 블로그 ㄱ", "자영업 블로그 ㄴ"... 숨어있는 롱테일 조합이 나온다.
2
발행량 vs 검색량 비교
황금도 = 검색량 / 경쟁 문서 수
네이버 블로그 탭 → "블로그 N건" = 경쟁 문서 수
네이버 검색광고 시스템 → 월간 검색량
3
상위 노출 글의 발행일 확인
상위 1~5위 글이 2~3년 전 글이면 → 최근에 아무도 안 썼다는 뜻 → 신규 발행만 해도 바로 상위 안착!
4
계절성 키워드 역산
6~8주 전에 미리 발행. 예: "연말정산 환급" → 11월에 발행 / "추석 선물 자영업자" → 7월에 발행
5
FAQ형 키워드 발굴
고객이 실제로 물어보는 질문을 키워드로 변환. 소스: 오픈채팅방, 카페 질문, 상담 중 반복 질문. 검색량이 작아도 전환율이 높다.
6
경쟁자 블로그 역분석
조회수 높은 블로거의 잘 되는 글 → 제목에서 키워드 추출. 수요가 검증된 키워드를 확인하는 용도.
검색의도 4가지 유형 (가장 중요)
정보형 — 기준, 조건, 구조를 알고 싶다
예: 신용점수등급표
사용법형 — 어떻게 쓰는지 알고 싶다
예: 쿠팡이츠사장님사이트
도구형 — 도구를 직접 쓰고 싶다
예: 사대보험계산기
수익형 — 돈을 벌 수 있는지 알고 싶다
예: 미리캔버스디자인허브
💡

파악 방법: 해당 키워드로 실제 검색해서 상위 글 3~5개를 봐요. "이 키워드를 검색한 사람이 진짜 원하는 게 뭔지" 파악!

글 구조 — 4단 구조
제목
모든 사람이 클릭
타겟 제한 단어 금지 (자영업자, 사업자, 사장님, 예비부부 등)
도입
검색노출용 → 검색의도 충족 / 홈피드용 → 공감
놓치는 부분
타겟만 공감하는 요소 → 비타겟 자연 이탈
구조/기준 제시
비교표, "이건 내 얘기다" → 타겟 확정
CTA
남은 독자 = 핵심 타겟. 가능성만 열기.
제목 규칙
❌ "방법 / 꿀팁 / 비법" 단어 금지
❌ 타겟 제한 단어 금지 (자영업자, 사장님 등)
✅ 25자 내외
✅ 제목은 모수 최대로 열고, 글 안에서 퍼널로 좁히기
검색노출용 제목 예시
만세력 계산기 결과가 틀릴 수 있는 3가지 경우
아동수당 2017년생 다시 받는다, 2026년 바뀐 기준 총정리
홈피드용 제목 예시
틱톡 스크롤로 돈 번다는 말, 해보고 나서 알게 된 현실
사대보험계산기 돌려봤는데, 이 금액이 맞나 싶은 분들
우리 자동화 시스템 프로세스
월요일
키워드 해커 자동 실행
네이버 API 3종 (검색광고 + 검색 + 데이터랩) → 황금키워드 필터 → 텔레그램 보고 → 대표 승인 → approved-keywords.json 저장
07:00
블로그 파이프라인
승인 키워드 자동 배정 → 웹서치 검색의도 파악 → 5단 퍼널 + 28개 규칙 글 작성 → QA 70점+ 통과 → Playwright 자동 발행
발행 시간
시간대별 발행
07시: 자영업자 1편 + 교육 1편 / 11시: 자영업자 2편 / 16시: 자영업자 3편
06:50
성과 추적
블로그 방문자 수 자동 수집 → 키워드 방향성 분석 → 하락 키워드 제외, 상승 키워드 우선
실전 워크플로우 (수동으로 할 때)
1
내 분야 핵심 키워드 10개 선정
2
자동완성 조합으로 50~100개 확장
3
네이버 검색광고에서 월 검색량 필터 (300 이상)
4
블로그 탭에서 경쟁 문서 수 확인 (3만 이하)
5
상위 글 발행일 확인 (오래된 것 우선)
6
검색의도 파악 (검색노출용 vs 홈피드용)
7
황금 후보 10~20개 → 발행 캘린더에 배치
8
검색량 작은 것부터 발행 (경쟁 낮아 빠르게 상위 노출)
🔥

핵심 교훈: 황금키워드를 찾는 것보다 찾은 키워드를 제때 발행하는 루틴이 더 중요합니다.

AI팀에 황금키워드 전문가 추가하기
💡

AI팀 빌딩 STEP 4 명세서 작성할 때, 키워드 전문가 팀원을 추가하면 매주 황금키워드를 자동으로 발굴해줘요. Claude Code에 아래 내용을 그대로 붙여넣으세요!

🔑
키워드 전문가 팀원 명세서 요청
Claude Code에 붙여넣기
프롬프트 예시
키워드 전문가 팀원 명세서를 만들어줘. 역할: - 매주 월요일 황금키워드 자동 발굴 - 황금 기준: 월 검색량 300 이상, 발행 문서 수 3만 이하 - 네이버 자동완성, 연관검색어, 발행량 vs 검색량 비교 - 검색의도 파악 (검색노출용 vs 홈피드용 분류) - 발굴한 키워드를 텔레그램으로 보고 → 대표 승인 후 블로그팀에 전달 절대 규칙: - 키워드 제목에 "방법/꿀팁/비법" 단어 금지 - 타겟 제한 단어 금지 (자영업자, 사장님 등) - 에버그린 키워드 우선 (1년 전후로도 검색되는 것) YAML 파일로 저장해줘.
➡️

명세서가 만들어지면 "이 키워드 전문가가 매주 자동으로 실행되게 cron 설정해줘" 라고 추가 요청하면 자동화까지 완성돼요!

수강생들이 가장 좋아하는 활용법 TOP 2
🎭
Playwright — 블로그 글 자동 발행
글 쓰고 발행까지 손 하나 안 대도 됩니다
1
Claude가 글 초안 작성 + QA 통과
2
이미지 API (Unsplash / DALL-E 등) 연결 → 글에 이미지 자동 배치
3
Playwright가 네이버 블로그에 자동 로그인 → 제목/본문/이미지 자동 입력 → 발행
Claude Code에 요청하는 방법
Playwright로 네이버 블로그에 글을 자동 발행하는 스크립트 만들어줘. 이미지는 Unsplash API로 자동으로 가져와서 글에 넣어줘.
📋
노션 API — 팀원 역할 배분 + 텔레그램 보고
노션이 콘텐츠 관제탑이 됩니다
1
노션 콘텐츠 캘린더/업무 목록에 할 일 추가
2
AI 팀원이 노션 API로 업무 읽고 규칙대로 처리
3
완료되면 텔레그램으로 자동 보고 + 노션에 결과 업로드
Claude Code에 요청하는 방법
노션 API 연결해서 콘텐츠 캘린더를 읽고 할 일을 팀원에게 배분하고 완료되면 텔레그램으로 보고하는 시스템 만들어줘.