Claude Code를 모바일에서 제어하는 오픈소스 도구, OpenACP

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

핵심 요약

Claude Code와 같은 코딩 에이전트를 Telegram 등 메시징 앱과 연결하여 모바일에서 원격 제어 및 비용 모니터링을 가능하게 하는 오픈소스 도구 OpenACP를 소개한다.

배경

작성자는 Claude Code를 외부에서 모바일로 제어하기 위해 SSH나 tmux 등을 시도했으나 UI 문제로 불편을 겪었고, 이를 해결하기 위해 OpenACP라는 오픈소스 브리지를 사용한 경험을 공유했다.

의미 / 영향

Claude Code와 같은 터미널 기반 에이전트의 모바일 접근성 문제를 오픈소스 브리지로 해결한 사례이다. 커뮤니티는 단순한 원격 접속을 넘어 비용 모니터링과 버튼 기반 승인 워크플로가 실무적인 에이전트 운영에 필수적임을 확인했다.

커뮤니티 반응

대체로 긍정적이며, 많은 사용자가 Claude Code의 모바일 접근성 문제에 공감하며 비용 추적 기능에 높은 관심을 보였다.

주요 논점

01찬성다수

모바일에서 버튼 클릭으로 권한을 승인하고 비용을 모니터링하는 기능이 실무적으로 매우 유용하다.

합의점 vs 논쟁점

합의점

Claude Code의 기본 터미널 UI는 모바일에서 사용하기에 부적합하다.
에이전트의 무한 루프를 방지하기 위한 실시간 비용 감시가 필수적이다.

실용적 조언

API 비용 폭주를 막기 위해 OpenACP의 세션별 비용 추적 기능을 활성화하여 사용할 것
Telegram의 포럼(Topics) 기능을 활용해 여러 에이전트 세션을 프로젝트별로 분리하여 관리할 것

섹션별 상세

Claude Code의 터미널 UI가 모바일 화면에 최적화되지 않아 발생하는 원격 제어의 어려움을 해결하고자 OpenACP가 개발됐다. 이 도구는 로컬에서 실행 중인 코딩 에이전트와 Telegram/Discord/Slack 간의 브리지 역할을 수행하여 메시징 인터페이스를 제공한다. 사용자는 자신의 머신에 CLI를 설치하고 워크스페이스를 지정함으로써 터미널 대신 채팅창에서 에이전트와 상호작용한다. 이를 통해 데스크톱 앞에 있지 않아도 코드 수정이나 명령 실행을 모바일로 관리할 수 있다.

에이전트가 파괴적인 명령을 실행하려 할 때 Telegram 채팅창에 승인/거부 버튼이 즉시 나타나도록 설계됐다. 사용자가 버튼을 누르면 해당 신호가 로컬 브리지를 거쳐 Claude Code 세션에 전달되어 프로세스가 진행되거나 중단된다. 기존에는 승인 대기 상태에서 작업이 몇 시간씩 멈춰있는 경우가 많았으나, 이 방식을 통해 실시간 대응이 가능해졌다. 특히 이동 중에도 세션 상태가 유지되므로 장소에 구애받지 않는 연속적인 작업 흐름을 보장한다.

세션별 실시간 비용 추적 기능을 도입하여 API 사용량에 따른 과도한 과금을 방지한다. 각 세션은 현재까지 발생한 비용을 표시하며, 사용자는 비용이 급증하거나 에이전트가 루프에 빠졌다고 판단될 경우 즉시 세션을 종료할 수 있다. 또한 Telegram의 포럼 기능을 활용해 여러 에이전트 세션을 독립된 주제로 분리하여 관리함으로써 작업 혼선을 최소화한다. 이는 대규모 리팩터링이나 복잡한 프로젝트 관리 시 유용하게 작용한다.

OpenACP는 로컬 환경에서 오케스트레이션과 코드 관리, 세션 상태 및 자격 증명을 처리하는 구조를 취한다. 실제 추론은 Anthropic API를 통해 이루어지지만, 에이전트의 행동 제어와 메시지 포맷팅은 로컬 브리지에서 담당한다. 긴 출력물은 메시징 앱의 특성에 맞춰 자동으로 청크 단위로 분할되어 전송되며, CLAUDE.md와 같은 프로젝트 규칙 파일도 그대로 적용된다. 다만 웹 UI는 제공되지 않으며 CLI와 메시징 앱 연동에만 집중한 초기 단계의 프로젝트이다.

코드 예제

bash

npm install -g @openacp/cli openacp
openacp

OpenACP CLI 도구를 전역으로 설치하고 실행하는 명령어

실무 Takeaway

OpenACP는 Claude Code를 Telegram 등과 연결하여 모바일에서 원격 제어할 수 있게 돕는 MIT 라이선스 오픈소스 도구이다.
메시징 앱의 버튼 인터페이스를 통해 에이전트의 명령 실행 승인 및 거부를 즉시 처리하여 작업 효율을 높인다.
세션별 실시간 비용 모니터링 기능을 제공하여 에이전트의 무한 루프로 인한 API 비용 낭비를 사전에 차단한다.
로컬에서 오케스트레이션과 세션 상태를 관리하므로 보안성을 유지하면서도 장소 제약 없는 코딩 워크플로를 구축할 수 있다.

언급된 도구

OpenACP추천링크

코딩 에이전트와 메시징 앱을 연결하는 브리지 도구

Claude Code중립

Anthropic의 터미널 기반 코딩 에이전트

언급된 리소스

GitHubOpenACP GitHub Repository

문서OpenACP Documentation