Show GN: 조금씩 생기는 운영 CS 클로드로 자동화하기 완벽 가이드

Show GN: 조금씩 생기는 운영 CS 클로드로 자동화하기 완벽 가이드

여러 프로젝트를 병행하다 보면 운영 관련 고객 대응(CS)이 생각보다 큰 부담이 됩니다. "어제 주문 중 배송 안 된 건 몇 개인가요?" 같은 질문에 매번 DB를 직접 조회하거나, "이 기능이 어떻게 설정돼 있나요?" 같은 문의에 소스 코드를 뒤져야 하는 경우가 적지 않습니다.

dohyeon5626 개발자가 공개한 로컬 Claude CLI 기반 CS 자동화 도구가 바로 이 문제를 해결합니다. API 키 없이, 내 맥북에서만 동작하는 가볍고 실용적인 솔루션입니다.

도입: 왜 이런 도구가 필요한가

소규모 팀이나 개인 개발자일수록 운영/CS 업무가 부담됩니다. 매번 직접대응하기엔 시간이 아깝고,대형 CRM을 도입하기엔 과합니다. 하지만 작은 문의 하나하나에 개발자가입해야 한다면 그것도 만성적 피로로 이어집니다.

이 도구는 그 사이를칟합니다. 자연어 질문만투하면 Claude CLI가 레포 코드와 DB 스키마를 분석해서 직접 답변을 구성합니다. 개발자가 매번입할 필요 없습니다.

설치 및 설정

# 1. Claude CLI 설치 (이미 설치되어 있다면 생략)# https://docs.anthropic.com/claude-code# 2. 프로젝트 클론git clone https://github.com/dohyeon5626/auto-cs-claude.gitcd auto-cs-claude# 3. 의존성 설치pip install -r requirements.txt# 4. config.yml 설정

# config.yml 예시database:host: localhostport: 3306user: your_userpassword: your_passwordname: your_databasegithub:repo: owner/repo-nametoken: your_github_token  # 필요시app:host: 0.0.0.0port: 5000

# 5. 서버 실행python app.py

설정이 끝나면 브라우저에서 http://localhost:5000에 접속하면 됩니다. 별도 API 키 필요 없습니다. 내 로컬에 설치된 Claude CLI를 그대로 사용합니다.

핵심 기능

1. 자연어 → SQL 자동 생성

"어제 주문 중 배송 안 된 건 몇 개인가요?"→ Claude CLI가 SELECT 쿼리 작성→ 서버가 안전 검증 (SELECT 전용, LIMIT 1000, 30초 timeout)→ DB 실행 후 결과를 표로 정리

검증 단계가 중요한 포인트입니다. 무조건 쿼리를 실행하지 않고, SELECT 문인지 확인하고, 결과 수와 실행 시간을 제한합니다. 이로 인해 SQL 인젝션이나 비정상적 쿼리집행을 원천 차단합니다.

2. 레포 코드 탐색

"이 기능이 어떻게 설정돼 있지?"→ Claude CLI가 GitHub 레포 코드 분석 (매번 Pull)→ 설정 관련 코드 추출→ 자연어로 답변

GitHub 레포에서 최신 코드를상니-pull해서 분석하기 때문에, 코드가 변경돼도 즉시 반영됩니다.

3. 동작 플로우

전체 흐름은 다음과 같습니다:

[브라우저] → 자연어 질문↓[웹 서버] → Claude CLI에 질문 전달↓[Claude CLI] → GitHub 레포 Pull + DB 스키마 분석↓[서버] → SELECT 쿼리 작성 + 안전 검증↓[DB] → 쿼리 실행↓[서버] → Markdown으로 결과 정리↓[브라우저] → 답변 표시

모든 처리가내 서버 내부에서완결됩니다. 외부 API를 호출하지 않기 때문에 민감한 데이터가 외부로류출할 위험이 없습니다.

실전 활용 시나리오

이 도구가 실제로 효과적인장면을 살펴봅니다.

사내 CS 대응: 운영 담당자가 직접 DB를 뒤지지 않고 자연어로 문의하면 됩니다. "최근 3일간 신규 가입 유저 수 알려줘" 같은 질문에 즉시 답변합니다.

개발‑운영 협업: 운영에서 오는 기술 설정 질문("이 이메일 발송 정책이 어떻게 돼 있어?")을 코드 레벨로 즉시합니다.

개인 프로젝트 관리: 여러 사이드 프로젝트를 굴리는 개발자가 한 곳에서 중앙 집중식으로 문의 대응합니다.

대안과의 비교

방식	장점	단점
이 도구	별도 API 키 불필요, 로컬 실행, 즉시 사용 가능	현재는 레포지토리 하나 + MySQL만 지원
Commercial CRM + AI	다양한 연동, 관리 기능완	비용 발생, 설정 복잡, 외부 의존
수동 대응	정확한 답변	시간 소모, 개발자 부담

이 도구의핵심 차별점은 다음과 같습니다:

• API 키 불필요: Claude CLI만 설치되어 있으면 바로 동작

• 로컬 실행: 데이터가 외부로류출하지 않음

• 즉시가용: 설정 파일 작성만으로 시작 가능

• SELECT 안전장치: 30초 timeout + LIMIT 1000 + SELECT 전용 검증

설치 후 활용 팁

이 도구를 자신의 환경에 맞게활용하는 팁을 공유합니다.

# MySQL 외 다른 DB를 사용하고 싶다면# app.py의 DB 모듈을 교체하면 됩니다# 예: PostgreSQL → psycopg2 사용 후，동양적 구조로 연결# GitHub 레포를 여러 개 관리하고 싶다면# config.yml에 repos 리스트를쫓아가하고# app.py의 라우팅 로직을 확장하면 됩니다

현재는 레포지토리 하나와 MySQL만 지원하지만, 코드가간결하게 작성되어 있어عديل이 가능합니다. 필요한 만큼 확장해보세요.

결론: 소규모 팀에 최적화된 실용적 도구

이 도구는 큰 기획이나 복잡한가구가 아닌, 문제를 실제로 겪은 개발자가 자신의 필요에 맞춰 만든 솔직한 솔루션입니다._api_key_없이_로컬에서_동작하고,_설정 문건 하나면_즉시_사용할_수_있습니다.

여러 프로젝트를 병행하는 개발자이거나, 소규모 팀에서 운영/CS 부담을 줄이고 싶다면일할 가치가 있습니다. 코드가 공개되어 있어 내 프로젝트에 맞게개조하는 것도 어렵지 않습니다.

GitHub: https://github.com/dohyeon5626/auto-cs-claude

---

📚 출처

• https://news.hada.io/topic?id=29794