요새 헤르메스나 OpenClaw 같은 에이전트를 텔레그램 봇으로 묶어서 외부에서 쓰시는 분들이 꽤 보이더라고요. 두 가지 용도로 나눠지는 것 같습니다.

전자(개인비서)면 텔레그램 봇이 합리적이에요. 짧은 메시지 주고받고, LLM 호출도 가끔이고, 토큰도 별로 안 듭니다.

다만 후자(외부에서 코딩 모니터링) 용도로 쓰시는 거라면 — 텔레그램 봇은 도구를 잘못 고르신 거예요. 이유는 단순합니다. 봇 구조에서는 외부에서 "작업 어떻게 됐어?" 라고 물을 때마다 LLM이 한 번 더 호출됩니다. 봇이 현재 상태를 LLM한테 물어보고 답을 만들어서 텔레그램으로 보내는 구조니까요.(토큰 지옥! 🤯)

근데 코딩 에이전트는 이미 본인 컨텍스트 안에서 돌고 있어요. 외부에서 보고 싶은 건 "이미 일어난 일을 그냥 보는 것" 이지 "LLM한테 다시 물어보는 것" 이 아닙니다. 그런데 봇 구조에서는 보는 행위 자체가 LLM 호출이 돼서 - 확인할수록 토큰이 닳는 구조가 됩니다. 외출 중에 자주 확인하실수록 손해예요.

더 맞는 도구 - TerminalSync

TerminalSync라는 도구가 이 니즈에 정확히 맞습니다. 얼마전에 해커뉴스에서 발견했습니다

이미 돌고 있는 터미널 세션을 폰 브라우저에 그대로 미러링

이게 끝이에요. 집 컴퓨터에 Claude Code나 Codex CLI 띄워놓고 작업 시켜둔 다음, 폰에서 그 화면을 그대로 실시간으로 볼 수 있습니다. 추가 LLM 호출 0. 그냥 화면 미러링이니까요. 필요하면 폰에서 직접 키 입력도 가능해요.

SSH랑 다른 점이 있어요. SSH는 새 세션을 여는 거라, 집에서 돌고 있는 그 세션이 아니라 새 터미널이 열립니다. AI 에이전트가 작업 중이면 그 작업은 SSH로 못 봐요. tmux나 screen으로 미리 세팅해뒀어야 합니다. TerminalSync는 이미 돌고 있는 세션을 그대로 비춰주는 게 차별점이에요. QR 한 번 스캔하면 끝납니다. 터미널이 그냥 그대로 브라우저로 미러링되요. 속도도 적당합니다.

외부 접속 - Tailscale이나 Cloudflare Tunnel

집 LAN 안에서는 그냥 동작하는데, 외부(카페·이동 중·다른 도시)에서 접속하시려면 외부 노출이 필요합니다. 두 가지 옵션 추천드려요.

Tailscale - 개인용 무료. 컴퓨터랑 폰에 깔고 같은 계정으로 로그인하면 끝. 둘이 한 네트워크처럼 보이게 됩니다.

terminalsync --host $(tailscale ip -4)

Cloudflare Tunnel — 도메인 노출 옵션. 무료고 설치 한 줄.

cloudflared tunnel --url http://localhost:12345
terminalsync --port 12345 --public-url https://YOUR.trycloudflare.com

둘 다 중계 서버 안 거치고 P2P로 연결됩니다. E2E 암호화라 중간에 가로채여도 못 봐요 (X25519 키 교환 + XSalsa20-Poly1305).

보안

이거 "내 터미널을 외부에 노출하는 도구" 라 보안이 신경 쓰이실 텐데, 설계가 꽤 깔끔해요.

• 키는 메모리에만 저장, 종료 시 0으로 덮어씀

• 데몬 없음 - 실행한 터미널 닫으면 즉시 종료

• 자체 서명 인증서 + QR 코드에 fingerprint 핀닝

• 12자리 SAS(Short Authentication String)로 양쪽 화면 비교 가능

• 백그라운드 실행 거부 (parent가 PID 1이면 실행 안 됨)

"실수로 켜놓고 잊어버려도 안전" 이라기보다 "실수로 켜놓을 수 없는" 구조에 가까워요. 터미널 닫으면 끝납니다.

누구한테 추천하나

• 집 데스크톱에 Claude Code/Codex/Cursor 띄워놓고 외출하시는 분

• AI 에이전트한테 긴 작업(빌드, 마이그레이션, 대량 리팩토링) 시켜놓고 진행 상황 확인하고 싶으신 분

• 출퇴근길에 폰으로 코드 한 줄 수정하거나 명령 한 번 날리고 싶으신 분

• 텔레그램 봇으로 비슷한 거 시도해보셨는데 "왜 토큰이 이렇게 빨리 닳지" 싶으셨던 분

누구한테는 안 맞나

• "폰에서 LLM이랑 자연어로 대화하면서 명령 내리고 싶다" - 이건 텔레그램 봇이 맞아요. 미러링은 터미널 그대로 보는 거라 자연어 대화 인터페이스가 아닙니다.

• "여러 사람이 같이 보면서 작업하고 싶다" - 이건 다른 도구(sshx, tmate 등)가 더 맞아요.

설치

pipx install terminalsync
# 또는: pip install terminalsync

terminalsync 한 줄 입력하면 QR 코드가 나오고, 폰으로 스캔하면 끝입니다. macOS / Linux 지원, Python 3.11+ 필요.

자세한 옵션은 레포 참조하시고요. MIT 라이선스고 코드 깔끔하게 짜여 있어요.

참고로 토큰 절약 자체에 관심 있으신 분은 어제 AI당에 올린 글에 좀 더 정리해뒀습니다. GPT + 로컬 LLM 같이 쓰는 패턴이랑 context-mode/tunaCtx 같은 다른 토큰 절약 도구도 같이요.