비개발자용 시작
이 가이드는 풀타임 개발자가 아닌 분을 위한 안내입니다. 본인 컴퓨터에서 /start로 환경을 잡고, 자연어로 첫 글을 쓰고, Blogger에 발행하는 자리까지 한 단계씩 따라가게 짜여 있습니다. 도중에 막히면 troubleshooting을 옆 탭에 켜두고 같은 증상을 찾아 보면 됩니다.
어떤 분을 염두에 두고 썼나
섹션 제목: “어떤 분을 염두에 두고 썼나”이 base를 집어 드는 분 중에는 풀타임 개발자가 아닌 경우가 적지 않습니다. 그래서 톤이 손을 잡듯 잡혀 있습니다. 다만 가정하는 학습 수준이 하나 있습니다.
터미널을 한 번이라도 열어 봤고, AI와 작업해 본 경험이 있다는 가정입니다. 명령을 한 줄씩 풀어 적기는 하지만, “터미널이 뭔지”, “git이 뭔지”, “Python이 왜 필요한지”를 처음부터 풀어 주지는 않습니다. 그 자리는 이 매뉴얼이 가르치는 자리가 아니라, 옆 탭에 무료 학습 자료(YouTube의 git/터미널 입문, MDN, Anthropic의 Claude Code 빠른 시작)를 두고 봐 주시면 됩니다.
다음 세 가지를 가정합니다.
- 터미널, git, Python의 이름과 대략의 쓰임은 알고 있습니다. 그 위에서 명령을 한 줄씩 풀어 적습니다.
- 첫 실행에는 Blogger 연결이 필요 없습니다.
/start가 환경을 검증하고 블로그 정체성을 잡는 자리까지가 첫 단계의 끝입니다. 실제 발행 연결은 publish 단계에서 시작합니다. - 글은 AI가 씁니다. 이 가이드에서는 Claude Code를 씁니다. 어떤 주제로 쓰고 싶은지만 알면 됩니다.
이미 익숙한 부분이 있다면 그 단계는 훑고 넘어가도 됩니다. 다만 한 번씩은 눈으로 지나가 두는 편이 좋습니다. 기대와 다르게 동작하는 자리를 만났을 때 어디로 돌아와야 하는지가 머릿속에 남기 때문입니다.
단계 안내
섹션 제목: “단계 안내”| 단계 | 무엇을 하나 | 대략 시간 |
|---|---|---|
| 1 prerequisites | Python, pip, git, Claude Code 설치, Google 계정과 Blogger, OAuth 자격증명 | 처음이면 40~60분 |
| 2 clone-and-install | base 받기와 발행 스크립트 의존성 설치 | 5~10분 |
| 3 first-run | /start로 환경 검증과 블로그 정체성 잡기 | 20~40분 |
| 4 write-first-post | 자연어로 첫 글 쓰기 (리서치와 집필) | 30분~1시간 |
| 5 bilingual | 한글본과 영문본 동시에 만들기 | 10~20분 |
| 6 publish | Blogger 연결과 첫 발행 (dry-run 먼저) | 30분~1시간 |
| 7 automated-safety-net | 발행 전 두 게이트와 훅이 챙겨주는 자리 이해 | 10분 |
| 8 when-ai-gets-stuck | AI 워크플로 자체가 막힌 자리 풀기 | 필요할 때만 |
| 9 troubleshooting | 자주 막히는 자리 모음 | 필요할 때만 |
| 10 promote (선택) | 발행 후 X, Reddit으로 퍼뜨리기 | 30분~ |
| 11 staying-up-to-date (선택) | base 업데이트를 내 블로그에 가져오기 | 한 사이클당 10~30분 |
이미 블로그 운영과 자동 발행이 익숙한 분이라면 전문가용 매뉴얼이 더 짧은 호흡으로 같은 base를 풉니다.
막혔을 때
섹션 제목: “막혔을 때”가장 먼저 볼 자리는 troubleshooting입니다. 첫 실행에서 흔히 부딪히는 자리는 거의 거기에 정리돼 있습니다.
거기에도 같은 증상이 없으면 에러 메시지를 그대로 복사해서 Claude Code에 붙여 넣고 “이거 어떻게 고쳐?”라고 물어 보세요. 다음에 시도할 만한 한 수가 보통 따라옵니다.
그래도 풀리지 않으면 GitHub 이슈를 열거나 팀 Slack에 글을 올립니다. 세 가지를 함께 적어 주세요.
- 어디서 막혔는지 (어느 단계, 어느 명령)
- 에러 메시지 전체
- 환경 정보 (운영체제, Python 버전)
처음 한 번이 가장 느립니다. 환경이 한 번 잡히고 나면 다음 글을 쓸 때는 1단계와 3단계를 통째로 건너뛰게 되고, “이 주제로 글 써줘” 한 줄에서 발행까지가 눈에 띄게 짧아집니다.
매뉴얼은 어디까지, base는 어디부터
섹션 제목: “매뉴얼은 어디까지, base는 어디부터”이 단계 표가 다루는 자리는 base가 자동으로 챙겨주는 자리, 즉 발행 전 AI-smell 게이트와 AdSense 게이트, 한영 동시 발행, AI-SEO, 컨텍스트 복구 같은 차별점입니다. 매뉴얼 본문은 무료로 풀려 있고, 옆 탭에 두고 따라가시면 됩니다.
실제 base 코드와 .claude/ 풀셋(에이전트, 스킬, 훅)은 라이선스 + 업데이트 채널 형태로 곧 풀립니다. 가격과 결제 채널이 정해지면 이 페이지와 랜딩에 같이 안내합니다.