휴대폰으로 코딩 에이전트와 작업하는 방법
호스트 컴퓨터, 휴대폰 승인, 변경 내용 검토, 재연결을 준비해 원격 코딩 작업을 이어 가세요.
휴대폰은 자리를 비웠을 때 코딩 에이전트에게 범위가 정해진 작업을 맡기고, 질문에 답하고, 작은 변경을 검토하는 데 유용합니다. 실제 작업은 컴퓨터에서 실행됩니다. 저장소, 개발 도구, 실행 중인 프로세스는 선택한 호스트에 남습니다.
쓸 만한 원격 작업 환경은 이 역할 구분이 명확합니다. 앱을 고르기 전에 명령이 실행되는 위치, 승인 요청을 받는 방법, 어느 기기든 연결이 끊겼을 때의 동작을 확인하세요.
작업에 맞는 연결 방식 선택하기
이미 Claude Code를 사용한다면 기본 Remote Control부터 확인하세요. 로컬 세션을 Claude 앱이나 브라우저에 연결하는 기능입니다. 다른 서비스를 추가하기 전에 현재 계정 및 버전 요구 사항을 읽으세요. 다른 에이전트 조합, 편집 기능, 프로젝트 관리가 필요할 때 별도 앱을 선택할 이유가 있습니다.
일부 클라이언트는 Agent Client Protocol, 즉 ACP로 에이전트에 연결합니다. 프로토콜 지원이 모든 에이전트 버전과 모든 클라이언트의 호환성을 보장하지는 않습니다. 휴대폰 운영체제, 컴퓨터 운영체제, 에이전트, 어댑터의 정확한 조합을 확인하세요. 비용을 비교할 때는 에이전트 자체 계정이나 API 요금도 포함하세요.
자리를 비우기 전에 컴퓨터 준비하기
호스트에서 프로젝트를 열고 먼저 그 컴퓨터에서 에이전트를 실행하세요. 키보드가 있을 때 로그인, 빠진 도구, 의존성 설치, 저장소 접근 문제를 해결하세요. 호스트에 필요한 도구가 없으면 원격 앱으로도 작업을 끝낼 수 없습니다.
새 변경에는 브랜치나 분리된 작업 복사본을 사용하세요. 기존 편집과 에이전트 작업을 구분할 수 있도록 시작 시점의 Git 상태를 기록하세요. 홈 디렉터리 전체 대신 필요한 파일이 들어 있는 프로젝트 폴더를 선택하세요.
전원과 네트워크 설정도 확인하세요. 휴대폰 연결이 끊겨도 유지되는 세션은 호스트가 깨어 있고 접근 가능해야 작동합니다. 푸시 알림이 전원이 꺼진 컴퓨터를 켜거나 회사 네트워크의 모든 제한을 통과한다고 가정하지 마세요.
검토할 수 있는 크기로 작업 맡기기
앱 전체를 개선하라는 넓은 지시보다 작고 명확한 요청이 휴대폰에 잘 맞습니다. 예를 들면 다음과 같습니다.
빈 검색을 제출하면 로딩 표시가 끝나지 않는 원인을 찾아줘. 먼저 원인을 설명해. 그다음 동작을 수정하고, 이 문제에 대한 회귀 검사를 추가하고, 변경한 파일을 알려줘. 커밋하거나 배포하지는 마.
이 요청은 무엇이 잘못되는지, 무엇을 조사할지, 에이전트가 무엇을 바꿔도 되는지, 언제 멈출지를 알려 줍니다. 문제를 재현하는 단계나 오류 메시지가 있다면 덧붙이세요. 관련 없는 정리 작업은 빼서 최종 diff를 읽기 쉽게 유지하세요.
일을 더 맡기 전에, 확신이 없을 때는 알려 달라고 에이전트에게 요청하세요. 수정에 예상하지 못한 데이터베이스 마이그레이션이나 계정 권한이 필요하다면 멈추고 결정하세요. 이해하지 못한 일련의 작업을 승인하지 마세요.
명령과 변경 내용 따로 검토하기
권한 요청은 작업을 실행해도 되는지 묻습니다. diff는 무엇이 바뀌었는지 보여 줍니다. 둘 다 필요합니다. 명령을 승인하기 전에 어느 폴더에서 실행되는지, 어떤 파일을 건드리는지, 컴퓨터 밖으로 무언가를 보내는지 확인하세요. 결과를 받아들이기 전에는 실제 변경을 원래 작업과 비교하세요.
다음 순서로 검토하세요.
- 원하는 프로젝트와 세션인지 확인합니다.
- 설명을 읽고 변경된 파일을 살펴봅니다.
- 실패와 생략된 검사까지 포함해 관련 테스트 결과를 확인합니다.
- 커밋, 병합, 배포는 각각 따로 결정합니다.
초록색 상태 표시는 근거를 살펴볼 이유이지, 건너뛸 이유가 아닙니다. diff가 크거나 자격 증명, 권한, 운영 데이터에 관련된 변경이라면 더 큰 화면에서 검토를 마치세요.
데이터를 바꾸지 않는 작업으로 재연결 시험하기
밖에서 이 작업 방식에 의존하기 전에 작은 읽기 전용 조사를 요청하세요. 휴대폰을 끊었다가 다시 연결해 같은 세션을 알아볼 수 있고 최신 상태를 읽을 수 있는지 확인하세요. 대기 중인 승인 요청이 재연결 후 어떻게 표시되는지도 살펴보세요.
출력이 멈추면 무슨 일인지 확인하세요. 휴대폰 연결이 끊겼는지, 컴퓨터가 잠자기 상태가 됐는지, 에이전트가 멈췄는지, 에이전트가 입력을 기다리는지 살펴봅니다. 가능하면 컴퓨터에서 직접 확인하세요. 같은 지시를 계속 보내지 마세요. 연결이 조용하다고 해서 이전 작업이 시작되지 않았다는 뜻은 아닙니다.
호스트 이름, 프로젝트 위치, 사용한 에이전트, 세션 확인 위치를 짧게 기록하세요. 여러 컴퓨터나 프로젝트를 다룰 때 도움이 됩니다.
Mono의 역할
Mono Code를 쓰면 휴대폰에서 컴퓨터의 터미널을 열고, 파일을 편집하고, Claude Code, Gemini CLI, OpenCode 같은 코딩 에이전트를 실행할 수 있습니다. 휴대폰 연결이 끊겨도 세션은 데스크톱에서 계속 실행됩니다. 하려는 작업에 내 에이전트와 기기가 지원되는지 확인하세요. 일은 여전히 컴퓨터가 하며, 기기 사이의 암호화된 연결이 AI 제공업체가 모델로 보낸 코드를 다루는 방식을 바꾸지는 않습니다. 이 차이는 AI 개인정보 보호와 암호화 동기화 가이드에서 설명합니다.
Mono는 현재 대기자 등록을 받고 있습니다. Mono 대기자 명단에 등록해 출시 소식을 받아 보세요. 그동안 현재 코딩 환경에 이 준비 및 검토 절차를 적용할 수 있습니다. 기본 원격 제어 기능이 이미 필요를 충족한다면 그 환경에서도 활용하세요.
