Claude Code - Tool-LOG

Claude Code 자동화의 핵심은 “한 번 만들어두면 다음부터는 알아서 돌아가는 구조”를 만드는 것입니다. 블로그 글 발행, 파일 일괄 처리, 보고서 생성 같은 반복 업무를 매번 처음부터 시키는 대신, 파이프라인으로 연결하면 한 마디로 끝나요.

결론부터 말하면, CLAUDE.md(규칙 파일) + hooks(자동 실행 트리거) + 스크립트(실행 도구)를 조합하면 비개발자도 자동화 파이프라인을 만들 수 있습니다.

자동화 파이프라인이 뭔가요

파이프라인이라는 말이 어렵게 들릴 수 있는데, 쉽게 말하면 “작업을 순서대로 연결해놓은 흐름”이에요. 수도관(pipe)을 연결하듯이, A 작업이 끝나면 B가 자동으로 시작되고, B가 끝나면 C가 이어지는 구조입니다.

예를 들어 블로그 글을 쓰고 발행하는 과정을 보면 이렇습니다.

수동 방식: 글 작성 → 파일 저장 → 워드프레스 접속 → 복사 붙여넣기 → 카테고리 설정 → SEO 설정 → 발행
파이프라인 방식: “이 주제로 글 써줘” → 나머지는 자동

이 차이가 하루에 한두 번이면 괜찮지만, 매일 반복되면 시간 차이가 쌓입니다.

Claude Code 자동화 파이프라인의 3가지 구성 요소

Claude Code에서 자동화 파이프라인을 만들려면 세 가지를 조합합니다. 각각 역할이 다르고, 함께 연결되면 강력해져요.

1. CLAUDE.md — 규칙을 기억하는 파일

CLAUDE.md는 프로젝트 폴더에 놓아두는 규칙 파일입니다. Claude Code가 대화를 시작할 때 자동으로 읽어요.

## 블로그 글 작성 규칙
- HTML 형식, <title>과 <meta description> 필수
- 톤: 합니다/해요 혼용
- 포커스 키워드를 제목, 첫 문단, H2에 포함
- 저장 위치: contents/ 폴더

이 파일이 있으면 “글 써줘”라고만 해도 형식, 톤, 저장 위치가 자동으로 맞춰집니다. 매번 같은 지시를 반복할 필요가 없어요.

2. Hooks — 특정 시점에 자동 실행되는 트리거

Hooks는 Claude Code의 특정 동작이 일어날 때 자동으로 스크립트를 실행하는 기능이에요. 예를 들어 “파일을 저장한 직후에 이 스크립트를 실행해라”라고 설정할 수 있습니다.

# 설정 예시 (settings.json)
# PostToolUse hook: 파일이 생성/수정되면 자동 업로드
"hooks": {
  "PostToolUse": [
    {
      "matcher": "Write|Edit",
      "command": "bash ftp_upload.sh $FILE_PATH"
    }
  ]
}

이렇게 설정하면 Claude Code가 HTML 파일을 만들 때마다 서버에 자동 업로드됩니다. 사용자가 별도로 “업로드해줘”라고 할 필요가 없어요.

3. 스크립트 — 실제로 일을 하는 도구

스크립트는 Python이나 Bash로 작성된 실행 파일입니다. 비개발자라고 겁먹을 필요 없어요. Claude Code에게 “이런 스크립트 만들어줘”라고 하면 알아서 만들어줍니다.

# 워드프레스 자동 발행 스크립트 사용 예시
python wp_publish.py "contents/글파일.html" --category "AI 도구" --status draft

이 스크립트는 HTML 파일을 읽어서 워드프레스에 자동으로 글을 올려줍니다. 제목, 본문, 카테고리, SEO 설정까지 한 번에 처리해요.

실전 예시 3가지

예시 1: 블로그 글 작성부터 발행까지

가장 대표적인 파이프라인이에요. 이 블로그에서 실제로 쓰고 있는 흐름입니다.

사용자: “Claude Code 자동화에 대해 블로그 글 써줘”
CLAUDE.md 참조: 톤, 형식, SEO 규칙 자동 적용
Claude Code: HTML 파일 생성 → contents/ 폴더에 저장
Hook 실행: 파일 저장 감지 → 서버 자동 업로드
발행 스크립트: 워드프레스에 초안(draft)으로 등록

사용자가 하는 건 첫 번째 단계뿐이에요. 나머지는 파이프라인이 처리합니다.

예시 2: 파일 일괄 처리

폴더에 CSV 파일이 20개 있고, 각각을 정리해서 요약 보고서를 만들어야 하는 상황입니다.

"data/ 폴더의 CSV 파일을 전부 읽어서,
각 파일의 월별 합계를 계산하고,
결과를 하나의 요약 HTML 보고서로 만들어줘."

CLAUDE.md에 보고서 형식 규칙이 적혀 있으면, 20개 파일을 읽고 → 계산하고 → 보고서를 만드는 과정이 한 번에 진행됩니다. 수작업으로 하면 반나절 걸릴 일이에요.

예시 3: 리서치 보고서 자동 생성

특정 주제에 대해 조사하고 보고서로 만드는 흐름입니다.

주제를 하위 항목으로 분해
한국어 + 영어로 웹 검색 수행
핵심 데이터를 추출하고 교차 검증
HTML 보고서 작성 (CLAUDE.md의 디자인 규칙 적용)
팩트체크 수행
최종본 저장 → Hook으로 서버 업로드

“이 주제 조사해줘”라는 한 마디로 6단계가 순차적으로 실행됩니다. CLAUDE.md에 조사 보고서 워크플로우를 정의해두면 가능한 구조예요.

파이프라인을 만들 때 주의할 점

처음부터 복잡하게 만들지 마세요. CLAUDE.md에 규칙 3~5줄 적는 것부터 시작하면 됩니다. Hook과 스크립트는 필요할 때 하나씩 추가하세요
스크립트는 Claude Code에게 만들어달라고 하세요. “워드프레스에 글 올리는 스크립트 만들어줘”라고 하면 됩니다. 직접 코딩할 필요 없어요
민감한 정보는 분리하세요. 비밀번호나 API 키는 별도 설정 파일에 두고, CLAUDE.md에는 “이 파일을 절대 출력하지 말 것”이라고 적어두세요
자동 실행 범위를 제한하세요. Hook이 모든 파일 저장에 반응하면 의도치 않은 동작이 생길 수 있어요. 특정 폴더나 파일 형식에만 반응하도록 조건을 걸어두는 게 좋습니다
결과물을 반드시 확인하세요. 자동화가 편하더라도, 최종 결과물은 사람이 한 번 검토해야 합니다. 특히 외부에 공개되는 콘텐츠는요

수동 vs 파이프라인, 뭐가 다른가요

항목	수동 작업	파이프라인
매번 지시	톤, 형식, 저장 위치 반복 설명	CLAUDE.md가 자동 적용
파일 저장 후	“이제 서버에 올려줘” 별도 지시	Hook이 자동 업로드
발행	워드프레스 접속 → 수동 입력	스크립트가 자동 등록
일관성	대화마다 품질이 다름	규칙에 따라 일정한 품질
확장성	작업이 늘면 시간도 비례 증가	파이프라인 하나로 반복 처리

정리하면

Claude Code 자동화 파이프라인은 CLAUDE.md + Hooks + 스크립트, 이 세 가지의 조합입니다. CLAUDE.md가 규칙을 기억하고, Hook이 시점을 감지하고, 스크립트가 실제 작업을 실행해요. 이 세 가지를 연결하면 “한 마디로 끝까지 처리되는” 구조가 만들어집니다.

처음에는 CLAUDE.md에 규칙 몇 줄 적는 것으로 충분합니다. 거기에 스크립트 하나, Hook 하나씩 추가하다 보면 자연스럽게 자동화 파이프라인이 완성돼요. 코딩을 몰라도 됩니다. 무엇을 자동화하고 싶은지만 알면, Claude Code가 나머지를 만들어줘요.

※ 이 글에서 소개한 자동화 구조는 Claude Code(CLI) 환경에서 사용할 수 있습니다. claude.ai 웹 인터페이스에서는 CLAUDE.md와 Hook 기능이 지원되지 않아요.

Claude Code 자동화 파이프라인 만들기, 반복 업무를 한 번에 처리하는 법