Claude Code 자동화 개념 지도¶
비개발자를 위한 학습 가이드. 새로운 개념을 배울 때마다 이 폴더에 추가한다.
전체 구조¶
나(사용자)
│
├─ Claude Code (터미널에서 작업)
│ ├─ Skill ─────────── 반복 워크플로우 (매뉴얼)
│ ├─ Sub-agent ─────── 전문 팀원 (위임)
│ ├─ Agent Team ────── 팀 프로젝트 (협업)
│ └─ MCP Server ────── 외부 서비스 연결 (노션, GitHub 등)
│
└─ Cowork (Claude Desktop에서 작업)
└─ 일회성 파일/이미지 작업에 최적
핵심 개념 요약¶
| 개념 | 한 줄 설명 | 비유 | 상세 문서 |
|---|---|---|---|
| Skill | 저장된 작업 매뉴얼 | 레시피북 | 01-skill.md |
| Skill 최적화 | 스킬 관리/재활용 설계 | 프랜차이즈 본사 | 07-skill-optimization.md |
| Sub-agent | 독립 전문 팀원 | 프리랜서 | 02-subagent.md |
| Agent Team | 팀원들의 협업 | 프로젝트팀 | 03-agent-team.md |
| MCP | 외부 서비스 연결 | 전화선 | 04-mcp.md |
| Cowork | GUI 파일 작업 도우미 | 옆자리 동료 | 05-cowork.md |
| Remotion Skills | 말로 시켜서 영상(MP4) 자동 생성 | AI 모션그래픽 디자이너 | 08-remotion-skills.md |
| 명령어 & 단축키 | 모드 전환, 모델 변경, 세션 관리 | TV 리모컨 | 09-claude-code-commands.md |
| Skills/Agents 비교 | Custom Skills, Agents, Sub-agents, Agent Teams 4가지 차이 | 레시피 vs 요리사 vs 심부름꾼 vs 프로젝트팀 | 13-skills-agents-비교.md |
| 자동화 판단 기준 | Claude가 할 것 vs 직접 할 것 | 외주 줄지 말지 판단표 | 10-automation-playbook.md |
| Agent 설계 가이드 | Sub-agent/Agent Team 설계 시 함정과 체크리스트 | 실수 방지 매뉴얼 | 11-agent-design-guide.md |
| Astro+Vercel 배포 | 웹사이트 만들고 무료 배포하는 과정 + 이메일 트러블슈팅 | 인쇄소에 원고 넘기기 | 08-astro-vercel-배포가이드.md |
| 웹 개발 패턴 | CSS Grid, GitHub Actions, API 활용, JSON 데이터 설계, 자동화 | 공사+물류 운영 매뉴얼 | 12-web-dev-patterns.md |
| HWP COM 자동화 | DOCX를 한글 파일로 자동 변환 | "한글에서 열기 > 저장"을 코드로 | 14-hwp-com-automation.md |
| 멀티 디바이스 동기화 | 여러 노트북에서 작업 이어가기 | 이사할 때 핵심 서류만 챙기기 | 15-multi-device-sync.md |
| Selenium 자동화 | Python으로 크롬 브라우저 자동 조종 | 로봇 팔이 마우스/키보드 대신 | selenium-automation.md |
| 파일 포맷 다루기 | 엑셀/PPT/텍스트 파일 읽고 쓸 때 함정과 해결법 | 책 목차가 틀려도 실제 내용은 다 있다 | 16-file-format-tips.md |
| SEO 실전 팁 | API 자동 발행 SEO 영향, 네이버 vs 구글 차이 | 배달 방법이 아니라 음식 맛이 평가 기준 | 17-seo-tips.md |
| 인스타 API 자동화 | 비공식 REST API로 타인 공개 프로필 데이터 수집 | 남의 가게 매출 조회하기 (공식 창구 X, 뒷문 O) | 18-instagram-api-automation.md |
| MCP 자동화 연동 | ComfyUI MCP, Selenium, Playwright 등 자동화 도구 연동 | Claude를 허브로, 팔을 여러 개 붙이기 | 04-mcp.md 하단 |
| Cloudflare Pages 배포 | Astro 사이트를 Cloudflare Pages에 무료 배포 + R2 이미지 + 도메인 | 무료 웹호스팅 + 이미지 창고 | 09-cloudflare-pages-배포가이드.md |
| Streamlit Cloud 배포 | Python 앱을 무료로 웹에 배포. 데이터 분석 도구에 최적 | Python 앱 전용 인쇄소 | 19-streamlit-cloud-배포가이드.md |
| 웹앱 자동화 가이드 | Apps Script vs Cloudflare Workers 비교 + 실전 이전 패턴 | 연습장 vs 공식 문서 | 20-webapp-automation-guide.md |
| CF Pages Functions | 정적 사이트에 DB+파일저장+API 붙이기 (D1+R2) | 전단지 뒤에 접수 창구 | cloudflare-pages-functions.md |
| SMS/이메일/카톡 API | 웹서비스에서 고객에게 문자/이메일/카톡 보내기 | 자동 우체국 (문자=편지, 알림톡=카톡, 이메일=무료) | sms-email-api-guide.md |
| 맥북 기초 가이드 | 윈도우 유저가 맥북 처음 쓸 때 핵심 차이점 + 키보드 + 터미널 + 갤럭시 미러링 | 좌핸들 → 우핸들 바꾼 자동차 | 21-macbook-basics.md |
| 이미지 처리 팁 | 얼굴 블러(YuNet), EXIF 회전, 리사이즈, SEO 파일명 | 사진 출력 전 보정소 | 22-image-processing-tips.md |
| 문서 사이트 구축 | MkDocs vs Docsify vs VitePress 비교 + 실전 설정 | 위키 만들기 도구 | 23-docs-site-builder.md |
언제 무엇을 쓰는가 (의사결정 트리)¶
"이 작업을 자동화하고 싶다"
│
├─ 반복하는 작업인가?
│ ├─ YES → Skill (/명령어로 실행)
│ └─ NO → Cowork (일회성 작업)
│
├─ 조사량이 엄청 많은가? (파일 50개 이상 읽기 등)
│ ├─ YES → Sub-agent (결과 요약만 받기)
│ └─ NO → Skill (직접 처리)
│
├─ 여러 독립된 관점이 필요한가?
│ ├─ YES → Agent Team (팀원들이 각자 조사 후 종합)
│ └─ NO → Skill 또는 Sub-agent
│
└─ 외부 서비스(노션, GitHub 등)에 연결해야 하는가?
├─ YES → MCP Server 연결 (어떤 도구와든 조합 가능)
└─ NO → 로컬에서 처리
학습 순서 추천¶
[1] Skill ──────── 가장 먼저, 가장 많이 쓰게 됨
[2] MCP ─────────── Skill과 조합하면 노션 등 외부 연동 가능
[3] Cowork ──────── 이미지/파일 작업에 보조적으로 활용
[4] Sub-agent ───── 대량 조사 등 특수 상황에 사용
[5] Agent Team ──── 출판사 에이전트 연합 같은 큰 프로젝트
외부 서비스 연동 현황¶
| 서비스 | 자동 업로드 | 방법 | 상세 |
|---|---|---|---|
| 노션 | O | Notion MCP | 읽기/쓰기 모두 가능 |
| 네이버 블로그 | X | API 종료 (2020) | 글 자동 생성 → 수동 복사 |
| 티스토리 | X | API 종료 (2024) | 글 자동 생성 → 수동 복사 |
| GitHub | O | GitHub MCP | PR, 이슈 등 |
| 워드프레스 | O | REST API | 자동 포스팅 가능 |
| 인스타그램 | △ | 비공식 REST API | 공개 프로필 읽기만 (쓰기 X). 공식 API는 자기 계정만 |
상세: 06-블로그-API-현황.md
이 폴더 구조¶
study/
├── 00-개념지도.md ← 지금 보고 있는 파일 (전체 맵)
├── 01-skill.md ← Skill 상세 개념
├── 02-subagent.md ← Sub-agent 상세 개념
├── 03-agent-team.md ← Agent Team 상세 개념
├── 04-mcp.md ← MCP 상세 개념
├── 05-cowork.md ← Cowork 상세 개념
├── 06-블로그-API-현황.md ← 네이버/티스토리/노션 연동 현황
├── 07-skill-optimization.md ← 스킬 통합 관리/최적화 설계
├── 08-remotion-skills.md ← Remotion Skills (코드로 영상 만들기)
├── 09-claude-code-commands.md ← 주요 명령어 & 단축키 레퍼런스
├── 10-automation-playbook.md ← 자동화 판단 기준 (Claude vs 직접)
├── 11-agent-design-guide.md ← Agent 설계 실전 가이드 (함정, 체크리스트, 사고 일지)
├── 12-web-dev-patterns.md ← 웹 개발 패턴 & 실수 방지 (CSS Grid, iframe, 구조 관리)
├── 13-skills-agents-비교.md ← Skills/Agents/Sub-agents/Agent Teams 4가지 비교
├── 14-hwp-com-automation.md ← 한글(HWP) COM 자동화 (DOCX→HWP 변환)
├── 15-multi-device-sync.md ← 여러 노트북에서 Claude Code 작업 이어가기
├── build-case-sigil-css-guide.md ← 빌드 케이스 #1: 시길 CSS 가이드
├── build-case-ai-prompt.md ← 빌드 케이스 #2: AI 프롬프트 사이트
├── build-case-subway-app.md ← 빌드 케이스 #3: 지하철 +/- 방향 표기 앱 (카카오맵+공공API)
├── 16-file-format-tips.md ← 파일 포맷 다루기 (엑셀/PPT/텍스트 함정+해결)
├── 17-seo-tips.md ← SEO 실전 팁 (API 발행, 네이버 vs 구글)
├── 18-instagram-api-automation.md ← 인스타그램 비공식 API 자동화 (프로필/좋아요/댓글 수집)
├── 19-streamlit-cloud-배포가이드.md ← Streamlit Cloud 배포 (Python 앱 무료 배포)
├── 20-webapp-automation-guide.md ← 웹앱 자동화 (Apps Script vs Cloudflare Workers)
├── build-case-meeting-scheduler.md ← 빌드 케이스: 미팅 예약 시스템 (의사결정 과정)
├── cloudflare-pages-functions.md ← CF Pages Functions + D1 + R2 (정적사이트에 API 붙이기)
├── sms-email-api-guide.md ← SMS(알리고)/이메일(Resend)/카카오 알림톡 API 가이드
├── 21-macbook-basics.md ← 맥북 기초 (윈도우→맥 전환, 키보드, 터미널, 갤럭시 미러링)
└── 22-image-processing-tips.md ← 이미지 처리 (YuNet 얼굴블러, EXIF 회전, SEO 파일명)
새로운 개념을 배울 때마다 파일을 추가한다.