CCGram: 텔레그램으로 AI 코딩 에이전트를 원격 제어하는 오픈소스 도구

이 요약은 AI가 원문을 분석해 생성했습니다. 정확한 내용은 원문 기준으로 확인하세요.

핵심 요약

tmux와 텔레그램을 연결하여 Claude Code 등 AI 코딩 에이전트의 진행 상황을 모바일에서 실시간 모니터링하고 상호작용할 수 있는 CCGram 도구가 공개되었다.

배경

작성자는 사무실 밖에서도 AI 코딩 에이전트의 작업을 모니터링하고 제어하기 위해 tmux 세션과 텔레그램 포럼 토픽을 연동하는 CCGram을 개발하여 MIT 라이선스로 공유했다.

의미 / 영향

AI 코딩 에이전트의 활용 시나리오가 데스크톱 환경을 넘어 모바일 원격 제어로 확장되고 있음을 보여준다. 특히 CLI 도구의 한계를 메신저 플랫폼의 UI 요소(인라인 버튼, 알림)와 결합하여 해결하는 방식은 향후 에이전트 인터페이스 설계의 중요한 참고 사례가 될 것으로 보인다.

커뮤니티 반응

작성자가 직접 개발한 도구에 대해 대체로 긍정적인 반응이며, 특히 Claude Code를 사용하여 Claude Code용 도구를 만들었다는 점에 흥미를 느끼는 사용자들이 많다.

실용적 조언

uv tool install ccgram 명령어로 빠르게 설치하여 사용해 볼 수 있다.
Claude Code를 주력으로 사용한다면 ccgram hook --install 명령어를 통해 실시간 알림 기능을 활성화하는 것이 좋다.
텔레그램 그룹에서 '주제(Topics)' 기능을 활성화해야 각 에이전트 세션을 독립된 토픽으로 관리할 수 있다.

섹션별 상세

CCGram은 로컬 머신의 tmux 윈도우에서 실행되는 에이전트의 출력을 읽어 텔레그램 포럼 토픽으로 전달하는 브릿지 역할을 수행한다. 사용자가 텔레그램에서 메시지를 보내면 해당 키스트로크가 에이전트에게 직접 전달되어 모바일에서도 대화형 세션을 유지할 수 있다. 노트북을 닫고 이동하더라도 텔레그램을 통해 작업을 지속하다가 나중에 다시 tmux에 접속하면 전체 스크롤백이 그대로 보존된다.

Claude Code와의 깊은 통합을 위해 7가지 훅 이벤트(세션 시작, 알림, 중단, 서브에이전트 상태 등)를 지원한다. 이를 통해 단순한 텍스트 폴링이 아닌 실시간 세션 추적과 알림이 가능하며, 사용자 질문이나 권한 요청 같은 대화형 프롬프트는 텔레그램 인라인 키보드 버튼으로 렌더링되어 탭 한 번으로 승인 처리가 가능하다.

멀티 프로바이더 및 멀티 세션 관리를 지원하여 Claude Code, Codex CLI, Gemini CLI를 각기 다른 텔레그램 토픽에서 병렬로 실행할 수 있다. 각 프로바이더의 특성을 인식하여 새로 시작하거나 기존 세션을 재개하는 버튼이 동적으로 적응하며, Gemini의 경우 작업 중이거나 조치가 필요한 상태를 자동으로 감지하여 표시한다.

bash

ccgram hook --install

Claude Code와의 최적 연동을 위해 훅 시스템을 설치하는 명령어

CCGram 프로젝트 자체가 Claude Code를 사용하여 개발되었다는 점이 특징이다. 아키텍처 설계부터 프로바이더 추상화, VT100 터미널 파서 구현, 대화형 UI 렌더링, E2E 테스트 하네스 구축까지 모든 과정에 Claude Code가 활용되었으며, 이는 AI 코딩 에이전트가 스스로를 제어하는 도구를 직접 만든 사례이다.

코드 예제

bash

uv tool install ccgram
# 또는
brew install alexei-led/tap/ccgram

CCGram 도구를 설치하는 명령어

실무 Takeaway

CCGram은 tmux와 텔레그램을 연동하여 AI 코딩 에이전트를 모바일에서 원격 제어할 수 있는 오픈소스 도구이다.
Claude Code의 훅 시스템을 활용해 실시간 상태 알림 및 인라인 버튼 기반의 상호작용을 구현하여 편의성을 높였다.
Codex 및 Gemini CLI 등 다양한 프로바이더를 지원하며 각 세션을 텔레그램 토픽별로 분리하여 관리할 수 있다.
MIT 라이선스로 공개되었으며 uv 또는 brew를 통해 간편하게 설치하고 설정할 수 있다.

언급된 도구

CCGram추천링크

tmux와 텔레그램을 연결하는 AI 에이전트 원격 제어 브릿지

Claude Code추천

Anthropic에서 개발한 CLI 기반 자율 코딩 에이전트

tmux추천

터미널 세션 유지 및 멀티플렉싱 도구

언급된 리소스

GitHubCCGram GitHub Repository