📖 5분 만에 끝내는 Claude 스킬 환경 세팅 가이드
🎯 Claude 스킬 마스터 시리즈 - EPISODE 03 / 10
📰 AI에 날개를 달다 | AI 프롬프트 연구소(APLab) | 피플웨어교육컨설팅
🔥 도입부 - "이거 알면 진짜 달라져요"
"Claude.ai 들어갔는데 스킬 메뉴가 어디 있는지 모르겠어요."
"커스텀 스킬을 ZIP 파일로 받았는데 어떻게 등록하나요?"
"휴대폰에서도 스킬이 작동하나요?"
강의 현장에서 가장 많이 받는 3가지 질문입니다.
1·2회차에서 "스킬이 무엇이고 왜 써야 하는가"를 다뤘다면, 3회차는 "지금 당장 어떻게 시작하는가"입니다. 오늘 글을 끝까지 읽으시면, 5분 안에 환경 세팅을 완료하고 첫 커스텀 스킬 등록까지 마치실 수 있습니다.
📊 핵심 수치
| 지표 | 시간 | 의미 |
|---|---|---|
| ⏱️ 전체 환경 세팅 | 5분 | 유료 가입 → 첫 작동까지 |
| ⚡ 첫 커스텀 스킬 등록 | 30초 | ZIP 업로드 → 검증 완료 |
| 🌐 동기화되는 환경 | 4가지 | 웹·데스크톱·모바일·CLI |
| 📦 ZIP 파일 크기 한도 | 100MB | 업로드 가능 최대 크기 |
🔍 시작 전 3가지 확인
세팅을 시작하기 전, 반드시 확인해야 할 3가지가 있습니다.
🔑 CHECK 01 - 유료 플랜 가입 여부
| 플랜 | 가격 | 추천 대상 |
|---|---|---|
| Pro | $20/월 | 개인 실무자 (★ 추천) |
| Max | $100/월 | 헤비 사용자 |
| Team | $30/시트/월 | 팀 단위 |
| Enterprise | 협의 | 관리 기능 포함 |
| Free | 무료 | 스킬 기능 제한 |
⚠️ 무료 플랜은 스킬 기능이 제한되니 먼저 Pro 이상으로 업그레이드하셔야 합니다.
🔑 CHECK 02 - 사용 환경 결정
Claude는 4가지 환경에서 사용 가능합니다.
| 환경 | 특징 | 등록 방식 |
|---|---|---|
| Claude.ai (웹) | 표준 환경, 가장 일반적 | ZIP 업로드 |
| Claude Desktop (PC) | 안정성 ↑, 동일 작동 | ZIP 업로드 |
| 모바일 앱 | 활용 가능, 등록은 PC 권장 | (PC에서 등록 후 동기화) |
| Claude Code (CLI) | 개발자용, 고급 기능 | 로컬 폴더 기반 |
💡 오늘은 가장 일반적인 Claude.ai 웹 환경을 중심으로 설명합니다.
🔑 CHECK 03 - 첫 스킬 준비
초보자는 다음 3가지 경로 중 하나로 시작하세요.
| 경로 | 내용 | 난이도 |
|---|---|---|
| 경로 A | 일단 기본 스킬(자동 작동)만 활용 | ⭐ |
| 경로 B | GitHub 검증된 스킬 다운로드 → 등록 | ⭐⭐ |
| 경로 C | skill-creator로 직접 만들기 | ⭐⭐⭐ |
💡 오늘은 경로 A·B를 다룹니다. 경로 C는 8회차에서 자세히.
🚀 5분 환경 세팅 - 단계별 완벽 가이드
이제 본격 세팅입니다. 화면을 보시면서 그대로 따라하세요.
🔑 STEP 1 - Claude.ai 로그인 + 플랜 확인 (30초)
claude.ai 접속 → 본인 계정으로 로그인 → 우측 상단 프로필 아이콘 클릭 → 현재 플랜 확인
| 표시 | 조치 |
|---|---|
| Pro / Max | ✅ OK, 다음 단계 진행 |
| Free | "업그레이드" 버튼 클릭하여 Pro 가입 |
🔑 STEP 2 - 좌측 사이드바 → "사용자 지정" 진입 (10초)
좌측 메뉴 순서:
새 채팅 / 검색 / 채팅 / 프로젝트 / 아티팩트 / 코드 /
→ 사용자 지정 ← (클릭) / 디자인 / 더보기
"사용자 지정" 클릭 → 두 개의 탭이 표시됩니다.
| 탭 | 용도 |
|---|---|
| 스킬 (Skills) | 자동 선택됨 |
| 커넥터 (Connectors) | MCP 연결 관리 |
🔑 STEP 3 - "개인 스킬" 영역 살펴보기 (20초)
화면에 "개인 스킬" 영역이 표시됩니다.
| 항목 | 내용 |
|---|---|
| 신규 사용자 | 비어있거나 skill-creator만 표시 |
| 우측 상단 | 검색 아이콘(🔍) + "+" 버튼 |
| "+" 버튼 | 새 스킬 등록 |
| 검색 | 등록된 스킬 찾기 |
⚠️ docx · pptx · xlsx · pdf 기본 스킬은 여기 표시되지 않습니다. 백그라운드 자동 작동입니다.
🔑 STEP 4 - (선택) skill-creator 활성화 (30초)
자체 제작 준비 단계입니다.
▸ "개인 스킬"에 skill-creator가 보이면 클릭
▸ 우측 상단 토글 버튼을 ON으로 활성화
▸ 활성화 시 Claude가 대화로 스킬 생성 가능
▸ 비어있다면 8회차에서 다루므로 패스 가능
🔑 STEP 5 - 첫 스킬 작동 테스트 (1분)
좌측 상단 "새 채팅" 버튼 클릭 → 새 대화창 열기 → 아래 프롬프트 그대로 붙여넣어 보세요.
💡 첫 스킬 작동 테스트 프롬프트
Claude, 다음 메모를 한국 직장 표준 양식의
주간업무보고서 DOCX 파일로 만들어주세요.
[이번 주 한 일]
- 신규 거래처 미팅 진행
- Q3 실적 분석 시작
[다음 주 계획]
- 후속 제안서 발송
- Q3 분석 마무리💚 정상 작동: 응답에 "Created file: weekly_report.docx" 메시지 + 다운로드 링크 ✨
⚠️ 텍스트로만 응답이 나온다면
① 무료 플랜인지 확인 (Pro 이상 필요)
② "DOCX 파일로" 같이 명확한 형식 요청 포함했는지 확인
③ 새 채팅에서 다시 시도 (이전 대화 컨텍스트 영향 가능)
💡 첫 커스텀 스킬 등록 - ZIP 업로드 완전 가이드
이제 외부 스킬을 직접 등록해보겠습니다. GitHub의 검증된 스킬을 다운로드하여 등록하는 가장 안전한 방법입니다.
🔑 방법 ❶. GitHub에서 검증된 스킬 다운로드
| 출처 | 신뢰도 | 설명 |
|---|---|---|
| github.com/anthropics/skills | ⭐⭐⭐⭐⭐ | Anthropic 공식 |
| awesome-claude-skills | ⭐⭐⭐⭐ | 커뮤니티 검증 큐레이션 |
원하는 스킬 폴더 진입 → SKILL.md 내용을 먼저 검토 → 폴더 전체를 ZIP으로 압축합니다.
🔑 방법 ❷. ZIP 파일 구조 준수
ZIP 파일은 반드시 다음 구조여야 합니다.
example-skill.zip
├── SKILL.md (필수 - ZIP 루트에 위치)
├── references/ (선택 - 참고 자료)
├── scripts/ (선택 - Python·Bash 등)
└── assets/ (선택 - 템플릿·이미지)⚠️ 중요: ZIP 안에 또 다른 폴더가 있으면 안 됩니다. SKILL.md가 ZIP 루트에 위치해야 합니다. 잘못된 구조는 "Invalid SKILL.md" 오류를 발생시킵니다.
🔑 방법 ❸. 4단계 업로드 절차
| 단계 | 행동 | 결과 |
|---|---|---|
| STEP A | 사용자 지정 → 스킬 → "+" 버튼 클릭 | 업로드 메뉴 표시 |
| STEP B | ZIP 파일 선택 또는 드래그 앤 드롭 | 자동 유효성 검사 |
| STEP C | "개인 스킬" 목록에서 토글 ON | 활성화 완료 |
| STEP D | 새 채팅에서 트리거 단어 입력 | Claude 자동 호출 ✨ |
⚠️ 자주 발생하는 문제 해결
| 증상 | 원인 | 해결 방법 |
|---|---|---|
| Invalid SKILL.md 오류 | YAML 프론트매터 오류 | --- 마커 사이에 name, description 필수 포함 |
| 자동 호출 안 됨 | description의 트리거 키워드 부족 | description에 "다음 상황에서 사용할 것" + 키워드 5개 이상 |
| ZIP 업로드 실패 | 파일 크기 100MB 초과 | references를 외부 링크로 분리 |
| 응답이 텍스트로만 나옴 | 코드 실행 권한 미부여 | 유료 플랜 확인, 명확한 형식 요청 |
⭐ AI 전문가의 한 수 - 환경 세팅 고급 팁 4가지
🔑 TIP 01 - 데스크톱 앱 + 웹 동시 활용
Claude Desktop 앱과 웹은 같은 계정으로 동기화됩니다.
| 환경 | 강점 |
|---|---|
| 데스크톱 앱 | macOS·Windows에서 더 안정적, 알림 활용 가능 |
| 웹 | 어디서나 즉시 접근, 공용 PC에서도 OK |
두 환경을 함께 쓰면 작업 흐름이 끊기지 않습니다.
🔑 TIP 02 - 모바일 앱 활용
모바일에서도 등록된 스킬은 작동합니다.
▸ 스킬 등록은 PC 권장 (ZIP 업로드 편의성)
▸ 등록 후 모바일에서 자유롭게 호출 가능
▸ 출퇴근 중 보고서 초안 작성 등 활용도 높음
🔑 TIP 03 - 검증되지 않은 외부 스킬 검토 5단계
GitHub에서 받은 외부 스킬은 반드시 검토 후 사용하세요.
| 단계 | 검토 항목 |
|---|---|
| 1단계 | SKILL.md 본문 확인 - 어떤 작업을 하는지 명확한가? |
| 2단계 | scripts 폴더 검토 - Python·Bash 코드 동작 확인 |
| 3단계 | 외부 API 호출 여부 - 데이터 전송 위험 확인 |
| 4단계 | 권한 요구 사항 - disable-model-invocation 등 설정 확인 |
| 5단계 | 테스트 환경에서 시범 실행 - 실무 데이터 사용 전 검증 |
🔑 TIP 04 - 커스텀 스킬 백업 전략
50여 개 커스텀 스킬을 운영하는 저의 백업 방식입니다.
▸ GitHub 비공개 저장소에 모든 SKILL.md 폴더 저장
▸ 버전 관리: v1.0 → v1.1 → v1.2 식으로 변경 이력 추적
▸ 클로드 환경 재설치 시 ZIP 일괄 업로드로 5분 복구
💚 피플웨어 강의 현장 팁: "환경 세팅이 제일 어렵다"고 생각하시는 분이 많은데, 실제로는 5분이면 충분합니다. 오히려 어려운 건 "어떤 스킬을 만들 것인가"입니다. 4회차부터는 실전 활용 사례로 들어갑니다.
🤔 이것도 알아두세요 - 주의사항 & 한계
⚠️ Claude.ai 웹의 런타임 제약
2026년 5월 기준 Claude.ai 웹에서 스킬 실행은 Python 런타임만 지원합니다. Node.js 등 다른 런타임이 필요한 스킬은 Claude Code에서 실행해야 합니다.
⚠️ 스킬 ZIP 파일 크기 제한
업로드 가능한 ZIP 파일 크기는 100MB 이내입니다. 대용량 자료가 필요한 스킬은 references를 외부 링크로 분리하세요.
💡 무료 플랜 사용자 - 임시 활용법
무료 플랜은 스킬 기능이 제한되지만 다음 방법으로 일부 기능 체험 가능:
| 방법 | 내용 |
|---|---|
| ① 빌리기 | 친구·가족이 Pro 플랜 보유 시 잠깐 빌려서 체험 |
| ② 트라이얼 | Anthropic의 무료 트라이얼 활용 (시점 확인 필요) |
| ③ 회사 계정 | 회사가 Team/Enterprise 플랜이라면 회사 계정 활용 |
⚠️ 회사 정책 확인 - 보안 필수
회사 자료를 다루는 스킬은 회사 IT 정책 사전 확인이 필수입니다.
▸ 데이터가 외부 API로 전송되는지 검토
▸ 비밀번호·API 키 등 민감 정보를 스킬에 절대 포함시키지 말 것
▸ 회사 자료 처리 시 Team/Enterprise 플랜 사용 권장
✅ 3회차에서 배운 것
- 환경 세팅은 5분이면 충분 - 유료 플랜 가입 → 사용자 지정 → 스킬 메뉴 진입까지 1분
- Claude.ai 웹·데스크톱·모바일·Claude Code 4가지 환경이 모두 동기화된다
- "개인 스킬" 영역에는 직접 등록한 커스텀 스킬만 표시되며, docx·pptx 기본 스킬은 백그라운드 자동 작동
- 커스텀 스킬은 ZIP 파일로 업로드하며, SKILL.md가 ZIP 루트에 위치해야 한다
- GitHub의 anthropics/skills와 awesome-claude-skills가 가장 안전한 외부 스킬 출처다
- 업로드 후에는 반드시 토글을 ON으로 활성화하고, 트리거 단어로 작동 테스트를 해야 한다
- 외부 스킬은 5단계 검토 절차(SKILL.md → scripts → API 호출 → 권한 → 테스트)를 거쳐야 안전하다
💪 오늘의 5분 숙제
| 단계 | 할 일 |
|---|---|
| 1단계 | 본인의 Claude 플랜 확인 (Free → Pro 업그레이드 결정) |
| 2단계 | 좌측 사이드바 → 사용자 지정 → 스킬 메뉴 들어가보기 |
| 3단계 | STEP 5의 테스트 프롬프트로 docx 기본 스킬 작동 확인 |
| 4단계 (도전) | GitHub anthropics/skills에서 1개 다운로드 → ZIP 업로드 시도 |
| 5단계 (선택) | 막힌 부분을 메모해두고 다음 회차 트러블슈팅 자료로 활용 |
🗺️ 다음 회차 예고 - EPISODE 04
"문서 작성이 30분 → 30초로: DOCX·PPTX·XLSX 스킬 실전"
한국 직장 표준 양식으로 보고서·제안서·기안문을 자동 생성하는 실전 프롬프트 템플릿을 대량 공개합니다. 표·차트·이미지 자동 삽입 명령어 모음과 주간업무보고서 1분 생성 따라하기까지 - 본격 실전 활용편 시작입니다.
🫵 독자 참여
세팅하시면서 막히는 부분이 있으셨나요?
어떤 단계에서 헤매셨는지 알려주세요.
다음 회차에 자주 막히는 지점을 별도 트러블슈팅으로 다뤄드립니다.
- 정진일 (NogadaHunter) 드림
🔗 관련 링크
🏠 [연구소] AI 프롬프트 연구소 🎓 [이러닝 클래스] 정진일의 PEOPLEWARE
📮 [뉴스레터] Next AI
📺 [유튜브 채널] AI에 날개를 달다
📝 [블로그] 자기 성장에 날개를 달다
💬 [문의] 프롬프트 엔지니어
📚 [과정] AI 에이전트를 활용한 업무 자동화
🎯 [과정] AI 전문강사(제자) 양성
의견을 남겨주세요