콘텐츠로 이동

원격 접속 (Cloudflare Tunnel)

원격 접속을 켜면 폰 브라우저나 다른 PC 에서 이 PC 의 AgentManager 를 그대로 씁니다. 연결은 Cloudflare Tunnel(cloudflared)을 거칩니다. 공유기 포트를 열 필요는 없습니다.

설정은 Settings > 원격 탭에서 합니다. 이 설정은 데스크톱 앱에서만 바꿀 수 있습니다.

모드 필요한 것 주소
⚡ 즉시 (토큰 X) 없음 임의 xxx.trycloudflare.com, 재시작마다 바뀜
자동 (API 토큰) Cloudflare API 토큰 + 내 도메인 서브도메인.내도메인 고정
수동 Cloudflare Zero Trust 에서 발급한 터널 토큰 + 공개 URL 직접 지정한 주소

처음 열리는 탭은 자동 모드입니다. ⚡ 즉시 (토큰 X) 탭을 고른 뒤 ⚡ 즉시 시작 을 누르면 끝입니다. 계정 · 도메인 · 토큰이 모두 필요 없습니다.

임시 터널이라 임시 tunnel · 성능 제한 안내가 붙습니다. 재시작할 때마다 주소가 바뀌고 대역폭이 낮습니다. 자주 쓰면 Named tunnel 로 전환 (고정 URL · 안정) 을 눌러 자동 모드로 옮기세요.

  1. Cloudflare API 토큰 입력 후 확인
  2. 도메인 선택 에서 도메인 고르기
  3. 서브도메인 (이 PC 식별용) 입력(자동 제안됨)
  4. 자동 셋업 + 시작

앱이 터널 생성 · 라우팅 · DNS 등록을 차례로 처리합니다. 진행 중에는 API 토큰 검증 중… → Cloudflare 터널 생성 중… → 라우팅 설정 중… → DNS 등록 중… → 저장 + 시작 중… 이 표시됩니다.

다른 도메인으로 바꾸려면 이 PC 터널 삭제 로 터널과 DNS 레코드를 지운 뒤 다시 셋업합니다.

Cloudflare 대시보드에서 직접 만든 터널을 씁니다. 공개 URL 과 터널 토큰 을 넣고 저장 후 시작. 앱 시작 시 자동으로 터널 실행 을 켜 두면 앱을 열 때 터널도 같이 뜹니다.

상태 뱃지는 중지됨 / 시작 중… / 실행 중 / 오류 중 하나입니다. 문제가 있으면 cloudflared 로그 를 펼쳐 최근 로그를 봅니다.

터널이 실행 중 이 되면 직접 접속 QR 보기 (앱 토큰 포함) 를 펼칩니다. 폰 카메라로 QR 을 찍으면 토큰이 자동으로 적용돼 바로 열립니다.

폰 브라우저에서는 모바일 화면이 뜹니다.

  • 하단 탭: 채팅 / 프로젝트 / 설정
  • 대화 보내기 · 중지, 세션 목록, Effort · Ultracode 같은 옵션은 ⋮ 메뉴
  • 새 프로젝트는 절대 경로를 직접 입력 (폰에는 폴더 선택 창이 없음)

토큰 없이 주소만 열면 토큰 입력 화면이 먼저 나옵니다.

작업이 끝나면 폰으로 알림을 받을 수 있습니다. 알림 허브는 agentmanager-app.karnellabs.com 입니다.

  1. 터널을 실행 중 으로 둔 상태에서 📱 폰 알림 연결 의 QR 을 폰 카메라로 찍기
  2. 폰에서 [앱 설치] → [알림 켜기]
  3. 짝지은 폰 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 안에서 127.0.0.1 로 들어오는 요청은 토큰 검사를 건너뜁니다. 한 사람이 쓰는 데스크톱을 위한 의도된 동작입니다.

여러 사람이 한 Windows 에 로그인하는 공유 PC 나 RDS(원격 데스크톱 서버) 환경에서는 위험합니다. 같은 머신의 다른 사용자도 토큰 없이 접속할 수 있기 때문입니다. 이 우회는 설정으로 끌 수 없으니, 이런 환경에 설치할 때는 이 점을 먼저 따져 보세요.