인앱 브라우저
터미널 옆의 브라우저 패널, 스스로 열리는 개발 서버, 그리고 에이전트가 페이지를 조작하게 하기.
⇧⌘B가 터미널 옆에 브라우저 패널을 엽니다. macOS에서는 Agentty 안의 WebKit 뷰, Windows에서는 Microsoft Edge WebView2(Chromium) 뷰이고, Linux에서는 기본 브라우저가 대신 열립니다. WebView2는 Windows 10·11에 기본으로 들어 있으며, 없는 PC에서는 브라우저를 열 때 Microsoft 공식 설치 파일을 받아 설치하도록 안내합니다.
여는 방법#
- 터미널의 링크를 ⌘-클릭(Windows·Linux는 Ctrl-클릭).
- 링크를 어디서 열지는 설정 → 브라우저에서 정합니다.
- 인앱 브라우저 (로컬 페이지만) — 개발 서버·로컬 페이지·파일은 여기서 열고, 웹 주소는 이미 로그인된 기본 브라우저에서 엽니다.
- 외부 기본 브라우저 — 모든 링크를 기본 브라우저에서 엽니다.
- 주소를 입력하거나 검색어를 입력합니다. 검색 엔진은 설정에서 바꿀 수 있습니다.
링크를 외부 기본 브라우저에서 열도록 하면 인앱 브라우저는 꺼집니다. 지구본 버튼이 사라지고, ⇧⌘B는 아무것도 열지 않으며, 파일 미리보기는 기본 브라우저에서 열리고, 에이전트는 브라우저 도구를 받지 않으며, 설정 → 브라우저에는 링크 선택만 남습니다. 플러그인 자체 페이지와 플러그인이 여는 로그인 창은 여전히 Agentty 안에서 열립니다.
개발 서버#
탭에서 시작한 로컬 서버는 워크스페이스 목록에 :포트 칩으로 나타나고, 페이지로 응답하는 즉시 패널에서 열립니다.
서버를 시작한 탭을 닫으면 서버도 종료됩니다. 두 동작 모두 설정 → 일반과 설정 → 브라우저에서 끌 수 있습니다.
반응형 모드#
주소창 옆 휴대폰 버튼을 누르면 페이지를 패널 크기가 아니라 기기 크기로 배치합니다. iPhone SE, iPhone 15 Pro, iPhone 15 Pro Max, Pixel 8, Galaxy S24, iPad mini, iPad Air, iPad Pro 12.9", Laptop, Desktop 중에서 고르거나, 너비와 높이를 직접 입력해도 됩니다. 페이지는 패널에 남은 공간에 맞춰 가운데 정렬되고 축소되므로 너비 1920의 데스크톱 레이아웃도 좁은 패널에서 알아볼 수 있습니다. 회전은 두 숫자를 맞바꾸고, 오른쪽이나 아래쪽 가장자리를 끌면 직접 크기를 조절합니다.
끄면 페이지가 패널 본래의 너비로 돌아갑니다.
크롬 로그인 정보로 로그인#
macOS에서 페이지가 로그인을 요구하면, 페이지 위에 뜨는 바에서 Google Chrome에 이미 있는 로그인 정보를 쓸지 물어봅니다. 앞으로 항상을 고르면 그다음부터 알아서 찾아오고, 이번만은 이번 한 번만, 아니요는 Agentty를 다시 켤 때까지 그 사이트를 묻지 않습니다. 처음에는 macOS가 크롬 저장소 키를 Agentty에 허용할지 물어봅니다. 허용을 눌러 주세요.
- 성공하면 페이지가 로그인된 상태로 다시 열리고, 어느 크롬 프로필에서 가져왔는지 바에 표시됩니다.
- 크롬 정보로 로그인되지 않으면 페이지가 블러 처리되어 가려지고, 크롬에서 인증을 완료하면 보통 1분 안에 저절로 연동됩니다. 직접 인증하기를 누르면 페이지가 돌아와 여기서 로그인할 수 있고, 크롬에서 열기를 누르면 그 페이지가 크롬에서 열립니다.
- 여기서 로그아웃하면 30분 동안은 저절로 다시 불러오지 않고 바에서 먼저 물어봅니다.
설정 → 브라우저 → 로그인에서 물어보기·항상·끄기와, 프로필이 여럿일 때 쓸 크롬 프로필을 고를 수 있습니다. 따로 고르지 않으면 최근에 쓴 프로필부터 시도하고, 로그인되지 않으면 다음 프로필을 시도합니다.
복사하는 것은 브라우저가 그 사이트에 보내는 쿠키뿐이며, 인앱 브라우저로 들어갑니다(터미널별로 분리한 경우 그 터미널의 쿠키로). 플러그인 페이지와 비공개 모드에서는 읽지 않습니다. 에이전트는 바에 대신 답하거나 특정 사이트를 요청할 수 없고, browser_status의 signIn으로 진행 상황만 봅니다. 다만 항상으로 두면 누가 열었든 로그인 페이지만으로 충분합니다. 에이전트가 로그인 페이지를 열었을 때 크롬이 그 사이트에 로그인되어 있으면, 보고 있지 않은 탭에서도 그대로 들어가 그 세션으로 동작합니다. 매번 직접 정하려면 물어보기로 두세요.
로그인을 만든 브라우저에 묶어 두고 복사본을 거부하는 사이트도 있습니다. 그런 곳은 여기서 한 번 로그인해 주세요. Windows에서는 쓸 수 없습니다. Windows의 크롬은 키를 크롬 자체에 묶어 둡니다.
에이전트가 조작하게 하기#
Claude Code와 Codex는 MCP로 이 브라우저를 조작할 수 있습니다(클릭, 입력, 콘솔 읽기, 스크린샷). 에이전트는 이렇게 실행 중인 페이지에서 자기 작업을 확인합니다.
에이전트가 받는 도구는 다음과 같습니다.
| 도구 | 하는 일 |
|---|---|
browser_open | 이 터미널의 탭을 엽니다(처음이면 새로 만듦). 원하면 URL을 불러옵니다 |
browser_navigate | URL, 호스트:포트, 또는 검색어를 불러옵니다 |
browser_status | 현재 URL·제목과 로딩 중인지 여부 |
browser_wait_load | 로딩이 끝날 때까지 대기 |
browser_click | 요소 클릭 |
browser_console | 페이지의 콘솔 출력 읽기 |
browser_screenshot | 페이지 캡처 |
browser_viewport | 기기 크기·WxH·off로 페이지 배치 |
browser_close | 이 터미널의 탭 닫기 |
Agentty가 에이전트를 시작할 때 함께 등록하므로 따로 설치하거나 설정할 것이 없습니다. 전형적인 흐름은 이렇습니다. 에이전트가 개발 서버를 띄우고 페이지를 열어 방금 만든 변경을 클릭해 봅니다. 그다음 콘솔에서 오류를 읽고 발견한 것을 고칩니다.
터미널마다 브라우저 하나#
터미널마다 브라우저가 따로 있습니다. 한 터미널의 브라우저에서 어떤 사이트를 보고 다른 터미널의 브라우저에서 다른 사이트를 보았다면, 터미널을 선택할 때마다 그 터미널의 브라우저가 보던 그대로 나타납니다. 브라우저를 연 적 없는 터미널에서는 패널이 닫혀 있습니다. 보이지 않는 터미널의 페이지도 로딩, 스크립트, 스크린샷이 계속 동작합니다. 내가 보고 있지 않아도 작업이 멈추지 않습니다.
- 링크와 서버는 그 터미널로 갑니다. 터미널에서 누른 링크, 그 터미널이 띄운 서버의 포트 칩, 저절로 열리는 서버 페이지는 모두 그 터미널의 브라우저에 열립니다. 다른 작업공간 카드의 포트 칩을 누르면 그 터미널이 선택됩니다.
- 에이전트는 그 터미널 브라우저 안의 자기 탭에서 일합니다. 처음
browser_open때 생기며 터미널의 폴더와 번호(app #3)로 표시됩니다. 그 에이전트의 모든 조작은 이 탭에만 적용되고, 다른 터미널의 페이지나 직접 연 페이지, 플러그인의 페이지는 바꾸지 않습니다. 페이지는 화면에 있든 없든 1280px(또는browser_viewport로 정한 크기)로 배치됩니다. 보일 때는 패널에 맞게 축소만 되므로 패널 폭에 따라 결과가 달라지지 않습니다. - 한도로 가볍게 유지합니다. 화면 밖에서 실행되는 터미널 브라우저는 최대 6개, 모든 인앱 브라우저 페이지가 함께 쓰는 메모리는 이 컴퓨터 메모리의 최대 30%입니다(둘 다 설정 → 브라우저). 어느 쪽이든 넘으면 화면 밖 브라우저를 가장 오래전에 본 것부터 메모리에서 내립니다. 화면에 보이는 브라우저와 에이전트가 최근 2분 안에 명령을 보낸 브라우저는 내리지 않습니다. 내린 페이지는 주소를 기억해 두었다가, 그 터미널을 선택하거나 에이전트가 명령을 보내면 다시 불러옵니다(이때 명령은 로딩이 끝난 뒤 실행됩니다).
- 패널을 닫으면 그 터미널의 브라우저가 숨겨지고, 다시 열면 그대로 돌아옵니다. 터미널을 닫으면 그 브라우저도 닫힙니다.
- 쿠키와 로그인 상태는 공유되므로 사이트에 한 번만 로그인하면 됩니다. 에이전트 탭마다 쿠키를 따로 쓰려면 설정 → 브라우저 → 터미널마다 쿠키·로그인 세션 분리를 켜세요(macOS 14 이상, Windows는 WebView2 런타임 101 이상). 터미널을 닫으면 그 쿠키도 지워집니다.
이 브라우저는 이용자가 로그인해 둔 세션을 유지합니다. 에이전트가 조작하면 그 세션 안에서 동작합니다. 필요할 때 쓰시되 어떤 탭이 열려 있는지 알고 계시기 바랍니다.