실행 프로그램과 확장

최종 업데이트

Unsloth Browser Use로 로컬 모델에게 브라우저를 맡기기

도구 호출 모델이면 페이지를 열고 폼을 채워요

Browser Use는 로컬 모델에게 브라우저 탭 하나를 맡기는 기능이에요. 도구 호출1을 지원하는 모델이면 되고, 비전 모델이면 스크린샷까지 봐요. 승인 없이 결제나 로그인이 진행되지 않고, localhost와 file:// 주소는 열리지 않아요.

실행 조건과 핵심 내용
  • 도구 호출 모델이면 로컬에서 브라우저를 조작해요.
  • 로그인·결제·다운로드는 기본이 승인 대기예요.
  • localhost와 file:// 주소는 열리지 않아요.
  • 비전 모델만 이미지와 차트를 읽어요.

브라우저를 쥔 로컬 모델

Browser Use는 채팅 옆에 브라우저 창을 하나 열고, 모델이 그 안에서 페이지를 넘기고 버튼을 누르게 해요. 도구 호출을 지원하는 모델이면 로컬에서도 돌아가요.

비전을 지원하는 모델은 스크린샷까지 봐요. 페이지 글자에 없는 이미지나 차트는 비전이 없으면 읽지 못해요.

클라우드 모델을 붙일 수도 있지만, 로컬 모델을 쓰는 이유는 페이지 내용이 밖으로 나가지 않는다는 점이에요.

작은 로봇 장치가 브라우저·달력·메시지 화면과 연결된 책상
모델은 자기 탭 하나만 봐요. 내가 쓰는 크롬 탭은 건드리지 않아요.

어떤 모델을 붙이나요

Browser Use는 모델을 고정하지 않아요. 도구 호출을 지원하고 기기 메모리에 들어가는 모델이면 되는데, 실제로는 호출을 안정적으로 만드는 쪽이 이겨요.

문서 예시는 Qwen3.8 27B를 쓰지만, 메모리가 8GB인 기기라면 2B나 4B급 도구 호출 모델로 시작해요. 화면의 이미지를 읽어야 하면 비전을 지원하는 모델을 골라요.

양자화2는 4비트면 충분해요. 브라우저 작업은 긴 문맥보다 짧은 호출을 여러 번 하는 일이라, 문맥을 크게 잡기보다 응답이 빠른 파일이 나아요.

되는 일과 안 되는 일

페이지 읽기와 링크 이동, 라벨이 있는 버튼 클릭, 폼 입력은 텍스트 모델도 해요. 이미지와 차트는 비전이 있어야 해요.

비밀번호와 결제 정보는 모델이 채우지 못해요. 업로드도 막혀 있어서, 민감한 입력은 사람이 직접 해요.

모델 종류에 따라 갈리는 일
작업텍스트 모델비전 모델
페이지 읽기와 링크 이동가능가능
라벨이 있는 버튼 클릭가능가능
이미지와 차트 확인불가스크린샷으로 가능
비밀번호와 결제 입력사람이 직접사람이 직접
파일 업로드불가불가
책상 위 노트북 화면에 Transformers.js가 동작하는 브라우저 창과 ONNX 모델이 보이는 장면
브라우저에서 모델을 돌리는 것과 브라우저를 조작하는 것은 달라요. 이 기능은 뒤쪽이에요.

설치하고 켜요

맥은 brew, 윈도는 winget으로 데스크톱 앱을 깔아요. 리눅스와 WSL은 설치 스크립트를 써요.

설치 명령
brew install --cask unsloth
winget install id UnslothAI.Unsloth
curl -fsSL https://unsloth.ai/install.sh | sh

모델 허브에서 도구 호출을 지원하는 모델을 고르고, 기기에 맞는 양자화를 받아요. 그다음 채팅 입력 옆 메뉴에서 Browser use를 켜면 돼요.

권한을 먼저 정해요

설정의 Browser 항목에서 사이트별 권한을 정해요. 처음에는 기본값을 좁게 두고, 자주 쓰는 사이트만 예외로 열어요.

전체 접근은 승인 창을 여러 개 건너뛰어요. 차단한 사이트와 다운로드는 그대로 막히고 스크립트도 여전히 승인을 받지만, 확인 단계가 줄어드는 만큼 필요한 작업에만 켜세요.

Browser 설정에서 정하는 것
설정정하는 것고를 수 있는 값
사이트 방문모델이 열 수 있는 사이트허용, 승인, 차단
동작 승인로그인·전송·구매 전 확인항상 확인, 전체 접근
다운로드허용·승인·차단허용, 승인, 차단
이름 없는 클릭캔버스처럼 라벨이 없는 영역 클릭차단, 허용
방문 기록모델이 내 기록을 읽을지먼저 물음, 항상 허용, 허용 안 함
스크립트매번 승인 후 실행매번 승인, 실행 안 함
노트북을 든 로봇과 열쇠가 걸린 열린 보관함, 잠든 고양이
결제와 로그인은 모델이 아니라 사람 몫으로 남겨 두세요. 승인 창이 마지막 방어선이에요.

막히는 지점

모델이 자기 탭에서만 움직여요. 크롬이나 사파리에서 열어 둔 탭은 조작하지 못하니, 주소를 채팅에 붙여 다시 열게 해요.

localhost, 사설망 주소, file:// 주소는 탐색 대상이 아니에요. 공개된 HTTP와 HTTPS 페이지만 열려요.

증상과 원인
증상원인해결
Browser use가 안 보여요도구 호출이 없는 모델이거나 모바일·비교 화면일반 채팅에서 도구 호출 모델로 바꿔요
설명만 하고 실행은 안 해요Browser use가 꺼져 있음한 번에 한 동작만 시켜요
페이지 일부가 안 열려요임베디드 콘텐츠나 캡차멈추고 직접 처리한 뒤 이어 가요
로컬 페이지가 안 열려요localhost와 file:// 차단공개 주소로 옮기거나 첨부 파일로 열어요

무엇에 약한가

도구 호출이 흔들리는 모델은 중간에 멈춰요. 페이지 구조가 복잡할수록 한 번에 여러 동작을 시키지 않는 게 나아요.

캡차와 임베디드 위젯, 캔버스 조작은 실패하기 쉬워요. 결제와 로그인을 자동화하려는 용도로는 쓰지 마세요.

앱 안의 기능이라 화면 구성이 바뀌면 절차도 달라져요. 브라우저 자동화를 서버에서 돌리려면 Playwright 같은 도구가 따로 필요해서, 이 앱을 서버용으로 권장하지 않아요.

모델이 페이지를 요약해 주는 것과 실제로 조작하는 것은 달라요. 요약만 필요하면 브라우저를 넘기지 않고 주소를 복사해 붙이는 편이 빨라요.

앱은 무료지만 모델 라이선스는 따로예요. 모델 카드에서 상업적 사용 조건을 확인해야 해요.

용어 각주

  1. 도구 호출 — 모델이 파일 읽기·검색·명령 실행 같은 외부 기능의 이름과 인자를 요청하는 형식입니다. 요청을 실제로 실행할지는 에이전트 런타임과 권한 설정이 결정합니다.

    본문으로 돌아가기
  2. 양자화 — 모델의 가중치나 계산값을 더 적은 비트로 표현해 저장 공간과 메모리 사용량을 줄이는 방법입니다. 표현 단계가 거칠어져 정확도에도 영향을 줄 수 있습니다.

    본문으로 돌아가기

자주 묻는 질문

이 글에서 가장 먼저 확인할 것은 무엇인가요?
Browser Use는 로컬 모델에게 브라우저 탭 하나를 맡기는 기능이에요. 도구 호출을 지원하는 모델이면 되고, 비전 모델이면 스크린샷까지 봐요. 승인 없이 결제나 로그인이 진행되지 않고, localhost와 file:// 주소는 열리지 않아요.
필요한 메모리는 어느 정도인가요?
문서 예시는 Qwen3.8 27B를 쓰지만, 메모리가 8GB인 기기라면 2B나 4B급 도구 호출 모델로 시작해요. 화면의 이미지를 읽어야 하면 비전을 지원하는 모델을 골라요.
선택하지 않는 편이 좋은 경우는 언제인가요?
앱 안의 기능이라 화면 구성이 바뀌면 절차도 달라져요. 브라우저 자동화를 서버에서 돌리려면 Playwright 같은 도구가 따로 필요해서, 이 앱을 서버용으로 권장하지 않아요.
조건과 출처는 어디서 확인하나요?
앱은 무료지만 모델 라이선스는 따로예요. 모델 카드에서 상업적 사용 조건을 확인해야 해요.