Claude Code를 원격으로 쓸 때 권한 프롬프트가 떠서 작업이 멈추는 문제를 해결합니다.
터미널 출력을 감시하다가 권한 요청이 뜨면 텔레그램으로 알림을 보내고, 버튼 하나로 승인/거부할 수 있습니다.
telegram_guard.py (백그라운드 데몬)
│
├─ [1] tmux 터미널 감시 (2초마다)
│ ├─ "Allow Bash tool?" 같은 프롬프트 감지
│ ├─ 텔레그램으로 알림 (승인/거부 버튼)
│ └─ 응답에 따라 'y' 또는 'n' 키 입력
│
└─ [2] macOS 시스템 다이얼로그 감시 (6초마다)
├─ "허용/Allow" 버튼이 있는 팝업 감지
├─ 텔레그램으로 알림 (앱 이름 + 내용 + 버튼 목록)
└─ 응답에 따라 허용/거부 버튼 자동 클릭
AI API 호출 없음. 토큰 소모 0.
git clone https://github.com/bugbug9999/claude-auto-permit.git
cd claude-auto-permit
./setup.shsetup.sh가 알아서 해줍니다:
- tmux 설치 확인 (없으면 Homebrew로 설치)
- Python 3 확인
- 텔레그램 봇 설정 (토큰 입력 + 자동 검증 + 테스트 메시지)
- 텔레그램에서 @BotFather 검색
/newbot입력- 봇 이름 입력 (예:
My Claude Guard) - 봇 유저네임 입력 (예:
my_claude_guard_bot) - BotFather가 알려주는 토큰을 복사 (예:
123456789:ABCdef...) - 만든 봇에게 아무 메시지 하나 보내기
./setup.sh실행하면 Chat ID 자동 감지
# 시작 (tmux + Claude Code + Guard 한번에)
./start.sh
# Claude Code에 인자 전달
./start.sh --model opus
# 종료
./stop.sh
# tmux 세션 직접 접속 (디버깅용)
tmux attach -t claude| 항목 | 기본값 | 설명 |
|---|---|---|
poll_interval |
2 |
터미널 감시 주기 (초) |
timeout_seconds |
900 |
무응답 타임아웃 (15분) |
timeout_action |
"deny" |
타임아웃 시 동작 ("deny" 또는 "approve") |
auto_approve_patterns |
["Read", "Glob", ...] |
알림 없이 자동 승인할 도구 |
tmux_session |
"claude" |
tmux 세션 이름 |
macos_dialog_monitor |
true |
macOS 시스템 다이얼로그 감시 on/off |
읽기 전용 도구는 자동 승인하고 싶으면:
{
"auto_approve_patterns": ["Read", "Glob", "Grep", "WebSearch", "WebFetch"]
}전부 수동 승인하려면:
{
"auto_approve_patterns": []
}macOS에서 "이 앱이 컴퓨터를 관리하려고 합니다" 같은 시스템 팝업도 감지합니다.
osascript(AppleScript)로 열려있는 다이얼로그를 스캔- "허용/Allow" 버튼이 있으면 텔레그램으로 알림
- 승인 시 해당 버튼을 자동 클릭
필요 권한: 시스템 설정 > 개인정보 보호 및 보안 > 손쉬운 사용에서 터미널(또는 iTerm) 허용 필요
끄고 싶으면 config.json에서:
{
"macos_dialog_monitor": false
}- macOS (Linux는 tmux 감시만 가능, 다이얼로그 감시 자동 비활성화)
- Python 3.6+
- tmux
- 텔레그램 계정 + 봇
MIT