어사이드 앱 1.0.928.1 과 명령줄 도구 1.26.916.1741, 맥 판 기준
aside 브라우저 사용법을 2026-10-06 기준으로 처음부터 다시 따라가 보니 공개 페이지 하나를 열어 글자와 누를 수 있는 단추 목록까지 읽어 오는 데 0.8초가 걸렸는데요, 정작 오래 붙잡힌 곳은 앞에서 만든 값이 다음 호출에서 사라지는 순간이었습니다.
안녕하세요? 정리하는 개발자 워니즈입니다.
- 한 일: 어사이드(Aside)는 AI 에게 웹 일을 맡길 수 있는 맥용 브라우저이고, 저는 앱 창, 말로 시키기, 코드로 시키기, 다른 AI 도구에 붙이기 네 갈래를 공개 페이지로만 돌려 봤습니다
- 결과: 코드로 페이지 읽기 0.8초, 말로 시켜 글 제목 세 개 받기 8초였고 막힌 곳은 두 군데였습니다
- 쓸모: 어사이드를 막 깔았는데 어디부터 손대야 할지 모르는 분께 맞습니다
| 이럴 때 | 쓰는 법 | 2026-10-06 직접 확인한 결과 |
|---|---|---|
| 평소처럼 클릭하며 쓸 때 | 앱 창 | 공개 페이지 example.com 열기 |
| 한 문장으로 맡기고 싶을 때 | 말로 시키기(exec) | 해커뉴스 첫 화면 글 제목 3개, 8초 |
| 같은 일을 정확히 되풀이할 때 | 코드로 시키기(repl) | 페이지 제목과 단추 목록, 0.8초 |
| 다른 AI 도구에서 부를 때 | MCP 서버(aside mcp) | 표준 입출력 서버로 뜸 |
| 실패 1 | 코드로 시키기 두 번 | 두 번째 호출에서 변수 사라짐 |
| 실패 2 | 주소 읽기 | 주소 대신 함수 본문이 찍힘 |
1. aside 브라우저 사용법, 무슨 일이 있었나요?
필자는 9월부터 어사이드를 앱 창과 명령줄 양쪽으로 섞어 쓰고 있는데요, 처음 쓰는 분이 어디서 시작하면 되는지 정리하려고 2026-10-06 에 세 가지 쓰는 법을 처음부터 다시 돌려 봤습니다. 로그인이 필요한 사이트와 계정 화면은 일부러 열지 않았고, 새로 가입한 것도 없습니다. 이 글은 macOS 판 기준이고 윈도우와 휴대폰 판은 다루지 않습니다.

2. 무슨 문제가 생겼나요?
aside 브라우저 사용법을 찾는 분이 가장 헷갈릴 곳은 앱 창과 명령줄 도구(터미널에서 치는 프로그램)가 따로 움직인다는 점일 것 같은데요, 둘은 업데이트 길도 다르고 버전 번호 체계도 다릅니다(앱 1.0.928.1, 명령줄 1.26.916.1741). 이번 재현에서 걸린 곳은 앞의 두 군데였고, 셋째는 9월에 겪은 일입니다.
- 코드로 시키기는 부를 때마다 새로 시작합니다. 첫 호출에서 숫자 42 를 넣고 찍으면 42 가 나왔는데, 다음 호출에서 같은 이름을 찾으니 “undefined”(정의되지 않음)였습니다
- 페이지 주소를 값처럼 읽으면 엉뚱한 글자가 나옵니다. 열린 탭의 주소를 그냥 읽었더니 “function url(” 로 시작하는 함수 본문이 찍혔고, 괄호를 붙여 불러야 https://example.com/ 이 나왔습니다
- 설치 이미지 안에서 바로 실행하면 자동 업데이트가 죽습니다. 9월에 설치 이미지(DMG, 맥 앱을 담아 오는 디스크 파일)를 연 채 그 안의 앱을 실행했더니 앱은 멀쩡히 떴지만 내장 업데이터가 설치 단계에서 실패했습니다(exit 27)
3. 어떻게 풀었나요?
aside 브라우저 사용법을 순서로 나누면 다섯 단계였고 다시 해도 같은 결과가 나왔는데요, 실제로 친 명령과 출력은 끝의 부록에 모았습니다.
- 응용 프로그램 폴더에 옮긴 뒤 실행합니다. 설치 이미지에서 앱을 응용 프로그램 폴더로 끌어 옮기고, 그 뒤로는 옮긴 사본에서만 실행합니다. 메뉴 막대의 프로필에서 프로필 추가를 누르면 어사이드 계정 가입 없이 이 맥 안에만 프로필이 생깁니다(2026-10-04 확인)
- 앱 창으로 먼저 익숙해집니다. 여느 브라우저처럼 주소를 치고 클릭하면 됩니다. 이번에는 공개 페이지 example.com 만 열었습니다
- 말로 시켜 봅니다. 해커뉴스 첫 화면의 맨 위 글 제목 세 개를 그대로 적어 달라고 한 문장으로 시키니 8초 만에 세 줄이 돌아왔습니다. 중간에 페이지 단추 목록이 먼저 찍히고 답이 그 뒤에 붙었습니다
- 코드로 시킬 때는 한 호출 안에 끝냅니다. 탭 열기, 제목 읽기, 페이지 구조 읽기(접근성 스냅샷, 화면을 글자와 단추 목록으로 바꾼 것), 탭 닫기를 한 줄에 묶으니 0.8초에 끝났습니다. 주소는 함수처럼 괄호를 붙여 불러야 합니다
- 다른 AI 도구에 붙입니다. 명령줄 도구의 MCP(AI 도구가 바깥 프로그램을 부르는 표준 규격) 명령은 도움말에 “Start the MCP server over stdio” 로 나오고, 필자는 이것을 클로드 코드에 붙여 씁니다

| 9월에 겪은 것 | 지금 지키는 것 |
|---|---|
| 한 호출 실행 상한 120초, 코드로 연 탭은 호출이 끝나면 닫힘 | 여러 호출에 걸친 일은 살아 있는 탭에 다시 붙음(attachBrowserTab) |
| 앱에서 연 탭에 붙으면 닫기 명령 뒤에도 탭이 남음(9/29) | 코드로 연 탭만 호출 끝에 닫힌다고 보고 정리 |
명령 목록과 사용 범위는 어사이드 개발자 도움말에, MCP 서버 등록 형식은 클로드 코드 MCP 공식 문서에 있습니다.
4. 누구에게 도움이 되나요?
aside 브라우저 사용법을 찾아 어사이드를 깔아 두고 앱 창만 쓰다가, 같은 일을 말이나 코드로 시켜 보고 싶은 분이라면 읽어 보세요. 이미 쓰고 있다면 코드 호출 두 번 사이에 값이 이어진다고 믿고 있지 않은지만 확인하면 됩니다.
설치 직후 겪기 쉬운 함정은 Aside 브라우저 후기, 함정 6가지에, 사람이 자리를 비운 채 맡길 때 걸리는 제약은 Aside 브라우저 자동화 제약 6가지에 따로 적었습니다. MCP 서버를 직접 만들어 보고 싶다면 나만의 MCP 서버 만들기 with 커서 AI 서평이 출발점으로 맞을 것 같습니다.
5. 한 줄 정리
필자의 결론
aside 브라우저 사용법은 앱 창으로 익히고, 반복할 일은 코드 한 호출에, 한 번 맡길 일은 말로 시키면 됩니다. 코드로 시키기는 0.8초로 빨랐지만 호출마다 새로 시작했고, 말로 시키기는 8초로 느려도 문장 하나면 됐습니다. 그래서 필자는 되풀이하는 일은 코드로, 처음 해 보는 일은 말로 시키는 쪽으로 나눠 쓰기로 했습니다.
그래서 당신은 이것만 하면 됩니다. 앱을 응용 프로그램 폴더로 옮겨 실행한 뒤, 공개 페이지 하나를 말로 한 번, 코드로 한 번 읽혀 보세요.
오늘은 example.com 을 코드 한 줄로 열어 제목을 읽어 보세요. 여러분은 어사이드로 처음 무엇을 맡겨 보셨는지 댓글로 들려주세요.
부록: 재현 명령과 출력
이 aside 브라우저 사용법 예제는 2026-10-06 macOS 27.0, 어사이드 앱 1.0.928.1, 명령줄 도구 1.26.916.1741 에서 돌렸습니다. 첫 블록은 탭 열기부터 닫기까지 한 호출이고, 출력은 긴 본문 줄을 빼고 제목과 단추 줄만 남겼습니다.
aside repl "const t = await openTab(\"https://example.com\"); console.log(await t.title()); const s = await snapshot(t, {interactive:true}); console.log(s.tree.split(\"\n\").slice(0,6).join(\"\n\")); await closeTab(t)"
Example Domain
- title: "Example Domain" [url=https://example.com/]
- link "Learn more" [ref=e1]
[ok | 614ms]
실패 1입니다. 같은 이름을 두 호출에 걸쳐 쓰면 두 번째에서 사라집니다.
$ aside repl "globalThis.memo = 42; console.log(memo)"
42
$ aside repl "console.log(typeof memo)"
undefined
실패 2입니다. 첫 줄은 괄호 없이 읽은 값, 둘째 줄은 괄호를 붙여 부른 값입니다.
aside repl "const t = await openTab(\"https://example.com\"); console.log(typeof t.url, String(t.url).slice(0,40)); console.log(t.url()); await closeTab(t)"
function url({truncate:Cn=!1}={}){return Cn?trunc
https://example.com/
말로 시키기는 time 으로 쟀고 8초였습니다. 앞에 찍힌 단추 목록 줄은 빼고 답만 옮겼습니다.
time aside exec "https://news.ycombinator.com 첫 화면에서 맨 위 글 제목 3개만 한국어 번역 없이 그대로 적어 줘"
1. Beam: Reflection's 501B open-weight model
2. Example.com just launched the biggest redesign in decades
3. Find the flattest route between any two points in SF
MCP 서버는 aside mcp 로 뜨고 도움말 첫 줄은 “Usage: aside mcp [options]” 입니다. 클로드 코드에 붙일 때는 claude mcp add --help 의 형식대로 claude mcp add aside -- aside mcp 처럼 이름과 실행 명령을 주면 되는데, 이 맥에 등록한 설정 내용은 이번 기록에 남기지 않아 이 한 줄을 그대로 돌린 결과는 미확인입니다.
새 글이 올라오면 Threads @wonizz.ai 에도 올립니다. 팔로우해 두면 피드에서 바로 볼 수 있습니다.