강사님,
그 일 언제까지
직접 하실 거예요?

GitHub 계정 만들기

코드를 받으려면 GitHub 계정이 필요해요. 아직 없다면 먼저 만들어주세요.

완성 코드 Fork (복제)

Fork는 다른 사람의 GitHub 코드를 내 계정으로 복제해 가져오는 기능이에요. 한 번 Fork하면 내 코드가 되니까 마음대로 수정해도 원본에 영향을 주지 않아요.

Fork 순서

1. 아래 완성 코드 레포 링크 접속:
   📂 github.com/TeddyChoi-wow/Mynewsletter →
2. 우측 상단 Fork 버튼 클릭
3. 본인 GitHub 계정 선택 → Create fork 클릭
4. 잠시 후 본인 계정 안에 똑같은 레포가 생김

※ 만약 Cannot fork because you own this repository 메시지가 보인다면, 본인이 이미 같은 레포를 소유하고 있다는 뜻이에요. 다른 강사 입장에서는 마주칠 일이 거의 없습니다.

준비물 발급 — API 키, 앱 비밀번호

코드는 받았으니, 이제 본인 키와 비밀번호를 발급받을 차례예요.

필요한 것 3가지

• Anthropic API 키 sk-ant-로 시작하는 긴 문자열
• Gmail 앱 비밀번호 16자리 (공백 제거하고 사용)
• 받을 이메일 주소 발송용 Gmail과 같아도 되고, 다른 메일이어도 됨

각각 발급 방법은 Track B의 사전 준비물 단계에 자세히 있어요. → Track B의 ③ 계정 + 키 발급 보기

GitHub Secrets에 키 등록

내 GitHub 레포에 안전하게 키와 비밀번호를 등록해요. 이게 자동화의 핵심이에요. 코드에 직접 쓰면 안 되고, Secrets 안에 보관해야 안전합니다.

등록 단계 — 클릭 경로

1. Fork된 본인 레포 페이지 접속 예: github.com/내아이디/daily-news-curator
2. 상단 메뉴 Settings 탭 클릭 ⚠️ 본인 프로필 Settings가 아니라, 레포 페이지 안의 Settings예요. 레포 이름 아래쪽 가로 메뉴에 있어요
3. 좌측 사이드 메뉴를 아래로 스크롤 → Security 섹션의 Secrets and variables 클릭
4. 드롭다운 펼침 → Actions 선택
5. 우측 상단 초록색 New repository secret 버튼 클릭
6. Name 입력란에 변수명, Secret 입력란에 실제 값 붙여넣기
7. 아래 Add secret 버튼 클릭 → 등록 완료
8. 아래 9개 변수를 위 단계로 하나씩 반복 등록 (한 번에 하나씩만 가능)

키워드 바꾸기 — 내 강의 분야로

이 단계가 트랙 A의 핵심이에요. 다른 건 다 그대로 두고, 키워드와 강사 프로필만 본인 것으로 바꿉니다. 그리고 좋은 소식 — 이미 A4에서 끝났어요.

A4에서 GitHub Secrets에 등록한 두 변수가 곧 본인의 강의 분야예요:

• KEYWORDS — 받고 싶은 뉴스 주제 (쉼표 구분) 예: 리더십,조직문화,코칭,MZ세대
• INSTRUCTOR_PROFILE — AI가 적합도 판단할 기준이 되는 강사 정체성 예: 리더십 강사, 코칭·조직문화 전문, 데이터 기반 인사이트 선호

나중에 키워드 바꾸고 싶을 때

코드를 다시 만질 필요 없어요. GitHub Secrets에서 KEYWORDS 값만 바꾸면 다음 실행부터 바로 반영됩니다.

1. 본인 레포 → Settings → Secrets and variables → Actions
2. KEYWORDS 옆 Update 버튼 클릭
3. 새 값 입력 → 저장

Actions 켜기 + 첫 실행

Fork한 레포는 기본적으로 GitHub Actions가 꺼져 있어요. 활성화하고 한 번 수동으로 돌려서 메일이 오는지 확인해요.

1. Fork한 레포 → 상단 메뉴 Actions
2. "I understand my workflows, go ahead and enable them" 버튼 클릭 (Fork한 레포에서 처음 한 번만 표시됨)
3. 좌측 워크플로우 목록에서 자동화 선택
4. 우측 Run workflow 버튼 클릭 → 다시 Run workflow
5. 잠시 후 실행 결과 확인 — 초록 체크면 성공
6. 본인 메일함 확인 — 뉴스레터 도착!

막혔을 때

• Secrets 이름이 정확히 일치하는지 확인 대소문자 구분, 오타 주의 — Settings → Secrets에서 다시 확인
• Gmail 앱 비밀번호의 공백 제거 발급 시 표시는 abcd efgh ijkl mnop이지만, 등록할 땐 공백 빼고 abcdefghijklmnop
• Actions 실패 시 빨간 X 클릭해서 로그 보기 에러 메시지를 그대로 Claude에 복붙해서 물어보면 답이 빠름
• 스팸함 확인 첫 발송은 가끔 스팸으로 분류됨

사전 준비물

실습 전에 깔거나 발급받아둘 것들이에요. 준비물 없이 시작하면 중간에 멈춥니다. 한 번 훑어보고, 각 항목은 클릭하면 자세한 설치·발급 방법이 펼쳐져요.

한눈에 보는 체크리스트

• Node.js (LTS) — 코드 실행 환경
• VS Code — 코드 에디터
• Git — 버전 관리 (GitHub과 다른 도구)
• Claude Code — 바이브코딩 도구 (CLI 또는 VS Code 확장)
• GitHub 계정 — 코드 저장 + Actions 자동화
• Anthropic API 키 — 앱에서 Claude 호출용
• Gmail 앱 비밀번호 — 메일 자동 발송용

설치 가이드

계정·키 발급 가이드

구현하기 (바이브코딩)

준비가 끝났으면 이제 실제로 만들어요. Step 2에서 만든 4개 문서를 Claude Code에 던지고, "1단계부터 개발 시작해줘"로 흘러갑니다.

① 프로젝트 폴더 만들기 — GitHub Desktop으로

터미널 명령어 대신 GitHub Desktop으로 프로젝트를 시작합니다. 클릭 몇 번이면 폴더 생성 + GitHub 레포 연결 + .gitignore 자동 생성까지 한 번에 끝나요.

단계

1. GitHub Desktop 실행 → 상단 메뉴 File → New repository
2. Name 입력 (예: my-newsletter)
3. Local path — 내 컴퓨터의 어디에 저장할지 선택 (기본값 OK)
4. Git ignore 드롭다운에서 Node 선택 ⭐ 자동으로 Node.js용 .gitignore가 만들어져요. node_modules, .env 같은 게 미리 제외됨
5. Initialize this repository with a README 체크 (옵션)
6. Create repository 버튼 클릭
7. 상단의 Publish repository 버튼 → Private 선택 → Publish ⭐ 이 단계에서 GitHub에도 같은 이름의 레포가 자동 생성돼요

VS Code에서 폴더 열기

이제 만든 폴더를 VS Code에서 열고 Claude Code를 실행합니다.

※ VS Code 메뉴 File → Open Folder에서 직접 선택해도 됩니다. Mac에서 code . 명령어가 안 되면 — VS Code에서 Cmd+Shift+P → "Install code command in PATH" 한 번 실행.

② Claude Code에 첫 프롬프트 던지기

Step 2에서 만든 4개 문서가 같은 폴더 안에 있는 상태예요. Claude Code를 열고 다음 한 줄을 던지면 됩니다.

※ Step 2에서 4개 문서를 잘 만들었다면, 정말 이 한 줄로 충분해요. Claude Code가 맥락을 다 파악하고 계획부터 세운 뒤 단계별로 작성합니다.

③ 중간 확인 포인트

Claude Code가 코드를 만드는 동안, 이 지점들에서 한 번씩 멈춰서 확인해요.

• 폴더 구조가 합리적인가 파일이 너무 많이 분산돼 있지 않은지 — 작은 프로젝트는 3~5개 파일이면 충분
• 환경변수 파일(.env)이 만들어졌는가 API 키, 비밀번호가 코드에 하드코딩되지 않았는지
• 각 함수가 한 가지 일만 하는가 RSS 가져오기 / AI 요약 / 메일 발송이 분리되어 있는지
• 에러 처리가 들어있는가 RSS 가져오기 실패, API 호출 실패 시 멈추지 않고 메시지 남기는지

로컬 테스트 — 내 컴퓨터에서 작동 확인

GitHub Actions로 자동화하기 전에, 내 컴퓨터에서 한 번 돌려서 메일이 실제로 오는지 확인해요. 여기서 작동 안 하면, GitHub Actions로 올려도 작동 안 합니다.

① .env 파일 만들기 — Claude Code가 만들어준 걸 활용

Claude Code에게 PRD대로 코드를 만들어달라고 했다면, 이미 .env.example 파일이 만들어져 있을 거예요. 그걸 복사해서 본인 키로 채우기만 하면 됩니다.

1. VS Code 파일 트리에서 .env.example 찾기
2. 복사해서 같은 위치에 .env로 새로 만들기 파일명 앞에 점(.) 빠뜨리지 않기
3. 각 항목에 본인의 실제 키와 비밀번호 채우기
4. 저장

또는 더 빠른 방법 — Claude Code에게 시키기:

② 의존성 설치 + 실행

설치는 한 번만, 실행은 매번 합니다.

※ 실제 실행 명령어는 Claude Code가 만든 package.json의 scripts에 따라 다를 수 있어요. 만든 직후 Claude Code에게 "어떻게 실행해?"라고 물어보면 알려줍니다.

③ 메일 수신 확인

• 터미널에 에러 메시지가 없는가 붉은 글씨가 보이면 에러 메시지를 그대로 Claude에 복붙해서 물어보기
• 내 Gmail 받은편지함에 뉴스레터가 도착했는가 스팸함도 한 번 확인 — 첫 발송은 가끔 스팸으로 분류됨
• 기사 내용이 키워드와 맞는가 엉뚱한 기사가 들어와 있으면 AI 필터링 프롬프트를 손봐야 할 수도 있음
• 요약 품질이 만족스러운가 짧으면 "3줄로 늘려줘", 평이하면 "강사 관점에서 어떻게 쓸지 한 줄 추가" 같은 보완 프롬프트로 조정

GitHub에 코드 올리기 + Actions 자동화

이미 Step 4에서 GitHub Desktop으로 레포를 만들고 GitHub에 연결해뒀어요. 이제 Claude Code가 만든 코드를 GitHub에 올리고, Actions로 자동 실행되게 만듭니다.

① 코드 GitHub에 올리기 (Commit + Push)

GitHub Desktop으로 한 번에 끝나요. 터미널 명령어 외울 필요 없어요.

1. GitHub Desktop 열기 → 좌측에서 본인 프로젝트 선택
2. 좌측 패널에 변경된 파일 목록이 보임 ⭐ .env 파일이 목록에 안 보이면 정상 — .gitignore가 잘 작동하는 거예요
3. 하단 Summary 입력란에 커밋 메시지 (예: first commit)
4. Commit to main 버튼 클릭
5. 상단 Push origin 버튼 클릭 → GitHub에 업로드 완료

② GitHub Actions Workflow 만들기 — 자동화의 심장

이 파일이 없으면 GitHub Actions는 아무것도 안 해요. .github/workflows/daily.yml이 "언제, 무엇을, 어떻게 실행할지"를 정의합니다.

※ Claude Code에게 PRD대로 만들어달라고 했다면 이 파일도 이미 만들어져 있을 거예요. 없으면 "GitHub Actions workflow 파일도 만들어줘 (매일 KST 오전 7시 실행)"라고 추가 요청.

핵심 한 줄 — 언제 실행할지

cron 표현 한 줄이 자동화의 스케줄을 결정해요. 강사들이 가장 자주 만지는 부분이기도 합니다.

③ Secrets 등록 — API 키와 비밀번호 안전하게 넣기

로컬의 .env에 있던 값들을 GitHub Secrets에 등록해서, Actions가 안전하게 사용하게 합니다.

클릭 경로

1. 내 GitHub 레포 → 상단 메뉴 Settings 탭 ⚠️ 프로필 Settings가 아니라 레포 페이지 안의 Settings
2. 좌측 사이드 메뉴 스크롤 → Security 섹션의 Secrets and variables → 드롭다운에서 Actions
3. 우측 상단 초록 New repository secret 버튼
4. Name에 변수명, Secret에 실제 값 입력 → Add secret
5. 아래 변수들을 하나씩 반복 등록 (한 번에 하나씩만 가능)

등록할 변수

• ANTHROPIC_API_KEY
• GMAIL_USER
• GMAIL_APP_PASSWORD (공백 제거)
• MAIL_TO
• KEYWORDS (쉼표 구분)
• INSTRUCTOR_PROFILE

④ 첫 실행 — 수동 테스트

매일 오전 7시까지 기다리지 말고, 지금 수동으로 한 번 돌려서 작동을 확인해요.

1. GitHub 레포 → 상단 메뉴 Actions
2. 좌측에서 만든 workflow 선택
3. 우측 Run workflow 버튼 → Run workflow
4. 실행 결과 — 초록 체크면 성공, 빨간 X면 실패 (클릭해서 로그 확인)
5. 실패 시 에러 메시지를 그대로 Claude에 복붙

완성 확인 + 막혔을 때

완성 확인 체크리스트

• 로컬에서 메일 수신 OK npm 실행 시 내 Gmail에 뉴스레터 도착
• GitHub에 코드 업로드 OK 레포 페이지에 파일들이 보이고, .env는 보이지 않아야 함
• GitHub Actions 수동 실행 OK Actions 탭에서 초록 체크 확인
• 다음 날 자동 실행 OK 설정한 시간에 자동으로 메일이 도착하는지 — 하루 기다려서 확인

막혔을 때

모든 단계에서 막혀도 괜찮아요. 가장 빠른 해결은 두 가지입니다.

1. 에러 메시지를 그대로 Claude에 복붙 — 메시지를 해석하려 하지 말고, 그대로 던지는 게 가장 빨라요.
2. 완성 레포에서 비교 — 아래 링크에서 작동하는 코드를 받아 내 것과 비교.

완성 코드 레포
📂 github.com/TeddyChoi-wow/Mynewsletter →