클로드 코드 완전 자동화 #2 — cron으로 매시간 무인 실행하기

claude -p로 스크립트에서 헤드리스 실행하기

claude -p 기본 사용법
# 프롬프트를 직접 인라인으로 전달
claude -p "현재 디렉토리의 TypeScript 파일에서 any 타입 사용을 모두 찾아서 목록으로 출력해줘"

# stdin에서 프롬프트 파이핑
echo "package.json을 분석해서 보안 취약점이 있는 패키지를 찾아줘" | claude -p

# 파일 내용을 프롬프트와 함께 파이핑
cat error.log | claude -p "이 로그에서 critical 에러만 추출해서 요약해줘"

--allowedTools로 사용 범위 제한
# 파일 읽기·편집만 허용 (네트워크, 셸 명령어 차단)
claude -p "src/ 폴더의 console.log를 모두 제거해줘" --allowedTools Read,Edit

# 읽기·쓰기·Bash 허용 (가장 일반적인 자동화 조합)
claude -p "테스트 커버리지 리포트를 생성해줘" --allowedTools Read,Write,Bash

# 위험한 명령 차단하고 편집 권한만
claude -p "TODO 주석을 정리해줘" --allowedTools Read,Edit,Write

JSON 출력 및 파일 저장
# JSON 형식으로 출력
claude -p "코드 리뷰 결과를 JSON으로 정리해줘" --output-format json

# 결과를 파일로 저장
claude -p "의존성 분석" --output-format json > /tmp/analysis-$(date +%Y%m%d).json

# jq로 응답 텍스트만 추출
claude -p "버그 목록" --output-format json | jq -r '.result'

crontab으로 정기 실행 설정하기

crontab 편집 및 확인
# crontab 편집기 열기
crontab -e

# 등록된 작업 목록 확인
crontab -l

# 현재 사용자의 crontab 백업
crontab -l > ~/crontab-backup.txt

# crontab 문법: 분 시 일 월 요일 명령어
# 예: 매일 새벽 2시에 실행
0 2 * * * /path/to/script.sh

crontab에 Claude Code 스크립트 등록 (로그 포함)
# crontab -e 에서 아래 형식으로 등록

# 1. PATH를 crontab 상단에 명시
PATH=/usr/local/bin:/usr/bin:/bin:/Users/username/.npm-global/bin

# 2. 매시간 정각에 로그 분석 스크립트 실행
0 * * * * /Users/username/scripts/hourly-log-check.sh >> /var/log/claude-cron.log 2>&1

# 3. 매일 새벽 2시에 코드 품질 리포트 생성
0 2 * * * /Users/username/scripts/daily-code-report.sh >> /var/log/claude-daily.log 2>&1

# 4. 날짜별 로그 파일로 분리하려면
0 2 * * * /Users/username/scripts/daily-code-report.sh >> /var/log/claude-$(date +\%Y\%m\%d).log 2>&1

실전 자동화 스크립트 예시 3가지

daily-code-report.sh
#!/bin/bash
# 매일 새벽 2시 실행 — 코드 품질 리포트 생성
# crontab: 0 2 * * * /Users/username/scripts/daily-code-report.sh >> /var/log/claude-daily.log 2>&1

set -euo pipefail

CLAUDE_BIN="/Users/username/.npm-global/bin/claude"
PROJECT_DIR="/Users/username/projects/myapp"
REPORT_DIR="/Users/username/reports"
DATE=$(date +%Y%m%d)

mkdir -p "$REPORT_DIR"
cd "$PROJECT_DIR"

echo "[$(date)] 코드 품질 리포트 시작"

"$CLAUDE_BIN" -p "
src/ 디렉토리의 TypeScript 파일을 분석해서 다음 항목을 리포트해줘:
1. any 타입 사용 횟수와 파일 목록
2. TODO/FIXME 주석 목록
3. 함수 길이가 50줄 이상인 파일
4. 중복 코드 패턴
결과는 마크다운 형식으로 작성해줘.
" \
  --allowedTools Read,Bash \
  --output-format json | jq -r '.result' > "$REPORT_DIR/report-$DATE.md"

echo "[$(date)] 리포트 저장 완료: $REPORT_DIR/report-$DATE.md"

hourly-log-check.sh
#!/bin/bash
# 매시간 정각 실행 — 최근 1시간 로그에서 이상 감지
# crontab: 0 * * * * /Users/username/scripts/hourly-log-check.sh >> /var/log/claude-cron.log 2>&1

CLAUDE_BIN="/usr/local/bin/claude"
APP_LOG="/var/log/myapp/app.log"
ALERT_FILE="/tmp/claude-alert-$(date +%Y%m%d%H).txt"

# 최근 1시간치 로그를 임시 파일로 추출
LAST_HOUR_LOG=$(tail -n 1000 "$APP_LOG" | grep "$(date -v-1H '+%Y-%m-%dT%H')")

if [ -z "$LAST_HOUR_LOG" ]; then
  echo "[$(date)] 최근 1시간 로그 없음, 스킵"
  exit 0
fi

echo "$LAST_HOUR_LOG" | "$CLAUDE_BIN" -p "
다음은 지난 1시간의 애플리케이션 로그다.
다음 항목을 분석해서 이상 여부를 JSON으로 반환해줘:
- error_count: ERROR 레벨 로그 건수
- critical_errors: CRITICAL/FATAL 에러 목록 (최대 5개)
- anomaly_detected: 이상 패턴 감지 여부 (true/false)
- summary: 한 줄 요약
" \
  --output-format json | jq -r '.result' > "$ALERT_FILE"

# 이상 감지 시 슬랙 알림 (선택사항 — 웹훅 URL 설정 후 사용)
# ANOMALY=$(jq -r '.anomaly_detected' "$ALERT_FILE")
# if [ "$ANOMALY" = "true" ]; then
#   curl -s -X POST "$SLACK_WEBHOOK" -d "{\"text\": \"이상 감지: $(jq -r '.summary' $ALERT_FILE)\"}"
# fi

echo "[$(date)] 로그 분석 완료"

.github/workflows/claude-review.yml
name: Claude Code Review

on:
  pull_request:
    types: [opened, synchronize]

jobs:
  review:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      pull-requests: write

    steps:
      - name: Checkout
        uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - name: Claude Code Review
        uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          prompt: |
            이 PR의 변경사항을 코드 리뷰해줘.
            다음 기준으로 평가하고 GitHub PR 코멘트 형식으로 작성해줘:
            1. 버그 가능성 (심각도: HIGH / MEDIUM / LOW)
            2. 성능 문제
            3. 보안 취약점
            4. 코드 스타일 위반
            긍정적인 부분도 함께 언급해줘.
          allowed_tools: "Read,Bash"

launchd (macOS) / systemd timer (Linux) 대안

~/Library/LaunchAgents/com.myname.claude-daily.plist
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
  "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
  <key>Label</key>
  <string>com.myname.claude-daily</string>

  <key>ProgramArguments</key>
  <array>
    <string>/bin/bash</string>
    <string>/Users/username/scripts/daily-code-report.sh</string>
  </array>

  <!-- 매일 새벽 2시 실행 -->
  <key>StartCalendarInterval</key>
  <dict>
    <key>Hour</key>
    <integer>2</integer>
    <key>Minute</key>
    <integer>0</integer>
  </dict>

  <key>StandardOutPath</key>
  <string>/var/log/claude-launchd.log</string>
  <key>StandardErrorPath</key>
  <string>/var/log/claude-launchd-error.log</string>
</dict>
</plist>

launchd 등록 및 관리 명령어
# plist 등록 (로드)
launchctl load ~/Library/LaunchAgents/com.myname.claude-daily.plist

# 즉시 수동 실행 (테스트용)
launchctl start com.myname.claude-daily

# 등록 해제
launchctl unload ~/Library/LaunchAgents/com.myname.claude-daily.plist

# 등록된 작업 목록 확인
launchctl list | grep myname

~/.config/systemd/user/claude-daily.service + .timer
# --- claude-daily.service ---
[Unit]
Description=Claude Code 일일 코드 품질 리포트

[Service]
Type=oneshot
ExecStart=/bin/bash /home/username/scripts/daily-code-report.sh
StandardOutput=journal
StandardError=journal

---

# --- claude-daily.timer ---
[Unit]
Description=Claude Code 일일 실행 타이머

[Timer]
OnCalendar=*-*-* 02:00:00
Persistent=true

[Install]
WantedBy=timers.target

---

# 등록 및 활성화
systemctl --user daemon-reload
systemctl --user enable --now claude-daily.timer

# 상태 확인
systemctl --user status claude-daily.timer

# 로그 확인
journalctl --user -u claude-daily.service -f

/loop 명령어와 cron 자동화의 차이

--remote 플래그로 클라우드에서 실행하기

--remote 플래그 기본 사용
# 원격 환경에서 헤드리스 실행
claude --remote -p "리포지토리를 클론하고 테스트를 실행한 결과를 알려줘"

# 원격 실행 + 결과 저장
claude --remote -p "분석 작업" --output-format json > remote-result.json

# 원격 실행 시 GitHub 리포지토리 컨텍스트 설정
claude --remote -p "https://github.com/username/repo의 최신 커밋을 분석해줘"