CLAUDE.md · Agent · Skill로 AI 업무 자동화 환경 구축하기

AI 코딩 도구를 사용하다 보면 이런 상황이 반복된다.
 

• 프로젝트를 새로 열 때마다 같은 지시 입력
• SQL 분석 방식 다시 설명
• 보고서 스타일 다시 설명
• 코딩 규칙 매번 설정

 
즉, AI에게 매번 같은 설명을 반복하는 상황이 발생한다.
 
Claude Code를 제대로 설정하지 않으면
AI는 매번 “초기화된 상태”에서 시작하기 때문이다.
 
이 글에서는 Claude Code의 핵심 구조인
 

• CLAUDE.md
• Agent
• Skill

 
세 가지 개념을 활용해 AI 업무 자동화 환경을 만드는 방법을 정리한다.

---

🔎 Claude Code 사용 시 가장 먼저 겪는 문제

Claude Code를 처음 사용할 때 가장 많이 겪는 문제는 다음과 같다.

반복되는 설정

 
새 프로젝트마다 입력해야 하는 것

• 한국어로 답변해줘
• SQL 스타일은 이렇게 작성
• Python 코드 스타일
• 리포트 형식

 
이런 규칙을 매번 설명해야 한다.
 

---

실무 패턴 재설명

 
예를 들어:

• BigQuery 분석 방식
• SQL 최적화 기준
• 리포트 작성 방식

 
이런 업무 패턴도 매번 설명해야 한다.
 

---

결국 생기는 문제

 
AI를 사용하지만
 

업무 방식은 자동화되지 않는다.

 
이 문제를 해결하는 것이
Claude Code 설정 구조다.

---

⚙️ Claude Code의 핵심 구성

 
Claude Code는 3가지 구성 요소로 동작한다.

구성요소	역할
CLAUDE.md	항상 지켜야 할 규칙
Agent	특정 역할 전문가
Skill	반복 작업 워크플로우

 
이 구조를 이해하면
AI를 업무 자동화 도구로 활용할 수 있다.
 

---

1️⃣ CLAUDE.md — AI의 기본 규칙 설정

CLAUDE.md는

AI가 항상 따라야 하는 규칙

 
을 정의하는 파일이다.
 
예를 들어:

항상 한국어로 답변
코드 주석도 한국어
작업 전 구조 설명
SQL 키워드 대문자

 
이 규칙은 세션 시작 시 자동으로 로드된다.
 
즉,
 
AI에게 매번 설명할 필요가 없다.

---

2️⃣ Agent — 특정 역할 전문가

 
Agent는 특정 역할을 수행하는 AI 설정이다. 
 
예:
 

• SQL 전문가
• 리포트 작성 전문가
• 데이터 분석 전문가

 
예시:

name: sql-analyst
description: BigQuery SQL 작성 및 최적화
model: sonnet

 
Claude는 사용자의 질문을 분석하고
description을 기준으로 자동으로 Agent를 호출한다.

---

3️⃣ Skill — 반복 작업 자동화

 
Skill은 업무 절차를 정의한 워크플로우다. 
 
예:
 
BigQuery 분석 Skill

1. 테이블 스키마 확인
2. 샘플 데이터 조회
3. 쿼리 비용 추정
4. 최종 쿼리 작성

 
이 과정을 Skill로 정의하면
Claude가 자동으로 해당 절차를 실행한다.

---

📁 Claude Code 디렉토리 구조

 
Claude Code 설정은 다음 구조로 구성된다.

~/.claude/

├── CLAUDE.md
├── agents/
│   ├── sql-analyst.md
│   └── report-writer.md
└── skills/
    └── bigquery-analysis/
        └── SKILL.md

 
이 구조로 설정하면
 

모든 프로젝트에서 동일한 설정을 사용할 수 있다. 

---

📌 경로 표기 이해하기

 
Claude Code 문서를 보면
다음 경로가 자주 등장한다.

표기	의미
~/	사용자 홈 폴더
./	현재 프로젝트 폴더
/	시스템 루트

 
예:

~/.claude/

 
→ 모든 프로젝트 공통 설정

./CLAUDE.md

 
→ 해당 프로젝트 전용 설정

---

🔄 글로벌 vs 프로젝트 설정

 
Claude Code는

• 글로벌 설정
• 프로젝트 설정

두 가지 범위를 지원한다.
설정 범위위치

설정	범위위치
글로벌	~/.claude/
프로젝트	./

 
충돌이 발생하면

프로젝트 설정이 우선한다.

 

---

🚀 실제 작동 흐름

 
예를 들어 다음 요청을 입력했다고 가정해 보자.

1월 채용 데이터 BigQuery에서 뽑아줘

 
Claude는 다음 순서로 동작한다.
 

STEP 1

CLAUDE.md 규칙 로드
 

STEP 2

Agent 자동 선택
 

STEP 3

Skill 워크플로우 실행
 

STEP 4

리포트 생성
 
즉, AI가

업무 방식 자체를 자동화한다.

---

🎯 실무 활용 예시

 
Claude Code 자동화는 다음 업무에서 특히 유용하다.
 

데이터 분석

• BigQuery 분석
• SQL 최적화
• 비용 계산

---

보고서 자동화

• 주간 리포트
• 월간 분석 리포트
• KPI 요약

---

코드 작성

• Python 스크립트
• 데이터 처리 자동화
• ETL 작업

---

📌 핵심 정리

 
Claude Code 자동화 구조

구성요소	한 줄 설명
CLAUDE.md	항상 지켜야 하는 규칙
Agent	특정 역할 전문가
Skill	반복 작업 절차

 
경로의미

경로	의미
~/	글로벌 설정
./	프로젝트 설정

---

마무리

 
Claude Code를 제대로 설정하면
AI에게 매번 같은 설명을 반복할 필요가 없다.
 
즉,
 

AI가 내 업무 방식을 기억하고 자동으로 수행한다.

 
이 블로그에서는 앞으로도
 

• Claude Code
• AI 업무 자동화
• 데이터 분석 자동화

 
같은 실무 자동화 방법을 계속 정리할 예정이다.