【Claude Code 활용】Zenn 기사를 Claude Code로 작성하기

Claude Code로 기사를 작성한다는 발상

"코드를 구현한 Claude Code가 기사도 쓸 수 있지 않을까?"

이것이 Series A·B 총 16편의 기사를 Claude Code로 생성하기로 한 출발점입니다.

Claude Code는 구현된 코드를 직접 읽을 수 있기 때문에 코드 인용이 정확합니다. 또한 PROGRESS.md에 기록한 "어려웠던 점·깨달은 점"도 참조할 수 있어, 체험담으로서 구체성 있는 기사를 생성할 수 있습니다.

기사 생성 지시서 설계

Claude.ai(claude.ai)에서 기사 생성 지시서를 작성하고, 그것을 Claude Code에 전달하는 형식을 채택했습니다.

지시서에는 다음과 같은 요소를 명시하고 있습니다.

# Zenn 기사 생성 지시서: Series B 총 8편
## 공통 규칙
- 모든 기사 서두에 아래의 `:::message` 블록을 추가한다
...
```yaml
---
title: "【Claude Code 활용】 파일 읽기/쓰기 맡기기"
emoji: "📁"
...

구성

## Claude Code의 파일 조작 능력

• Read / Write / Edit의 3가지 기본 조작
  ...

"참조 파일·기사 구성·문체 규칙"을 명시함으로써, Claude Code가 기사의 아웃라인을 망설임 없이 구현할 수 있습니다.

## 실제 생성 플로우

Series B 총 8편의 생성 플로우는 다음과 같습니다.

Claude（claude.ai）
↓ 기사 생성 지시서 작성
↓ 참조해야 할 소스 코드와 PROGRESS.md 지정
...

Claude Code는 코드를 읽으면서 기사를 생성하기 때문에, 코드 블록의 내용과 본문의 설명이 일치합니다. 수기로 기사를 작성할 때 발생하기 쉬운 "코드를 붙여넣는 것을 잊음", "설명과 코드가 어긋남"과 같은 문제가 일어나기 어렵습니다.

## 품질 관리: 인간의 리뷰가 중요

생성된 기사에 대해 Claude.ai로 리뷰와 수정 지시를 수행했습니다.

확인 포인트는 다음과 같습니다.

-
**기술적 정확성**: 코드 인용이 올바른지, 실제 동작과 일치하는지 -
**가독성**: 기사의 흐름이 자연스러운지, 헤딩(Heading) 구성이 적절한지 -
**독창성**: "어려웠던 점·깨달은 점"이 체험담으로서 구체적인지 -
**포맷**: 프런트매터(Frontmatter)·시리즈 링크·`:::message` 블록이 갖춰져 있는지

`published: false`로 작성하여 리뷰·수정 후에 `published: true`로 변경함으로써, 미완성된 기사가 공개되는 사고를 방지하고 있습니다.

## 깨달은 점

**구현 코드를 직접 인용하기 때문에 기술적 정확성이 높다**: Claude Code는 agent01의 `src/tools/file_tools.py` 등을 실제로 읽은 후 기사를 생성합니다. "이 코드를 작성한 경험"을 가진 Claude Code가 기사를 쓰기 때문에 코드 설명의 정확성이 높아집니다.

**어려웠던 점의 기록(PROGRESS.md)이 기사의 차별화 포인트가 되었다**: "Windows의 cp932 인코딩 문제", "llama3.1:8b의 도구 호출(Tool Calling) 안정성과 일본어 품질 과제"와 같은 구체적인 체험담은 PROGRESS.md에 기록되어 있던 내용입니다. 이러한 1차 정보를 포함하는 기사는 범용적인 해설 기사와 차별화됩니다.

**Series A 총 8편도 이 플로우로 작성할 수 있었다**: AI 에이전트 구현 체험을 Series A(코드 해설)로, Claude Code 활용 방법을 Series B(도구 활용)로 하여 동일한 플로우로 16편의 기사를 생성했습니다. 개발과 문서 생성을 동시에 병행할 수 있다는 점이 최대의 장점입니다.

**기사 생성 지시서는 Claude.ai에서 설계한다**: 기사의 구성·문체·인용할 코드 부분을 지시서로 옮기는 작업은 Claude.ai가 담당합니다. Claude Code는 지시서를 충실히 실행하는 역할에 전념하게 함으로써 품질을 안정화했습니다.

## 요약

Claude Code를 사용한 Zenn 기사 생성 플로우는 "Claude.ai가 설계한 지시서를 Claude Code가 실행한다"라는 분업 체제로 이루어져 있습니다. 구현 코드를 직접 인용할 수 있다는 점, PROGRESS.md의 체험담을 소재로 사용할 수 있다는 점이 이 플로우의 강점입니다.

Series B는 이 기사로 완결됩니다. Series C에서는 SKILL.md나 CLAUDE.md를 사용한 AI 지시서 (AI Instruction) 설계·관리 기법을 소개할 예정입니다.

## 시리즈 링크 (Series B)

| 기사 | 제목 |
|---|---|
| B1 | Claude Code란 무엇인가 · 도입과 초기 설정 |
| ... | 
### Discussion

![](https://static.zenn.studio/images/drawing/discussion.png)