Skip to content

macOS · Claude Code · 셀프호스팅 · AGPL-3.0

맥의 Claude Code 를
폰에서 이어서.

Agent Bridge 는 맥에서 도는 진짜 Claude Code 세션을 웹에 이어요. 폰으로 대화하고 권한 요청에 답하고, 세션을 맥북에서 아이맥으로 옮겨 이어서 작업해요.

구조

어디서든

폰 브라우저
다른 맥·PC
알림·웹 푸시
조작
Agent Bridge서버 · 맥의 브라우저 탭 · 127.0.0.1 의 에이전트
실행

내 맥

claude진짜 세션
zeropty세션 터미널
git작업 폴더

구성과 연결 자세히 보기 →

화면

폰 폭에 먼저 맞춘 조작 화면

세션 목록 화면. 그룹으로 묶인 세션 세 개와 권한 요청을 기다리는 세션 표시
세션 목록: 그룹, 상태, 응답 대기
대화 화면. 사용자의 요청, Claude 의 답, 접힌 도구 호출 세 개와 입력창
대화: 답과 도구 호출이 흘러 들어와요
권한 요청 카드. npm test 실행을 허용할지 세 가지 선택지로 묻는 화면
결정 카드: 터미널의 확인 창을 버튼으로

맥에 남는 세션

실행도 기록도 내 맥에

서버는 Claude 를 돌리지 않고 대화도 저장하지 않아요. 코드, 자격 증명, 대화 기록은 맥에 남고 서버는 최근 이벤트만 메모리에 둬요.

열린 포트 없음

터널도 고정 IP 도 없이

맥의 브라우저 탭이 서버와 127.0.0.1 의 에이전트를 이어요. 맥에 포트를 열 필요가 없어요.

결정 카드

권한 요청에 폰으로 답하기

권한 요청, 질문, 플랜 승인 같은 터미널 확인 창이 카드로 떠요. 지금 화면에 있는 선택지만 눌러요.

옮기기

맥북에서 아이맥으로

보내는 맥에서 대화와 작업 폴더의 브랜치·커밋을 받아 다른 맥에서 같은 대화를 이어요. 실패하면 원래 자리에 남아요.

끊겨도 그대로

맥이 다시 붙으면 이어서

맥이 잠들거나 탭이 닫혀도 세션은 맥의 터미널에서 계속 돌아요. 다시 연결되면 그 사이의 대화를 이어서 보여 줘요.

서명된 업데이트

서버를 그대로 믿지 않는 에이전트

에이전트는 운영자 키로 서명된 새 버전만 받아요. 세션에 비밀번호를 걸면 화면, 목록, 알림, 플러그인에서 내용이 가려져요.

지원 환경

macOS 호스트Chrome 연동 페이지폰·PC 브라우저zeropty · tmuxDocker 서버헤드리스 연동 모드선택
지원 환경 자세히 보기 →

맥에서 한 번

$ curl -fsSL https://bridge.example.com/install.sh | bash
시작하기

AGPL-3.0-only 라이선스로 배포해요.