> ## Content Index
> Fetch the complete content index at: https://blog.sshong.com/llms.txt
> Use this file to discover other available public pages before exploring further.

# 코덱스와 어사이드 CLI 연결하기: 웹 조사에서 문서 작업까지
- URL: https://blog.sshong.com/codex-aside-cli-web-research-writing/
- Published: 2026-10-21T12:51:13.000Z
- Updated: 2026-10-21T12:51:13.000Z
- Description: 어사이드 브라우저의 개발자 설정에서 CLI를 찾고, 코덱스로 공식 웹페이지를 조사해 출처가 있는 블로그 초안과 강의 자료로 이어가는 방법을 정리합니다.
- Author: 홍작가

브라우저에서 공식 안내를 찾고 코덱스(Codex)로 돌아와 내용을 붙여 넣습니다. 출처를 빠뜨렸다면 다시 브라우저를 엽니다. 글이나 강의안을 만들기 전에 자료를 옮기는 일이 반복됩니다.

코덱스와 어사이드(Aside)를 연결하면 웹에서 확인한 내용을 문서 작업으로 이어갈 수 있습니다. 코덱스가 전체 작업을 진행하고, 어사이드는 브라우저에서 필요한 페이지를 확인하는 방식입니다.

## 코덱스의 요청은 어사이드 브라우저까지 어떻게 전달될까

```
사용자
  │ 조사·작성 요청
  ▼
코덱스 ── 어사이드 CLI ── 어사이드 브라우저
  ▲                              │
  └──── 조사 결과·출처 회수 ──────┘
                                 │
                         설정한 AI 모델 제공자
                         예: ChatGPT 구독 연결
```

코덱스는 돌아온 자료를 정리해 원고나 파일을 만듭니다. 어사이드는 사이트를 열어 내용을 확인합니다. CLI(Command-Line Interface)는 코덱스가 어사이드에 명령을 전달하는 통로입니다. 어사이드의 [개발자 안내](https://docs.aside.com/help/developers?ref=blog.sshong.com)는 자연어 명령으로 브라우저 작업을 요청하는 방법을 설명합니다.

그림 아래의 AI 모델 제공자는 별도 설정입니다. ChatGPT 구독을 코덱스에 붙이는 것이 아니라, 어사이드에서 사용할 모델을 고르는 것입니다. [어사이드 모델 안내](https://docs.aside.com/help/ai?ref=blog.sshong.com)에 따르면 어사이드 제공 모델과 지원되는 구독·API 방식을 선택할 수 있습니다. ChatGPT 구독 연결이 CLI 사용의 필수 조건은 아닙니다.

## 어사이드 CLI는 브라우저의 어디에서 찾을까

어사이드 브라우저를 열고 **Settings → Developers**로 이동합니다. 이 개발자 설정에서 CLI의 설치·업데이트 안내와 코딩 도구 연결 방법을 확인할 수 있습니다. 메뉴를 찾기 어렵다면 [어사이드 공식 개발자 문서](https://docs.aside.com/help/developers?ref=blog.sshong.com)의 ‘Install the CLI’를 열면 됩니다. CLI는 웹페이지 안의 대화창이 아니라 터미널에서 실행하는 명령입니다.

공식 문서는 macOS용 설치 명령도 제공합니다. Windows 사용자는 같은 문서의 Windows 탭이나 어사이드의 Settings → Developers에서 설치 절차를 확인합니다.

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

macOS 터미널에서 설치된 명령의 위치를 확인하려면 다음 명령을 실행합니다. 설치 화면에 표시되는 경로와 다르거나 명령이 발견되지 않으면 어사이드의 개발자 설정에서 설치 상태를 다시 확인합니다.

```
command -v aside
```

코덱스가 명령을 실행하는 환경에서도 \`aside\`를 사용할 수 있어야 합니다. 코덱스를 다른 컴퓨터나 호스팅 환경에서 사용한다면 내 컴퓨터에 CLI가 있다는 사실만으로 연결이 완료되지는 않습니다.

처음에는 공식 페이지 하나를 읽는 작은 작업으로 확인합니다.

```
aside "어사이드 공식 개발자 문서를 열고 CLI가 할 수 있는 일을 두 가지로 요약해줘. 확인한 페이지의 URL을 함께 알려줘. 페이지에서 어떤 설정도 변경하지 마."
```

페이지 내용과 URL이 돌아오면 코덱스에서 조사 요청을 해볼 차례입니다. 실행이 막히면 내용을 추측하기보다 CLI 실행 환경과 어사이드의 [접근 권한 설정](https://docs.aside.com/help/security?ref=blog.sshong.com)을 확인해야 합니다.

## 코덱스에서는 출처와 멈출 지점을 함께 요청합니다

첫 프롬프트(Prompt)는 연결 확인에 집중합니다. 아래 내용을 코덱스에 입력하고 공식 페이지 주소와 확인할 항목만 바꿉니다.

```
어사이드 CLI를 사용해 아래 공식 페이지 한 곳을 확인해줘.

확인할 URL: [공식 페이지 URL]
확인할 내용: [기능 또는 이용 조건]

페이지에서 직접 확인한 내용만 3~5문장으로 정리하고,
출처 URL과 확인 날짜를 함께 남겨줘.
찾지 못한 내용은 '미확인'으로 표시해줘.

가입, 결제, 문의 발송, 파일 수정은 하지 마.
어사이드 CLI를 실행할 수 없으면 내용을 추측하지 말고
어느 단계에서 막혔는지 알려줘.
```

여기서 볼 것은 답변의 길이가 아닙니다. 코덱스의 요청이 브라우저까지 전달되고, 어사이드가 확인한 내용과 출처가 다시 돌아오는지가 우선입니다.

## 강의안과 블로그 글에는 비교 기준을 먼저 정합니다

강의 자료를 준비하며 여러 서비스의 기능을 비교한다면, 사이트마다 같은 질문을 해야 합니다. 주요 기능만 모으면 이용 조건과 제한 사항이 빠집니다. 공통 항목으로 조사해야 기존 강의안에서 바꿀 문장도 찾을 수 있습니다.

비교형 블로그 글에는 다음처럼 요청합니다.

```
어사이드 CLI를 사용해 아래 서비스의 공식 사이트를 조사해줘.

대상: [서비스 A], [서비스 B], [서비스 C]
조사 항목: 주요 기능, 이용 조건, 제한 사항
결과물: 같은 항목으로 정리한 비교 자료와 블로그 초안

각 항목에 출처 URL과 확인 날짜를 남겨줘.
공식 페이지에서 찾지 못한 내용은 '미확인'으로 표시하고 추정하지 마.
확인한 사실과 원고의 해석을 구분해줘.
어떤 작업에 어느 서비스를 검토할지 독자가 판단하도록 작성해줘.

가입, 결제, 문의 발송, 외부 게시, 기존 파일 수정은 하지 마.
중요한 수치와 인용문은 원문과 대조할 URL을 남겨줘.
```

강의안이라면 결과물을 ‘서비스별 변경 사항과 기존 강의안에서 수정할 문장 목록’으로 바꾸고, 강의안 파일은 아직 고치지 말라고 지정합니다. 기능, 가격, 이용 한도처럼 바뀔 수 있는 내용은 발행하거나 배포하기 전에 원문과 다시 대조합니다.

고객사 제안서를 준비할 때는 공개된 회사 소개와 제품 정보를 확인하는 데 쓸 수 있습니다. 다만 공개 페이지에 나온 사실과 제안자의 해석은 분리해야 합니다. 직접 만든 강의 신청 페이지라면 화면과 링크를 확인하고 코덱스에서 수정 항목을 정리할 수 있습니다. 어사이드도 [개발자 활용 사례](https://aside.com/blog/developers?ref=blog.sshong.com)에서 화면 확인과 스크린샷을 작업 근거로 가져오는 방식을 소개합니다.

이미 가진 메모를 고치거나 짧은 문장을 다듬는 데는 브라우저 연결이 필요하지 않을 수 있습니다. 웹에서 확인한 내용을 강의안, 블로그 글, 제안서로 계속 옮기고 있다면 공식 페이지 한 곳을 확인해 출처와 함께 초안으로 이어보는 작업부터 시작합니다.