Page Assist 실전 활용: 로컬 및 클라우드 모델로 익히는 일상 브라우저 워크플로우 네 가지

AIHubMix9분 분량
Page Assist 실전 활용: 로컬 및 클라우드 모델로 익히는 일상 브라우저 워크플로우 네 가지

대부분의 AI 채팅 도구는 자체 탭에서 동작합니다. 페이지에서 텍스트를 복사해 채팅창에 붙여넣고, 답변을 다시 복사해 와야 합니다. Page Assist는 이 번거로운 과정을 없앱니다. 이 오픈소스 브라우저 확장 프로그램은 읽고 있는 페이지 옆 사이드바에서 모델을 열어주고, 더 긴 대화를 위한 전체 탭 웹 UI도 제공합니다.

이 도구는 Ollama에서 실행되는 로컬 모델을 위한 프런트엔드로 시작했고, 지금도 기본값은 그대로입니다. 하지만 OpenAI 호환 엔드포인트도 모두 지원하므로, 같은 사이드바에서 노트북의 소형 모델과 클라우드의 프런티어 모델을 전환할 수 있습니다. 이 가이드에서는 사람들이 실제로 사용하는 네 가지 워크플로우를 살펴보고, 각 워크플로우에서 어떤 기능을 켜야 하며 로컬 모델과 클라우드 모델 중 무엇이 더 잘 맞는지 설명합니다.

Page Assist 한눈에 보기

아래 수치는 2026년 10월 8일 기준 GitHub 저장소와 Chrome 웹 스토어 등록 정보에서 가져왔습니다.

  • 라이선스 및 비용: MIT 라이선스, 무료. 독립 개발자(n4ze3m)와 커뮤니티 기여자들이 만들었습니다.
  • 채택 현황: GitHub 스타 약 8,200개, 사용자 30만 명, Chrome 웹 스토어 평점 4.8점.
  • 출시 주기: 매주. 2026년 10월 8일 출시된 1.5.86 버전에서 사전 설정 제공업체 목록에 AIHubMix가 추가되었습니다.
  • 지원 브라우저: Chrome, Brave, Edge, Vivaldi, Firefox, LibreWolf, Zen. Opera와 Arc에서는 웹 UI만 사용할 수 있고 사이드바는 지원되지 않습니다.
  • 개인정보 보호: 텔레메트리 없음. 채팅 기록, 설정, 지식 베이스 임베딩은 모두 브라우저 저장소에 보관됩니다.

Chrome 웹 스토어에서 설치할 수 있습니다(Firefox와 Edge는 각각 별도의 부가기능 페이지가 있습니다). 첫날 익혀두면 좋은 단축키가 두 개 있습니다. Ctrl+Shift+Y는 사이드바를 열고, Ctrl+Shift+L은 웹 UI를 엽니다.

워크플로우별 필요 조건

워크플로우기능필요 조건적합한 모델
긴 페이지 읽기Chat with Website채팅 모델긴 페이지에는 클라우드
선택한 텍스트 다시 쓰기Copilot 메뉴채팅 모델로컬로 충분함
내 파일에 질문하기Knowledge Base채팅 + 임베딩둘 다 가능
모델이 직접 작업 수행하기Page Action / MCP도구 호출 가능 모델클라우드

"적합한 모델"은 하나의 기준일 뿐 규칙이 아닙니다. 좋은 GPU에서 돌아가는 성능 좋은 로컬 모델이면 네 가지 행을 모두 감당할 수 있습니다.

최초 1회 설정: 로컬 모델과 클라우드 제공업체

로컬: Ollama 자동 감지

Ollama가 localhost:11434에서 실행 중이면 Page Assist가 별도 설정 없이 이를 찾아 내려받은 모든 모델을 목록으로 보여줍니다. 메시지를 보낼 때 403 오류가 나타나면 CORS 문제입니다. 설정 → Ollama Settings에서 사용자 지정 origin 옵션을 켜거나, OLLAMA_ORIGINS=*를 설정한 뒤 Ollama를 다시 시작하세요.

클라우드: 제공업체 목록에서 AIHubMix 선택

AIHubMix는 Page Assist에 기본 제공되는 제공업체입니다. 1.5.86 버전부터 OpenAI, DeepSeek 등과 함께 제공업체 드롭다운에 있으므로 URL을 직접 입력할 필요가 없습니다. 설정 흐름은 Page Assist의 OpenAI 호환 제공업체 가이드를 따릅니다.

  1. AIHubMix 콘솔에서 API 키를 만드세요(위치는 빠른 시작 문서에 나와 있습니다).
  2. Page Assist에서 설정 → OpenAI Compatible API → Add Provider를 엽니다.
  3. 드롭다운에서 AIHubMix를 선택하세요. Base URL https://aihubmix.com/v1은 자동으로 채워집니다.
  4. API 키를 붙여넣고 저장하세요.
  5. AIHubMix에서 가져온 모델 목록이 나타납니다. 검색한 뒤 원하는 채팅 모델을 체크하고, 유형은 Chat Model로 둔 채 저장하세요.

확장 프로그램에 키를 붙여넣기 전에 확인하고 싶다면, 요청 한 번이면 충분합니다. Page Assist는 AIHubMix와 동일한 Chat Completions 엔드포인트를 통해 통신합니다.

curl https://aihubmix.com/v1/chat/completions \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "auto", "messages": [{"role": "user", "content": "ping"}]}'

auto는 AIHubMix의 실제 모델 이름입니다. 요청마다 LLM Router가 모델을 선택하며(기본값은 비용 우선이고, 품질 우선·지연 시간 우선 변형도 있습니다) 실제로 사용된 모델에 과금합니다. 직접 고르고 싶지 않다면 Page Assist 모델 중 하나로 auto를 추가하는 것이 무난한 기본값입니다. 특정 모델을 골라 가격을 비교하려면 모델 목록을 살펴보세요.

임베딩 모델: 네 가지 워크플로우 중 두 가지에 필요

Knowledge Base와 Chat with Website의 기본 모드에는 임베딩 모델이 필요합니다. 설정 → RAG Settings에서 지정하세요. 로컬에서는 Page Assist가 Ollama를 통해 nomic-embed-text를 추천합니다. AIHubMix를 쓰는 경우 임베딩 모델도 채팅 모델과 같은 모델 목록에 있습니다. 제공업체의 모델 목록을 다시 열고 gemini-embedding-001 같은 임베딩 모델을 체크한 뒤, 유형을 Embedding Model로 설정해 저장하세요. 그러면 RAG Settings 드롭다운에 나타납니다.

워크플로우 1: 페이지를 떠나지 않고 긴 글 읽기

기사, 문서 페이지, 또는 GitHub 이슈 스레드에서 사이드바를 열고 Chat with Website를 켜세요. 이제 "여기서 주요 논점 세 가지는 무엇인가요?" 또는 "14번 댓글의 오류를 고치는 설정 옵션은 무엇인가요?"라고 물을 수 있고, 모델은 현재 보고 있는 페이지를 기준으로 답합니다.

페이지가 모델에 전달되는 방식은 두 가지이며, 그 차이가 중요합니다.

  • 임베딩 모드(기본값): 페이지를 여러 청크로 나누어 임베딩하고, 관련성이 높은 청크만 모델에 전달합니다. 작은 컨텍스트 창에서도 동작하지만, 페이지 전체에 걸친 내용은 놓칠 수 있습니다.
  • 일반 모드: 페이지 텍스트를 그대로 보냅니다. Retrieval Settings에서 "Enable Embedding and Retrieval"을 끄고 "Maximum Content Size for Full Context Mode"를 높이세요. 요약이나 "A 섹션과 D 섹션을 비교하라"는 질문에 더 적합하지만, 긴 컨텍스트 창을 지원하는 모델이 필요합니다.

두 번째 모드에서 클라우드 모델의 가치가 드러납니다. 긴 사양서나 댓글 200개짜리 스레드도 대용량 컨텍스트를 지원하는 클라우드 모델에는 여유 있게 들어가지만, 작은 로컬 모델은 페이지를 잘라내야 합니다.

함께 알아두면 좋은 기능이 세 가지 있습니다.

  • @tab 멘션: @를 입력하면 열려 있는 다른 탭을 같은 질문에 끌어올 수 있습니다. 예를 들어 두 가격 페이지를 비교할 때 쓸 수 있습니다. 먼저 설정에서 활성화해야 합니다.
  • YouTube 요약 버튼: YouTube 동영상 페이지에 표시되는 선택적 버튼으로, 누르면 사이드바가 열리고 페이지의 자막을 바탕으로 동영상을 요약합니다.
  • 비전: 내용이 주로 이미지나 차트로 된 페이지에서는 눈 아이콘을 눌러 페이지 스크린샷을 비전 기능을 지원하는 모델에 보낼 수 있습니다. 비전을 지원하지 않는 모델은 OCR로 대체할 수 있는데, Page Assist 공식 문서에서는 이를 기본적인 수준이라고 설명합니다.

워크플로우 2: 텍스트 선택, 우클릭, 끝

Copilot 메뉴는 이 확장 프로그램에서 가장 빠른 워크플로우입니다. 아무 페이지에서나 텍스트를 선택하고 우클릭한 뒤 Page Assist 아래의 작업을 고르세요. 기본으로 Summarize, Rephrase, Translate, Explain, Custom 다섯 가지가 제공됩니다.

진짜 가치는 Custom Copilot Prompts(설정 → Manage Prompts → Custom Copilot)에 있습니다. 각 프롬프트는 제목과, 선택한 텍스트가 들어갈 자리에 {text}를 넣은 템플릿으로 구성되며, 각각 자체 우클릭 메뉴 항목이 됩니다. 금방 효과를 보는 몇 가지 예시는 다음과 같습니다.

Title: Reply in plain English
Prompt: Rewrite the following so a non-native speaker can follow it. Keep it under 80 words.

{text}
Title: Find the claim
Prompt: List each factual claim in the following text and mark the ones that need a source.

{text}

이런 작업은 짧고 자주 발생하므로 로컬 모델이 잘 맞는 영역입니다. 요청당 비용이 없고 네트워크 왕복도 없으며, 선택한 텍스트가 사용자 기기 밖으로 나가지 않습니다. 길거나 실질적인 추론이 필요한 선택 영역(복잡한 계약 조항, 낯선 코드 블록 등)에는 클라우드 모델을 사용하세요.

기본 제공 Translate 프롬프트는 영어로 번역합니다. 주로 다른 언어로 읽는다면 기본 프롬프트를 편집하거나 원하는 대상 언어로 사용자 지정 프롬프트를 추가하세요.

워크플로우 3: 내 파일에 대해 질문하기

Knowledge Base를 사용하면 PDF, Word 문서, 텍스트, CSV, Markdown 파일을 대화 가능한 대상으로 만들 수 있습니다. 설정 → Manage Knowledge → Add New Knowledge로 이동해 파일을 업로드하고 처리가 끝나기를 기다리세요. 그다음 채팅 입력창의 지식 아이콘으로 사용할 컬렉션을 고를 수 있습니다.

대용량 폴더를 업로드하기 전에 알아둘 점이 두 가지 있습니다.

  • 모든 데이터는 브라우저 안에서 처리되고 저장됩니다. Page Assist는 데이터가 많을 경우 성능 문제가 생길 수 있다고 경고합니다. 전체 아카이브 대신 필요한 파일만 추린 집합으로 시작하세요.
  • 검색 품질은 채팅 모델보다 임베딩 모델에 더 좌우됩니다. 답변이 명확한 구절을 계속 놓친다면 채팅 모델을 바꾸기 전에 더 성능 좋은 임베딩 모델을 시도해 보세요.

여기서 로컬과 클라우드 중 무엇을 고를지는 대부분 문서의 성격에 달려 있습니다. 웹 서비스에 붙여넣고 싶지 않은 내부 파일이라면 로컬 임베딩과 로컬 채팅 모델을 조합한 완전 로컬 구성이 적합합니다. 공개 논문이나 제품 문서는 어느 쪽이든 괜찮습니다.

워크플로우 4: 모델이 페이지에서 직접 작업하게 하기

최신 워크플로우는 읽기를 넘어섭니다. 두 기능이 모델에 도구를 제공합니다.

  • Page Action은 Chromium 기반 브라우저용 별도 보조 확장 프로그램입니다. 활성화하면(사이드바의 커서 아이콘) 모델이 현재 탭을 읽고, 클릭, 입력, 스크롤, 이동, 양식 작성을 한 단계씩 수행할 수 있습니다. Chrome의 debugger 권한이 필요해서 별도로 제공되며, 대부분의 사용자는 이 권한을 줄 필요가 없습니다. 설정 방법은 Page Action 문서를 참고하세요.
  • MCP를 사용하면 Bearer 토큰 또는 OAuth 2.1 인증으로 Streamable HTTP를 통해 원격 MCP 서버에 연결할 수 있습니다. STDIO 서버는 supergateway로 HTTP에 연결할 수 있습니다.

두 기능 모두 승인 스위치가 있습니다. Page Action은 "Require approval before each action"이 기본으로 켜져 있습니다. MCP는 반대로 "Require approval before running MCP tools"를 켜기 전까지 승인 없이 도구가 실행되며, 켠 뒤에는 각 도구를 Allow, Human in loop, Disable 중 하나로 설정할 수 있습니다. 양식 제출, 메시지 발송, 데이터 쓰기를 하는 작업에는 승인 기능을 계속 켜 두세요.

이 워크플로우는 모델 선택이 가장 중요한 영역입니다. 여러 단계의 도구 사용에는 도구 스키마를 안정적으로 따르고 잘못된 단계에서 복구할 수 있는 모델이 필요하며, 실제로는 성능이 뛰어난 클라우드 모델을 의미합니다. 작은 로컬 모델은 자주 멈추거나 동작을 반복하곤 합니다.

로컬이냐 클라우드냐: 빠른 판단 기준

  • 로컬을 선택하세요 텍스트가 비공개이거나, 작업이 짧거나(다시 쓰기, 번역, 간단한 설명), 추가 비용을 전혀 원하지 않을 때입니다.
  • 클라우드를 선택하세요 페이지가 길거나, 문서 전체에 걸친 추론이 필요하거나, 모델이 도구를 사용해야 할 때입니다.
  • 무엇을 보내는지 주의하세요: Page Assist 자체는 아무 정보도 수집하지 않지만, 클라우드 제공업체로 보내는 내용은 사용자의 기기를 벗어납니다. AIHubMix는 프롬프트나 응답 내용을 저장하지 않으며, 토큰 수와 같은 요청 메타데이터만 저장한다고 밝히고 있습니다. 상위 모델 제공업체마다 각자의 데이터 보관 정책이 있습니다.

두 종류의 모델이 같은 모델 선택 메뉴에 있기 때문에, 대화 도중에 드롭다운만 바꾸면 모델을 전환할 수 있으며 다른 앱을 실행할 필요는 없습니다.

자주 발생하는 문제

  • Ollama로 채팅할 때 403 오류: CORS 문제입니다. Ollama 설정에서 사용자 지정 origin URL을 활성화하거나 OLLAMA_ORIGINS=*를 설정하세요.
  • 제공업체를 추가한 후 "No model found" 표시: API 키가 잘못되었거나 잔액이 없는 경우입니다.
  • 드롭다운에 AIHubMix가 없음: 확장 프로그램 버전이 1.5.86보다 낮습니다. 업데이트하거나, Custom을 선택한 후 https://aihubmix.com/v1을 입력하세요.
  • RAG 설정에 임베딩 모델이 나타나지 않음: 채팅 모델(Chat Model)로 저장된 상태입니다. 유형을 Embedding Model로 설정하여 다시 추가하세요.
  • Chat with Website 답변이 얕음: 일반 모드로 전환하고, 더 긴 컨텍스트 윈도우를 가진 모델을 사용하세요.
  • 사이드바가 열리지 않음: Opera와 Arc에서는 지원되지 않으므로 웹 UI를 사용하세요.

자주 묻는 질문

Page Assist는 무료인가요? 네. MIT 라이선스이며, 지원되는 모든 브라우저에서 무료로 사용할 수 있습니다. 유료 클라우드 제공업체를 연결한 경우에만 비용이 발생합니다.

Page Assist를 사용하려면 Ollama가 필요한가요? 아니요. Ollama가 기본값이지만, LM Studio, llama.cpp, vLLM, AIHubMix와 같은 클라우드 게이트웨이를 포함하여 OpenAI 호환 엔드포인트라면 모두 사용할 수 있습니다.

제공업체 드롭다운에 AIHubMix가 있나요? 네, 1.5.86 버전부터 지원됩니다. AIHubMix를 선택하고 API 키를 붙여넣으세요. Base URL은 자동으로 입력됩니다. 이전 버전을 사용 중이라면 먼저 확장 프로그램을 업데이트하세요.

Page Assist가 제 브라우징 데이터를 외부로 전송하나요? Page Assist는 텔레메트리를 사용하지 않으며, 기록은 로컬에 저장됩니다. 페이지 내용은 대화하는 모델로만 전송됩니다. 클라우드 모델을 사용하는 경우, 그 내용은 해당 제공업체로 전송됩니다.

어떤 임베딩 모델을 사용해야 하나요? 로컬에서는 Ollama를 통한 nomic-embed-text가 공식 문서에서 권장하는 모델입니다. AIHubMix를 사용하는 경우, 채팅 모델과 같은 모델 목록에서 gemini-embedding-001 등을 선택하고, 유형을 Embedding Model로 설정하여 저장하세요.

워크플로마다 다른 모델을 사용할 수 있나요? 네. 모델 선택은 채팅마다 개별적으로 이루어지므로, 빠른 교정에는 로컬 모델을 사용하고, 같은 세션에서 긴 페이지를 다룰 때는 클라우드 모델로 전환할 수 있습니다.

Page Action은 Firefox에서 작동하나요? 아니요. Page Action은 Chrome, Brave, Edge와 같은 Chromium 기반 브라우저에서만 사용할 수 있습니다. Chrome DevTools Protocol에 의존하기 때문입니다.

출처

여러 AI 제공업체를 하나의 게이트웨이로. 프로덕션 환경을 위해 설계했습니다.

AIHubMix 웹사이트 방문