Claude Code로 하는 데이터 분석: 쿼리, CSV, 주간 다이제스트

데이터 분석에서 Claude Code가 하는 일

• 읽기 전용 역할이나 복제본에 SQL을 실행해 질문에 답하고, 답과 함께 쿼리를 보여 줍니다.
• CSV 내보내기 파일을 Python으로 정리하고 분석하며 차트를 그립니다.
• 주간 지표 다이제스트를 씁니다: 무엇이 얼마나 움직였는지, 그리고 추정되는 이유.
• 가입 감소나 오류 급증 같은 이상 징후를 누가 알아채기 전에 알립니다.

데이터 분석에 쓰는 Claude Code 기능

데이터 분석용 Claude Code 설정 방법

1. 도구 연결하기

   읽기 전용 데이터베이스 역할을 만들어 그 연결을 Claude Code에 주거나, 읽기 전용 사용자로 로그인한 웨어하우스 CLI를 주세요. 일회성 분석이라면 CSV 내보내기 파일을 작업 폴더에 넣으면 됩니다.

   -- Postgres: 에이전트용 읽기 전용 역할
   CREATE ROLE analyst LOGIN PASSWORD '<password>';
   GRANT pg_read_all_data TO analyst;

2. CLAUDE.md에 규칙 쓰기

   Claude Code는 claude -p 실행을 포함해 모든 세션을 시작할 때 CLAUDE.md를 읽습니다. 이 일의 규칙을 여기에 넣거나, 길다면 .claude/skills/ 아래 스킬로 만드세요. CLAUDE.md 가이드를 참고하세요.

   ## 데이터 규칙
   - 읽기 전용: 앱의 데이터베이스 사용자가 아니라 분석용 역할을
     쓰세요. INSERT, UPDATE, DELETE, 스키마 변경은 하지 마세요.
   - 모든 숫자에 그 뒤에 있는 쿼리나 스크립트를 보여 주세요.
   - 이전 기간과 비교하고, 변화가 평소 변동 범위 안이면
     그렇다고 말하세요.
   - 개인 데이터는 내보내지 마세요. 무엇이든 적기 전에
     집계하세요.
   - 주간 다이제스트: 중요한 숫자 다섯 개, 무엇이 움직였는지,
     다음 주에 던져 볼 만한 질문 하나.

3. 대화형 화면 없이 실행하기

   claude -p는 작업 하나를 실행하고 종료하므로 cron, CI, 다른 도구에서 시작할 수 있습니다. 묻지 않고 할 수 있는 일은 --allowedTools나 --permission-mode로 정하고, --output-format json을 쓰면 결과가 비용과 함께 반환됩니다.

   # 대시보드나 게시물에 쓸 지난주 수치를 JSON으로
   claude -p "지난주 가입, 활성화, 매출을 계산하고 그 전주와 비교해 줘" \
     --output-format json --json-schema "$(cat metrics.schema.json)"

4. 일정에 올리기

   /schedule로 클라우드 예약 작업을 만들거나(Pro, Max, Ultra, Team, Enterprise), 데스크톱 예약 작업을 쓰거나, 세션이 열려 있는 동안 /loop를 쓰세요. Claude Code를 능동적으로 만드는 방법을 참고하세요.

출처: Claude Code 문서

한계와 안전

• 읽기 전용 역할을 주세요. 데이터베이스에 쓰기 권한이 있는 에이전트는 데이터를 바꿀 수 있습니다.
• 열의 의미를 잘못 이해할 수 있습니다. 짧은 데이터 사전을 쓰고 처음 몇 개의 답을 확인하세요.
• 결과가 크면 컨텍스트와 사용량이 듭니다. 행을 읽기 전에 쿼리로 집계하세요.
• Claude Code v2.1.302부터 claude -p는 Manual 모드로 시작합니다. 승인이 필요한 작업은 규칙으로 허용하지 않는 한 거부됩니다. 이 일에 필요한 도구만 허용하세요.

데이터 분석에는 Claude Code와 Codex 중 무엇을 쓸까요?

규칙은 그대로 옮겨 쓸 수 있습니다. AGENTS.md에 한 번 쓰고 CLAUDE.md에 @AGENTS.md를 넣으면 두 에이전트가 같은 파일을 읽습니다.

다른 에이전트용 단계별 안내: Codex에서 하는 데이터 분석.

데이터 분석 담당자 두기

명령어는 누군가 기억해서 실행할 때만 돌아갑니다. Crewmark는 내 Claude Code 세션을 역할, 숫자로 된 목표, 근무 시간, 하트비트를 갖춘 AI 직원으로 바꿔, 일이 일정에 맞춰 진행되고 보드에 올라오게 합니다.

1. 역할에서 시작하기

   AI 직원 역할 중 하나의 브리프에 이 규칙을 넣으세요.

2. 일을 보드에 올리기

   이 일을 반복 이슈로 추가하세요. 직원이 하트비트에 깨어나 일을 하고 댓글로 보고합니다.

3. 관련 페이지

   일일 SEO 리포트는 반복되는 분석 업무의 실제 예시입니다.

자주 묻는 질문