Claude Code로 만드는 완전 자동화 상담 시스템

📞 전화상담 접수
    ↓
✍️ 상담 내용 수기 기록 (10분)
    ↓
📊 엑셀에 정리 (30분)
    ↓
🔍 학생 특성 분석 (20분)
    ↓
✉️ 맞춤 메시지 작성 (15분)
    ↓
📱 문자 발송 (5분)
━━━━━━━━━━━━━━━━━━━━
⏱️ 총 소요시간: 70분/건

┌─────────────────────────────────────────────────────┐
│                  📱 입력 소스                         │
├──────────────────────────┬──────────────────────────┤
│  전화상담 (VITO AI)       │  대면상담 (구글독스)       │
│  • 음성 → 텍스트 자동변환  │  • 음성입력 직접 저장      │
│  • 정확도 95%+            │  • 실시간 확인 가능        │
└──────────────────────────┴──────────────────────────┘
                        ↓
┌─────────────────────────────────────────────────────┐
│           📊 구글 시트 (데이터 허브)                  │
│  날짜 | 시간 | 전화번호 | 상담내용 | 분석결과 | DB_ID │
│  • Apps Script 10분마다 자동 수집                     │
│  • 중앙집중식 데이터 관리                             │
└─────────────────────────────────────────────────────┘
                        ↓
┌─────────────────────────────────────────────────────┐
│           🐍 Python 자동 감시 (10초 주기)            │
│  • 새 행 자동 감지                                   │
│  • 백그라운드 실행                                   │
└─────────────────────────────────────────────────────┘
                        ↓
┌─────────────────────────────────────────────────────┐
│           🤖 Claude AI 분석 엔진 (10초)              │
│  ✓ 위험도 평가 (1-10점)                             │
│  ✓ 주요 욕구 파악 (학업/경제/심리/건강/관계)          │
│  ✓ 종교 성향 감지 (확신도: 높음/중간/낮음)            │
│  ✓ 핵심 고민 추출 (3가지)                           │
└─────────────────────────────────────────────────────┘
                        ↓
┌─────────────────────────────────────────────────────┐
│           ✍️ 맞춤형 메시지 생성 (5초)                │
│  • 위험도별 톤 자동 조정                             │
│  • 개인화된 격려 메시지                              │
│  • 종교별 맞춤 문구 (확신도 높음만)                   │
│  • 500자 이내 최적화                                │
└─────────────────────────────────────────────────────┘
                        ↓
┌─────────────────────────────────────────────────────┐
│           📱 SMS 자동 발송 (알리고 API)              │
│  • 즉시 발송 (건당 15-20원)                         │
│  • 발송 로그 자동 기록                               │
└─────────────────────────────────────────────────────┘

# Claude Code 설치
npm install -g @anthropic-ai/claude-code

# 프로젝트 시작
claude

💬 "입학상담 자동화 시스템을 만들어줘. 

요구사항:
1. 구글시트에서 상담내용 자동 수집
2. Claude AI로 위험도/욕구/종교 성향 분석
3. 개인화된 메시지 자동 생성
4. SMS 자동 발송
5. 10초마다 자동 감시"

E:\자동화\admission_automation\
│
├── 📄 auto_sheets_collector.py    # 메인 자동화 프로그램
├── 📄 vito_integration.py         # VITO 연동 버전
├── 📄 start_auto_sms.bat          # 원클릭 시작
├── 📄 stop_auto_sms.bat           # 원클릭 종료
│
├── 🔐 .env                        # 환경변수 (API 키)
├── 🔑 google-credentials.json     # 구글 인증
│
├── 📂 src/
│   ├── 📂 ai/
│   │   ├── analyzer.py            # AI 상담 분석 엔진
│   │   └── content_generator.py   # 맞춤 메시지 생성기
│   │
│   ├── 📂 clova/
│   │   └── google_sheets_collector.py  # 구글시트 수집
│   │
│   ├── 📂 database/
│   │   ├── models.py              # DB 스키마
│   │   └── crud.py                # DB CRUD 연산
│   │
│   └── 📂 messaging/
│       └── sms_sender.py          # SMS 발송 (알리고)
│
└── 📂 data/
    └── counseling.db              # SQLite 상담 DB

class GoogleSheetsCollector:
    """구글 시트에서 새 상담 자동 수집"""
    
    def fetch_new_rows(self):
        """DB_ID가 비어있는 행만 수집"""
        all_rows = self.sheet.get_all_records()
        
        for idx, row in enumerate(all_rows, start=2):
            # DB_ID가 비어있으면 미처리
            if not row.get('DB_ID'):
                content = row.get('상담내용', '').strip()
                
                if content:
                    yield {
                        'row_number': idx,
                        'date': row['날짜'],
                        'time': row['시간'],
                        'phone_number': row['전화번호'],
                        'content': content
                    }
    
    def mark_as_processed(self, row_number, db_id):
        """처리 완료 표시 (H열에 DB_ID 기록)"""
        self.sheet.update_cell(row_number, 8, str(db_id))

ANALYSIS_PROMPT = """
당신은 대한간호학원의 입학상담 전문가입니다.
상담 내용을 분석하여 JSON 형식으로 응답하세요.

## 분석 항목

1. 위험도 (risk_score: 1-10)
   - 1-3점: 낮음 (안정적)
   - 4-6점: 중간 (주의 필요)
   - 7-10점: 높음 (즉시 개입 필요)
   
   평가 기준:
   • 경제적 어려움 (학비 부담, 생활비)
   • 학업 스트레스 (시험 걱정, 성적 불안)
   • 포기 의사 ("그만두고 싶다", "힘들다")
   • 가족/건강 문제

2. 주요 욕구 (needs)
   - 학업: 공부, 성적, 자격증
   - 경제: 학비, 생활비, 일자리
   - 심리: 스트레스, 불안, 우울
   - 건강: 질병, 피로
   - 관계: 가족, 친구

3. 주요 고민사항 (concerns)
   - 구체적인 고민 3가지 추출

4. 종교 성향 (religion)
   - type: 불교/기독교/천주교/무교/미확인
   - confidence: 높음/중간/낮음
   - keywords: 감지된 키워드
   
   예시:
   • "절에 가서 기도했어요" → 불교 (높음)
   • "교회 다녀요" → 기독교 (높음)

5. 분석 요약 (summary)
   - 2-3문장으로 핵심 요약

## 상담 내용
{content}

## 응답 형식 (JSON만)
{{"risk_score": 7, "risk_level": "높음", ...}}
"""

교수: 안녕하세요, 무엇을 도와드릴까요?
학생: 간호조무사 과정 문의합니다.
학생: 시험 준비가 너무 어렵고 스트레스 많이 받아요.
학생: 학비도 부담되고 절에 가서 기도도 했어요.
학생: 집안 형편 어렵고 포기하고 싶은 마음도 들어요.

{
  "risk_score": 8,
  "risk_level": "높음",
  "needs": ["학업", "경제", "심리"],
  "concerns": [
    "시험 준비 어려움",
    "학비 부담",
    "포기하고 싶은 마음"
  ],
  "religion": {
    "type": "불교",
    "confidence": "높음",
    "keywords": ["절", "기도"]
  },
  "summary": "경제적 어려움과 학업 스트레스로 중도탈락 위험이 높습니다. 즉각적인 상담과 지원이 필요합니다."
}

def get_tone(risk_score):
    """위험도에 따른 메시지 톤 결정"""
    
    if risk_score >= 7:
        return "따뜻하고 적극적인"
        # → 즉각 대응, 구체적 지원 방안 제시
        
    elif risk_score >= 4:
        return "공감하고 격려하는"
        # → 관심 표현, 언제든 상담 가능 안내
        
    else:
        return "밝고 희망적인"
        # → 일반 안내, 긍정적 피드백

MESSAGE_PROMPT = """
{student_name} 학생에게 보낼 격려 메시지를 작성하세요.

## 학생 분석 결과
- 위험도: {risk_score}/10 ({risk_level})
- 주요 욕구: {needs}
- 고민사항: {concerns}
- 종교: {religion_type} (확신도: {confidence})

## 메시지 작성 지침

1. 톤: {tone} 톤으로 작성
2. 구조:
   • 인사 및 공감 (1-2문장)
   • 구체적 고민에 대한 공감
   • 학원의 지원 방안 언급
   • 종교별 격려 문구 (확신도 "높음"일 때만)
   • 마무리 및 연락 안내
   
3. 제약:
   • 총 500자 이내
   • 이모지 사용 금지
   • 진정성 있는 표현

## 종교별 격려 문구 (확신도 "높음"만)
- 불교: "부처님의 자비로운 가르침처럼, 한 걸음씩 나아가시면 됩니다"
- 기독교: "주님께서 함께하시니 두려워하지 마세요"
- 천주교: "성모님의 사랑으로 힘을 얻으시길 기도합니다"

## 학원 정보
- 학원명: {academy_name}
- 연락처: {academy_phone}
"""

김철수 학생, 안녕하세요.
대한간호학원입니다.

시험 준비와 경제적 어려움으로 많이 힘드시죠?
학생의 고민을 진심으로 이해합니다.

지금 겪고 있는 어려움은 혼자만의 것이 아닙니다.
학비 문제는 장학금과 분할납부 방법이 있으니 함께 찾아보겠습니다.
학업도 천천히, 하나씩 해나가면 충분히 따라잡을 수 있습니다.

부처님의 자비로운 가르침처럼, 한 걸음씩 나아가시면 됩니다.

언제든 연락주세요. 함께 이겨내겠습니다!

📞 010-8805-0005
대한간호학원

이영희 학생, 안녕하세요.
대한간호학원입니다.

간호조무사 과정에 관심 가져주셔서 감사합니다.
시험 준비가 걱정되시는군요.

저희 학원에서는 개인별 맞춤 학습 지원을 제공하고 있습니다.
어려운 부분은 보충 수업으로 충분히 보완 가능하니 걱정 마세요.

궁금한 점이 있으시면 언제든 연락주세요!

📞 010-8805-0005
대한간호학원

# 알리고 SMS 설정
ALIGO_API_KEY=abcdef1234567890
ALIGO_USER_ID=myhospital
ALIGO_SENDER=01088050005

# 학원 정보
ACADEMY_NAME=대한간호학원
ACADEMY_PHONE=010-8805-0005

class SMSSender:
    """알리고 API를 사용한 SMS 발송"""
    
    def send_message(self, phone, name, message):
        """실제 SMS 발송"""
        
        # 메시지 타입 자동 결정
        msg_type = 'LMS' if len(message) > 90 else 'SMS'
        
        # API 요청 데이터
        data = {
            'key': self.api_key,
            'user_id': self.user_id,
            'sender': self.sender,          # 발신번호
            'receiver': phone,              # 수신번호
            'msg': message,                 # 메시지 내용
            'msg_type': msg_type,           # SMS/LMS
            'title': '대한간호학원' if msg_type == 'LMS' else ''
        }
        
        # API 호출
        response = requests.post(
            'https://apis.aligo.in/send/',
            data=data
        )
        
        result = response.json()
        
        # 결과 확인
        if result.get('result_code') == '1':
            print(f"✅ SMS 발송 성공! (ID: {result['msg_id']})")
            return {'success': True, 'msg_id': result['msg_id']}
        else:
            print(f"❌ SMS 발송 실패: {result.get('message')}")
            return {'success': False, 'error': result.get('message')}

======================================================================
발송 시각: 2026-02-01 17:08:35
수신자: 김철수 (010-1234-5678)
상태: success
메시지 ID: 1260222884
메시지 타입: LMS (423자)

메시지:
김철수 학생, 안녕하세요.
대한간호학원입니다.

시험 준비와 경제적 어려움으로 많이 힘드시죠?
학생의 고민을 진심으로 이해합니다.

지금 겪고 있는 어려움은 혼자만의 것이 아닙니다.
학비 문제는 장학금과 분할납부 방법이 있으니 함께 찾아보겠습니다.
...

📞 010-8805-0005
대한간호학원
======================================================================

def main():
    """입학상담 자동화 메인 루프"""
    
    print("="*70)
    print("📞 입학상담 자동화 시스템 시작")
    print("="*70)
    
    # 1. 초기화
    collector = GoogleSheetsCollector(sheet_id)
    db = DatabaseManager()
    analyzer = ConsultationAnalyzer()
    generator = MessageGenerator()
    sender = SMSSender()
    
    print("✅ 모든 모듈 초기화 완료")
    print("10초마다 새 상담을 확인합니다...\n")
    
    # 2. 무한 루프 (10초마다 감시)
    while True:
        try:
            # 2-1. 새 상담 수집
            consultations = collector.fetch_new_rows()
            
            if not consultations:
                print(f"[{time.strftime('%H:%M:%S')}] 대기 중... 💤", end='\r')
                time.sleep(10)
                continue
            
            print(f"\n📝 새 상담 {len(consultations)}건 발견!")
            
            # 2-2. 각 상담 처리
            for content, metadata in consultations:
                row_num = metadata['row_number']
                student_name = metadata.get('student_name', '학생')
                
                # ① AI 분석
                analysis = analyzer.analyze(content)
                print(f"  [{row_num}] 분석: {analysis['risk_score']}/10")
                
                # ② DB 저장
                db_id = db.save_consultation(content, analysis, metadata)
                
                # ③ 시트 업데이트
                collector.update_analysis_results(row_num, analysis)
                
                # ④ 메시지 생성
                message = generator.generate(student_name, analysis)
                
                # ⑤ SMS 발송
                phone = metadata.get('phone_number')
                if phone:
                    result = sender.send_message(phone, student_name, message)
                    
                    if result['success']:
                        print(f"  [{row_num}] ✅ SMS 발송 완료")
                    else:
                        print(f"  [{row_num}] ❌ SMS 실패")
                
                # ⑥ 완료 표시
                collector.mark_as_processed(row_num, db_id)
            
            time.sleep(10)
            
        except KeyboardInterrupt:
            print("\n\n⏹️ 프로그램 종료")
            break
        except Exception as e:
            print(f"\n❌ 오류: {e}")
            time.sleep(10)


if __name__ == "__main__":
    main()

@echo off
echo ======================================
echo   입학상담 자동화 시스템 시작
echo ======================================

cd /d "E:\자동화\admission_automation"
call venv\Scripts\activate.bat

echo.
echo 자동화 프로그램을 시작합니다...
echo 종료하려면 Ctrl+C를 누르세요.
echo.

pythonw auto_sheets_collector.py

pause

@echo off
echo 자동화 프로그램을 종료합니다...

taskkill /F /IM pythonw.exe /T

echo.
echo 프로그램이 종료되었습니다.
pause

"Claude Code는 단순한 코드 생성 도구가 아니라,
비개발자도 복잡한 자동화 시스템을 구축할 수 있게 해주는
AI 파트너입니다."

작은 성공 → 점진적 확장

완벽함보다 작동하는 시스템

# AI 및 데이터 처리
anthropic>=0.18.0
python-dotenv>=1.0.0

# 구글 시트 연동
gspread>=5.10.0
google-auth>=2.22.0
oauth2client>=4.1.3

# SMS 발송
requests>=2.31.0

# 데이터베이스
sqlalchemy>=2.0.0

# 유틸리티
python-dateutil>=2.8.2

# Claude AI
ANTHROPIC_API_KEY=sk-ant-api03-xxxxx...

# Google Sheets
GOOGLE_SHEET_ID=1GA41mkxvdBFvVai_2ba8FzSrz03Twj8a1ebv79b5mqk
GOOGLE_CREDENTIALS_FILE=google-credentials.json

# 알리고 SMS
ALIGO_API_KEY=abcdef1234567890
ALIGO_USER_ID=myhospital
ALIGO_SENDER=01088050005

# 학원 정보
ACADEMY_NAME=대한간호학원
ACADEMY_PHONE=010-8805-0005

# Python 3.11 다운로드
https://www.python.org/downloads/

# 설치 시 "Add to PATH" 체크!

# 프로젝트 폴더 생성
mkdir E:\자동화\admission_automation
cd E:\자동화\admission_automation

# 가상환경 생성
python -m venv venv

# 가상환경 활성화
.\venv\Scripts\Activate.ps1

# 패키지 설치
pip install -r requirements.txt

# 방법 1: 직접 실행
python auto_sheets_collector.py

# 방법 2: 배치 파일
start_auto_sms.bat

┌────────────────────────────────────────────────┐
│                                                │
│  "AI는 더 이상 개발자만의 도구가 아닙니다"     │
│                                                │
│   Claude Code와 함께라면                       │
│   누구나 자동화 전문가가 될 수 있습니다        │
│                                                │
└────────────────────────────────────────────────┘