macOS 설치 + Windows 지원 현황

Aside AI 브라우저
3분 설치 & 활용법

공식 설치가 가능한 환경과 Windows 사용자가 반드시 알아야 할 제한, CLI·MCP 연동까지 정확하게 정리했습니다.

중요 — 2026년 8월 17일 공개 페이지 기준

공식 시작 문서는 macOS 15.0 이상만 요구사항으로 명시하고, 공개 다운로드 페이지도 DMG 설치만 안내합니다. 변경 로그에는 Windows 관련 기능이 등장하지만, 공개 Windows 설치 파일과 공식 설치 절차는 아직 확인되지 않습니다. 따라서 이 글은 macOS 설치법과 Windows의 현재 상태·출시 후 안전한 설치 절차를 구분해 설명합니다.

AI 브라우저를 써보고 싶지만 설치나 연동이 복잡할 것 같아 미뤘다면 이 글을 순서대로 확인하세요. 일반 사용자는 브라우저 설치 후 웹페이지 요약, 비교, 번역, 여러 단계의 브라우저 작업을 요청할 수 있습니다. 개발자는 CLI와 MCP를 연결해 스테이징 검증, 화면 캡처, CI 로그 확인처럼 코드 밖에서 일어나는 브라우저 작업을 코딩 흐름 안으로 가져올 수 있습니다.

내 환경에서는 어떻게 해야 할까?

macOSmacOS 15 이상 확인 → DMG 설치 → 초기 설정 → 필요하면 CLI·MCP 연결

Windows공식 EXE/MSI가 공개되었는지 다운로드 페이지 확인 → 없으면 설치하지 않기

개발자브라우저 설치 후 Developer 설정에서 CLI 설치 → MCP 연결

환경별 Aside 시작 방법: macOS는 DMG 설치, Windows는 공식 출시 대기, 개발자는 CLI MCP 연결

1단계. 운영체제별 설치 가능 여부 확인

환경	공개 설치 상태	해야 할 일
macOS 15+	공식 지원	공식 DMG 설치
Windows 10/11	공개 설치 안내 미확인	공식 EXE/MSI 공개 여부 확인
Linux·WSL	공식 브라우저 설치 안내 미확인	임의 설치 스크립트 사용 금지

2단계. macOS에서 설치하기

① macOS 버전 확인

화면 왼쪽 위 Apple 메뉴 → 이 Mac에 관하여에서 버전을 확인하세요. 공식 요구사항은 macOS 15.0 이상입니다. 버전이 낮다면 먼저 macOS 업데이트 가능 여부를 확인해야 합니다.

② 공식 다운로드 페이지에서 설치

Aside 공식 다운로드 페이지를 엽니다.
다운로드된 Aside.dmg 파일을 실행합니다.
Aside 아이콘을 Applications 폴더로 드래그합니다.
응용 프로그램 폴더에서 Aside를 실행하고 계정에 로그인하거나 새 계정을 만듭니다.

팁: 처음 실행할 때 macOS가 앱 실행 여부를 묻는다면 앱 이름과 다운로드 출처를 확인한 뒤 진행하세요. 반드시 공식 사이트에서 받은 설치 파일을 사용하세요.

③ Chrome·Safari 데이터 가져오기

초기 설정에서 기존 브라우저의 방문 기록, 쿠키, 북마크를 가져올 수 있습니다. 여러 프로필이 발견되면 가져올 프로필을 직접 선택하세요.

Chrome 등: 가져오기 화면에서 프로필 선택 → 시스템 접근 허용 → 완료될 때까지 기다리기
Safari: Safari에서 File → Export로 ZIP 파일을 만든 뒤 Aside에 업로드
가져오기 오류: 원본 브라우저를 완전히 종료하고 다시 시도

보안을 우선한다면

처음부터 모든 쿠키와 로그인 상태를 가져올 필요는 없습니다. 검증·테스트가 목적이라면 로그인 정보가 없는 상태에서 시작하거나, 작업별로 Incognito 모드와 최소 권한을 사용하는 편이 안전합니다.

3단계. Windows에서 설치하려면

현재는 공개 Windows 설치 파일을 확인할 수 없습니다

공식 변경 로그에는 Windows 파일 접근, Windows 메뉴, Edge·Chrome 가져오기 같은 기능이 기록되어 있습니다. 하지만 공식 다운로드 페이지와 시작 문서에는 Windows용 EXE/MSI 링크, 최소 사양, 설치 절차가 아직 공개되어 있지 않습니다. 개발 중인 기능이나 제한 배포일 수 있으므로, 제3자 다운로드 사이트의 설치 파일은 사용하지 마세요.

Windows 사용자가 지금 할 일

공식 다운로드 페이지에 Windows 버튼이 생겼는지 확인합니다.
Aside Browser 변경 로그에서 Windows 정식 출시 공지를 확인합니다.
공식 링크가 없다면 WSL, 비공식 EXE, 재패키징 설치 파일로 우회하지 않습니다.

Windows 버전이 공식 공개된 뒤 설치 순서

아래 절차는 공식 EXE/MSI가 다운로드 페이지에 표시된 경우에만 진행하세요.

공식 다운로드 페이지에서 Windows용 EXE 또는 MSI를 받습니다.
다운로드 파일을 마우스 오른쪽 버튼으로 클릭해 속성 → 디지털 서명에서 게시자를 확인합니다.
설치 파일을 실행하고 사용자 계정 컨트롤 창의 게시자와 앱 이름을 확인한 뒤 허용합니다.
설치가 끝나면 시작 메뉴에서 Aside를 실행하고 로그인합니다.
초기 설정에서 Chrome 또는 Edge 프로필을 선택해 북마크·방문 기록 등을 가져옵니다.
첫 작업은 로그인이나 파일 변경이 필요 없는 읽기 전용 페이지 요약으로 테스트합니다.

PowerShell·CMD 주의: 현재 공식 개발자 문서는 Bash용 curl ... | bash 명령만 제시합니다. 이를 Windows PowerShell이나 CMD에 그대로 붙여넣지 마세요. Windows용 CLI 설치 명령은 정식 Windows 문서가 공개된 뒤 그 안내를 따르세요.

✍️ 운영자 노트

이 블로그의 운영 작업 상당 부분을 AI 에이전트가 브라우저를 조종하는 방식으로 처리하고 있습니다. 그 경험에서 말씀드리면, 본문의 "읽기 전용으로 시작" 원칙은 장식이 아니라 실전 수칙입니다 — 에이전트가 클릭·전송까지 하는 순간 실수 비용이 커지므로, 어떤 AI 브라우저든 처음 일주일은 요약·비교 같은 읽기 작업만 맡기고 신뢰를 쌓은 뒤 범위를 넓히는 것을 권합니다.

4단계. 일반 사용자 활용법

새 탭의 Ask AI 또는 사이드 패널에서 원하는 결과를 문장으로 요청하면 됩니다. 좋은 요청은 보통 대상 사이트 + 원하는 결과 + 제한 조건을 함께 담습니다.

좋은 요청의 공식

어디에서 + 무엇을 + 어떤 형식으로 + 어디까지 할지

바로 써볼 수 있는 예시

웹페이지 요약 “현재 페이지의 핵심 내용을 5줄로 요약하고, 숫자와 날짜는 별도 표로 정리해줘. 페이지에 없는 내용은 추측하지 마.”

상품 비교 “열려 있는 두 상품 페이지에서 가격, 배송비, 반품 조건, 핵심 사양을 비교표로 만들어줘. 결제는 하지 말고 결과만 보여줘.”

자료 정리 “Downloads 폴더의 영수증 PDF를 날짜, 상호, 금액, 결제수단 열이 있는 표로 정리해줘. 원본 파일은 수정하지 마.”

페이지 일부만 처리 “선택한 문단을 자연스러운 한국어로 번역하고, 전문 용어는 원문을 괄호 안에 함께 표시해줘.”

단축키 Cmd/Ctrl + E로 Ask Aside를 열 수 있습니다. 두 페이지를 나란히 비교할 때는 분할 탭 기능이 편리합니다.

5단계. Aside CLI 설치하기

개발자가 터미널이나 코딩 에이전트에서 Aside를 호출하려면 CLI를 설치합니다. 가장 쉬운 방법은 Aside 앱의 Developer 설정에서 설치·업데이트 버튼을 이용하는 것입니다. 아래 명령은 현재 공식 문서에 실린 macOS/Bash용 안내입니다.

macOS Terminal — CLI 설치

curl -fsSL https://releases.aside.com/install.sh | bash

터미널 명령 보안: 원격 설치 스크립트는 공식 문서와 주소를 다시 확인한 뒤 실행하세요. 회사 관리 기기라면 보안 정책이나 관리자 승인이 필요할 수 있습니다.

설치 확인

aside --help

첫 번째 브라우저 작업 실행

aside "Open localhost:3000 and run a smoke test"

진행 중인 세션을 이어서 작업하려면 세션 ID를 넣어 다음처럼 실행합니다.

aside --session <session-id> "Continue"

6단계. Claude Code·Codex 등 코딩 에이전트와 MCP 연동

Aside는 MCP(Model Context Protocol) 서버로 실행할 수 있습니다. 사용 중인 코딩 도구가 mcp.json 형식을 지원한다면 아래 설정을 MCP 구성에 추가하세요.

mcp.json

{
  "mcpServers": {
    "aside": {
      "command": "aside",
      "args": ["mcp"]
    }
  }
}

Aside 앱의 Settings → Developer에서 CLI 경로와 지원되는 코딩 도구 자동 설정 여부를 확인합니다.
코딩 에이전트의 MCP 설정 화면 또는 설정 파일에 위 구성을 추가합니다.
도구가 aside 명령을 찾지 못하면 Developer 설정에 표시된 전체 CLI 경로를 command 값으로 넣습니다.
코딩 에이전트를 재시작한 뒤 간단한 읽기 전용 검증을 요청합니다.

연동 확인용 첫 프롬프트

“Aside를 사용해 localhost:3000을 열고 홈 화면이 정상 표시되는지 확인해줘. 데스크톱 화면을 캡처하고, 깨진 레이아웃과 콘솔 오류만 보고해줘. 폼 제출이나 데이터 변경은 하지 마.”

개발자 활용 예시 5가지

활용	요청 예시
스모크 테스트	“로그인 → 대시보드 진입 흐름을 확인하고 실패 지점과 화면을 남겨줘.”
반응형 QA	“데스크톱과 모바일 폭에서 온보딩 화면을 캡처하고 잘림을 비교해줘.”
CI 로그 분석	“실패한 작업의 첫 오류와 마지막 성공 실행의 차이를 찾아 링크와 함께 정리해줘.”
배포 증거 수집	“프리뷰 배포를 열어 핵심 화면을 캡처하고 PR 검토용 체크리스트를 작성해줘.”
관리 화면 점검	“현재 설정과 내부 문서의 기대값을 비교하되 저장이나 변경은 하지 마.”

7단계. 안전하게 사용하는 권한 설정

AI 브라우저는 로그인된 사이트, 브라우징 기록, 로컬 파일을 다룰 수 있으므로 “무엇을 할 수 있는가”보다 “어디까지 허용할 것인가”가 더 중요합니다.

모드	권장 상황
Read only	처음 연동할 때, 조사·요약·검증만 필요할 때
Guard	승인된 폴더에서 파일 작업이 필요할 때. 새 작업의 기본 모드
Full access	정말 필요한 경우에만, 범위와 결과를 직접 검토하면서 사용
Incognito	일반 브라우저 프로필의 로그인 상태를 사용하지 않는 독립 작업

권장 보안 체크리스트

첫 실행은 Read only 또는 Guard로 시작하기
결제, 전송, 게시, 삭제 전에는 반드시 멈추도록 프롬프트에 명시하기
파일 작업은 프로젝트나 테스트용 폴더 하나로 제한하기
민감한 관리자 화면은 가능하면 별도 계정·최소 권한으로 접속하기
페이지 안의 지시문보다 사용자의 요청을 우선하고, 의심스러운 다운로드·로그인 요구는 중단시키기
작업이 끝난 뒤 생성·변경된 파일과 활동 기록 검토하기

세부 권한은 Settings → Agents에서 설정합니다. 도구별 규칙은 Allow / Ask / Deny로 나뉘며, Deny가 다른 규칙보다 우선합니다. 개인 정보 관련 설정은 Settings → Security & Privacy에서 방문 기록, 쿠키, 분석 공유, 사이트 권한 등을 확인할 수 있습니다.

문제가 생겼을 때 빠른 해결법

브라우저 데이터 가져오기가 실패해요 원본 프로필이 남아 있는지 확인하고, 원본 브라우저를 완전히 종료한 뒤 다시 시도하세요. Safari는 ZIP 파일 가져오기를 사용합니다.

터미널에서 aside 명령을 찾지 못해요 Aside의 Developer 설정에서 CLI를 다시 설치·업데이트하고, 코딩 도구의 MCP 설정에는 표시된 전체 CLI 경로를 사용해 보세요. 터미널과 코딩 도구도 재시작합니다.

Windows에서 다운로드 버튼이 보이지 않아요 현재 공개 다운로드 페이지가 macOS DMG만 제공하는 상태일 수 있습니다. 운영체제를 속이거나 비공식 설치 파일을 받지 말고, 공식 다운로드 페이지와 변경 로그에서 Windows 정식 배포를 확인하세요.

작업이 중간에 멈췄어요 작업 화면에서 승인, 질문, MFA, 패스키, CAPTCHA 같은 사용자 입력을 기다리는지 확인한 뒤 응답하고 재개하세요.

에이전트가 잘못된 방향으로 가요 즉시 수정해야 하면 Steer, 현재 작업이 끝난 뒤 새 지시를 적용하려면 Queue를 사용합니다. “이메일은 보내지 말고 초안만 작성해”처럼 금지 행동도 구체적으로 적으세요.

자주 묻는 질문

Q. Windows에서도 설치할 수 있나요?

2026년 8월 17일 확인 기준, 공개 다운로드 페이지와 시작 문서는 macOS 설치만 안내합니다. 변경 로그에는 Windows 관련 기능이 보이지만 공개 EXE/MSI 설치 링크는 확인되지 않았습니다. 공식 Windows 다운로드가 표시된 경우에만 설치하세요.

Q. CLI를 꼭 설치해야 하나요?

아닙니다. 브라우저 안에서 Ask AI와 작업 기능만 사용할 경우 CLI는 필요하지 않습니다. CLI와 MCP는 개발 워크플로에 연결할 때 설치하면 됩니다.

Q. 저장된 비밀번호가 AI에 그대로 보이나요?

공식 문서에 따르면 저장된 비밀번호 값은 AI 에이전트에 숨겨지고, URL과 접근 정책을 확인한 뒤 자동 완성에 사용됩니다. 다만 MFA·패스키·신원 확인은 사용자가 직접 처리해야 할 수 있습니다.

Q. 처음 어떤 작업으로 시험하면 좋나요?

로그인이나 파일 변경이 필요 없는 페이지 요약부터 시작하세요. 개발자라면 localhost 화면을 읽기 전용으로 열어 깨진 레이아웃과 콘솔 오류를 보고하게 하는 것이 좋습니다.

AI 브라우저 안전 원칙 3가지: 읽기 전용 시작, 민감 작업은 사람 확인, 공식 설치 파일만 사용

정리: 브라우저는 쉽게, 권한은 작게

macOS 15 이상에서는 공식 DMG로 설치할 수 있습니다. Windows 사용자는 공식 EXE/MSI가 공개 다운로드 페이지에 나타날 때까지 기다리는 것이 안전합니다. 지원 환경에서 개발자는 공식 CLI를 설치하고 aside mcp를 연결해 코딩 에이전트에서 실제 브라우저 검증을 요청할 수 있습니다.

가장 중요한 원칙은 읽기 전용으로 시작하고, 변경·전송·결제·삭제는 사람의 확인 뒤에 실행하는 것입니다.

공식 자료

· Aside 다운로드

· Aside 시작 가이드

· CLI·MCP·REPL 개발자 문서

· 에이전트 권한 설정

· Aside Browser 변경 로그

※ 제품 지원 환경과 설치 방법은 업데이트될 수 있습니다. 게시 전 공식 문서의 최신 안내를 다시 확인하세요.

· 말 대신 화면을 녹화하면 AI가 그대로 따라합니다: 클로드 화면 녹화 스킬

· Paseo 원격 접속 보안 경고 — 에이전트에게 노트북 안 넘겨주는 설정

태그: #Aside #AsideBrowser #AI브라우저 #코딩에이전트 #ClaudeCode #Codex #MCP #CLI #웹자동화 #개발자도구

이 블로그 검색

최신 AI 뉴스