Claude Code로 무한동력 블로그를 만들고 운영하는 전 과정 정리

개발자 아닌 사람이 블로그를 직접 만든다는 것

이 블로그(digitalmarketer.co.kr)는 디지털 마케터인 제가 Claude Code를 사용해 직접 만들었습니다. 프론트엔드, 백엔드, 데이터베이스, 배포까지 전부 Claude Code와의 대화로 구축했고, 지금도 같은 방식으로 운영하고 있습니다. 개발을 업으로 삼은 적은 없습니다.

"비개발자가 어떻게 Next.js 블로그를?"이라고 의아할 수 있습니다. 저도 처음에는 같은 생각이었습니다. 하지만 Claude Code는 코드를 대신 써주는 도구가 아니라, 프로젝트 전체를 이해하고 자율적으로 작업하는 AI 에이전트입니다. 제가 "어떤 블로그를 만들고 싶은지"를 설명하면, Claude Code가 기술적 구현을 담당합니다. 이 글에서는 그 전 과정을 처음부터 정리합니다.

2026년 2월 기준으로 Claude Code는 출시 6개월 만에 연간 환산 매출(ARR) 10억 달러를 돌파했고, GitHub Copilot과 Cursor를 제치고 가장 많이 사용되는 AI 코딩 에이전트가 되었습니다. Pragmatic Engineer의 2026년 2월 설문에서는 엔지니어링 팀의 73%가 AI 코딩 도구를 매일 사용한다고 답했습니다. 이 글이 그 흐름 속에서 "개발자가 아닌 사람은 어떻게 활용하는가"에 대한 하나의 실전 사례가 되었으면 합니다.

Claude Code를 선택한 이유

블로그를 만들겠다고 결심했을 때 선택지는 여러 개였습니다. 워드프레스, 티스토리 같은 기존 플랫폼도 있었고, Bolt나 Lovable 같은 바이브코딩 도구도 있었습니다. 그런데 제가 원한 것은 세 가지였습니다.

• 디자인과 기능을 완전히 제어할 수 있는 자체 블로그
• 콘텐츠 생성부터 배포까지 자동화할 수 있는 구조
• 프로젝트가 커져도 일관성을 유지할 수 있는 개발 환경

바이브코딩 도구는 첫 번째는 충족하지만 두 번째, 세 번째에서 한계가 있었습니다. 새 기능을 하나씩 추가할수록 기존 코드와 충돌하는 상황이 반복될 것이 예상되었습니다. Claude Code는 다릅니다. 프로젝트의 전체 코드베이스를 읽고, 기존 패턴을 파악한 상태에서 작업합니다. 파일이 100개가 넘어가도 "이 프로젝트에서는 이런 방식으로 코드를 작성하고 있으니, 새 기능도 같은 패턴으로 만들겠습니다"라고 판단합니다.

결정적인 차이는 맥락 이해였습니다. 다른 도구들은 매번 새로운 코드를 생성하지만, Claude Code는 기존 코드를 이해한 상태에서 수정합니다. 마치 프로젝트에 합류한 팀원이 기존 코드를 먼저 파악한 뒤 작업하는 것과 비슷합니다.

기술 스택: 왜 이 조합인가

블로그의 기술 스택은 다음과 같습니다.

이 조합을 제가 직접 기술적으로 선정한 것은 아닙니다. Claude Code에게 "한국어 블로그를 만들고 싶고, SEO가 중요하고, 무료 또는 저비용으로 운영하고 싶다"고 설명했더니 이 스택을 제안했습니다. 각 기술의 장단점을 설명해 주었고, 제가 이해한 뒤 승인하는 방식으로 결정했습니다.

Neo-Brutalism 디자인 시스템은 의도적인 선택이었습니다. 각진 모서리(border-radius 0), 두꺼운 검은 테두리, 하드 그림자, 빨간색(#FF0000) 포인트 컬러로 구성되어 다른 블로그와 시각적으로 확실히 구분됩니다. 마케터 관점에서 "한 번 보면 기억에 남는 디자인"이 필요했고, 이 스타일이 정확히 그 역할을 합니다.

구축 과정: 제로에서 배포까지

블로그를 처음부터 배포까지 만드는 과정은 크게 네 단계였습니다.

1단계: 프로젝트 초기화와 기본 구조

터미널에서 Claude Code를 실행하고 "Next.js 블로그 프로젝트를 새로 시작하자"고 대화를 시작했습니다. Claude Code가 프로젝트를 생성하고, 폴더 구조를 잡고, 필요한 패키지를 설치했습니다. 제가 한 것은 "카테고리는 마케팅, AI/기술, 데이터 세 개로 나누고 싶다", "콘텐츠 타입은 인사이트 글, FAQ, 용어사전, 일상 글 네 가지가 필요하다"처럼 요구사항을 설명하는 것이었습니다.

Claude Code는 이 요구사항을 바탕으로 데이터베이스 스키마를 설계하고, 각 콘텐츠 타입별 서비스 레이어를 만들고, API 라우트를 생성했습니다. 하루가 아니라 한 세션 안에서 기본 구조가 완성되었습니다.

2단계: 디자인 시스템 적용

Neo-Brutalism 디자인을 적용하는 단계입니다. "NeoCard라는 컴포넌트를 만들어 줘. 모바일에서는 배경 투명, 테두리 없음이고 데스크톱에서는 흰색 배경에 검은 테두리와 그림자"처럼 구체적으로 설명했습니다. 색상 체계, 타이포그래피, 반응형 규칙을 하나씩 정의해 나갔고, Claude Code가 이를 Tailwind CSS 클래스로 구현했습니다.

흥미로운 점은, 디자인 컴포넌트가 늘어날수록 Claude Code의 작업 품질이 높아졌다는 것입니다. 첫 번째 컴포넌트를 만들 때는 세세하게 설명해야 했지만, 다섯 번째쯤 되면 "기존 NeoCard 패턴과 동일하게"라는 한마디로 충분했습니다. 기존 코드에서 패턴을 학습한 것입니다.

3단계: 기능 구현

블로그에 필요한 기능을 하나씩 추가했습니다. 태그 시스템, 시리즈(연재물) 기능, SEO 메타 필드, 사이트맵, RSS 피드, 소셜 공유 미리보기(OG Image) 등입니다. 각 기능마다 "데이터베이스 스키마 변경 → ORM 마이그레이션 → 서비스 레이어 → API → 프론트엔드 UI"라는 일관된 절차를 Claude Code가 따랐습니다.

이 단계에서 Claude Code의 맥락 이해 능력이 가장 빛났습니다. 태그 시스템을 추가할 때, 기존의 posts 테이블 구조를 확인하고, 다대다(many-to-many) 관계를 위한 중간 테이블을 만들고, 기존 서비스 레이어의 패턴에 맞춰 태그 관련 함수를 추가했습니다. 제가 "다대다 관계"라는 용어를 쓴 것이 아닙니다. "하나의 글에 여러 태그를 붙일 수 있고, 하나의 태그로 여러 글을 묶을 수 있었으면 좋겠다"고 설명했을 뿐입니다.

4단계: 배포

Vercel에 연결하고 환경 변수를 설정한 뒤 배포했습니다. GitHub 저장소에 코드를 푸시하면 Vercel이 자동으로 빌드하고 배포하는 구조입니다. 도메인 연결, HTTPS 설정, 환경 변수 관리는 Vercel 대시보드에서 직접 처리했고, 나머지 기술적 설정은 Claude Code가 코드로 구현했습니다.

초기 구축에 걸린 기간은 약 2주였습니다. 물론 매일 풀타임으로 작업한 것은 아니고, 본업(마케팅) 틈틈이 진행한 결과입니다.

일상 운영: 콘텐츠 파이프라인

블로그를 만드는 것보다 운영하는 것이 더 큰 과제입니다. 매주 새 글을 쓰고, SEO를 최적화하고, 성과를 분석하는 반복 작업이 필요합니다. 이 부분을 자동화한 것이 Claude Code 활용의 핵심입니다.

콘텐츠 생성 워크플로우

글 하나가 만들어지는 과정은 다음과 같습니다.

1. 주제 선정: GA4 데이터를 분석하여 어떤 주제가 트래픽을 끌어오는지 확인합니다
2. 리서치: 웹 검색으로 최신 정보를 수집합니다
3. 초안 작성: 수집한 정보와 작성 스타일 가이드를 기반으로 글을 생성합니다
4. 검수: 맞춤법, 팩트 체크, 논리 흐름, 어투 일관성을 확인합니다
5. SEO 최적화: 메타 제목, 설명, 태그, 슬러그를 최적화합니다
6. 배포: JSON 파일로 저장한 뒤 스크립트로 데이터베이스에 삽입합니다

이 전체 과정을 Claude Code의 에이전트 시스템이 처리합니다. 제가 "이 주제로 글을 써줘"라고 지시하면, 리서치부터 배포까지 하나의 파이프라인으로 진행됩니다. 중간중간 체크포인트에서 제 승인을 받고 다음 단계로 넘어갑니다.

CLAUDE.md: 프로젝트의 규칙서

Claude Code에는 CLAUDE.md라는 파일이 있습니다. 프로젝트 루트에 두면 Claude Code가 매 세션마다 이 파일을 먼저 읽습니다. 일종의 프로젝트 매뉴얼입니다.

이 블로그의 CLAUDE.md에는 다음과 같은 내용이 담겨 있습니다.

• 프로젝트 아키텍처 설명 (폴더 구조, 핵심 파일 위치)
• 사용 가능한 명령어 (개발 서버, 빌드, 데이터베이스 관련)
• 코딩 컨벤션 (Neo-Brutalism 디자인 규칙, 컴포넌트 패턴)
• 콘텐츠 규칙 (한국어 맞춤법, 태그 체계, 작성 스타일)

Claude Code가 새 세션을 시작할 때마다 이 파일을 읽기 때문에, 매번 처음부터 설명하지 않아도 됩니다. "블로그에 새 기능 추가해 줘"라고만 말해도 기존 패턴을 알고 있는 상태에서 작업합니다.

에이전트 시스템: 자동화의 핵심

이 블로그의 운영을 실질적으로 자동화하는 것은 서브에이전트 시스템입니다. Claude Code는 하나의 에이전트가 모든 것을 처리하는 것이 아니라, 전문 역할별로 서브에이전트를 나눠서 작업할 수 있습니다.

현재 이 블로그에서 운영 중인 에이전트 구성은 다음과 같습니다.

이 에이전트들을 조율하는 것이 content-ops라는 스킬입니다. 스킬은 Claude Code에서 반복 워크플로우를 정의한 실행 템플릿입니다. /content-ops를 실행하면 토픽 제안 → 콘텐츠 생성 → 검수 → SEO 최적화 → 배포라는 전체 흐름이 순서대로 진행됩니다.

각 에이전트가 독립적으로 설계되어 있기 때문에, 필요한 단계만 골라서 실행할 수도 있습니다. "이 글 검수만 해줘"라고 하면 content-reviewer만 동작하고, "SEO 일괄 점검해 줘"라고 하면 seo-manager가 기존 글 전체를 훑습니다.

경량 작업(토픽 추천, SEO 분석)에는 Haiku 모델을, 깊은 분석이 필요한 작업(콘텐츠 생성, 검수)에는 Sonnet 모델을 배정했습니다. 이렇게 모델을 나누면 비용을 효율적으로 관리하면서도 품질을 유지할 수 있습니다.

GA4 데이터 기반 운영

블로그를 "감"이 아니라 "데이터"로 운영하기 위해 GA4(Google Analytics 4) 데이터를 적극 활용하고 있습니다. GA4 Data API를 통해 트래픽 데이터를 직접 조회하고, 이를 콘텐츠 전략에 반영합니다.

실제로 이 글의 주제도 GA4 데이터에서 나왔습니다. 최근 90일 기준 Claude 관련 콘텐츠가 블로그 상위 4개 포지션을 모두 차지하고 있었고, AI_TECH 카테고리의 글당 평균 세션이 MARKETING 카테고리의 약 4배였습니다. 이 데이터를 보고 "Claude Code 실전 활용기"가 빠져 있다는 콘텐츠 갭을 확인한 것입니다.

GA4 분석도 Claude Code의 스킬로 자동화되어 있습니다. /ga4-analysis를 실행하면 3개월/1개월/1주 단위로 트래픽을 분석하고, 고성과 콘텐츠와 저성과 콘텐츠를 분류하고, 다음에 쓸 주제를 데이터 기반으로 제안합니다.

솔직한 평가: 잘되는 것과 아쉬운 것

1년 가까이 Claude Code로 블로그를 운영하면서 느낀 점을 솔직하게 정리합니다.

잘되는 것

코드베이스 이해가 탁월합니다. 파일이 200개가 넘는 지금도 기존 패턴을 정확히 파악하고 일관성 있게 작업합니다. 새 기능을 추가할 때 "이 프로젝트에서는 이렇게 하고 있으니 같은 방식으로"라는 판단을 알아서 내립니다.

디버깅이 빠릅니다. 에러가 발생하면 관련 파일을 찾아 원인을 추적하고, 수정 방안을 제시합니다. 예전에는 에러 메시지를 검색 엔진에 붙여넣고 해결법을 찾아 헤맸는데, 지금은 Claude Code에게 에러 로그를 보여주면 몇 분 안에 해결됩니다.

반복 작업이 사라집니다. 스킬과 에이전트 시스템 덕분에, 글 하나를 기획부터 배포까지 30분 이내에 처리합니다. 수작업으로 하면 반나절은 걸릴 일입니다.

아쉬운 것

디자인 감각은 제한적입니다. "예쁘게 만들어 줘"라는 추상적 요청에는 평범한 결과가 나옵니다. 디자인은 제가 구체적으로 방향을 잡아주어야 합니다. "여백을 더 넓게", "이 색상 대신 저 색상으로"처럼 세세하게 지시할수록 결과가 좋아집니다.

비즈니스 맥락을 모릅니다. "마케터가 읽으면 유용한 글"이라는 판단은 제가 내려야 합니다. Claude Code는 기술적으로 완벽한 코드를 작성할 수 있지만, "이 기능이 사용자에게 정말 필요한가"라는 질문에는 답하지 못합니다.

긴 세션에서 맥락이 흐려집니다. 하나의 세션에서 너무 많은 작업을 요청하면 초반에 논의한 내용을 놓치는 경우가 있습니다. 작업을 적절히 나누고, 중간에 커밋하는 습관이 필요합니다. 다만 최근 업데이트로 100만 토큰 컨텍스트 윈도우가 지원되면서 이 문제는 많이 개선되었습니다.

비개발자를 위한 실전 팁

Claude Code로 프로젝트를 시작하려는 비개발자에게 드리는 팁입니다.

CLAUDE.md를 먼저 작성하세요

프로젝트를 시작하기 전에 CLAUDE.md 파일에 원하는 것을 정리해 두세요. 프로젝트의 목적, 사용할 기술, 지켜야 할 규칙을 적어두면 Claude Code가 매 세션마다 이를 참고합니다. 처음에는 간단하게 시작하고 점점 내용을 추가하면 됩니다.

작은 단위로 요청하세요

"블로그 전체를 만들어 줘"보다 "먼저 데이터베이스 스키마를 설계하자"가 훨씬 좋은 결과를 냅니다. 큰 작업을 3~5단계로 나누고, 각 단계의 결과를 확인한 뒤 다음으로 넘어가세요. 이 방식이 오히려 더 빠릅니다.

"왜"를 함께 설명하세요

"검색 기능 추가해 줘"보다 "사용자가 태그로 글을 필터링할 수 있으면 좋겠어. 현재 글이 50개가 넘어서 원하는 글을 찾기 어렵거든"이 더 좋은 결과를 만듭니다. 맥락을 알면 Claude Code가 더 적절한 기술적 판단을 내립니다.

빌드를 자주 돌리세요

코드를 수정한 뒤에는 npm run build로 빌드가 정상적으로 되는지 확인하세요. Claude Code에게 "빌드 돌려봐"라고 말하면 알아서 실행하고, 에러가 나면 바로 수정합니다. 작은 변경마다 확인하는 습관이 큰 문제를 예방합니다.

Git 커밋을 자주 하세요

작업이 잘 된 시점마다 커밋해 두세요. Claude Code가 실수로 코드를 망치더라도 이전 상태로 돌아갈 수 있습니다. Claude Code에게 "지금까지 변경사항 커밋해 줘"라고 말하면 적절한 커밋 메시지와 함께 저장합니다.

이 블로그의 현재 규모

참고용으로 현재 블로그의 규모를 정리합니다.

모든 것을 Claude Code 하나의 도구로 구축하고 운영하고 있습니다. 초기 구축보다 운영 자동화에 투자한 시간이 더 길고, 그만큼 일상 운영이 효율적입니다.

“

이 글의 쉬운 버전도 있습니다. 전문 용어가 부담스러우시다면 Claude Code로 블로그 만들기, 쉽게 풀어쓴 버전을 읽어보세요.

정리

핵심을 세 줄로 요약합니다.

• Claude Code는 코드 생성기가 아니라, 프로젝트를 이해하는 AI 팀원입니다. 기존 코드의 패턴을 파악하고 일관성 있게 작업하기 때문에, 프로젝트가 커질수록 진가를 발휘합니다.
• 비개발자도 '무엇을 만들고 싶은지'를 명확히 설명할 수 있다면 충분합니다. 기술적 구현은 Claude Code가 담당하고, 방향 설정과 품질 판단은 사용자가 담당합니다.
• 만드는 것보다 운영하는 것이 핵심입니다. 에이전트 시스템과 스킬로 반복 업무를 자동화하면, 블로그 운영에 드는 시간을 획기적으로 줄일 수 있습니다.