원격 접속 (Cloudflare Tunnel)
원격 접속을 켜면 폰 브라우저나 다른 PC 에서 이 PC 의 AgentManager 를 그대로 씁니다. 연결은 Cloudflare Tunnel(cloudflared)을 거칩니다. 공유기 포트를 열 필요는 없습니다.
설정은 Settings > 원격 탭에서 합니다. 이 설정은 데스크톱 앱에서만 바꿀 수 있습니다.
3가지 모드
섹션 제목: “3가지 모드”| 모드 | 필요한 것 | 주소 |
|---|---|---|
| ⚡ 즉시 (토큰 X) | 없음 | 임의 xxx.trycloudflare.com, 재시작마다 바뀜 |
| 자동 (API 토큰) | Cloudflare API 토큰 + 내 도메인 | 서브도메인.내도메인 고정 |
| 수동 | Cloudflare Zero Trust 에서 발급한 터널 토큰 + 공개 URL | 직접 지정한 주소 |
즉시 모드
섹션 제목: “즉시 모드”처음 열리는 탭은 자동 모드입니다. ⚡ 즉시 (토큰 X) 탭을 고른 뒤 ⚡ 즉시 시작 을 누르면 끝입니다. 계정 · 도메인 · 토큰이 모두 필요 없습니다.
임시 터널이라 임시 tunnel · 성능 제한 안내가 붙습니다. 재시작할 때마다 주소가 바뀌고 대역폭이 낮습니다. 자주 쓰면 Named tunnel 로 전환 (고정 URL · 안정) 을 눌러 자동 모드로 옮기세요.
자동 모드
섹션 제목: “자동 모드”- Cloudflare API 토큰 입력 후 확인
- 도메인 선택 에서 도메인 고르기
- 서브도메인 (이 PC 식별용) 입력(자동 제안됨)
- 자동 셋업 + 시작
앱이 터널 생성 · 라우팅 · DNS 등록을 차례로 처리합니다. 진행 중에는 API 토큰 검증 중… → Cloudflare 터널 생성 중… → 라우팅 설정 중… → DNS 등록 중… → 저장 + 시작 중… 이 표시됩니다.
다른 도메인으로 바꾸려면 이 PC 터널 삭제 로 터널과 DNS 레코드를 지운 뒤 다시 셋업합니다.
수동 모드
섹션 제목: “수동 모드”Cloudflare 대시보드에서 직접 만든 터널을 씁니다. 공개 URL 과 터널 토큰 을 넣고 저장 후 시작. 앱 시작 시 자동으로 터널 실행 을 켜 두면 앱을 열 때 터널도 같이 뜹니다.
상태 확인
섹션 제목: “상태 확인”상태 뱃지는 중지됨 / 시작 중… / 실행 중 / 오류 중 하나입니다. 문제가 있으면 cloudflared 로그 를 펼쳐 최근 로그를 봅니다.
폰에서 접속 (모바일 웹)
섹션 제목: “폰에서 접속 (모바일 웹)”터널이 실행 중 이 되면 직접 접속 QR 보기 (앱 토큰 포함) 를 펼칩니다. 폰 카메라로 QR 을 찍으면 토큰이 자동으로 적용돼 바로 열립니다.
폰 브라우저에서는 모바일 화면이 뜹니다.
- 하단 탭: 채팅 / 프로젝트 / 설정
- 대화 보내기 · 중지, 세션 목록, Effort · Ultracode 같은 옵션은 ⋮ 메뉴
- 새 프로젝트는 절대 경로를 직접 입력 (폰에는 폴더 선택 창이 없음)
토큰 없이 주소만 열면 토큰 입력 화면이 먼저 나옵니다.
폰 완료 알림
섹션 제목: “폰 완료 알림”작업이 끝나면 폰으로 알림을 받을 수 있습니다. 알림 허브는 agentmanager-app.karnellabs.com 입니다.
- 터널을
실행 중으로 둔 상태에서 📱 폰 알림 연결 의 QR 을 폰 카메라로 찍기 - 폰에서 [앱 설치] → [알림 켜기]
- 짝지은 폰 N대 목록에 폰이 나타나면 완료
- 알림을 누르면 그 프로젝트 · 칸의 대화가 로그인된 채로 열립니다.
- PC 를 다시 켜서 주소가 바뀌어도 다시 찍지 않아도 됩니다.
- 알림은 각 PC 가 직접 보냅니다. 허브에는 대화 데이터가 남지 않습니다.
- 원격 접속이 https 주소여야 연결됩니다.
- Cloudflare Access 를 쓰고 있다면
/api/push/hub-subscribe,/api/push/ping두 경로를 Access 예외(bypass)로 추가해야 합니다.
안드로이드 실기에서 확인했습니다. iOS 는 아직 확인하지 않았습니다.
폰을 잃어버렸을 때
섹션 제목: “폰을 잃어버렸을 때”- 목록에서 그 폰의 해제 를 누릅니다. 해제할 때 모든 원격 기기 로그아웃 을 켜 두면 앱 토큰도 새로 발급합니다.
- 모든 원격 기기 로그아웃 은 앱 토큰을 새로 발급해 연결된 원격 화면을 모두 끊습니다. 짝지은 다른 폰은 다음 알림으로 다시 로그인됩니다.
보안 주의
섹션 제목: “보안 주의”원격 접속 토큰은 이 PC 에서 명령을 실행할 수 있는 권한과 같습니다. 토큰이 붙은 주소를 가진 사람은 AI 에게 일을 시키고 터미널을 열 수 있습니다.
- 토큰이 붙은 URL 은 공개 채널에 올리지 마세요. 공유할 때는 끝의
?token=…을 빼세요. - 가능하면 Cloudflare Access(이메일/SSO 로그인)를 함께 설정하세요.
- 토큰이 샜다고 의심되면 모든 원격 기기 로그아웃 으로 새 토큰을 받으세요.
허용 폴더
섹션 제목: “허용 폴더”허용 폴더 (원격 접속 시) 에 원격에서 쓸 폴더를 추가합니다. 원격 접속자는 이 폴더와 그 하위만 탐색하고 프로젝트로 등록할 수 있습니다. 이 PC 에서 직접 쓰는 화면은 영향이 없습니다.
목록이 비어 있으면 원격에서는 파일 읽기 · 쓰기 · 폴더 탐색이 거부됩니다. 원격에서 실제로 쓰려면 폴더를 하나 이상 넣으세요.
허용 폴더는 샌드박스가 아닙니다. 앱이 검사하는 것은 파일 화면과 터미널 · 대화의 시작 폴더뿐이고, 터미널 명령과 AI 가 실행하는 명령은 PC 사용자 권한으로 이 폴더 밖에도 접근할 수 있습니다.
원격에서 막힌 동작
섹션 제목: “원격에서 막힌 동작”| 동작 | 원격 제한 |
|---|---|
| 터미널 | 작업 폴더가 반드시 있어야 하고, 허용 폴더 안이어야 열림 |
| MCP 인증 콘솔 | 허용 폴더가 설정돼 있어야 열림 |
| MCP 서버 추가 | 막힘 (MCP 서버 추가는 PC 에서 해주세요) |
| Codex MCP 서버 허용 변경 | PC 앱에서만 가능 |
같은 PC 접속(루프백)
섹션 제목: “같은 PC 접속(루프백)”이 PC 안에서 127.0.0.1 로 들어오는 요청은 토큰 검사를 건너뜁니다. 한 사람이 쓰는 데스크톱을 위한 의도된 동작입니다.
여러 사람이 한 Windows 에 로그인하는 공유 PC 나 RDS(원격 데스크톱 서버) 환경에서는 위험합니다. 같은 머신의 다른 사용자도 토큰 없이 접속할 수 있기 때문입니다. 이 우회는 설정으로 끌 수 없으니, 이런 환경에 설치할 때는 이 점을 먼저 따져 보세요.