Claude Code Telegram Bot

Telegram에서 Claude Code에 원격으로 접근할 수 있는 오픈소스 봇. 모바일에서 자연어로 코드베이스와 상호작용

개요

터미널 없이 Telegram 채팅으로 Claude Code를 사용할 수 있는 봇이다. Python 3.11+로 작성되었으며, 세션 지속성, 보안 샌드박싱, GitHub 연동, 음성 인식, 스케줄러까지 포함하는 풀기능 코딩 어시스턴트다.

핵심 기능

Agentic Mode (기본)

명령어 없이 자연어 대화로 코드 분석/편집/설명
/verbose 0|1|2로 출력 상세도 조절
/repo로 프로젝트 전환
Claude SDK (기본) + CLI (폴백)

Classic Mode

AGENTIC_MODE=false로 활성화
13개 명령어 + 인라인 키보드
/start, /help, /new, /continue, /end, /status, /cd, /ls, /pwd, /projects, /export, /actions, /git

이벤트 기반 자동화

Webhook: GitHub (push/PR/issues) → Claude 요약/리뷰 → Telegram 알림
Scheduler: Cron 기반 정기 작업
ENABLE_API_SERVER=true, ENABLE_SCHEDULER=true로 활성화

기타 기능

음성 인식: Mistral Voxtral / OpenAI Whisper / local whisper.cpp
파일/이미지 업로드 분석
Git 통합 (안전 연산)
세션 내보내기 (Markdown/HTML/JSON)
비용 추적, 감사 로그
16개 설정 가능한 도구 (allow/deny 목록)
SQLite 지속성 + 마이그레이션

설치

# uv 권장 (격리된 환경)
uv tool install git+https://github.com/RichardAtCT/claude-code-telegram@v1.6.0
 
# 또는 pip
pip install git+https://github.com/RichardAtCT/claude-code-telegram@latest

필수 설정 (.env)

TELEGRAM_BOT_TOKEN=...        # @BotFather에서 발급
TELEGRAM_BOT_USERNAME=...     # 봇 사용자명
APPROVED_DIRECTORY=...        # 프로젝트 접근 기본 디렉토리
ALLOWED_USERS=123456789       # 콤마로 구분된 Telegram 사용자 ID

보안

사용자 화이트리스트 + 선택적 토큰 인증
디렉토리 샌드박싱 (지정 경로 외 접근 차단)
GitHub Webhook HMAC-SHA256 검증
속도 제한 (토큰 버킷)
감사 로그

메타데이터

별점: 2,291★ / Fork: 313 / Contributors: 30
언어: Python (99.6%)
라이선스: MIT
최신 버전: v1.6.0 (2026-03-30)
Python: 3.11+
릴리스: 7개 (태그 기반 설치 권장)

Hermes Agent와의 비교

Hermes Agent도 Telegram 플랫폼을 지원하지만, Claude Code Telegram Bot과는 접근 방식이 다르다:

관점	Claude Code Telegram Bot	Hermes Agent
기반 에이전트	Claude Code CLI	자체 AIAgent (멀티프로바이더)
언어	Python	Python
멀티프로바이더	Claude만	Anthropic, OpenAI, Google 등
MCP	Claude Code 내장	자체 MCP 클라이언트
세션	SQLite	SQLite (SessionDB)
자동화	Webhook + Scheduler	Cronjob + Webhook
보안	화이트리스트 + 샌드박스	화이트리스트 + approval
음성	Whisper/Voxtral	TTS 지원

Claude Code 전용이라는 제약이 있지만, Claude 생태계 내에서는 가장 성숙한 Telegram 코딩 봇이다.

LLM Wiki

탐색기

Claude Code Telegram Bot — 원격 코딩 어시스턴트 (2.3K★)