Community생산성 & 협업github.com

shotX33/claude-code-telegram

텔레그램을 통해 클로드 코드에 원활하게 접속하여 어디서나 자연스럽고 맥락을 인식하는 코딩 도움, 편집 및 프로젝트 알림을 받을 수 있습니다.

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

이 스킬(shotX33/claude-code-telegram)은 텔레그램 봇을 활용하여 Claude Code에 원격으로 접근할 수 있는 브리지 역할을 합니다. 개발자는 모바일 기기 등에서 텔레그램 메시지를 보내 Claude Code에게 코딩 질문, 코드 편집, 리팩토링, 디버깅 등을 요청할 수 있으며, Claude Code는 그 결과를 텔레그램으로 전송합니다. 주요 기능으로는 자연어 명령 처리, 프로젝트 변경 사항에 대한 실시간 알림, 컨텍스트 인식 대화 등이 포함되어 있어, 개발자가 데스크톱 환경에 항상 접속하지 않아도 생산성을 유지할 수 있도록 도와줍니다. Claude Code CLI와 텔레그램 봇 API를 활용하며, 설정은 `TELEGRAM_BOT_TOKEN` 환경 변수와 텔레그램 채팅 ID를 통해 간단히 구성할 수 있습니다.

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

Installed? Explore more 생산성 & 협업 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

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

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

문서

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

텔레그램을 통해 Claude Code에 원활하게 접속하여 어디서나 자연스럽고 맥락을 인식하는 코딩 도움, 편집 및 프로젝트 알림을 받을 수 있습니다.

개요

shotX33/claude-code-telegram 스킬은 텔레그램 메신저와 Claude Code를 연결하는 브리지 역할을 합니다. 텔레그램 봇을 통해 Claude Code에게 명령을 보내고, 코드 편집 요청을 하며, 프로젝트 상태에 대한 실시간 알림을 받을 수 있습니다.

주요 기능

  • 텔레그램을 통한 원격 명령: 텔레그램 클라이언트에서 Claude Code에게 직접 메시지를 보내 코딩 작업을 요청합니다.
  • 컨텍스트 인식 대화: Claude Code가 프로젝트의 컨텍스트를 유지하며 연속적인 대화를 지원합니다.
  • 실시간 알림: 빌드 완료, 테스트 실패, 오류 발생 등 프로젝트 이벤트에 대한 알림을 텔레그램으로 받습니다.
  • 코드 편집 및 리뷰: 코드 파일을 텔레그램을 통해 전송하거나 링크를 공유하여 리뷰 및 편집을 요청합니다.

설정 방법

  1. 텔레그램 봇 생성: @BotFather에게 /newbot 명령을 보내 봇을 생성하고 토큰을 받습니다.
  2. 환경 변수 설정:
    export TELEGRAM_BOT_TOKEN="your-bot-token-here"
    
  3. 텔레그램 채팅 ID 확인: 봇과 대화를 시작한 후 https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates에서 채팅 ID를 찾습니다.
  4. Claude Code와 연동: Claude Code 설정에서 이 스킬을 활성화하고 채팅 ID를 등록합니다.

사용 예시

  • 코딩 질문: "텔레그램"에 "이 파이썬 함수를 리팩토링해줘"라고 보내면 Claude Code가 작업을 수행하고 결과를 전송합니다.
  • 파일 편집: 텔레그램에 "main.py 파일에 새 함수를 추가해줘"라고 요청합니다.
  • 상태 확인: "프로젝트 빌드 상태가 어떻게 돼?"와 같은 질문으로 현재 상태를 확인합니다.

요구 사항

  • Claude Code CLI (v1.0.0 이상)
  • 텔레그램 계정 및 봇 토큰
  • 안정적인 인터넷 연결

지원 플랫폼

  • Linux, macOS, Windows (WSL 포함)
  • Claude Code가 설치된 모든 환경

라이선스

MIT

관련 스킬