← Sandbox

🤖 텔레그램 Claude 브리지 인프라

텔레그램으로 보낸 메시지를 헤드리스 Claude Code에 넘기고 결과를 되돌려 주는 데몬. SSH 없이 폰에서 서버 작업을 지시하기 위한 것. 여기 있는 실험들도 폰에서 고칠 수 있다.

접근

봇

텔레그램 @jtdecentman_bot (알림봇과 같은 봇)

허용

화이트리스트한 chat_id 외에는 응답하지 않음

주요 기능

롱폴링 → claude -p --output-format stream-json 실행 → 텔레그램 회신
작업 디렉토리별로 --resume으로 대화가 이어짐
헤드리스 크로미움 render.py — 스크린샷·PDF·본문 추출을 폰으로 전송
guard.py URL 화이트리스트 — 밖의 주소는 텔레그램 버튼으로 승인을 받고, 거부되면 curl·WebFetch로 우회하지 않는다
오래 걸리는 작업은 bg.sh로 세션과 분리하고 완료를 폰으로 알림

구성

스택

Python 표준 라이브러리(urllib·subprocess) · 헤드리스 Chromium

구동

systemd user 유닛 claude-telegram.service (Linger=yes)

소스

~/.claude/tgbot/ — bridge.py·guard.py·render.py

기본값

bypassPermissions · opus · relay=final · 허용 디렉토리는 /opt/docker/apps와 ~/vault뿐

상태

state.json · 로그 bridge.log · journalctl --user -u claude-telegram

※ 설계 원칙 — 폴링 루프는 죽지 않는다(데몬이 조용히 죽으면 폰에서는 "생각 중"과 구별되지 않음), 토큰을 자식에게 물려주지 않는다(프롬프트 인젝션 한 번으로 봇을 빼앗김), 로그에 토큰·URL을 남기지 않는다(예외는 타입 이름만 찍음). bridge.py·config.json을 고쳤으면 systemctl --user restart claude-telegram까지 해야 반영됩니다.