사용 안내

이음을 쓰는 방법

공개 내려받기가 아직 없어요. 이 안내는 macOS 1.0.0 기준이고, 공개 전에 바뀔 수 있어요.

1. 준비

  1. 공식 사이트에서 BrowserOS를 설치해요.
  2. 쓰려는 AI의 공식 CLI를 설치하고 본인 계정으로 로그인해요. Codex는 codex login, Claude는 claude auth login이에요.
  3. 프로젝트 상태를 보려면 Git이 있어야 해요.

2. 시작

이음을 열면 메뉴 막대의 이음에서 브라우저 열기, 기기 연결, 종료를 쓸 수 있어요. 처음에는 폴더 설정에서 위키와 프로젝트 폴더를 지정해 주세요. 빈 폴더에 가짜 자료를 만들지 않고, 원본도 고치지 않아요.

브라우저는 이음 전용 프로필을 쓰기 때문에 일반 BrowserOS 프로필은 바뀌지 않아요.

3. 질문하기

  1. 프로젝트를 고르거나 위키 문서를 선택해요.
  2. 웹페이지 가져오기로 최근 웹 탭의 본문을 첨부해요.
  3. AI를 고르고 Ctrl/⌘ + Enter로 보내요. 한글을 조합하는 중에는 전송되지 않아요.

질문을 쓰다 멈춰도 로컬 초안으로 남고, 전송에 성공하면 비워져요. 초안에는 첨부한 본문도 포함돼요.

4. 탭과 단축키

5. 모델과 구독 사용량

입력창에서 모델과 추론 강도를 골라요. 목록은 설치된 CLI에서 조회하고, 고른 값은 그 질문에만 적용해요. 전역 CLI 설정은 바꾸지 않아요.

구독 사용량에서는 한도별 사용률과 리셋 시각을 볼 수 있어요. 조회에 실패하면 0%로 표시하지 않고 확인 불가로 알려요.

Codex와 Claude 외에 Gemini(Antigravity), Cursor CLI, Grok CLI도 고를 수 있어요. 각 CLI에 먼저 로그인해야 하고, 사용량을 확인할 수 없는 서비스도 있어요.

6. 순차 실행: 계획, 분석, 검토

봇 실행 방식에서 멀티에이전트를 고르면 계획, 분석, 검토 봇이 차례로 실행돼요. 요청 한 번에 AI를 3번 호출하고, 단계마다 구독 사용량을 써요. 실패하면 이후 단계는 실행하지 않고, 중단 지점부터 재개로 완료된 앞 단계를 다시 쓰며 이어 갈 수 있어요.

7. 작업 기록

질문, 답변, 프로젝트 이름으로 전체 기록을 찾고 중요한 작업을 고정해요. 답변은 복사하거나 출처를 포함한 Markdown 파일로 저장할 수 있어요. 완료된 답변을 3개까지 골라 비교하고 종합하는 질문도 만들 수 있어요.

이전 답변 사본은 최신 원문을 다시 조회한 결과가 아니고, 사실로 검증되었다는 뜻도 아니에요.

8. 기억과 작업 방식

기억에는 다시 쓸 사실과 선호를, 작업 방식에는 반복할 절차를 저장해요. 질문할 때 필요한 항목만 골라서 쓰고, 실제로 쓴 내용은 작업 상세에 남아요. 답변에서 초안을 만들어도 확인하고 저장해야 보관함에 들어가요.

9. iPhone · iPad 연결

iOS 앱은 개발 버전이라 App Store에서 받을 수 없어요. 서명 프로필에 등록된 기기에만 설치돼요.

  1. 컴퓨터와 같은 네트워크에 연결해요.
  2. 메뉴 막대의 이음에서 연결 코드를 복사해요.
  3. iOS 앱의 연결 탭에 붙여 넣어요.

연결은 TLS 암호화와 인증서 지문, 개인 연결 코드로 보호해요. 연결 코드는 개인 작업에 접근하는 권한이니 공개하지 마세요.

10. 문제 해결

AI 연결이 안 돼요
터미널에서 codex login status 또는 claude auth status로 로그인을 확인하고, CLI를 최신 공식 버전으로 올려 주세요. 사용 한도에 닿으면 오류가 표시돼요.
BrowserOS를 찾지 못해요
응용 프로그램 폴더에 BrowserOS가 있는지 확인해 주세요.
iPhone이 연결되지 않아요
컴퓨터가 켜져 있고 이음이 실행 중인지 확인해 주세요. 네트워크 주소가 바뀌었다면 이음을 다시 실행하고 새 연결 코드를 붙여 넣어요. 방화벽 안내가 뜰 수 있어요.
답변이 글자 단위로 나오지 않아요
일부 CLI는 답변 전체를 한 번에 내보내요. 처리 단계는 작업 상세에서 볼 수 있어요.

11. 제거

이음을 종료하고 앱을 휴지통으로 옮기면 제거돼요. 작업 기록까지 지우려면 데이터 폴더를 따로 삭제해야 하고, 복구하기 어려워요. BrowserOS와 AI CLI는 별도 앱이라 자동으로 지워지지 않아요.