인앱 브라우저
터미널 옆의 브라우저 패널, 스스로 열리는 개발 서버, 그리고 에이전트가 페이지를 조작하게 하기.
⇧⌘B가 터미널 옆에 브라우저 패널을 엽니다. macOS에서는 Agentty 안의 WebKit 뷰이고, Windows와 Linux에서는 기본 브라우저가 대신 열립니다.
여는 방법#
- 터미널의 링크를 ⌘-클릭(Windows·Linux는 Ctrl-클릭).
- 설정 → 일반에서 ⌘-클릭이 인앱 브라우저를 쓸지 기본 브라우저를 쓸지 정합니다.
- 주소를 입력하거나 검색어를 입력합니다. 검색 엔진은 설정에서 바꿀 수 있습니다.
개발 서버#
탭에서 시작한 로컬 서버는 워크스페이스 목록에 :포트 칩으로 나타나고, 페이지로 응답하는 즉시 패널에서 열립니다.
서버를 시작한 탭을 닫으면 서버도 종료됩니다. 두 동작 모두 설정 → 일반과 설정 → 브라우저에서 끌 수 있습니다.
에이전트가 조작하게 하기#
Claude Code와 Codex는 MCP를 통해 이 브라우저를 조작할 수 있습니다. 클릭, 입력, 콘솔 읽기, 스크린샷입니다. 에이전트가 실행 중인 페이지에서 자기 작업을 확인하는 방법입니다.
에이전트가 받는 도구는 다음과 같습니다.
| 도구 | 하는 일 |
|---|---|
browser_open | 패널을 열고, 원하면 URL을 불러옵니다 |
browser_navigate | URL, 호스트:포트, 또는 검색어를 불러옵니다 |
browser_status | 현재 URL·제목과 로딩 중인지 여부 |
browser_wait_load | 로딩이 끝날 때까지 대기 |
browser_click | 요소 클릭 |
browser_console | 페이지의 콘솔 출력 읽기 |
browser_screenshot | 페이지 캡처 |
browser_close | 패널 닫기 |
Agentty가 에이전트를 시작할 때 함께 등록하므로 따로 설치하거나 설정할 것이 없습니다. 전형적인 흐름은 이렇습니다. 에이전트가 개발 서버를 띄우고, 페이지를 열고, 방금 만든 변경을 클릭해 보고, 콘솔에서 오류를 읽고, 발견한 것을 고칩니다.
Important
이 브라우저는 이용자가 로그인해 둔 세션을 유지합니다. 에이전트가 조작하면 그 세션 안에서 동작합니다. 필요할 때 쓰시되, 어떤 탭이 열려 있는지 알고 계시기 바랍니다.