Claude Code 사용법 — 블로그 글 자동 발행 시스템 만들기
Claude Code로 블로그 자동 발행 스크립트를 만드는 방법이다. 마크다운 파일을 터미널에서 명령어 한 줄로 Blogspot에 발행한다. Google Cloud Console 설정 10분, Claude Code에 지시 20분, 테스트 5분이면 끝난다.
코드를 직접 쓰지 않고 Claude Code에게 지시만 해서 만들었다.
Claude Code가 뭔가
터미널에서 “블로그 발행 자동화해줘”라고 치면
스크립트를 만들어주는 AI 코딩 도구다.
Anthropic이 만들었다.
IDE 플러그인이 아니라 독립 CLI 도구다.
프로젝트 폴더 전체를 읽고,
파일을 직접 생성하고 수정하고 실행까지 한다.
블로그 글 1편 올리는 데 15분이 걸렸다
Blogspot에 글을 올리려면
마크다운 → HTML 변환 → Blogger 접속 → 제목 입력 → HTML 모드 전환 → 본문 붙여넣기 → 라벨 설정 → 검색 설명 → 미리보기 → 발행.
1편에 15분.
한 달에 30편이면 7시간 이상을 “올리는 작업”에만 쓰는 셈이다.
글 쓰는 시간보다
올리는 시간이 더 길었다.
이걸 Claude Code에게 맡겼다.
Claude Code에게 한 지시
터미널에서 Claude Code를 열고 이렇게 말했다:
“마크다운 파일을 Blogger API v3으로 자동 발행하는 Python 스크립트를 만들어줘.
frontmatter에서 제목, 라벨, 슬러그를 읽고,
마크다운을 HTML로 변환한 뒤,
OAuth 2.0으로 인증해서 Blogger에 POST해줘.
dry-run 옵션도 넣어줘.”
Claude Code가 만든 것:
publish.py메인 스크립트 (약 200줄)requirements.txt의존성 목록config.json설정 파일- OAuth(구글 로그인 인증) 흐름 (최초 1회 브라우저 인증 → 이후 자동)
- dry-run 모드 (발행 없이 HTML 미리보기)
코드를 직접 쓰지 않았다.
다만 요구사항을 구체적으로 지시하고,
결과를 확인하고,
안 되는 부분은 다시 지시해서 고쳤다.
“아무것도 안 해도 되는” 마법은 아니다.
완성된 시스템
입력: 마크다운 파일 1개
처리:
1. frontmatter(마크다운 파일 맨 위에 붙이는 메타 정보) 파싱 → 제목, 라벨, 슬러그 추출
2. 마크다운 → HTML 변환
3. Blogger API v3으로 POST 요청
출력: Blogspot에 글 발행 + 마크다운 파일에 발행 URL 자동 기록
사용법:
python publish.py --draft 내글.md
--draft를 붙이면 초안 저장,
빼면 즉시 발행.
Claude Code로 블로그 자동 발행 만드는 방법
필요한 것 3가지:
- Claude Code — claude.ai/code에서 설치
- Google Cloud Console 계정 — Blogger API 활성화용
- Blogspot 블로그 — 발행할 블로그 1개
이 과정은 터미널 기본 사용법(폴더 이동, 명령어 실행)을 알아야 한다.
완전 초보자에게는 허들이 있으니 솔직히 말해둔다.
1단계: Google Cloud Console 설정 (10분)
Claude Code에게 코드를 맡기기 전에
API 접근 권한을 먼저 만들어야 한다.
- Google Cloud Console 접속
- 새 프로젝트 생성 (또는 기존 프로젝트 선택)
- API 및 서비스 → 라이브러리 → “Blogger API v3” 검색 → 사용 클릭
- 사용자 인증 정보 → OAuth 클라이언트 ID 만들기 → 유형: 데스크톱 앱
- 생성된
credentials.json다운로드
이 파일이 Blogger API에 접근하는 열쇠다.
2단계: Claude Code에게 스크립트 요청 (20분)
Claude Code를 열고 위에 적은 지시를 그대로 붙여넣으면 된다.
본인 블로그 상황에 맞게 수정해도 된다.
Claude Code가 파일을 생성하면
의존성을 설치한다:
pip install -r requirements.txt
3단계: 테스트 (5분)
dry-run으로 HTML 변환 결과를 먼저 확인한다:
python publish.py --dry-run 내글.md
제목, 라벨, HTML 본문이 정상이면
초안으로 저장해본다:
python publish.py --draft 내글.md
브라우저가 열리면서 Google 계정 인증 화면이 나온다.
승인하면 끝이다.
이후에는 인증 없이 바로 실행된다.
이전 vs 이후
| 항목 | 이전 (수동) | 이후 (자동) |
|---|---|---|
| 발행 과정 | 8단계 복붙 | 명령어 1줄 |
| 소요 시간 | 15분/편 | 1분/편 |
| 월 30편 기준 | 7.5시간 | 30분 |
| 라벨/슬러그 | 매번 수동 입력 | frontmatter에서 자동 |
| 실수 가능성 | HTML 복붙 오류 | 없음 (dry-run 검증) |
다른 플랫폼에도 적용 가능하다
이 글은 Blogspot(Blogger API) 기준이지만
같은 방식을 다른 플랫폼에도 쓸 수 있다.
- WordPress — REST API 제공. 인증 방식만 다르고 구조는 같다.
- Tistory — Open API 제공. OAuth 인증 후 글 발행 가능.
- Ghost, Medium — 각각 API가 있다.
Claude Code에게 “WordPress REST API로 자동 발행하는 스크립트 만들어줘”라고 지시하면
Blogger 때와 같은 과정으로 만들 수 있다.
단, Blogger API와 달리 WordPress는 Application Password 인증을 쓰고,
Tistory는 토큰 만료 주기가 짧아서 갱신 로직이 추가로 필요하다.
플랫폼마다 약간의 차이는 있다.
자주 묻는 질문
Claude Code로 블로그 발행을 자동화하려면 뭐가 필요한가?
Google Cloud Console에서 Blogger API v3 활성화,
OAuth 클라이언트 ID 생성,
Claude Code 설치가 필요하다.
설정은 30분이면 끝난다.
Blogger 외에 다른 블로그 플랫폼도 자동화할 수 있나?
WordPress는 REST API,
Tistory는 Open API를 제공한다.
같은 방식으로 Claude Code에게
스크립트를 만들어달라고 하면 된다.
코딩을 몰라도 Claude Code를 쓸 수 있나?
한국어로 원하는 기능을 설명하면
Claude Code가 코드를 작성한다.
다만 터미널 기본 사용법
(폴더 이동, 명령어 실행)은 알아야 한다.
댓글
댓글 쓰기