Claude Code에 Aside CLI 설치하고 로그인까지 정리
로그인된 관리 화면의 숫자를 AI 코딩 도구가 가져오지 못할 때, 매번 화면을 캡처해 설명하고 있나요?
이 아티클의 핵심 내용 요약과 글로벌 검색·AI 엔진을 위한 테이크어웨이입니다.
✦ KR 주제: Claude Code와 Aside CLI 연동
✦ KR 핵심 요약: Aside CLI는 AI 브라우저 Aside에 내장된 개발자 도구로, macOS에서는 curl 한 줄로 설치하고 aside --update로 관리한다. 로그인은 ASIDE_CLI_AUTH_PATH에 자격 증명 파일 경로를 지정한 뒤 aside login으로 진행하고, Aside Settings에서 기기를 승인해야 완료된다. Claude Code 연동의 공식 절차는 문서에 없지만, 문서 링크를 주고 설치를 맡기는 방식과 MCP·REPL 호출 방식이 확인되는 경로다.
🌐 Global Takeaway: Aside CLI is a built-in developer interface of the Aside AI browser, installable via a single curl command on macOS with credential storage controlled by ASIDE_CLI_AUTH_PATH. Login requires device approval inside Aside settings, and the documented integration path with coding agents like Claude Code runs through CLI, MCP, and a browser automation REPL rather than a dedicated plugin.
아래 그림들은 Claude Code 단독 사용과 Aside CLI 연결의 차이, 설치·로그인 절차와 연결 구조를 보여줍니다.
- API 응답만으로 판단
- 로그인 세션 접근 불가
- 화면 확인은 사람이 대신
- 내 브라우저 로그인 상태 활용
- 검색·클릭·입력을 AI가 수행
- MCP·REPL로 호출
🔍 1. Claude Code만으로는 안 되는 일
AI 코딩 도구로 일하다 보면 코드 수정과 명령 실행은 잘 처리되지만, "내가 로그인해 둔 관리 화면에서 숫자를 가져와 줘" 같은 요청에서 자주 막힌다. Claude Code나 Codex 같은 터미널 기반 도구는 기본적으로 API 응답과 파일 시스템을 다루는 데 강하지만, 브라우저에 저장된 로그인 세션과 화면 상태에는 직접 닿기 어렵다.
오픈소스마케팅(osoma.kr)에 2026년 10월에 공개된 실사용 후기는 이 문제를 잘 보여준다. 광고 성과처럼 API로 바로 가져올 수 있는 데이터조차, 브라우저 자동화 도구가 연결되어 있으면 AI가 "API로 확인해 줘"라는 지시를 무시하고 브라우저부터 열려 한다는 것이다. 도구가 많아질수록 오히려 판단이 흐려지는 셈이다.
반대로 화면을 봐야 하는 작업까지 사람에게 떠넘기면, 코딩 에이전트가 코드는 고쳐 주지만 마지막 한 뼘의 확인은 수동으로 남는다. 이 빈자리를 메우려고 등장한 것이 AI 브라우저 Aside와 그 구성 요소인 aside CLI다. 2026년 8월 스레드에 "문서 링크를 Claude Code에 넣고 설치해 달라고 하면 된다"는 설치 팁이 공유되면서 관심을 모았다.
🧭 2. Aside와 aside CLI, 정확히 무엇인가
Aside는 한국인 창업자 세 명이 실리콘밸리에서 만든 AI 브라우저다. 처음 설치할 때 크롬의 방문 기록과 쿠키를 가져오기 때문에, 광고 관리자나 사내 관리 화면처럼 로그인이 필요한 곳에서도 별도 연동 없이 AI가 작업할 수 있다. 이미 쓰는 Claude Pro/Max, ChatGPT Plus/Pro, GitHub Copilot 구독을 로그인만으로 연결할 수도 있고, 연결하지 않으면 Aside에 포함된 모델이 크레딧을 차감하며 동작한다. 내장 비밀번호 관리자가 로그인 화면을 자동으로 채우되 비밀번호 값 자체는 AI에게 보이지 않는 구조도 특징이다.
중요한 점은 aside CLI가 별도 프로그램이 아니라는 것이다. 공식 개발자 문서(docs.aside.com/help/developers)는 Aside가 CLI, MCP(Model Context Protocol) 지원, 브라우저 자동화 REPL의 세 가지 개발자 인터페이스를 함께 제공한다고 안내한다. 즉 브라우저 앱 하나에 터미널 진입점이 내장된 형태다.
| 구성 요소 | 역할 |
|---|---|
| Aside 브라우저 | 로그인 세션에서 검색·클릭·입력을 수행하는 AI 브라우저 |
| aside CLI | 터미널에서 Aside를 호출하는 명령줄 도구 |
| MCP 지원 | AI 코딩 도구가 Aside를 도구로 연결하는 프로토콜 |
| 브라우저 자동화 REPL | 브라우저 조작을 대화형으로 실행하는 환경 |
이 구조가 Claude Code와 궁합이 맞는 이유는 단순하다. Claude Code는 터미널에서 명령을 받고 MCP 서버를 도구로 연결할 수 있다. aside CLI가 같은 터미널 환경에서 Aside 브라우저를 호출할 수 있다면, 코딩 에이전트가 "이 페이지를 열고, 이 값을 읽어 와"라고 지시할 통로가 생긴다. Aside 도움말에는 사이드 패널, Ultrabrowse, 루틴, 메모리 같은 기능도 함께 안내되어 있어, 브라우저 안에서의 작업 범위가 단발성 클릭을 넘어선다.
⚙️ 3. 설치: 공식 문서 기준
설치의 전제는 Claude Code가 이미 동작하는 환경이다. Claude Code 자체는 네이티브 설치 스크립트로 Node.js 없이 설치할 수 있으며, macOS 13 이상·Windows 10 1809 이상·Ubuntu 20.04 또는 Debian 10 이상, 메모리 4GB 이상이 권장 사양으로 안내된다. 맥에서는 curl -fsSL https://claude.ai/install.sh | bash, Windows PowerShell에서는 irm https://claude.ai/install.ps1 | iex, WinGet 사용자라면 winget install Anthropic.ClaudeCode가 대표적이다.
aside CLI 설치는 이보다 훨씬 단순하다. 공식 문서에 명시된 명령을 그대로 실행하면 된다.
3-1. macOS 설치
macOS에서는 터미널에서 아래 명령 하나로 설치된다.
curl -fsSL https://releases.aside.com/install.sh | bash
설치 후 업데이트가 있는지 확인하려면 터미널에서 aside --update를 실행한다. 터미널 명령이 부담스러운 사용자를 위해 Aside의 개발자 설정 페이지에서도 CLI를 직접 설치·업데이트·재설치할 수 있다.
3-2. Windows 설치
공식 문서에는 macOS·Windows 탭이 나란히 배치되어 있지만, 이번 글의 근거 자료에서는 Windows 전용 설치 명령이 잘려 있어 구체 명령을 확인할 수 없었다. 확인된 범위에서는 개발자 설정 페이지가 OS를 가리지 않고 CLI 설치·재설치를 담당한다는 점까지가 근거다. Windows 사용자는 문서의 Windows 탭을 직접 확인하거나 설정 페이지 경로를 우선 검토하는 것이 안전하다. 확인되지 않은 명령을 추측해서 실행하는 것보다 공식 문서를 다시 여는 편이 낫다.
🔑 4. 로그인: ASIDE_CLI_AUTH_PATH가 핵심
설치가 끝나도 로그인 단계에서 대부분의 사용자가 한 번 막힌다. 문서가 강조하는 것은 자격 증명 저장 경로다.
4-1. 인증 경로 지정
다른 컴퓨터나 에이전트가 호스팅하는 환경에서 CLI에 로그인할 때는 aside login을 실행하기 전에 ASIDE_CLI_AUTH_PATH를 설정해야 한다. 이 값은 디렉터리가 아니라 절대 파일 경로여야 하고, 현재 프로세스가 쓸 수 있는 비공개 저장소에 있어야 하며 이후 명령에서도 계속 사용 가능해야 한다. 부모 디렉터리가 존재하고 쓰기 가능한지 먼저 확인하고, $HOME이 쓰기 가능하다고 가정하지 말라고 문서는 못 박는다.
export ASIDE_CLI_AUTH_PATH="/your/allowed/private/path/aside-auth.json"
aside login --email "[이메일 마스킹]"
PowerShell에서는 환경 변수를 이렇게 지정한다.
$env:ASIDE_CLI_AUTH_PATH = 'C:\your\allowed\private\path\aside-auth.json'
4-2. 기기 승인과 완료 확인
로그인 명령을 실행한 뒤에는 Aside Settings > Account > Devices에서 코드를 승인하고, "Signed in as ..." 메시지가 뜰 때까지 기다려야 한다. 승인이 완료됐다고 자격 증명이 저장된 것은 아니다. 문서는 이 메시지가 뜨기 전까지 후속 작업을 진행하지 말라고 안내한다.
그리고 이 경로는 새 셸이나 에이전트의 도구 호출에서도 동일하게 전달해야 한다. 셸에서 export한 값이 이후 모든 셸에 자동 적용되지는 않기 때문이다.
문서의 보안 지침은 명확하다. 자격 증명 파일을 출력·업로드·커밋·공유하지 말고, 공개·공유·임시 디렉터리에 저장하지 않는다. 자격 증명을 저장할 수 없는 환경이라면 억지로 진행하지 말고 한계를 보고하라고 안내한다.
🔗 5. Claude Code에 연결하는 실제 방법
원글 작성자가 공유한 워크플로는 "Aside 개발자 문서 링크를 Claude Code에 붙여넣고 설치를 요청하는 것"이다. 이 방식이 통하는 이유는 Claude Code가 문서를 읽고 명령을 대신 실행해 주기 때문이다. 사람이 curl 명령을 찾을 필요 없이, 문서 URL 하나가 설치 지시서 역할을 한다.
다만 제공된 공식 문서에는 "Claude Code에 aside CLI를 연동하는" 단계별 설정이 명시되어 있지 않다. 확인되는 것은 Aside가 CLI·MCP·REPL을 제공한다는 사실과, Claude Code가 MCP를 지원한다는 점이다. 따라서 실제 연결은 두 갈래로 정리된다.
- 설치 자동화: Claude Code에 문서 링크를 주고 설치·로그인 명령을 실행하게 한다.
- 런타임 연결: aside CLI를 Claude Code의 MCP 설정 또는 셸 도구로 등록해, 코딩 에이전트가 브라우저 작업을 호출하게 한다.
두 번째 경로의 구체적 설정 파일 형식은 이번 근거 자료에 없으므로, Aside 문서의 MCP 항목과 Claude Code의 MCP 설정 문서를 함께 확인해야 한다. 지어낸 설정을 넣는 것보다 공식 문서 두 개를 대조하는 편이 빠르다. 최gpt(choigpt)의 2026년 10월 세팅 가이드처럼 Aside를 Codex·Claude Code에 연결하는 실사용 사례는 늘고 있지만, 각자 환경에 맞는 설정은 직접 검증이 필요하다.
🆚 6. Playwright MCP·Claude in Chrome과 무엇이 다른가
브라우저를 AI에 붙이는 방법은 Aside만이 아니다. 대표적으로 Playwright MCP와 Claude in Chrome이 있다.
| 방식 | 연결 대상 | 특징 |
|---|---|---|
| Playwright MCP | Claude Code·Codex 등 | 브라우저 창을 띄워 클릭·확인. 로그인 상태는 크롬 확장 설치 필요 |
| Claude in Chrome | 크롬 확장 | 내 크롬에서 탭을 열어 페이지 확인 |
| Aside CLI | Aside 브라우저 | 설치 시 크롬 기록·쿠키를 가져와 로그인 세션 재사용, 내장 비밀번호 관리자 |
핵심 차이는 "어느 브라우저에서 일하는가"다. Playwright MCP와 Claude in Chrome은 기존 브라우저 환경에 도구를 얹는 방식이고, Aside는 AI가 일하는 전용 브라우저 자체를 제공한다. 그래서 광고 관리자처럼 로그인해야 들어가는 화면에서, 별도 세션 이관 없이 작업이 이어지는 것이 장점으로 꼽힌다.
반대로 단점도 있다. API로 금방 얻을 수 있는 데이터까지 브라우저를 먼저 열려는 경향은 도구 선택과 무관하게 생길 수 있고, 자격 증명 파일 관리 책임도 사용자에게 남는다. 어느 쪽이든 "로그인된 내 화면을 AI가 대신 본다"는 점에서는 같은 문제의식에서 출발했다.
⚠️ 7. 주의할 점
첫째, 인증 파일이다. aside-auth.json 같은 자격 증명 파일은 절대 경로를 지정하더라도 비공개·쓰기 가능 위치여야 하고, 공개 저장소나 임시 폴더에 두면 안 된다. 새 셸과 에이전트 호출마다 같은 경로를 전달하는 운영 습관이 필요하다.
둘째, Windows 설치 명령은 미확인이다. macOS용 curl 명령만 문서 본문에서 확인됐으므로, Windows 사용자는 문서의 Windows 탭과 개발자 설정 페이지를 다시 확인해야 한다.
셋째, 도구 우선순위 문제다. Aside를 연결해도 API로 가능한 데이터는 API로 요청하도록 지시하는 습관이 필요하다. 브라우저 도구가 연결되어 있으면 AI가 그쪽을 먼저 쓰는 경우가 보고되고 있다.
넷째, 구독과 크레딧이다. Aside에 별도 AI 구독을 연결하지 않으면 Aside 포함 모델이 크레딧을 차감하며 동작한다. 어떤 구독이 연결되어 있는지, 크레딧이 얼마나 소모되는지 알고 연결하는 편이 좋다.
✅ 8. 정리
aside CLI는 AI 브라우저 Aside에 내장된 개발자 인터페이스로, macOS에서는 curl -fsSL https://releases.aside.com/install.sh | bash 한 줄로 설치하고 aside --update로 업데이트를 확인한다. 로그인은 ASIDE_CLI_AUTH_PATH로 자격 증명 파일 경로를 지정한 뒤 aside login으로 진행하고, Aside Settings > Account > Devices에서 승인해야 완료된다.
Claude Code와의 연결은 문서 링크를 주고 설치를 맡기는 방식에서 시작해, MCP·REPL을 통한 런타임 호출로 확장할 수 있다. 다만 Windows 설치 명령과 Claude Code 전용 연동 설정은 공식 문서에서 추가 확인이 필요하다. 도구를 붙이기 전에 "이 작업이 정말 브라우저를 필요로 하는가"를 먼저 묻는 것이, 비용과 보안 측면에서 가장 안전한 출발점이다.
자주 묻는 질문
Q. aside CLI는 별도로 설치해야 하는 프로그램인가요?
A. 아닙니다. Aside에 포함된 구성 요소로, Aside가 CLI·MCP·브라우저 자동화 REPL을 함께 제공합니다. macOS에서는 curl 설치 스크립트 한 줄로 설치되고, 개발자 설정 페이지에서도 설치·재설치가 가능합니다.
Q. 로그인할 때 ASIDE_CLI_AUTH_PATH는 왜 필요한가요?
A. 자격 증명을 저장할 파일의 절대 경로를 지정하기 위해서입니다. 디렉터리가 아닌 파일 경로여야 하고, 쓰기 가능한 비공개 위치여야 하며, 이후 모든 aside 명령에 동일하게 전달해야 합니다.
Q. Windows에서도 aside CLI를 설치할 수 있나요?
A. 공식 문서에 Windows용 설치 절차가 별도 탭으로 안내되어 있고 개발자 설정 페이지에서 설치·재설치가 가능하다고 확인됩니다. 다만 이번 근거 자료에서는 Windows 전용 명령이 잘려 있어, 문서의 Windows 탭을 직접 확인해야 합니다.
Q. Claude Code와 aside CLI의 연동 절차가 공식 문서에 있나요?
A. 제공된 문서에는 Claude Code 전용 연동 절차가 명시되어 있지 않습니다. 확인되는 경로는 문서 링크를 Claude Code에 주고 설치를 맡기는 방식과, Aside의 MCP·REPL 기능을 코딩 도구의 도구로 연결하는 방식입니다.
원본
https://docs.aside.com/help/developers



댓글 0개