overwirehq/claude-code-telegram

해결하는 문제

이 프로젝트는 Claude Code에 대한 원격 접근을 제공하여 사용자가 Telegram 봇을 통해 코드베이스와 상호작용할 수 있도록 합니다. 터미널 없이도 코드를 분석하거나 편집하거나 설명할 수 있어, 개발자가 어떤 기기에서도 프로젝트를 관리할 수 있습니다.

작동 방식

봇은 Telegram API와 Claude Code CLI/SDK 사이의 다리 역할을 합니다. 주로 두 가지 주요 상호작용 모드를 지원합니다:

• 에이전트 모드: 사용자가 자연어로 Claude와 대화하여 파일 편집, 테스트 실행, GitHub 리포지토리 관리(예: gh CLI 사용) 등의 작업을 수행할 수 있는 인터페이스입니다.
• 클래식 모드: 특정 명령어(예: /cd, /ls, /pwd)와 인라인 키보드를 사용하는 터미널과 유사한 인터페이스로 탐색 및 파일 관리가 가능합니다.

또한, 웹훅(예: GitHub 이벤트) 또는 크론 기반 스케줄러를 통해 이벤트 기반 시스템을 통해 Claude를 트리거할 수 있으며, 자동 코드 건강 점검을 수행할 수 있습니다.

대상 사용자

모바일 친화적인 인터페이스를 통해 코드베이스를 원격으로 관리하고 싶은 개발자, 또는 Telegram 알림과 웹훅을 통해 코드베이스 유지보수 작업을 실제로 자동화하고 싶은 사용자.

주요 특징

• 원격 코드베이스 상호작용: Claude Code와의 완전한 통합을 통해 원격으로 코드 편집 및 분석이 가능합니다.
• 다중 모드 인터페이스: 대화형 에이전트 경험 또는 명령 기반 터미널 경험 중 선택 가능합니다.
• 다중 모달 입력: Whisper 또는 Voxtral을 통해 이미지/스크린샷 분석 및 음성 메시지 전사 기능을 지원합니다.
• 보안: 디렉터리 사전화, 사용자 화이트리스트, 요청 제한 기능으로 비인가 접근이나 경로 탐색을 방지합니다.
• 자동화: 내장된 웹훅 API 서버와 작업 스케줄러를 통해 사전 알림 및 자동 작업만을 수행할 수 있습니다.