사교원 연대지능 AI활동가 양성과정 1기 보조강사 2인의 사전 훈련. 본 과정에서 학생이 직접 만들 5종 자산(GitHub·위키·DB·사이트·자동화)을 보조강사가 먼저 손에 익히고, 학생이 막히는 지점을 미리 시뮬레이션한다.
개요
| 항목 | 내용 |
|---|---|
| 일정 | 1박 2일 · 총 8시간 (Day1 저녁 4h + Day2 오전 4h) |
| 장소 | 완도 망남 현장 |
| 책임 | 김성훈 |
| 참여 보조강사 | 김일영 · 김태현 |
| 진행 방식 | 텔레그램 모듈 카드 → 각자 노트북·Claude에 복붙하면서 따라가기 |
| 산출물 | 보조강사 각자 5종 자산 완비 + 멘토링 카드 1세트 |
사전 준비물 (시작 전 30분)
- 노트북(맥/윈도우, RAM 8GB+) · 안정 인터넷
- 계정: GitHub · Cloudflare · Supabase · Anthropic(Claude Code 또는 API)
- 설치: VSCode · 옵시디언 · Node.js 18 LTS
- 개인 메모: 자기 현장 문제 1개 (M6 자동화에서 씀)
- 챗 Claude 접근 (claude.ai 웹 로그인 또는 모바일 앱) — M1 시작 직후 시동 프롬프트용
전체 시간표
Day 1 저녁 (18:00 ~ 22:00, 4h)
| 시간 | 분 | 모듈 | 산출물 |
|---|---|---|---|
| 18:00 | 15 | OT — 5종 자산 지도, 멘토 역할 합의 | — |
| 18:15 | 60 | M1. Claude Code + CLAUDE.md | claude 작동 + 첫 CLAUDE.md |
| 19:15 | 60 | M2. VSCode + Git + GitHub | 자기 레포 + 첫 push |
| 20:15 | 15 | 휴식 | — |
| 20:30 | 75 | M3. 옵시디언 + Quartz + CF Pages | 자기 위키 URL 라이브 |
| 21:45 | 15 | Day1 회고 · 막힘 카드 1차 | 막힘 5건 메모 |
Day 2 오전 (08:30 ~ 12:30, 4h)
| 시간 | 분 | 모듈 | 산출물 |
|---|---|---|---|
| 08:30 | 60 | M4. Supabase 첫 테이블 + REST | DB 테이블 1개 |
| 09:30 | 60 | M5. 한 페이지 사이트 + CF Pages | 사이트 URL |
| 10:30 | 15 | 휴식 | — |
| 10:45 | 60 | M6. 자동화 1개 (자기 현장 문제) | 작동하는 스크립트 |
| 11:45 | 45 | M7. 멘토링 시뮬 + 카드 완성 | 멘토 카드 세트 |
🔑 자기 Claude 인프라 공유 (M1 시작 전 필수)
핵심: 자기 Claude가 1박2일 컨텍스트를 알아야 동료로 같이 간다. 두 보조강사가 동일 CLAUDE.md를 박으면 멘토 톤도 통일.
A. CLAUDE.md 표준 템플릿 (자기 폴더에 그대로 저장)
# 나의 작업 컨텍스트 — 사교원 보조강사 선행학습 1박2일
## 내가 누구
- 이름: [본인 — 김일영 / 김태현]
- 역할: 사교원 「연대지능 AI활동가 양성과정 1기」 보조강사
- 책임강사: 김성훈 / 동료 보조강사: [다른 한 명]
- 일정: 2026-06-12~13, 완도 망남, 1박 2일 8시간
## 우리가 만들 5종 자산 (내가 직접 손에 들 것)
1. GitHub 레포
2. 위키 URL (옵시디언 + Quartz + CF Pages)
3. Supabase DB 테이블
4. 한 페이지 사이트 URL
5. 작동하는 자동화 1개
## 전체 프로그램 (참조)
https://wiki.poomasi.org/교육훈련/사교원_보조강사_선행학습_1박2일
## 너(Claude)에게 부탁하는 톤
- 한국어로
- 한 번에 1개 단계만, 명령어는 코드블록
- 모르면 "모른다" 먼저 말해라
- 내가 "다음" 하기 전엔 다음 단계로 안 넘어감
- 내 폴더 밖 파일은 건드리지 마라
- 정답기계 아닌 동료처럼, 내가 왜 막혔는지 짚어라
## 지금 단계
M1 진행 중 (모듈 바뀔 때마다 본인이 갱신)
## 내 현장 문제 (M6 자동화에서 씀)
[본인이 한 줄로 적어두기]B. 첫 시동 프롬프트 (챗 Claude — claude.ai 웹/앱 — 에 던지기)
이 시점엔 아직 Claude Code 설치 전이라 챗 Claude에 던진다.
나는 사교원 「연대지능 AI활동가 양성과정 1기」 보조강사 [김일영 / 김태현]입니다.
오늘부터 1박 2일, 완도 망남에서 책임강사 김성훈과 함께 선행학습을 합니다.
전체 프로그램: https://wiki.poomasi.org/교육훈련/사교원_보조강사_선행학습_1박2일
지금부터 1박 2일 동안 너(Claude)와 동료로 같이 갈 거야.
톤: 한국어 / 한 번에 한 단계 / 모르면 "모른다" 먼저 / 내가 "다음" 하기 전엔 다음 단계로 안 넘어감 / 정답기계 아닌 동료.
먼저 내 PC 환경을 점검해줘:
- OS 종류·버전
- 셸 (bash / zsh / PowerShell)
- Node 버전 (없으면 없다고)
- Git 버전 (없으면 없다고)
- VSCode 설치 여부
- 옵시디언 설치 여부
각 항목 어떤 명령어로 확인하는지 OS별로 알려주고,
내가 결과 붙여넣으면 "있어야 할 것 / 없는 것 / 설치 순서"를 표로 정리해줘.
지금은 점검만, 설치는 다음 단계에서 같이 할 거야.
모듈 카드 (텔방 복붙용 + 자기 클로드 프롬프트 포함)
각 모듈 카드는 그대로 텔레그램에 복붙 → 보조강사가 각자 노트북에서 [클로드에 줄 프롬프트] 블록을 자기 Claude에 복붙하면서 진행한다.
📦 M1. Claude Code + CLAUDE.md (60분) — 인프라 공유
목표: 자기 Claude(챗 + Claude Code)가 1박2일 컨텍스트를 손에 쥔 동료가 된다.
시간표
| 시간 | 단계 | 매체 |
|---|---|---|
| 0~15’ | 챗 Claude에 첫 시동 프롬프트 (위 B) 던지기 → PC 환경 보고 | claude.ai 웹/앱 |
| 15~30’ | 챗 Claude와 함께 없는 도구 설치 (Node·Git·VSCode·옵시디언) | claude.ai |
| 30~40’ | 자기 폴더 만들고 CLAUDE.md 표준 템플릿 (위 A) 박기 | 텍스트 에디터 |
| 40~50’ | 그 폴더에서 claude 띄움 → 헬로월드 → CLAUDE.md 읽었는지 확인 | Claude Code |
| 50~60’ | 같은 질문 챗 Claude vs Claude Code 응답 비교 — 컨텍스트 효과 체감 | 둘 다 |
자주 막힘 → 멘토 답변
| 증상 | 1차 답변 |
|---|---|
| Claude Code 결제카드 없어서 가입 막힘 | Anthropic 체험 크레딧 경로 또는 책임강사 키 임시 공유 |
claude: command not found | PATH 설정 한 줄 + 셸 재시작 카드 |
| 한글 깨짐 | 터미널 인코딩 UTF-8 한 줄 가이드 |
| CLAUDE.md 안 읽힌 듯 | 같은 폴더에서 claude 띄웠는지 확인, 파일명 정확히 CLAUDE.md |
📦 M2. VSCode + Git + GitHub (60분)
목표: 내 폴더가 GitHub 레포 1개가 되고, 변경하면 push로 올라간다.
순서
- (10’) Git 설치 확인 +
git config --global user.name/email - (15’) 폴더에서
git init→ README.md 만들고 첫 commit - (15’) GitHub 빈 레포 생성 → HTTPS+PAT로 remote 연결 → push
- (10’) VSCode Source Control 탭에서 수정·커밋·push 한 사이클
- (10’) 두 번째 파일 추가 후 다시 push
[클로드에 줄 프롬프트]
지금 이 폴더를 git 레포로 만들고 GitHub에 올리고 싶어.
나는 git 처음이야. 다음 흐름을 한 단계씩 알려줘.
각 단계 끝나면 "다음" 하기 전에 멈춰.
1) git 초기화 + 첫 커밋
2) GitHub에 빈 레포 만들고 remote 연결
3) HTTPS + Personal Access Token으로 push
README.md는 "내 이름 — AI 활동가 1기" 한 줄만 들어가게.
자주 막힘 → 멘토 답변
| 증상 | 1차 답변 |
|---|---|
Permission denied (publickey) | SSH 말고 HTTPS+PAT 경로로 통일 |
| PAT 어디서 만드나요 | GitHub > Settings > Developer settings > PAT (classic) repo 권한만 |
LF/CRLF 경고 | git config --global core.autocrlf 한 줄로 통일 |
📦 M3. 옵시디언 + Quartz + CF Pages (75분)
목표: 내 옵시디언 노트가 *.pages.dev 공개 위키로 뜬다.
순서
- (10’) 옵시디언 vault 생성 + 첫 노드 (
index.md한 페이지) - (15’) Quartz v4 fork → clone →
npm install - (15’)
content/폴더에 옵시디언 vault 내용 복사 →npx quartz build --serve로컬 미리보기 - (20’) GitHub push → Cloudflare Pages 프로젝트 연결
- (15’) 빌드 명령
npx quartz build/ 출력 디렉토리public설정 → 라이브 URL 확인
[클로드에 줄 프롬프트]
Quartz v4로 옵시디언 위키를 Cloudflare Pages에 배포하려고 해.
다음 순서를 한 단계씩 알려줘.
- Quartz 레포 fork 후 clone
- npm install
- content/ 폴더에 내 노트 한 개 넣기
- 로컬에서 npx quartz build --serve로 미리보기
- GitHub에 push
- Cloudflare Pages에서 빌드 명령·출력 디렉토리 어디에 뭘 넣는지
Node 18 기준이야.
자주 막힘 → 멘토 답변
| 증상 | 1차 답변 |
|---|---|
npm install 실패 | Node 버전 확인 → 18 LTS 통일 |
| CF Pages 빌드 실패 | 빌드 명령 npx quartz build, 출력 public 카드 |
| 위키 URL 한글 깨짐 | Quartz slug 옵션 카드 |
📦 M4. Supabase 첫 테이블 + REST (60분)
목표: 내 DB에 데이터 한 줄 들어가고, REST로 꺼내본다.
순서
- (10’) Supabase 프로젝트 생성
- (15’) 테이블
notes(id·title·body·created_at) - (15’) RLS 켜기 + 정책 1개 (
anon읽기 허용) - (20’)
curl또는 Pythonrequests로 GET/POST 한 번씩
[클로드에 줄 프롬프트]
Supabase에 notes 테이블을 만들고, anon 키로 REST GET이 되게 하려고 해.
다음을 단계별로 알려줘.
1) 테이블 스키마(id uuid PK, title text, body text, created_at timestamptz default now())
2) RLS 켜기 + anon에게 SELECT만 허용하는 정책 SQL
3) curl로 GET 한 줄 (URL, apikey 헤더, Authorization 헤더)
4) anon 키와 service 키 차이 (어디까지 노출 OK인지)
자주 막힘 → 멘토 답변
| 증상 | 1차 답변 |
|---|---|
| REST가 빈 배열만 옴 | RLS 정책 누락 — anon SELECT 정책 추가 |
| anon/service 헷갈림 | ”anon=공개 OK, service=절대 클라이언트 X” 한 줄 |
| CORS 에러 | Supabase 대시보드 URL 화이트리스트 |
📦 M5. 한 페이지 사이트 + CF Pages (60분)
목표: 내 위키와 DB로 연결되는 한 페이지 사이트가 라이브 URL로 뜬다.
순서
- (15’) Claude Code로 한 페이지 정적 HTML 생성 (자기 소개 + 위키·DB 링크)
- (15’) 로컬 브라우저로 열어보고 수정
- (15’) 새 GitHub 레포 → push
- (15’) CF Pages 연결 → 빌드 명령 비움 / 출력
/→ 라이브 URL
[클로드에 줄 프롬프트]
한 페이지 정적 사이트를 만들어줘.
- 파일: index.html 1개, CSS는 같은 파일에 인라인
- 내용: 내 이름, 한 줄 소개, 내 위키 URL 링크, 내 GitHub 링크
- 모바일에서도 보기 편하게
- 빌드 도구 없이 그냥 정적 HTML
다 만들면 git add → commit → push 명령도 알려줘.
자주 막힘 → 멘토 답변
| 증상 | 1차 답변 |
|---|---|
| CF Pages 빌드 실패 | 정적 HTML이면 빌드 명령 비우고 출력 디렉토리 / |
| 모바일에서 글자 작음 | <meta name="viewport"> 한 줄 카드 |
📦 M6. 자동화 1개 (60분)
목표: 내 현장 문제 1개가 코드로 풀려서 손이 줄어든다.
순서
- (10’) 사전 메모한 현장 문제 → 입력·처리·출력 3줄로 쪼개기
- (40’) Claude Code와 페어로 스크립트 작성·실행
- (10’) GitHub push + README에 사용법 1단락
[클로드에 줄 프롬프트]
나의 현장 문제는 이거야: [여기 본인 문제 1줄]
이걸 자동화로 풀려고 해.
먼저 입력·처리·출력 3줄로 잘게 쪼개주고, 그 다음 가장 단순한 스크립트(파이썬 또는 셸)로 시작하자.
환경변수는 .env에 두고, .gitignore에 .env 넣어줘.
한 번에 다 짜지 말고 한 단계씩 같이 가자.
자주 막힘 → 멘토 답변
| 증상 | 1차 답변 |
|---|---|
| API 키 노출 위험 | .env + .gitignore 카드 |
| 스케줄러 어디다 두나요 | 우선 수동 실행, cron/CF Cron은 다음 회차 |
📦 M7. 멘토링 시뮬레이션 + 카드 완성 (45분)
목표: 학생 메시지 10개에 김일영·김태현이 각자 답안 작성 → 톤·길이 합 맞추기.
가상 학생 메시지 10개 (책임강사가 텔방에 던짐 → 보조강사 각자 답변)
- “claude 명령이 안 먹어요”
- “git push 했는데 비번 물어봐요”
- “CF Pages가 빌드 실패라고 떠요”
- “RLS가 뭐예요?”
- “내 위키 URL 한글이 깨져요”
- “옵시디언이랑 Quartz 폴더가 뭐가 어디 있는지 모르겠어요”
- “.env 파일을 실수로 push한 것 같아요”
- “Claude가 자꾸 영어로 대답해요”
- “내 자동화 스크립트가 PC 끄면 멈춰요”
- “수료할 자신이 없어요” (멘탈 케어)
텔레그램 응답 톤 합의
- 3줄 이내 + 명령어는 코드블록
- “왜 그런가” 1줄 → “이렇게 해보세요” 1~2줄
- 안 풀리면 줌 통화·화면공유 트리거
- 인격적 응답 톤 (정답기계 X, 같이 가는 동료)
산출: 멘토_카드.md — 위 10개에 대한 답변 표준안 + 톤 가이드. 본 과정 시작 전 책임강사 검토.
멘토 카드 양식
[증상] 학생이 보낸 메시지 한 줄
[원인 1순위] 가장 흔한 원인 한 줄
[1차 답변] 텔레그램에 보낼 3줄 (명령어 포함)
[안 풀리면] 줌 통화 / 화면공유 트리거 조건
[참고 위키] 관련 노드 링크
운영 규칙
- 모듈 시작 전 5종 자산 지도를 매번 1번 가리키며 “지금 어디”인지 합의
- 모듈마다 막힌 사람 1명 있으면 전체 멈추고 같이 푼다 (멘토링 리허설)
- Day1 회고에서 나온 막힘 5건은 그대로 Day2 M7 시뮬에 들어감 (현장 자료)
- 모든 산출물은 GitHub·위키·DB·사이트로 라이브 — 캡처·자랑 X, 실제 작동만
관련 노드
- 사교원_연대지능_AI아카데미_1기 — 본 과정 (5회차)
- 사교원 — 주최 법인