Claude Code Headless로 프로덕션 오류 자동 수정 시스템 구축

자동 수정 시스템 작동 방식

개발자가 Claude Code CLI의 헤드리스 모드를 사용하여 프로덕션 오류를 감지하고 수정하는 자동화 시스템을 구축했습니다. 이 시스템은 몇 주 동안 운영되었으며 무료 오픈 소스로 설명되며 Claude 구독만 필요합니다.

시스템 아키텍처

워크플로우는 다음과 같은 순서로 진행됩니다:

프로덕션 로그 모니터링
감시기가 오류를 식별하고 중복을 그룹화하며 심각도 분류
30초 정착 시간
중요/높은 심각도 오류 감지 시 시스템 작동
Git worktree 생성 (메인 브랜치와 완전히 격리된 분리된 브랜치)
Claude Code 헤드리스 모드 실행, 특정 오류에만 범위 제한
Telegram 알림: "새 오류 — 수정 승인하시겠습니까?" 승인/건너뛰기 옵션 포함
승인 시 자동으로 PR 생성

주요 구현 세부사항

개발자는 git worktree를 핵심 구성 요소로 식별했습니다 — 각 오류마다 저장소의 격리된 복사본을 가집니다. Claude는 이 격리된 환경 내에서 읽기, 편집, 테스트 실행 및 기타 작업을 수행할 수 있습니다. 수정이 만족스럽지 않으면 worktree를 삭제하여 메인 브랜치에 영향을 주지 않을 수 있습니다.

Claude 세션에는 다음과 같은 집중된 프롬프트가 제공됩니다:

오류 메시지
스택 트레이스
영향받은 경로
심각도 수준

헤드리스 세션은 범위가 제한된 도구로 실행됩니다: 읽기, 쓰기, 편집, Glob, Grep, Bash. 제공된 예시 프롬프트: "LevProductAdvisor 코드베이스에서 이 프로덕션 오류를 수정하세요. 오류: MongoServerError: connection pool closed. 스택: at MongoClient.connect (mongo-client.ts:88). 경로: POST /api/products/list. 심각도: CRITICAL."

결과 및 성능

개발자에 따르면:

중요 인프라 오류 (데이터베이스 연결, 인증): Claude가 70-80% 정확하게 수정
명확한 스택 트레이스가 있는 논리 버그: 견고한 성능
좋은 스택 트레이스가 없는 모호한 오류: 결과가 일정하지 않음, 일반적으로 건너뜀

시스템은 누락된 null 체크나 잘못된 쿼리 논리와 같은 직관적인 문제를 효과적으로 처리하며, 종종 첫 시도에서 해결합니다.

추가 기능

개발자는 모니터링을 위한 대화형 Telegram 대시보드를 구축했습니다:

대기열 상태
최근 오류
시스템 상태
새로고침 기능

/errors 뷰는 MongoDB에서 데이터를 가져와 "수정 중 • 5분 전," "감지됨 • 12분 전," 또는 "수정됨 • 2시간 전"과 같은 상태 정보를 표시합니다.

기술 스택

시스템은 TypeScript, Express, MongoDB, node-telegram-bot-api 및 Claude Code CLI를 사용합니다. 개발자는 헤드리스 CLI 사용으로 API 비용을 피할 수 있으며, 로컬에서 실행되는 Claude 구독만 필요하다고 언급합니다. 각 세션은 worktree 내에서 범위가 제한되고 격리되어 위험을 최소화합니다.

개발자는 GitHub에 저장소를 게시할 계획이며, 이를 일반적인 것으로 설명합니다 — 사용자는 감시기를 자신의 로그 파일에 연결하고 심각도 패턴을 구성하기만 하면 됩니다.

📖 전체 소스 읽기: r/ClaudeAI