Community코딩 & 개발github.com

jcordon5/claude-telegram-bridge

AI 에이전트가 텔레그램으로 알림을 보내고, 긴/무인 실행 중 차단 질문(허용 목록 포함)을 할 수 있게 해주는 클로드 스킬입니다.

claude-telegram-bridge란 무엇인가요?

이 스킬은 AI 에이전트(예: Claude Code)가 텔레그램을 통해 사용자와 비동기적으로 통신할 수 있게 해줍니다. 긴 작업 실행 중에도 사용자에게 진행 상황을 알리거나, 중요한 결정을 내려야 할 때 차단 질문을 텔레그램으로 보내 입력을 받을 수 있습니다. 허용 목록(allowlist)을 설정하여 특정 작업 또는 사용자만 차단 질문을 할 수 있도록 제어할 수 있어 보안과 안정성을 높입니다. 이 스킬은 Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼에서 사용할 수 있으며, 봇 토큰과 채팅 ID 설정만으로 간단히 연동됩니다. 무인 실행 환경에서도 AI 에이전트가 사용자의 개입을 필요로 할 때 유용하게 활용할 수 있습니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add jcordon5/claude-telegram-bridge

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

claude-telegram-bridge은(는) 무엇을 하나요?

Claude 스킬: AI 에이전트가 텔레그램으로 알림을 보내고, 긴/무인 실행 중 차단 질문(허용 목록 포함)을 할 수 있게 해줍니다.

이 스킬은 AI 에이전트(예: Claude Code, Cursor, Codex)가 텔레그램을 통해 사용자와 통신할 수 있도록 합니다. 주요 기능은 다음과 같습니다:

  • 알림 전송: 작업 진행 상황, 완료, 오류 등을 텔레그램 메시지로 전송합니다.
  • 차단 질문: 사용자의 결정이 필요한 경우 텔레그램을 통해 질문을 보내고 응답을 기다립니다.
  • 허용 목록: 특정 사용자나 작업만 차단 질문을 할 수 있도록 제한합니다.

설정 방법

  1. 텔레그램 봇을 생성하고 토큰을 받으세요 (BotFather 사용).
  2. 채팅 ID와 봇 토큰을 환경 변수로 설정하세요:
    TELEGRAM_BOT_TOKEN=your_bot_token
    TELEGRAM_CHAT_ID=your_chat_id
    
  3. 허용 목록을 설정하려면 다음 환경 변수를 사용하세요:
    TELEGRAM_ALLOWED_USERS=user1,user2
    

사용 예시

알림 보내기

AI: 텔레그램으로 "작업이 완료되었습니다."라고 보내 주세요.

차단 질문

AI: 사용자에게 "이 파일을 삭제해도 될까요?"라고 텔레그램으로 질문하고 응답을 기다려 주세요.

지원 플랫폼

  • Claude Code
  • Cursor
  • Codex

참고

  • 봇은 먼저 사용자와의 대화를 시작해야 메시지를 보낼 수 있습니다.
  • 보안을 위해 허용 목록을 적절히 설정하세요.
  • 자세한 내용은 공식 문서를 참조하세요.

관련 스킬