휴대폰으로 1DevTool 제어하기
LAN, Cloudflare 터널 또는 Tailscale로 Remote Control을 사용해 휴대폰에서 에이전트를 실행하고, diff를 검토하고, 계획을 승인하고, 팀을 지켜보세요.
Remote Control은 1DevTool이 실행 중인 컴퓨터를 들여다보는 창으로 휴대폰을 바꿔 줍니다. 소파에서 에이전트를 시작하고, 기차 안에서 diff를 검토하고, 입력을 기다리던 프롬프트에 답할 수 있습니다. 노트북을 열 필요가 없습니다. 모든 것은 내 컴퓨터에서 실행되며, 휴대폰은 리모컨일 뿐입니다.

켜기
- 데스크톱의 상태 표시줄에서 Remote Control을 열고 활성화합니다.
- 1DevTool이 비공개 URL과 QR 코드를 생성합니다. 휴대폰으로 코드를 스캔하거나 모바일 브라우저에서 URL을 엽니다.
- 안내에 따라 로그인합니다. 연결은 내 컴퓨터에 묶여 있어 본인만 접속할 수 있습니다.
세 가지 연결 모드
- Local Network — 휴대폰과 데스크톱이 같은 Wi-Fi에 있을 때 사용합니다.
- Cloudflare Tunnel — 안전한 Cloudflare 터널을 사용하므로 포트를 열거나 VPN을 설정할 필요가 없습니다.
- Tailscale / VPN — 휴대폰이 내 tailnet을 통해 데스크톱에 접속합니다.
Tailscale을 이미 쓰고 있다면 설정해 볼 가치가 있습니다. 공개 인터넷에 아무것도 노출되지 않고, 터널 준비 대기 시간이 없으며, iOS Safari를 그대로 사용할 수 있어 집 네트워크에서도 앱 내 스캐너 브라우저를 쓸 필요가 없습니다. 패널에는 Tailscale이 설치되어 있는지, 실행 중인지, 연결되어 있는지가 명확하게 표시되며, QR 코드와 페어링 URL도 tailnet 주소로 바뀝니다. tailnet에서 HTTPS를 활성화해야 하는 경우에는 안내에 따라 한 번만 진행하면 됩니다.
Start on Launch
Settings → Remote에서 Start on Launch를 켜면 1DevTool을 열 때마다 원격 서버가 시작되므로, 페어링된 휴대폰이 재시작이나 업데이트 후에도 자동으로 다시 연결됩니다. 스위치 옆의 배지에는 시작될 모드가 표시됩니다.
- Local Network — 앱이 열리면 바로 Wi-Fi에서 서버가 올라옵니다.
- Tailscale — 재부팅 후 Tailscale이 아직 연결 중이면 1DevTool이 최대 2분간 기다리며, 그동안에는 로컬 네트워크에서 서비스합니다.
- Cloudflare Tunnel은 공개 방식이므로 자동으로 시작되지 않습니다. 이 모드를 선택한 동안에는 스위치가 꺼져 있으며, 사용하려면 Local Network 또는 Tailscale을 선택하세요.

휴대폰 앱
앱 받기. iPhone과 iPad에서는 App Store에서 1DevTool을 설치하세요. 무료이며 iOS 17 이상이 필요합니다. Android에서는 Google Play에서 1DevTool을 설치하세요. 역시 무료이며 Android 8.0 이상이 필요합니다.
Settings → Remote에는 두 개의 탭이 있습니다. 이 페이지의 모든 내용에 해당하는 Web UI와, 아직 Beta 태그가 붙어 있는 Phone입니다. Phone 탭은 1DevTool 모바일 앱을 위한 호스트입니다. 호스트는 기본적으로 꺼져 있습니다. 켜면 로컬 네트워크 또는 Tailscale tailnet을 통해 Remote Control 포트에서 연결을 기다립니다. 연결은 종단 간 암호화되며 릴레이나 터널은 사용하지 않습니다. Cloudflare 터널은 브라우저 클라이언트 전용입니다.
Phone 탭에는 설정 가이드 Read how to install and use the 1DevTool mobile app beta → 링크도 있으며, 여기에서 읽을 수도 있습니다. 이 가이드는 베타 시절에 작성되었으므로 iPhone에서는 TestFlight 대신 App Store에서, Android에서는 초대 없이 Google Play에서 설치하세요. 나머지 설정 단계는 그대로 적용됩니다.
이 섹션에는 휴대폰이 접속할 수 있는 주소가 나열되고, 10분 후에 만료되는 Pairing code와 함께 Copy code, New code 버튼이 표시됩니다. 앱에서 Add computer를 선택하고 코드를 스캔하세요. 휴대폰은 Viewer로 페어링되며, 이후 1DevTool이 어떤 역할을 부여할지 묻습니다(Viewer, Approver, Operator, Admin). 터미널에 입력하려면 Operator 권한이 필요합니다. 코드 하나는 휴대폰 한 대만 페어링하며, 5번 실패하면 더 이상 사용할 수 없습니다. 한 주소에서는 분당 20번까지 페어링을 시도할 수 있고, 최대 32대의 휴대폰을 페어링할 수 있습니다. 페어링된 휴대폰은 플랫폼과 마지막 접속 시점과 함께 목록에 표시되며, 이름을 바꾸거나 역할을 변경하거나 Forget으로 삭제할 수 있습니다. 삭제하면 해당 휴대폰의 실시간 세션이 종료됩니다.
페어링은 일회용이며 처음에는 읽기 전용입니다
- QR 초대는 한 번만 사용할 수 있고 10분 후에 만료됩니다. 스캔하면 코드가 소모되고 새 코드로 교체되므로, 사진으로 찍어 둔 코드나 오래된 코드는 재사용할 수 없습니다. 페어링 응답 자체도 암호화되어 전달됩니다.
- 새 휴대폰은 Viewer로 연결됩니다(따로 설정하지 않은 경우). 파일과 대화 기록을 포함해 이 데스크톱의 워크스페이스를 읽을 수 있지만, 작업을 수행하려면 더 높은 역할이 필요합니다. 아래 권한을 참고하세요.
- QR 페어링의 역할을 기억하게 할 수 있습니다. 기기가 QR 코드를 스캔할 때 역할 대화상자에서 Don’t ask again을 선택하거나, Settings → Remote의 New QR Devices를 Ask every time 또는 고정 역할로 설정하세요. Viewer보다 높은 역할을 선택하면 먼저 확인을 요청합니다. 패스코드 로그인은 항상 묻습니다.
휴대폰이 페어링 상태로 유지되는 기간
Settings → Remote → Pairing Expiry에서 7 days, 30 days, 90 days max 중에서 선택할 수 있습니다. 무제한 자격 증명은 더 이상 없습니다.
브라우저 페어링은 어떤 옵션을 선택하든 페어링 후 최대 7일 뒤에 만료되며, 사용한다고 해서 갱신되지 않습니다. 매일 휴대폰을 사용해도 접근 기간이 늘어나지 않으며, 일주일이 지나면 다시 페어링해야 합니다. 설정을 바꾸면 기존 페어링의 기간이 짧아질 수는 있어도 길어지지는 않습니다.
HTTPS Remote URL에서는 브라우저가 페어링의 자기 쪽 절반을 추출할 수 없는 키로 보호된 저장소에 보관하므로, 페이지의 저장소를 읽는 스크립트가 이를 가져갈 수 없습니다. 일반 HTTP에서는 페어링이 해당 탭에서만 유지되어 새로고침하면 다시 페어링해야 하므로, HTTPS URL을 사용하는 것이 좋습니다.
연결되면 데스크톱에서 정리한 그대로 프로젝트가 휴대폰에 나타납니다. 프로젝트를 탭하면 해당 워크스페이스로 들어갑니다.
휴대폰에서 할 수 있는 일
Remote Control은 키보드에서 떨어져 있을 때 중요한 1DevTool의 기능을 그대로 보여 줍니다.
AI 에이전트에 프롬프트를 보내고 조종하기
프로젝트의 터미널을 열어 에이전트의 최신 출력을 읽고 새 프롬프트를 보낼 수 있습니다. 승인을 기다리며 대기 중인 에이전트도 마찬가지입니다. 다음 기능을 사용할 수 있습니다.
- 모바일에 맞춘 리더 모드에서 터미널 텍스트를 스크롤하고 복사
- 휴대폰의 이미지를 첨부하여 바로 프롬프트에 포함
- 저장소의 파일을 멘션하여 에이전트에 올바른 컨텍스트 제공
- 프롬프트 기록에서 이전 프롬프트 재사용

코드를 검토하고 Git으로 배포하기
프로젝트의 파일을 탐색하고, 커밋의 세부 정보를 열고, 휴대폰에서 diff를 검토하세요. 변경 사항이 괜찮아 보이면 스테이징하고, 메시지를 작성하고, 푸시하면 됩니다. 소스 제어의 전체 과정을 손바닥 위에서 처리할 수 있습니다.

API 테스트와 데이터베이스 쿼리
HTTP 요청을 보내고 응답을 확인하거나, 데스크톱에서 설정해 둔 컬렉션과 연결을 그대로 사용해 데이터베이스 쿼리를 실행할 수 있습니다. 저장한 요청은 휴대폰과 데스크톱 간에 동기화됩니다.

나중에 실행할 프롬프트 예약
Agent Input 프롬프트를 타이머, 특정 시각 또는 다음 할당량 초기화 시점에 실행되도록 대기열에 넣으세요. 자리를 비운 사이에 긴 작업을 시작하고, 돌아왔을 때 결과를 확인할 수 있습니다.

대화 기록을 제대로 읽기
Reader Mode는 에이전트의 대화를 문서처럼 다시 렌더링하므로 휴대폰으로도 내용을 따라잡기 편합니다. 사용자 메시지, 에이전트 결과, 코드, 원시 터미널 출력이 각각 다르게 스타일링되며, 라이트, 세피아, 다크 읽기 화면을 지원하고 기본값은 기기 테마를 따릅니다.

화면에 맞는 크기의 터미널
휴대폰에서 터미널을 열면 화면에 맞게 다시 배치됩니다. 터미널을 실제로 보고 있는 휴대폰이 너비를 결정하므로, 데스크톱 너비의 격자를 좌우로 밀어 볼 필요 없이 줄이 휴대폰 화면에 맞게 줄바꿈됩니다. 최신 출력과 에이전트의 입력창이 눈에 잘 보이는 위치에 놓입니다.
휴대폰 두 대가 동시에 보고 있으면 둘 다에 맞는 크기로 조정되고, 터미널을 닫는 순간 데스크톱 창은 원래 크기를 되찾습니다. 휴대폰이 연결되어 있는 동안 데스크톱 창에는 Sized for phone 배지와 Reader Mode로 가는 바로 가기가 표시됩니다. 읽기 전용 뷰어는 이전의 미러링 화면을 그대로 유지합니다.
페어링된 컴퓨터에서 실행되는 터미널도 같은 방식으로 동작합니다. Host 선택기로 열면 휴대폰의 너비에 맞춰지며, 텍스트 크기 바의 **A−**와 **A+**로 열 수를 바꿀 수 있습니다. 휴대폰이 너비를 차지하는 동안 해당 컴퓨터의 창에는 **Sized for phone · <phone> via <computer>**가 표시됩니다. 터미널에서 나가면 데스크톱 크기로 돌아갑니다. 페어링된 컴퓨터에서 이전 버전의 1DevTool이 실행 중이거나 내 접근 권한이 보기 전용이면 터미널은 해당 컴퓨터의 너비를 유지하며, 텍스트 크기 패널에 그 이유가 표시되고 Open Reader로 전체 줄을 읽을 수 있습니다.
주방에서 계획 승인하기
내 판단을 기다리는 작업에는 별도의 페이지가 있습니다. 계획을 읽고 Approve 또는 Request changes를 선택하세요. 입력한 내용은 에이전트에 그대로 전달되며, 자리를 비운 동안에는 아무것도 자동으로 승인되지 않습니다. Approval Gates를 참고하세요.
지도에서 팀 전체 보기
Maps 탭(Agents, Projects, Inbox 옆)은 각 프로젝트를 실시간 지도로 그립니다. 모든 에이전트 터미널은 하나의 책상이고, 두 에이전트 사이의 모든 링크는 선이며, 배치는 지휘 체계를 따릅니다. 조직도는 계층을 유지하고, 팀의 호스트는 구성원 위에 놓이며, 링크가 없는 에이전트는 지도 아래의 Not linked 목록에서 대기합니다.
- 프로젝트를 고르세요. Maps — Live terminals & links 아래의 칩에서 선택합니다. 요약 줄은 4 agents · 3 links · 4-seat org처럼 표시되며, 비어 있는 자리가 있으면 그것도 알려 줍니다.
- 책상을 읽으세요. 각 책상에는 역할과 상태가 표시됩니다(예: devin · running). 내 응답을 기다리는 책상(AI 실행이 방금 끝났거나 팀 구성원에 입력이 필요하다고 표시된 경우)은 표시되며, 헤더에 개수가 나타납니다. 3 needs you
- 선을 읽으세요. 실선은 활성 링크이고, 점선은 quarantined(격리된) 링크입니다. 터미널이 닫히거나 다시 시작되었거나, 세션이 교체되었거나, 에이전트 또는 worktree가 바뀌어서 일시 중단된 링크입니다. 직선은 양방향으로 메시지를 전달하고, 곡선은 한 방향으로만 전달합니다.
- 책상을 탭하면 해당 터미널이 휴대폰에서 열립니다.
- 링크 요청이 대기 중이면 1 link decision waiting — answer in Inbox라는 배너가 표시됩니다.
이전에 별도의 Team 탭이 있던 팀, 계층, 실행 보기는 지도 아래 Start 목록의 Teams, runs & logs에 있습니다. 같은 그림의 데스크톱 버전은 Team Map을 참고하세요.

저장된 팀 시작하기
데스크톱 Builder에서 저장한 조직도와 파이프라인을 휴대폰에서 시작할 수 있습니다. 프로젝트의 Orchestrate Agents 시트를 열고 Add Terminal → Orchestration을 선택하거나, Maps 탭에서 Start a team from a chart를 탭하세요.
각 차트는 역할 또는 단계와 열리는 터미널 수(opens 4)를 보여 주는 카드로 표시됩니다. Preview는 Builder와 같은 방식으로 그려 줍니다. 조직도는 역할 카드와 보고선으로, 파이프라인은 번호가 매겨진 단계로 표시됩니다. Start team은 모든 자리를 새 터미널로 열고 차트에 따라 이미 연결해 두며, 진행 중에는 *Opening 2/4 terminals…*라고 표시합니다.
- 휴대폰에서는 모든 자리가 새 터미널로 열립니다. 이미 열려 있는 터미널을 자리에 배정하는 것은 데스크톱에서만 가능합니다.
- 활성 자리가 있는 차트는 교체되지 않습니다. 해당 차트가 이미 프로젝트에서 실행 중이면 버튼이 비활성화되고 그 차트의 이름을 알려 줍니다. 중지하거나 교체하려면 데스크톱에서 하세요.
- 팀을 시작하려면 해당 기기에 Operator 권한이 필요합니다.
맞는 저장된 차트가 없나요? Plan a team from a goal을 사용하면 플래너가 구성원을 제안하며, 내가 승인하기 전에는 아무것도 실행되지 않습니다.
페어링된 컴퓨터에서 에이전트 시작하기
휴대폰의 Host 선택기에서 페어링된 컴퓨터를 고르고, 그곳의 프로젝트를 연 다음 Add Terminal을 선택하세요. 시트에는 해당 컴퓨터에서 감지된 AI 에이전트만 표시되며, Start on 뒤에 컴퓨터 이름이 붙은 버튼으로 에이전트를 시작합니다. 이를 위해서는 휴대폰의 Operator 또는 Admin 권한과 페어링된 컴퓨터의 Start terminals 권한 부여가 필요합니다.
그곳의 에이전트가 처음 실행 시 질문에서 멈추면, 휴대폰이 질문을 알려 주고 한 번의 탭으로 답할 수 있습니다.
| 에이전트 | 질문 | 버튼 |
|---|---|---|
| Codex | 이 폴더를 신뢰할지 여부 | Trust folder |
| Codex | 시작 전에 업데이트 | Skip update |
| Cursor Agent | 이 워크스페이스를 신뢰할지 여부 | Trust workspace |
| OpenCode | 시작 전에 업데이트 | Skip update |
| Devin | 이 폴더 작성자를 신뢰할지 여부 | Trust folder |
컴퓨터 간 대화 조종하기
두 컴퓨터에 있는 에이전트 간의 대화는 Inbox에 표시됩니다. Approver, Operator, Admin 기기는 Pause conversation, Resume, End, Deliver now를 사용할 수 있으며, 보기 전용 기기에는 데스크톱에서 일시 중지하거나 종료하라는 안내가 표시됩니다.
링크 요청과 대기 중인 메시지 승인하기
Inbox 탭에서는 휴대폰으로 링크 요청을 허용하거나 대기 중인 메시지를 내보낼 수 있으며, 탭하기 전에 무엇을 허용하는지 볼 수 있도록 권한 칩이 표시됩니다. Approver 기기가 결정하며, 보기 전용 기기는 요청을 볼 수 있지만 데스크톱에서 확인하라는 안내를 받습니다. 읽기 권한을 요청하는 링크는 승인하려면 데스크톱의 공개 범위 검토가 필요하기 때문에 휴대폰에서는 거부만 할 수 있습니다.
휴대폰에서 계층 구조 지켜보기
Teams, runs & logs는 활성 조직을 레벨별로 보여 줍니다. 호스트가 맨 위에, 구성원이 그 아래에 있으며, 각 책상은 데스크톱과 같은 오피스 모습으로 에이전트의 실제 상태에 따라 불이 들어옵니다. 빈 자리와 라우팅 위반도 표시됩니다. Approver 기기는 탭 한 번으로 자리를 다시 연결할 수 있습니다. Agent Hierarchy를 참고하세요.
오케스트레이션 실행 로그 읽기
최근 실행을 둘러보고, 실행의 파일을 열고, 책상으로 돌아가지 않고도 앱 로그를 읽을 수 있습니다.
AI 할당량 확인하기
AI Quota 섹션은 제공업체별, 계정별 여유량을 보여 주므로, 긴 작업을 시작하기 전에 밤새 버틸 수 있는지 판단할 수 있습니다. Accounts & Quota를 참고하세요.
스킬과 슬래시 명령
스킬 선택기도 휴대폰에서 사용할 수 있으므로, 스킬이나 슬래시 명령의 이름을 외워서 입력하지 않고도 삽입할 수 있습니다.

알림
활동 알림을 켜면 에이전트가 작업을 마치거나, 입력이 필요하거나, 오래 걸리는 명령이 끝났을 때 휴대폰이 알려 줍니다. 앱을 계속 열어 두지 않아도 다시 개입할 때를 알 수 있습니다.
권한
페어링된 모든 기기에는 역할이 있으며, 데스크톱의 Settings → Remote에서 기기별로 설정합니다.
| 역할 | 허용되는 작업 |
|---|---|
| Viewer | 파일과 대화 기록을 포함해 데스크톱의 워크스페이스를 읽습니다. 설정의 Remote에서 New QR Devices가 QR 페어링에 다른 역할을 지정하지 않는 한, 모든 새 페어링은 여기서 시작합니다. |
| Approver | 에이전트 작업과 작업 게이트를 승인합니다. 파괴적인 결과를 낳을 수 있습니다. |
| Operator / Admin | 이 데스크톱 워크스페이스에 대한 광범위한 명령 실행 및 쓰기 권한이며, localhost 포트 미리보기 열기를 포함합니다. |
기기를 Viewer보다 높은 역할로 올리려면 데스크톱에서 기기 이름과 수행할 수 있게 될 작업을 표시하는 확인 절차를 거칩니다. 기기의 역할을 낮추면 기존 수준을 유지하지 않고 실시간 연결이 즉시 끊어지며, 예약된 프롬프트는 실행 시점이 되면 기기의 권한을 다시 확인합니다. 이러한 역할이 생기기 전에 페어링된 기기는 Viewer로 초기화되었으며, 데스크톱이 이를 표시해 주므로 더 넓은 역할을 의도적으로 확인하여 부여할 수 있습니다.
localhost 포트 미리보기에는 Operator 또는 Admin이 필요하며, 각 미리보기는 페어링에 의존하지 않고 해당 포트에 대한 짧은 수명의 별도 권한을 받습니다. 권한이 만료되면 휴대폰이 미리보기를 다시 열라고 요청합니다.
데스크톱이 확인할 수 없는 전송은 무작정 재시도하지 않습니다. 프롬프트가 터미널에 도달했는지 휴대폰이 확인할 수 없으면 입력창에 Check terminal before resending이라는 경고가 표시되고, 작성 중인 내용은 그대로 유지되며, 원본 오류는 Details 뒤에 표시됩니다. 따라서 무심코 다시 시도해 프롬프트가 두 번 전송되는 일이 없습니다.
관련 문서
- AI 에이전트 실행하기 — 에이전트에 프롬프트를 보내고 오케스트레이션하는 데스크톱 쪽 사용법
- AI 사용량 및 할당량 — 사용량 표시가 휴대폰에도 나타납니다
- Reader Mode — 작은 화면에서 대화 기록 읽기
- Approval Gates — 어디서든 에이전트에 답하기
- Accounts & Quota — 할당량 섹션의 데스크톱 보기
- Paired Devices — 휴대폰이 아닌 두 번째 컴퓨터를 위한 같은 개념