Orch termdocs
기능 검색…Ctrl K

대형 기능 · CDP 브라우저 미러 WebView2 CDP

CDP 브라우저 미러

대화 중인 AI가 브라우저로 웹을 탐색하면, 그 모든 동작(페이지 이동·클릭·입력)이 터미널 옆 인앱 브라우저 패널에 실시간으로 비칩니다. 앱 자신의 화면은 에이전트에게 보이지 않아 실수로 조작되지 않습니다.

무엇을 하는가

에이전트에게 웹 작업을 시키면 보통 무엇을 열었는지, 어디서 헤매는지 보이지 않습니다. 미러는 에이전트의 브라우저를 내 화면 안의 진짜 패널로 만들어, 일하는 모습을 어깨너머로 보듯 실시간 관찰하게 합니다. 에이전트는 그 패널만 보고 운전하며, 앱 자신의 UI는 보이지도 잡히지도 않습니다.

AI 에이전트
브라우저로 웹 탐색
미러
앱 내장 미러
앱 UI 숨김
새 페이지 → 인앱 탭
인앱 브라우저 패널
내 화면에 실시간 표시
에이전트 브라우저 — 패널에 미러 · 이어서 사용보임
앱 자신의 UI — 에이전트에게 숨김숨김

켜기

dev에서는 npm run dev:app으로 앱을 띄우면 미러가 항상 켜지고 에이전트 연결도 자동입니다(프록시 9522+base). 릴리즈에서는 설정 → 에이전트 브라우저 미러를 켜고 앱을 재시작하면 에이전트 세션이 자동으로 연결됩니다(기본 포트 9422, 설정에서 변경 가능). 켜져 있는 동안은 상태바에 미러 :포트가 표시됩니다.

orchterm — devmirror live
PowerShell
$ npm run dev:app [dev] base=0 vite=1420 bridge=9323 cdp=9222 proxy=9522 [mirror] proxy 127.0.0.1:9522 → 127.0.0.1:9222 [mirror] .mcp.json 패치 → orchterm-mirror @ :9522 $
미러 :9522 UTF-8 · CRLF
런처가 미러를 함께 띄우고 에이전트 연결을 자동 설정 · 상태바에 미러 :포트 표시.

에이전트 세션은 시작할 때 미러 연결을 읽습니다. 이미 떠 있던 세션은 한 번 재시작해야 미러에 붙습니다.

사용

"브라우저로 ○○ 열어서 확인해줘" 한마디면, 에이전트가 연 페이지가 떠다니는 임시 창이 아니라 정식 인앱 브라우저 탭으로 열리고, 이후 모든 이동·클릭·입력이 그 패널에 실시간으로 보입니다. 에이전트가 페이지를 바꾸면 내가 보던 화면도 따라 전환되고, 일을 마치면 그 탭은 사용자가 그대로 이어서 씁니다.

orchterm — 에이전트 ↔ 미러 패널미러 :9422
claude
example.com 열어서 페이지 제목 확인해줘 ▸ new_page https://example.com → 인앱 브라우저 탭 생성 + 자동 선택 ▸ take_snapshot → h1 "Example Domain" 제목은 "Example Domain"이에요. 오른쪽 패널에 그대로 떠 있어요.
Example Domain
https://example.com

Example Domain

This domain is for use in illustrative examples in documents. 에이전트가 연 페이지가 이 패널에 그대로 렌더됩니다.

More information →
에이전트가 연 페이지 = 정식 브라우저 탭. 이후 동작이 이 패널에 실시간 미러 — 끝나면 탭은 사용자 것.

한계 · 주의

멀티 에이전트는 Space 단위로 분리됩니다. 앱 터미널에서 띄운 에이전트는 자기 Space의 패널만 보고 운전하며, 새 페이지도 자기 Space에 열립니다. 단, 같은 Space 안의 에이전트끼리는 서로의 패널이 보이고, 터미널 탭을 다른 Space로 옮겨도 셸을 재시작하기 전까지는 옛 Space를 가리킵니다. 새 페이지는 한 번에 하나씩 열립니다(동시에 두 개를 열면 두 번째는 거부, 재시도 가능).

미러 모드는 브라우저 프로필이 분리됩니다 — 미러를 켜면 인앱 브라우저가 별도 프로필을 쓰므로, 일반 모드의 로그인·쿠키가 미러 모드로 이어지지 않습니다. 미러 모드에서 필요한 사이트는 다시 로그인해야 합니다.

참조

항목
프록시 포트dev 9522+base · 릴리즈 기본 9422 (설정 변경 가능)
켜기 / 끄기설정 → 에이전트 브라우저 미러 → 앱 재시작
멀티 에이전트Space마다 분리
미러 프로필미러 ON일 때 로그인·쿠키 별도 보관
상태 표시상태바 미러 :포트