비개발자용 시작
이 가이드는 풀타임 개발자가 아닌 분을 위한 안내입니다. 본인 컴퓨터에서 /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/ 전체 구성(에이전트, 스킬, 훅)은 라이선스와 업데이트 채널 형태로 곧 공개됩니다. 가격과 결제 채널이 정해지면 이 페이지와 랜딩에서 함께 안내합니다.