Aside 브라우저 윈도우 설치와 aside-cli 연결, AI에게 브라우저 맡기기

먼저 설치할 프로그램은 없습니다. 이 글부터 바로 시작하면 됩니다.

Aside는 사람이 평소처럼 쓰면서 AI에게 일을 맡길 수도 있는 웹 브라우저입니다. 크롬이나 엣지처럼 사이트를 열고 로그인해서 쓰는데, 옆에 있는 AI가 같은 화면을 보고 클릭과 입력을 대신할 수 있습니다.

비유하면 운전 연수용 자동차와 비슷합니다. 평소에는 내가 운전하고, 필요할 때 옆자리 강사(AI)가 운전대를 잡습니다. 브레이크는 여전히 내 쪽에도 있습니다.

aside-cli는 이 브라우저를 터미널에서 부르는 연결 도구입니다. CLI는 글자로 명령을 입력해 프로그램을 움직이는 방식을 말합니다. aside-cli가 연결되면 Codex 같은 AI 에이전트가 "이 사이트를 열고 이 내용을 찾아 줘" 같은 일을 Aside 브라우저에 시킬 수 있습니다.

이 수업에서 하는 일

수업 00:40~01:00에 Aside 브라우저와 aside-cli를 설정합니다. 이후 실습에서 AI가 웹 화면을 열어 자료를 찾거나, 내가 로그인해 둔 서비스에서 필요한 화면을 확인하는 데 씁니다.

영상 제작 과정에는 웹에서 하는 일이 꽤 많습니다. 예제 자료 페이지를 열고, 결과 파일을 확인하고, 생성 서비스의 작업 상태를 봅니다. 이 일을 AI가 직접 브라우저로 처리할 수 있게 연결해 두는 것이 이 시간의 목표입니다.

설치하기

브라우저 설치는 공식 다운로드 페이지에서 합니다.

1) https://aside.com/download 에 접속합니다. 2) 윈도우용 설치 파일이 내려받아집니다. 자동으로 시작되지 않으면 페이지의 수동 다운로드 링크를 누르고 다운로드 폴더에 저장합니다. 3) 내려받은 실행 파일(.exe)을 더블클릭하고 설치 안내를 따라갑니다. 4) 설치가 끝나면 Aside를 실행하고 계정으로 로그인합니다.

수업 계획서의 사전 준비 항목에도 이 설치와 로그인 확인이 들어 있습니다. 회사 PC라면 프로그램 설치 권한이 있는지, 외부 AI 서비스 이용이 허용되는지 교육 담당자에게 미리 확인해 주세요.

aside-cli 연결은 브라우저 설치와 별개입니다. 공식 문서는 Aside 브라우저 설정의 개발자 설정 화면에서 CLI를 설치하고 업데이트하거나 다시 설치할 수 있다고 안내합니다. 윈도우에서 터미널 명령으로 설치하는 방법은 공식 문서에 따로 적혀 있지 않아서, 이 글에서는 명령을 소개하지 않습니다. 수업에서는 강사가 안내하는 방법으로 함께 연결합니다.

CLI를 설치한 뒤에는 PowerShell 창을 닫았다가 새로 열어야 aside 명령을 찾습니다. 이미 열려 있던 창은 설치 전 상태를 기억하고 있기 때문입니다.

확인

새 PowerShell 창에서 다음 명령을 입력합니다.

aside --version

이 명령은 설치된 aside-cli의 버전을 보여 줍니다. 아래처럼 숫자가 나오면 설치된 것입니다. 숫자는 시점마다 다릅니다.

1.26.1023.1115

다음은 CLI를 내 Aside 계정에 연결하는 로그인입니다.

aside login

이 명령을 실행하면 확인 코드가 나옵니다. 창을 닫지 말고 그대로 둔 채 Aside 브라우저의 설정에서 Account, Devices 화면으로 가서 그 코드를 승인합니다. 터미널에 Signed in as 로 시작하는 문장이 나오면 로그인이 끝난 것입니다. 승인 버튼만 누르고 창을 먼저 닫으면 로그인이 저장되지 않을 수 있습니다.

처음 써 보기

첫째, AI 에이전트가 Aside를 쓰는 방법을 알도록 기술(스킬)을 설치합니다.

aside skills install

이 명령은 Codex, Claude Code, Cursor, OpenCode 같은 코딩 에이전트에 Aside 사용법을 담은 안내서를 넣어 줍니다.

둘째, 터미널에서 직접 간단한 일을 시켜 봅니다. 명령 뒤에 하고 싶은 일을 따옴표로 적습니다.

aside "https://www.letscoding.kr 을 열고 페이지 제목을 알려 줘"

Aside 브라우저에서 사이트가 열리고, 결과가 터미널에 글로 돌아옵니다.

셋째, 수업에서처럼 Codex에게 부탁해 봅니다. Codex 대화창에 이렇게 적으면 됩니다.

Aside 브라우저로 https://github.com/jub0t/Concat/releases 를 열어서
가장 최근 버전 번호와 윈도우용 설치 파일 이름을 알려 줘.

안전하게 쓰기

Aside의 AI는 내가 로그인해 둔 사이트에서 실제로 클릭하고 입력할 수 있습니다. 메일 보내기, 게시물 작성, 결제 같은 행동도 화면에서 가능한 일이라면 할 수 있다는 뜻입니다.

그래서 실습은 연습용 계정으로 하기를 권합니다. 회사 메일, 고객 관리 시스템, 결제 정보가 저장된 사이트에 로그인한 상태로 AI에게 넓은 범위의 일을 맡기지 마세요. AI가 확인을 요청하면 무엇을 하려는지 읽고 나서 승인합니다. 공식 문서도 CLI 로그인 정보 파일을 출력하거나 공유하지 말라고 안내합니다.

자주 막히는 곳

aside : 'aside' 용어가 cmdlet, 함수, 스크립트 파일 또는 실행할 수 있는 프로그램 이름으로 인식되지 않습니다.

CLI가 설치되지 않았거나, 설치 전에 열어 둔 PowerShell 창을 그대로 쓰고 있다는 뜻입니다. 창을 새로 열고 다시 입력합니다. 그래도 같으면 개발자 설정 화면에서 CLI 설치 상태를 확인합니다.

로그인 코드를 승인했는데 터미널이 계속 기다리는 경우가 있습니다. 승인한 계정과 브라우저에 로그인한 계정이 같은지 확인하고, 처음부터 aside login 을 다시 실행해 새 코드를 승인합니다.

회사 PC에서는 설치 파일 실행이 막히거나 백신이 경고를 띄울 수 있습니다. 직접 우회하지 말고 교육 담당자나 사내 IT 담당자에게 알려 주세요.

명령이 예전 버전처럼 동작하면 업데이트를 합니다.

aside --update

용어 풀이

CLI: 마우스 대신 글자 명령으로 프로그램을 다루는 방식입니다. 에이전트: 목표를 받으면 여러 단계를 스스로 나눠 처리하는 AI입니다. 스킬: AI 에이전트가 특정 도구를 쓰는 법을 적어 둔 안내서입니다. MCP: AI가 다른 프로그램의 기능을 정해진 규칙으로 불러 쓰는 연결 방식입니다. aside-cli도 aside mcp 명령으로 이 방식을 지원합니다. PowerShell: 윈도우에 기본으로 들어 있는 터미널 프로그램입니다.

맥에서는

브라우저는 같은 다운로드 페이지에서 내 맥에 맞는 버전을 고른 뒤, 디스크 이미지를 열고 Aside를 응용 프로그램 폴더로 끌어 놓습니다.

aside-cli는 공식 문서에 맥용 설치 명령이 있습니다. 터미널 앱에서 실행합니다.

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

이 명령은 Aside가 제공하는 설치 스크립트를 내려받아 실행합니다. 설치 후 터미널을 새로 열고 aside --version, aside login 순서로 확인합니다.

다음 글

다음 글: Python 3.11 윈도우 설치 방법, Whisper를 쓰기 위한 준비 시리즈 전체 목록: https://www.letscoding.kr/blog/category/tools

공식 자료 https://aside.com https://aside.com/download https://docs.aside.com/help/developers

확인일: 2026-11-02