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가지 구성 요소로 동작한다.

 
이 구조를 이해하면
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는

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

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

 
충돌이 발생하면

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

🚀 실제 작동 흐름

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

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 Code를 제대로 설정하면
AI에게 매번 같은 설명을 반복할 필요가 없다.
 
즉,
 

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

 
이 블로그에서는 앞으로도
 

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

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

Claude Code 업무 자동화에 대해 실무에서 자주 겪는 문제와 해결 방법을 정리했습니다. AI를 업무에 활용하는 방법은 점점 다양해지고 있다.
 
하지만 많은 경우 AI는 다음 역할에 머무른다.
 

• 코드 생성
• 문서 작성
• SQL 작성

 
즉 업무를 도와주는 도구에 가깝다.
 
하지만 Claude Code를 활용하면
AI를 단순 도우미가 아니라 업무 자동화 시스템으로 사용할 수 있다.
 
이 글에서는 실제 업무에서 사용하는 자동화 흐름을 기준으로
Claude Code로 자동화 시스템을 구축하는 방법을 정리해본다.

자주 묻는 질문

AI 자동화의 핵심은 “작업 실행”이다

 
많은 사람들이 AI 자동화를 이야기할 때
다음과 같은 기능을 떠올린다.
 

• SQL 생성
• 코드 작성
• 보고서 작성

 
하지만 실제 업무 자동화의 핵심은 이것이다.
 

AI가 실제 작업을 대신 수행할 수 있는가

 
예를 들어 다음 작업이 있다고 가정해 보자.
 

• 데이터 조회
• 분석
• 보고서 작성
• 협업툴 공유

 
이 과정을 사람이 직접 해야 한다면
완전한 자동화라고 보기 어렵다.

기존 AI 자동화 방식의 한계

 
ChatGPT나 Gemini를 사용한 자동화는 보통 이런 흐름이 된다.

AI가 코드 생성
↓
사용자가 복사
↓
Script 실행
↓
결과 확인

 
이 방식은 자동화라기보다

AI가 작업 방법을 알려주는 구조

 
에 가깝다.
 
즉 여전히 사람이 개입해야 한다.

Claude Code 자동화 방식

 
Claude Code는 조금 다른 접근을 한다.
 
Claude Code는 로컬 환경에서
 

• 파일 생성
• 코드 수정
• 스크립트 실행
• 프로젝트 구조 변경

 
같은 작업을 직접 수행할 수 있다.
 
즉 AI가
 

실제 작업을 실행하는 자동화 환경

 
을 만들 수 있다.

실제 업무 자동화 예시

 
실제 업무에서 사용하는 자동화 흐름 예시를 보면 다음과 같다.

BigQuery 데이터 조회
↓
SQL 분석
↓
데이터 요약
↓
리포트 작성
↓
Confluence 문서 생성
↓
Slack 알림 전송

 
이 과정은 보통 사람이 직접 수행한다.
 
하지만 Claude Code를 사용하면
이 흐름을 하나의 자동화 프로세스로 만들 수 있다.

Claude Code 자동화 시스템 구조

 
Claude Code 자동화는 보통 다음 구조로 설계된다.

CLAUDE.md
↓
Agent
↓
Skill

 
각 구성 요소 역할은 다음과 같다.

 
이 구조를 잘 설정하면
Claude는 자동으로 적절한 작업 흐름을 선택한다.

실제 자동화 예시 (데이터 분석)

 
예를 들어 다음 요청을 한다.

1월 채용 데이터 분석해서 리포트 만들어줘

 
Claude Code는 다음 흐름으로 작업한다.
 

STEP 1

CLAUDE.md 규칙 로드

• 한국어 응답
• SQL 작성 방식

STEP 2

Agent 호출

• sql-analyst

STEP 3

Skill 실행

• 스키마 확인
• 샘플 조회
• 비용 계산
• SQL 작성

STEP 4

리포트 생성
 

협업 도구 자동화

 
업무 자동화에서 중요한 부분은
협업 도구 연결이다.
 
Claude Code 자동화 예시

데이터 분석
↓
리포트 생성
↓
Confluence 문서 작성
↓
Slack 알림 전송

 
이렇게 하면 데이터 분석부터 공유까지
하나의 자동화 흐름으로 연결된다.

비개발자가 자동화를 시작하는 방법

 
Claude Code 자동화를 처음 시작할 때는
복잡한 시스템을 만들 필요 없다.
 
다음 3가지부터 시작하는 것이 좋다.

기본 규칙 설정

CLAUDE.md
 
예

항상 한국어로 응답
SQL은 BigQuery 기준 작성
코드 주석 포함

Agent 만들기

예

• SQL 분석 Agent
• 보고서 작성 Agent

Skill 만들기

예

• BigQuery 분석
• 데이터 리포트 생성

Claude Code 자동화가 특히 좋은 업무

 
다음 업무에서 자동화 효과가 크다.

데이터 분석

• SQL 분석
• KPI 계산
• 데이터 요약

보고서 작성

• 주간 리포트
• 월간 리포트
• 분석 보고서

반복 업무

• 로그 분석
• 데이터 정리
• 문서 생성

핵심 정리

 
Claude Code 자동화의 핵심은 다음 세 가지다.

 
이 구조를 잘 설계하면
Claude Code는 단순 AI가 아니라

업무 자동화 시스템

 
으로 사용할 수 있다.

마무리

 
AI를 업무에 활용하는 방법은 많지만
Claude Code는 그중에서도
 
업무 자동화에 특화된 도구다.
 
특히 비개발자라도
 

• 반복 업무
• 데이터 분석
• 리포트 작성

 
같은 작업을 자동화할 수 있다는 점이 큰 장점이다.
 
앞으로 이 블로그에서는
 

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

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