휴대폰에서 Claude Code를 제어하고 컴퓨터를 계속 작동시키기 — 도구
이 문서는 번역본입니다. 기준이 되는 판본은 영어 원문이며, 인용할 때는 원문을 사용해 주세요.
집의 컴퓨터에서 Claude Code에서 무언가를 시작하고, 휴대폰을 들고 도시로 나갑니다. 한 시간 후 휴대폰을 확인합니다: 아무것도 진행되지 않고 있습니다. 컴퓨터는 당신이 문을 닫고 4분 후에 잠들었습니다. 또는 2년 전에 설정한 설정이 조용히 원격 기능을 꺼놨습니다. 또는 Claude가 한 시간 동안 "진행해도 될까요?"라고 묻고 있는데 아무도 휴대폰에 알려주지 않았습니다.
휴대폰과 Claude Code 사이의 연결은 이미 존재하며 당신이 구독하는 것에 함께 제공됩니다. 잘못되는 것은 그 주변의 모든 것입니다. Pocketcall은 Claude Code(컴퓨터의 파일과 함께 작동하는 Anthropic의 AI 어시스턴트)를 위한 무료 오픈 소스 플러그인(2줄로 설치하는 추가 기능)입니다. 떠나기 전에 문제가 되는 것들을 명확히 하고, 외출 중에도 계속 연락을 유지하며, 휴대폰에서 작업을 중지하거나 계속하거나 새 작업을 인계받을 수 있게 해줍니다.
원격 제어가 조용히 실패하는 이유
원인 중 어느 것도 어렵지 않지만, 모두 조용합니다. Google에 "claude code remote control not"을 입력하면 "not working", "not connecting", "not showing up", "stops working"을 제안합니다. 사용자들은 모바일 앱에서 연결되지 않는 원격 세션, 두 기기 모두 깨어있을 때 끊기는 세션, 또는 휴대전화에 전혀 나타나지 않는 세션을 보고하고 있습니다(예를 들어 Claude Code 추적기의 issue 30691). 또한 다른 사용자들은 휴대전화의 권한 질문에 답하기 위해 자체 소형 도구를 만들기도 했습니다. "claude용 mac 깨우기"는 이제 Google의 자체 검색 제안이 되었습니다.
Pocketcall은 또 다른 연결을 추가하지 않습니다. 무인 머신이 작동하는지 여부를 결정하는 요소들을 확인하고, 떠난 후 작업을 보고 조작할 수 있는 방법을 제공합니다.
무엇을 제공하는가
- 떠나기 전에 일곱 가지 조용한 것들을 확인합니다 (
ready). 작업 폴더에서 시작했는지 확인하고, 프로그램이 충분히 최신인지 확인하고, 설정이나 변수가 원격을 껐는지 확인하며(정확한 파일 위치를 표시합니다), 누군가 설정 파일에서 원격을 껐는지 확인하고, 컴퓨터가 절전 모드에 들어갈지 확인하고(Mac에서는 실제 분 단위로 읽습니다), 완료된 작업에 휴대폰이 볼 수 있는 폴더가 있는지 확인하고, 그 공유 폴더가 정말 동기화되고 있는지 확인합니다. 준비되지 않은 것들이 무엇인지 평문으로 표시합니다. - 현관에서의 네 분 (
leave). 여섯 단계이며, 다른 방의 휴대폰에서 실제 메시지를 보내고 답변받은 후 매일 저녁 반복하는 30초로 끝납니다: 꽂혀 있음, 뚜껑 열림, 이 창이 열려 있음, 공유 폴더의 이름을 알고 있음, 손에 휴대폰이 있음. 인쇄 가능한 카드는 체크리스트를 볼 수 있는 곳에 유지합니다. - 모든 작업을 위한 하나의 화면 (
board). 각 Claude Code 세션, 밤 실행 또는 검토는 작업 중, 당신을 기다리는 중, 완료됨, 또는 주어진 시간까지 한계를 기다리는 중으로 표시됩니다. 시작할 것은 없습니다: 플러그인의 훅(Claude Code가 정해진 시점에 실행하는 작은 스크립트)이 각 세션의 상태를 자동으로 작성합니다. 상태가 당신을 위해 변경될 때 휴대폰이 울립니다(Telegram 또는 자신의 ntfy 주제를 통해, 각각 짧은 한 줄). 보드는 또한 휴대폰이 이미 볼 수 있는 공유 폴더의 평문 웹 페이지이며, 1분마다 새로고침되고 서버가 없습니다. - 각 작업 아래 작업 카드. 보드는 작업이 얼마나 진행되었는지("단계 3/7"), 무엇을 확인했는지("확인 2/5"), 마지막으로 한 작업, 그리고 당신을 위해 얼마나 많은 것들이 기다리고 있는지 보여줄 수 있습니다. Nightcall의 밤 실행은 매번 라운드 후에 자동으로 채웁니다.
- 떠나 있는 동안 짧은 답변 (
handover). Claude를 위한 지속적인 지침: 휴대폰에서 읽을 수 있는 몇 줄로 답변하고 완료된 작업을 공유 폴더의 파일에 넣습니다. - 회사를 위한 승인 카드. 떠나 있는 동안 모든 권한 질문은 휴대폰에 도착할 수 있으며, 엔드투엔드 암호화되어 전체 명령, 터치하는 모든 파일, 그리고 예, 아니오, 차이점 보기 버튼이 있는 카드로 표시됩니다. 음성 메모는 회사의 추적기에서 작업이 될 수 있고, 세션은 끌어오기 요청을 열고, 예는 카드가 표시한 정확한 커밋을 병합합니다. 이 부분은 회사의 자체 릴레이에서 실행되며, 이는 Python의 표준 라이브러리만 사용하는 단일 스크립트입니다.
휴대폰에서 작업 중지, 계속 또는 시작
Pocketcall의 최신 부분은 링을 장시간 작업을 위한 리모콘으로 바꿉니다. Nightcall 밤 또는 긴 빌드와 같은 작업 폴더가 있는 작업이 울릴 때 Telegram 메시지는 두 개의 버튼과 함께 옵니다: 계속과 중지. 중지는 폴더에 메모를 남기고 해당 단계에서 밤이 끝납니다. 계속은 메모를 제거하고 이미 끝난 밤이 자신의 끝까지 계속됩니다. "stop" 또는 "continue"를 입력하면 같은 결과이며, 5개 언어 중 하나로 여러 작업이 실행 중일 때 작업 이름의 일부와 함께 사용할 수 있습니다.
같은 Telegram 봇으로 보낸 음성 메모가 다음 작업이 됩니다. 이는 자신의 컴퓨터에서 텍스트로 변환되며(whisper 같은 무료 음성-텍스트 도구 또는 자신의 OpenAI 또는 Groq 키 사용), 작업 수신함의 새 폴더에 TASK.md 파일로 저장됩니다. "task: ..."를 입력해도 됩니다. 예를 들어 오늘 밤 Nightcall 실행으로 즉시 시작하도록 할 수 있습니다. 음성-텍스트 도구가 아직 없으면 오디오는 보관되고 휴대폰에 설정 방법이 알려집니다.
목록에 추가한 Telegram 계정만 버튼을 누르거나 작업을 보낼 수 있습니다. 한 가지 명령어 steer.py install은 세션이 끝난 후에도 컴퓨터에서 리스너가 실행되도록 유지합니다. 보드 페이지는 또한 각 구독의 남은 양을 막대로 표시할 수 있습니다("Claude는 21:00까지 휴식 · Codex 72%"). Nightcall의 구독 미터에서 가져온 것입니다.
두 가지 내재된 습관
모든 승인 카드는 어떤 파일인지, 어떤 변경사항인지, 그리고 실행 취소가 가능한지 여부를 표시하므로, 휴대폰에서는 실제로 볼 수 있는 것만 결정하고, 그 외의 모든 것은 책상에서의 작업을 기다리며, 기다리는 것은 아무것도 잃지 않습니다. 그리고 거리에서의 음성 메모는 대기열(작업, 야간 작업 또는 인수인계 폴더)에 들어가며, 작업이 이를 처리할 때까지 그 말 그대로 보관됩니다. 환불처럼 추적해야 할 항목은 Chasecall로 이동합니다.
구체적인 예시
Dana는 Claude Code로 검토할 긴 문서가 있는 변호사입니다. 나가기 전에 그녀는 ready를 실행합니다. 이것은 셸 프로필이 원격 기능을 비활성화하는 변수를 설정하고 있으며, 그녀의 Mac이 10분 후에 절전 모드로 전환된다고 보고합니다. 그녀는 1분 안에 둘 다 해결하고, 휴대폰에서 공유 폴더로 사진을 보내 도착 여부를 확인한 후 나갑니다.
점심시간에 휴대폰의 게시판에 "당신을 기다리고 있습니다"라고 표시되고, 초인종은 1분 전에 그녀에게 같은 내용을 알렸습니다. 그녀는 4줄을 읽고 답변합니다. 오후에 두 번째 배치를 위해 설정한 야간 실행이 이름 아래에 "단계 5/8, 마지막: 계약 5 요약됨"으로 표시됩니다. 그녀는 조항을 빠뜨렸음을 깨닫고, 중지를 누르고, 봇에 10초 음성 메모를 녹음합니다: "모든 요약에 종료 조항을 추가해요." 그것은 집에서 과제로 정확히 그대로 대기합니다. 저녁에 그녀는 폴더에서 완성된 문서를 엽니다.
시작하는 방법
유료 Claude 구독(개인 또는 업무용)이 있는 Claude Code가 필요합니다. API 키(프로그램이 AI를 호출하기 위해 사용하는 액세스 코드)나 서버는 필요하지 않습니다. Claude Code에서 다음을 입력합니다:
/plugin marketplace add https://raw.githubusercontent.com/vadimchernets/poly-a1-plugins/main/.claude-plugin/marketplace.json
/plugin install pocketcall@poly-a1첫 번째 줄은 Poly A1 카탈로그를 링크로 추가합니다. git나 GitHub 계정이 필요하지 않습니다 (Claude Code 2.1.224 이상). 그 다음:
- "am I ready to leave?"라고 말하거나
ready를 실행하고, 지적한 사항을 수정합니다. - 처음에는
leave를 실행하고 Claude와 함께 6단계를 진행합니다. - 알림을 위해 휴대폰에 ntfy를 설치하고 Claude에게 토픽 이름을 알려주거나, 자신의 Telegram 봇을 연결합니다. Telegram 봇은 Continue, Stop 및 음성 작업도 제공합니다.
- 공유 폴더에서 보드 페이지를 요청하고 휴대폰의 홈 화면에 추가합니다.
플러그인 없이도 수동으로 확인할 수 있습니다: python3 scripts/check.py는 설정만 읽고 네트워크와 통신하지 않습니다. Pocketcall은 영어, 스페인어, 포르투갈어, 러시아어, 우크라이나어를 지원하며, Claude 로그인을 요청하지 않습니다. Team 또는 Enterprise 플랜에서 ready는 회사에 맞는 4가지 방법 중 하나를 선택합니다: 소유자가 활성화한 기본 제공 원격, 노트북이 절전 중에 실행되는 클라우드 세션, Tailscale을 통한 컴퓨터로의 터미널, 또는 승인 카드가 있는 회사의 자체 릴레이입니다.
어디서 왔는가
Pocketcall은 Vadym Chernets가 작성했으며 Apache-2.0 라이선스로 공개되었으며, 현재 버전 0.6.0이고 240개 이상의 자동화된 테스트와 Zenodo 아카이브(DOI 10.5281/zenodo.23107735)를 갖추고 있습니다. 이것은 Anthropic과 제휴되지 않은 독립적인 프로젝트입니다. 이는 밤새 긴 작업을 실행하고 같은 보드에 밤을 표시하는 Nightcall과 Claude가 변경하기 전에 모든 것의 사본을 유지하는 Safecall의 형제 프로젝트들과 잘 작동합니다. 이들 모두는 Poly A1 plugins 카탈로그에 있습니다. 코드는 github.com/vadimchernets/pocketcall에 있습니다.
Vadym Chernets는 또한 서로 다른 회사의 AI들이 서로의 작업을 확인하는 앱인 Poly A1을 개발하고 있습니다.