Claude Code + Telegram 자동 알림 시스템 구축기 마지막(과연?)

[Claude Code]
     │
     │ 턴 종료
     ▼
[Stop Hook] ──── POST /send ────▶ [Bridge Daemon]
(Python)                           (Node.js)
                                       │
                                       │ Telegram Bot API
                                       ▼
                                 [Telegram Bot]
                                       │
                                       ▼
                                 [사용자 수신] 📱

[사용자 Reply] 📱
     │
     ▼
[Telegram Bot]
     │
     │ Long Polling
     ▼
[Bridge Daemon] ◀─── 메시지 감지 + 세션 매칭
     │
     │ 응답 저장
     ▼
[Stop Hook] ◀─────── GET /poll ─────────┘
(Python)              응답 수신
     │
     │ block 반환
     ▼
[Claude Code] ◀───── 다음 지시 전달

Claude 작업 완료
     ↓
Claude가 telegram_send 호출? ─── NO ──→ ❌ 알림 없음
     │
    YES
     ↓
MCP Server → Bridge → Telegram

Claude 작업 완료 (턴 종료)
     ↓
Stop Hook 자동 실행 (100%)
     ↓
Python urllib → Bridge HTTP API → Telegram ✅

#!/usr/bin/env python3
"""
Stop Hook: 턴 종료 시 telegram 자동 전송 + 응답 대기 (v3.9)

핵심: Claude가 뭘 하든 상관없이, 턴이 끝나면 무조건 실행됨
"""

def main():
    # 1. Telegram 모드 ON인지 확인
    if not is_telegram_mode_on(input_data):
        return 0

    # 2. Claude가 이미 telegram_send를 호출했는지 확인
    if has_telegram_send_in_turn(lines, last_user_idx):
        return 0  # Claude가 보냈으면 중복 방지

    # 3. Claude가 안 보냈으면 Hook이 대신 전송
    summary = extract_last_assistant_summary(lines, last_user_idx)
    send_telegram_auto(session_id, summary,
                       project_name=project_name,
                       session_name=session_name,
                       project_dir=project_dir)

    # 4. 응답 대기 (Telegram Reply)
    poll_response(session_id, question_id, timeout=300)

# Bridge 시작 (백그라운드 실행)
./scripts/telegram-bridge.sh start

# 상태 확인
./scripts/telegram-bridge.sh status
# 출력: ✅ Daemon 실행 중 (PID: 58952)

# 중지
./scripts/telegram-bridge.sh stop

{
  "hooks": {
    "Stop": [{
      "hooks": [{
        "type": "command",
        "command": "python3 ~/.claude/hooks/check-completion-notification.py"
      }]
    }]
  }
}

🤖 itdalife-new / feature-auth

📁 /Users/eyeson/workspaces/itdalife-new

✅ Hook v3.9 업데이트 완료
- 세션명/프로젝트명 표시 추가
- 작업 요약 최대 600자

━━━━━━━━━━━━━━━━━━━━━━━━━
💬 Reply로 다음 지시를 보내주세요
💤 done 입력 시 대기 종료

# 세션명 설정 (여러 세션 구분용)
/session feature-auth

# Telegram 모드 ON/OFF
/telegram on
/telegram off

~/.claude/
├── hooks/
│   └── check-completion-notification.py  # Stop Hook (v3.9)
├── commands/
│   └── session.md                        # /session 명령어
└── settings.json                         # Hook 설정

/project/
├── .telegram-mode                        # ON/OFF 플래그
├── .session-name                         # 세션명
├── mcp-servers/
│   └── telegram/
│       └── src/
│           ├── bridge/                   # HTTP 서버 + Telegram Polling
│           └── mcp/                      # (레거시) MCP 서버
└── scripts/
    └── telegram-bridge.sh                # Bridge 데몬 관리 스크립트