<div id="readability-page-1" class="page"><div itemprop="articleBody"><p>Claude Code가 작업할 때마다 실시간으로 텔레그램 알림을 받는 방법.</p>



<h2 id="배경">배경</h2>

<p>Claude Code는 강력하지만 장시간 작업 시 진행 상황을 파악하기 어려운 경우가 있습니다. 특히 대규모 리팩토링이나 복잡한 디버깅 작업 중에는 “지금 뭐하고 있는지”, “멈춘 건 아닌지” 궁금할 때가 많습니다.</p>

<p>Claude Code Telegram Notification Hook은 이런 상황을 위한 간단한 솔루션입니다. Claude Code의 모든 작업을 텔레그램으로 실시간 알림받을 수 있습니다.</p>

<h2 id="설치">설치</h2>

<h3 id="준비물">준비물</h3>

<table>
  <thead>
    <tr>
      <th>도구</th>
      <th>용도</th>
      <th>비용</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><strong>텔레그램</strong></td>
      <td>알림 수신</td>
      <td>무료</td>
    </tr>
    <tr>
      <td><strong>Python 3</strong></td>
      <td>Hook 스크립트 실행</td>
      <td>무료</td>
    </tr>
    <tr>
      <td><strong>Claude Code</strong></td>
      <td>AI 코딩 도구</td>
      <td>구독 필요</td>
    </tr>
  </tbody>
</table>

<h3 id="1단계-텔레그램-봇-생성">1단계: 텔레그램 봇 생성</h3>

<ol>
  <li>텔레그램에서 <a href="https://t.me/botfather">@BotFather</a> 검색</li>
  <li><code>/newbot</code> 명령어 입력</li>
  <li>봇 이름과 username 설정</li>
  <li>생성된 봇 토큰 저장 (형식: <code>1234567890:ABCdefGHI...</code>)</li>
</ol>

<h3 id="2단계-chat-id-확인">2단계: Chat ID 확인</h3>

<h4 id="방법-1-userinfobot-사용">방법 1: UserInfoBot 사용</h4>
<p><a href="https://t.me/userinfobot">@userinfobot</a>에게 메시지 전송 → ID 확인</p>

<h4 id="방법-2-api-직접-호출">방법 2: API 직접 호출</h4>
<ol>
  <li>생성한 봇에게 아무 메시지 전송</li>
  <li>브라우저에서 접속:
    <div><pre><code>https://api.telegram.org/botYOUR_TOKEN/getUpdates
</code></pre></div>
  </li>
  <li>JSON 응답에서 <code>"chat":{"id":YOUR_ID}</code> 확인</li>
</ol>

<h3 id="3단계-hook-설치">3단계: Hook 설치</h3>

<div><pre><code><span># 저장소 클론</span>
git clone https://github.com/rokrokss/claude-code-telegram-notify-hook.git
<span>cd </span>claude-code-telegram-notify-hook

<span># 환경변수 설정</span>
<span>export </span><span>CC_HOOK_TELEGRAM_BOT_TOKEN</span><span>=</span><span>"your_bot_token"</span>
<span>export </span><span>CC_HOOK_TELEGRAM_CHAT_ID</span><span>=</span><span>"your_chat_id"</span>

<span># Hook 파일 복사</span>
<span>cp</span> <span>-r</span> .claude ~/.claude

<span># 실행 권한 부여</span>
<span>chmod</span> +x ~/.claude/hooks/notification.py
</code></pre></div>

<h3 id="4단계-작동-확인">4단계: 작동 확인</h3>

<div><pre><code><span># 테스트 메시지 전송</span>
curl <span>-X</span> POST <span>"https://api.telegram.org/botYOUR_TOKEN/sendMessage"</span> <span>\</span>
     <span>-d</span> <span>"chat_id=YOUR_CHAT_ID"</span> <span>\</span>
     <span>-d</span> <span>"text=Hook 설치 완료!"</span>
</code></pre></div>

<p>메시지가 도착하면 설정 완료입니다.</p>

<h2 id="알림-형식">알림 형식</h2>

<p>Claude Code가 작업할 때마다 다음과 같은 형식의 알림을 받습니다:</p>

<div><pre><code>🤖 Project: my-awesome-project
⏰ 2025-01-08 15:30:45
✅ Event: File Edit
📁 Path: src/components/Header.tsx
📌 Stop Hook Active: false
</code></pre></div>

<h2 id="주요-기능">주요 기능</h2>

<h3 id="지원-이벤트">지원 이벤트</h3>

<table>
  <thead>
    <tr>
      <th>이벤트</th>
      <th>설명</th>
      <th>활용</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><strong>Notification</strong></td>
      <td>일반 작업 알림</td>
      <td>전체 작업 흐름 파악</td>
    </tr>
    <tr>
      <td><strong>Stop</strong></td>
      <td>작업 완료</td>
      <td>작업 종료 시점 확인</td>
    </tr>
    <tr>
      <td><strong>SubagentStop</strong></td>
      <td>서브 에이전트 완료</td>
      <td>병렬 작업 추적</td>
    </tr>
    <tr>
      <td><strong>File Operations</strong></td>
      <td>파일 편집/생성/삭제</td>
      <td>코드 변경사항 추적</td>
    </tr>
    <tr>
      <td><strong>Terminal Commands</strong></td>
      <td>명령어 실행</td>
      <td>빌드/테스트 상태 확인</td>
    </tr>
  </tbody>
</table>

<h3 id="활용-예시">활용 예시</h3>

<h4 id="1-장시간-리팩토링">1. 장시간 리팩토링</h4>
<p>대규모 코드베이스 리팩토링 시 진행 상황을 실시간으로 확인할 수 있습니다. 다른 작업을 하면서도 모바일로 진행도를 체크할 수 있어 효율적입니다.</p>

<h4 id="2-디버깅-과정-추적">2. 디버깅 과정 추적</h4>
<p>Claude Code가 어떤 파일을 분석하고 수정하는지 추적하여 디버깅 과정을 이해하고 학습할 수 있습니다.</p>

<h4 id="3-팀-협업">3. 팀 협업</h4>
<p>팀 텔레그램 채널에 봇을 추가하면 Claude Code의 작업을 팀원들과 실시간으로 공유할 수 있습니다.</p>

<h2 id="고급-설정">고급 설정</h2>

<h3 id="환경변수-영구-설정">환경변수 영구 설정</h3>

<p><code>.bashrc</code> 또는 <code>.zshrc</code>에 추가:</p>

<div><pre><code><span>export </span><span>CC_HOOK_TELEGRAM_BOT_TOKEN</span><span>=</span><span>"your_bot_token"</span>
<span>export </span><span>CC_HOOK_TELEGRAM_CHAT_ID</span><span>=</span><span>"your_chat_id"</span>
</code></pre></div>

<h3 id="그룹-채팅-연동">그룹 채팅 연동</h3>

<ol>
  <li>봇을 그룹에 초대</li>
  <li>그룹 Chat ID 확인 (음수로 시작: <code>-1001234567890</code>)</li>
  <li>해당 ID로 환경변수 설정</li>
</ol>

<h3 id="필터링-커스터마이징">필터링 커스터마이징</h3>

<p>특정 이벤트만 알림받으려면 <code>notification.py</code> 수정:</p>

<div><pre><code><span># 예: 파일 작업만 알림
</span><span>if</span> <span>event_type</span> <span>in</span> <span>[</span><span>'FileEdit'</span><span>,</span> <span>'FileCreate'</span><span>,</span> <span>'FileDelete'</span><span>]:</span>
    <span>send_telegram_message</span><span>(</span><span>message</span><span>)</span>
</code></pre></div>

<h2 id="문제-해결">문제 해결</h2>

<table>
  <thead>
    <tr>
      <th>문제</th>
      <th>해결 방법</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><strong>알림이 오지 않음</strong></td>
      <td>토큰/ID 확인, 봇과 대화 시작 여부 확인</td>
    </tr>
    <tr>
      <td><strong>권한 오류</strong></td>
      <td><code>chmod +x ~/.claude/hooks/notification.py</code> 실행</td>
    </tr>
    <tr>
      <td><strong>토큰 오류</strong></td>
      <td>토큰을 정확히 복사했는지 확인 (대소문자 구분)</td>
    </tr>
    <tr>
      <td><strong>그룹 채팅 실패</strong></td>
      <td>음수 Chat ID 사용, 봇 관리자 권한 확인</td>
    </tr>
  </tbody>
</table>

<h2 id="보안-주의사항">보안 주의사항</h2>

<ul>
  <li>토큰을 절대 공개 저장소에 커밋하지 마세요</li>
  <li><code>.env</code> 파일을 <code>.gitignore</code>에 추가하세요</li>
  <li>토큰이 노출되면 BotFather의 <code>/revoke</code> 명령으로 즉시 재발급하세요</li>
</ul>

<h2 id="마무리">마무리</h2>

<p>간단한 Hook 설정으로 Claude Code의 작업을 실시간으로 모니터링할 수 있습니다. 특히 모바일 환경에서 작업 진행 상황을 확인하고 싶을 때 유용한 도구입니다.</p>

<p>전체 소스 코드: <a href="https://github.com/rokrokss/claude-code-telegram-notify-hook">GitHub 저장소</a></p>
</div></div>

ROKROKSS

Claude Code가 작업할 때마다 실시간으로 텔레그램 알림을 받는 방법.
배경
Claude Code는 강력하지만 장시간 작업 시 진행 상황을 파악하기 어려운 경우가 있습니다. 특히 대규모 리팩토링이나 복잡한 디버깅 작업 중에는 “지금 뭐하고 있는지”, “멈춘 건 아닌지” 궁금할 때가 많습니다.
Claude Code Telegram Notification Hook은 이런 상황을 위한 간단한 솔루션입니다. Claude Code의 모든 작업을 텔레그램으로 실시간 알림받을 수 있습니다.
설치
준비물
도구
      용도
      비용
    
텔레그램
      알림 수신
      무료
    
Python 3
      Hook 스크립트 실행
      무료
    
Claude Code
      AI 코딩 도구
      구독 필요
    
1단계: 텔레그램 봇 생성
텔레그램에서 @BotFather 검색
/newbot 명령어 입력
봇 이름과 username 설정
생성된 봇 토큰 저장 (형식: 1234567890:ABCdefGHI...)
2단계: Chat ID 확인
방법 1: UserInfoBot 사용
@userinfobot에게 메시지 전송 → ID 확인
방법 2: API 직접 호출
생성한 봇에게 아무 메시지 전송
브라우저에서 접속:
    
https://api.telegram.org/botYOUR_TOKEN/getUpdates
    
JSON 응답에서 "chat":{"id":YOUR_ID} 확인
3단계: Hook 설치
# 저장소 클론
git clone https://github.com/rokrokss/claude-code-telegram-notify-hook.git
cd claude-code-telegram-notify-hook
# 환경변수 설정
export CC_HOOK_TELEGRAM_BOT_TOKEN="your_bot_token"
export CC_HOOK_TELEGRAM_CHAT_ID="your_chat_id"
# Hook 파일 복사
cp -r .claude ~/.claude
# 실행 권한 부여
chmod +x ~/.claude/hooks/notification.py
4단계: 작동 확인
# 테스트 메시지 전송
curl -X POST "https://api.telegram.org/botYOUR_TOKEN/sendMessage" \
     -d "chat_id=YOUR_CHAT_ID" \
     -d "text=Hook 설치 완료!"
메시지가 도착하면 설정 완료입니다.
알림 형식
Claude Code가 작업할 때마다 다음과 같은 형식의 알림을 받습니다:
🤖 Project: my-awesome-project
⏰ 2025-01-08 15:30:45
✅ Event: File Edit
📁 Path: src/components/Header.tsx
📌 Stop Hook Active: false
주요 기능
지원 이벤트
이벤트
      설명
      활용
    
Notification
      일반 작업 알림
      전체 작업 흐름 파악
    
Stop
      작업 완료
      작업 종료 시점 확인
    
SubagentStop
      서브 에이전트 완료
      병렬 작업 추적
    
File Operations
      파일 편집/생성/삭제
      코드 변경사항 추적
    
Terminal Commands
      명령어 실행
      빌드/테스트 상태 확인
    
활용 예시
1. 장시간 리팩토링
대규모 코드베이스 리팩토링 시 진행 상황을 실시간으로 확인할 수 있습니다. 다른 작업을 하면서도 모바일로 진행도를 체크할 수 있어 효율적입니다.
2. 디버깅 과정 추적
Claude Code가 어떤 파일을 분석하고 수정하는지 추적하여 디버깅 과정을 이해하고 학습할 수 있습니다.
3. 팀 협업
팀 텔레그램 채널에 봇을 추가하면 Claude Code의 작업을 팀원들과 실시간으로 공유할 수 있습니다.
고급 설정
환경변수 영구 설정
.bashrc 또는 .zshrc에 추가:
export CC_HOOK_TELEGRAM_BOT_TOKEN="your_bot_token"
export CC_HOOK_TELEGRAM_CHAT_ID="your_chat_id"
그룹 채팅 연동
봇을 그룹에 초대
그룹 Chat ID 확인 (음수로 시작: -1001234567890)
해당 ID로 환경변수 설정
필터링 커스터마이징
특정 이벤트만 알림받으려면 notification.py 수정:
# 예: 파일 작업만 알림
if event_type in ['FileEdit', 'FileCreate', 'FileDelete']:
    send_telegram_message(message)
문제 해결
문제
      해결 방법
    
알림이 오지 않음
      토큰/ID 확인, 봇과 대화 시작 여부 확인
    
권한 오류
      chmod +x ~/.claude/hooks/notification.py 실행
    
토큰 오류
      토큰을 정확히 복사했는지 확인 (대소문자 구분)
    
그룹 채팅 실패
      음수 Chat ID 사용, 봇 관리자 권한 확인
    
보안 주의사항
토큰을 절대 공개 저장소에 커밋하지 마세요
.env 파일을 .gitignore에 추가하세요
토큰이 노출되면 BotFather의 /revoke 명령으로 즉시 재발급하세요
마무리
간단한 Hook 설정으로 Claude Code의 작업을 실시간으로 모니터링할 수 있습니다. 특히 모바일 환경에서 작업 진행 상황을 확인하고 싶을 때 유용한 도구입니다.
전체 소스 코드: GitHub 저장소

Claude Code 텔레그램으로 알림 받기

댓글