// AI Native Camp Week 1 실습. Claude Code 체험 → MCP 연결 → 나만의 첫 스킬 만들기. "1일차", "Day 1", "온보딩" 요청에 사용.
[HINT] Download the complete skill directory including SKILL.md and all related files
| name | day1-onboarding |
| description | AI Native Camp Week 1 실습. Claude Code 체험 → MCP 연결 → 나만의 첫 스킬 만들기. "1일차", "Day 1", "온보딩" 요청에 사용. |
이 스킬이 호출되면 아래 3개 Block을 순서대로 진행한다. 각 Block이 끝나면 AskUserQuestion으로 다음으로 넘어갈지 물어본다.
절대 한 번에 여러 Block을 진행하지 않는다. 하나의 Block이 완료될 때까지 다음 Block을 시작하지 않는다. 사용자의 응답을 기다린 후에만 진행한다. 막히면 5분 이상 붙잡지 않고 다음으로 — 호스트(승아)에게 슬랙 #ai-native-camp DM.
박주영처럼 Claude Code 처음 켜는 분이라면 이 Block부터.
AskUserQuestion({
"questions": [{
"question": "현재 환경 알려주세요.",
"header": "OS/도구",
"options": [
{"label": "Mac, 터미널에서 claude 실행 중", "description": "표준 흐름"},
{"label": "Windows, PowerShell에서 claude 실행 중", "description": "OS 분기 활성화"},
{"label": "VSCode 확장에서 Claude Code 사용 중", "description": "터미널이 VSCode 안에 있음"},
{"label": "터미널 켜본 적 없음", "description": "호스트에게 도움 요청 필요"}
],
"multiSelect": false
}]
})
마지막 옵션이면 "호스트에게 화면 공유 요청" 안내 후 일시 정지.
claude --version
→ 2.0.0 이상이면 OK. 미만이거나 명령어 없음 → 슬랙 #ai-native-camp 에 OS와 함께 보고. 호스트가 화면 공유로 도움.
박주영이 어느 폴더에서 시작할지 정함:
~/Documents/driving-teacher-day1 (호스트가 사전 안내)%USERPROFILE%\Documents\driving-teacher-day1mkdir -p ~/Documents/driving-teacher-day1 && cd ~/Documents/driving-teacher-day1
(Windows PowerShell)
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\Documents\driving-teacher-day1"; cd "$env:USERPROFILE\Documents\driving-teacher-day1"
→ 이 폴더 안에 Block 1의 output/ 도 자동 생성됨.
Claude Code가 내 컴퓨터에서 직접 파일을 읽고 쓸 수 있다는 것을 체감.
안녕하세요! AI Native Camp Week 1 실습을 시작합니다.
먼저, Claude Code가 여러분의 컴퓨터에서 직접 동작한다는 걸 보여드릴게요.
프로젝트의 파일/폴더 구조를 간단히 탐색해서 보여준다.
AskUserQuestion으로 체험할 업무를 선택하게 한다:
AskUserQuestion({
"questions": [{
"question": "Claude Code로 뭘 시켜볼까요? 하나 골라보세요.",
"header": "첫 체험",
"options": [
{"label": "데이터 정리", "description": "표나 리스트를 정리해줘"},
{"label": "문서 초안", "description": "안내문/보고서 초안 만들어줘"},
{"label": "아이디어 브레인스토밍", "description": "아이디어 5개 내줘"},
{"label": "내 업무 직접 말할게", "description": "자유롭게 시켜볼래요"}
],
"multiSelect": false
}]
})
선택한 업무를 실행하되, 파일을 직접 생성해서 결과를 저장한다. (이것이 ChatGPT와의 차이 — 답변을 복사할 필요 없이 파일이 바로 생긴다)
output/ 폴더에 저장 (Claude가 폴더 없으면 자동 생성)mkdir -p output (Mac/Linux) / mkdir output (Windows PowerShell) 수동 생성 후 재시도결과를 보여주고 "파일이 바로 생겼죠?"라고 설명.
두 번째 체험 — Claude의 기억 시스템을 체험한다:
이번엔 더 실용적인 걸 해볼게요.
Claude Code에는 기억 시스템이 있습니다. 3가지예요.
1. CLAUDE.md — 프로젝트 규칙서. "이 프로젝트에서는 이렇게 해"를 적는 파일
2. Auto Memory — Claude가 대화하면서 알아서 적는 메모. "이 사람은 이런 걸 좋아하는구나"
3. ~/.claude/CLAUDE.md — 나의 전역 설정. 어떤 프로젝트에서든 적용
지금 Auto Memory를 직접 체험해볼게요!
AskUserQuestion({
"questions": [{
"question": "Claude Code의 기억 시스템 — CLAUDE.md와 Auto Memory의 차이는?",
"header": "Block 1 퀴즈",
"options": [
{"label": "CLAUDE.md는 내가 쓰고, Auto Memory는 Claude가 쓴다", "description": "작성 주체가 다르다"},
{"label": "같은 파일이다", "description": "이름만 다른 같은 기능"},
{"label": "Auto Memory는 한 번만 읽힌다", "description": "매 세션마다? 한 번만?"}
],
"multiSelect": false
}]
})
정답: 1번. CLAUDE.md는 내가 직접 적는 매뉴얼, Auto Memory는 Claude가 대화하면서 알아서 적는 메모. 둘 다 매 세션 시작 시 자동으로 읽힌다.
AskUserQuestion({
"questions": [{
"question": "첫 체험 어떠셨나요? MCP 연결로 넘어갈까요?",
"header": "다음 단계",
"options": [
{"label": "넘어가자", "description": "MCP 연결 실습으로"},
{"label": "하나 더 해볼래", "description": "다른 업무도 시켜보고 싶어"}
],
"multiSelect": false
}]
})
외부 도구(채널톡 or 노션)를 Claude Code에 연결해서, AI가 내 도구의 데이터를 읽을 수 있게 한다.
MCP는 외부 도구를 Claude Code에 연결하는 방법입니다.
쉽게 말하면:
- 지금 Claude Code는 여러분 컴퓨터의 파일만 볼 수 있어요
- MCP를 연결하면 노션, 슬랙, 채널톡 같은 외부 서비스의 데이터도 읽을 수 있어요
- USB-C처럼 — 꽂으면 바로 쓸 수 있어요
예를 들어 노션 MCP를 연결하면:
"노션에서 지난달 회의록 찾아줘" 가 가능해집니다.
MCP는 수백 개가 있어요. 노션, 슬랙 말고도 구글시트, 지메일, 캘린더,
웹 검색 등 거의 모든 서비스에 MCP가 있습니다.
💡 웹 검색도 MCP로 연결할 수 있어요!
- Tavily MCP: AI 전용 검색 엔진. 검색 결과를 깔끔하게 요약해줍니다
- Claude Code 기본 웹 검색보다 정확하고 빠를 수 있어요
- "최신 뉴스 찾아줘", "경쟁사 분석해줘" 같은 리서치에 유용
"이런 것도 연결할 수 있어?" 싶으면 검색해보세요 — 거의 다 있어요!
⚠️ 반드시 개인 계정으로 먼저! 회사 노션/슬랙은 Admin 권한으로 막힐 수 있어요. 개인 노션, 개인 Gmail 등으로 먼저 연결 → 성공하면 나중에 회사 도구로.
이 경고를 AskUserQuestion 전에 반드시 말한다. 도구 선택 후가 아니라 선택 전에.
AskUserQuestion({
"questions": [{
"question": "어떤 도구를 Claude Code에 연결해볼까요?",
"header": "MCP 연결",
"options": [
{"label": "채널톡", "description": "고객 문의를 AI가 읽고 답변 초안을 만들 수 있음"},
{"label": "노션", "description": "노션 문서를 AI가 검색하고 읽을 수 있음"},
{"label": "슬랙", "description": "슬랙 메시지를 AI가 읽고 요약할 수 있음"},
{"label": "웹 검색 (Tavily)", "description": "AI가 웹을 검색하고 결과를 요약. 리서치에 유용"},
{"label": "다른 도구 검색", "description": "원하는 서비스의 MCP를 검색해서 연결 (구글시트, 지메일 등)"}
],
"multiSelect": false
}]
})
API 키를 발급받으면 한 마디만 안내한다:
참고: API 키는 비밀번호와 같아요.
- claude mcp add 명령어로 연결하면 안전하게 저장됩니다
- 키를 슬랙이나 메모장에 붙여넣지 마세요
- 대화창에 "내 키는 sk-xxx야"라고 직접 입력하지 마세요 — 로그에 남을 수 있어요
기술적 설명(.env, .gitignore 등)은 하지 않는다. 비개발자에게 혼란만 준다.
claude mcp add명령어가 키를 안전하게 저장한다는 것만 전달하면 충분.
서비스별 정확한 호출. 새 터미널에서 실행:
# Notion
claude mcp add notion --env NOTION_API_KEY=<발급받은_키> -- npx -y @modelcontextprotocol/server-notion
# Slack (Slack Bot Token + Team ID 필요)
claude mcp add slack --env SLACK_BOT_TOKEN=<토큰> --env SLACK_TEAM_ID=<팀ID> -- npx -y @modelcontextprotocol/server-slack
# Tavily 웹 검색
claude mcp add tavily --env TAVILY_API_KEY=<키> -- npx -y @modelcontextprotocol/server-tavily
# Google Drive
claude mcp add gdrive -- npx -y @modelcontextprotocol/server-gdrive
# → 첫 호출 시 OAuth 브라우저 자동 열림
연결 후 검증:
claude mcp list
# → 방금 추가한 서비스가 ✅ 표시되어야 함
Windows (PowerShell) — 동일하지만 줄바꿈 \ 대신 한 줄로:
claude mcp add notion --env NOTION_API_KEY=<키> -- npx -y @modelcontextprotocol/server-notion
연결이 안 되면 (권한 없음, API 키 발급 불가 등) 바로 대안을 제시한다:
원칙: 막히면 5분 이상 붙잡지 않는다. 대안으로 넘어간다.
연결 성공 후, 실제로 데이터를 가져와서 보여준다:
퀴즈로 핵심을 확인한다:
AskUserQuestion({
"questions": [{
"question": "MCP를 한 마디로 말하면?",
"header": "Block 2 퀴즈",
"options": [
{"label": "Claude와 외부 도구를 연결하는 표준 프로토콜", "description": "노션, 슬랙 등을 꽂는 USB-C"},
{"label": "Claude의 내장 기능", "description": "MCP는 외부 연결 vs 내장?"},
{"label": "프로그래밍 언어", "description": "도구 연결 프로토콜 vs 언어?"}
],
"multiSelect": false
}]
})
정답: 1번. MCP는 외부 도구를 Claude에 연결하는 오픈 표준 프로토콜. USB-C처럼 꽂으면 쓸 수 있다.
AskUserQuestion({
"questions": [{
"question": "MCP 연결 완료! 이제 나만의 스킬을 만들어볼까요?",
"header": "다음 단계",
"options": [
{"label": "스킬 만들러 가자", "description": "나만의 첫 스킬 만들기"},
{"label": "MCP 하나 더 연결할래", "description": "다른 도구도 연결하고 싶어"}
],
"multiSelect": false
}]
})
반복하는 업무를 스킬로 만들어서 명령어 하나로 실행할 수 있게 한다.
스킬은 반복하는 업무를 자동화하는 명령어입니다.
예: /cs-reply 치면 채널톡 답변 초안이 나오는 식.
한 번 만들면 계속 쓸 수 있고, 팀원과 공유도 됩니다.
AskUserQuestion({
"questions": [{
"question": "평소에 반복해서 귀찮은 업무가 뭔가요? 하나만 떠올려보세요.",
"header": "자동화 대상 찾기",
"options": [
{"label": "고객 응대 (CS)", "description": "비슷한 질문에 비슷한 답변을 반복"},
{"label": "보고/정리", "description": "데일리 스크럼, 주간 보고 등 정형화된 문서"},
{"label": "자료 조사/요약", "description": "리서치 후 정리하는 작업"},
{"label": "직접 말할게", "description": "위에 없는 다른 업무"}
],
"multiSelect": false
}]
})
참고:
/think-deeper를 쓰면 "왜 이게 귀찮은가?"를 깊이 파볼 수 있어요. 시간 관계상 여기선 빠르게 넘어가고, 숙제에서 /think-deeper를 직접 써보세요!
AskUserQuestion({
"questions": [{
"question": "어떤 스킬을 만들어볼까요? 설문에서 쓴 귀찮은 업무를 떠올려보세요.",
"header": "스킬 만들기",
"options": [
{"label": "/cs-reply", "description": "채널톡 답변 초안 자동 생성"},
{"label": "/daily-scrum", "description": "데일리 스크럼 자동 작성"},
{"label": "/research-summary", "description": "리서치 자료 요약"},
{"label": "/contract-review", "description": "계약서 검토 체크리스트"},
{"label": "직접 말할게", "description": "위에 없는 다른 업무를 자동화하고 싶어"}
],
"multiSelect": false
}]
})
선택한 스킬의 SKILL.md를 사용자와 대화하면서 만든다:
~/.claude/skills/<스킬이름>/SKILL.md (전역) 또는 <현재폴더>/.claude/skills/<스킬이름>/SKILL.md (프로젝트)%USERPROFILE%\.claude\skills\<스킬이름>\SKILL.md (전역)~/.claude/skills/) — 어느 폴더에서든 호출 가능mkdir -p ~/.claude/skills/<스킬이름> 수동만든 스킬을 바로 테스트한다:
퀴즈로 핵심을 확인한다:
AskUserQuestion({
"questions": [{
"question": "스킬은 CLAUDE.md와 어떻게 다르게 로드되나요?",
"header": "Block 3 퀴즈",
"options": [
{"label": "필요할 때만 로드된다", "description": "/명령어를 치거나 자동 매칭될 때만"},
{"label": "CLAUDE.md처럼 매번 전부 로드된다", "description": "그러면 스킬이 많아질수록 느려지겠죠?"},
{"label": "한 번 로드하면 영구 저장된다", "description": "세션이 끝나면?"}
],
"multiSelect": false
}]
})
정답: 1번. CLAUDE.md는 매 세션마다 전부 로드되지만, 스킬은 필요할 때만 로드된다. 그래서 스킬을 아무리 많이 만들어도 무겁지 않다.
축하합니다! 나만의 첫 스킬을 만들었습니다. 🎉
이제 이 스킬은 언제든 사용할 수 있습니다.
다음 주에는 이 스킬을 실전에 써보고, 팀원들과 공유합니다.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
다음 단계 (이 명령어가 안 보이면 슬랙 #ai-native-camp DM):
📝 /homework — Day별 숙제
💡 /claude-code-guide — 7개 기능 가이드
🔧 /tips — 팀 꿀팁 모음
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
명령어 안 보이면 호스트(승아)에게 슬랙으로 화면 캡처 공유.
output/ 폴더 권한 문제 → chmod u+w . (Mac/Linux) 후 재시도df -h (Mac/Linux) / Get-PSDrive (Windows)로 용량 확인exit 후 claude 재실행) 후 "내 이름 기억해?" 물어보기claude mcp add 명령어 미인식 → Claude Code 버전 2.0 이상인지 (claude --version)claude mcp list 로 ✅ 확인. 빨간색이면 키 오류~/.claude/ 폴더 권한 확인 (ls -la ~/.claude)%USERPROFILE% 안 풀림 → $env:USERPROFILE 사용#ai-native-camp — 화면 캡처 + 에러 메시지 함께 공유