사용 안내
이음을 쓰는 방법
공개 내려받기가 아직 없어요. 이 안내는 macOS 1.0.0 기준이고, 공개 전에 바뀔 수 있어요.
1. 준비
- 공식 사이트에서 BrowserOS를 설치해요.
- 쓰려는 AI의 공식 CLI를 설치하고 본인 계정으로 로그인해요. Codex는
codex login, Claude는claude auth login이에요. - 프로젝트 상태를 보려면 Git이 있어야 해요.
2. 시작
이음을 열면 메뉴 막대의 이음에서 브라우저 열기, 기기 연결, 종료를 쓸 수 있어요. 처음에는 폴더 설정에서 위키와 프로젝트 폴더를 지정해 주세요. 빈 폴더에 가짜 자료를 만들지 않고, 원본도 고치지 않아요.
브라우저는 이음 전용 프로필을 쓰기 때문에 일반 BrowserOS 프로필은 바뀌지 않아요.
3. 질문하기
- 프로젝트를 고르거나 위키 문서를 선택해요.
- 웹페이지 가져오기로 최근 웹 탭의 본문을 첨부해요.
- AI를 고르고 Ctrl/⌘ + Enter로 보내요. 한글을 조합하는 중에는 전송되지 않아요.
질문을 쓰다 멈춰도 로컬 초안으로 남고, 전송에 성공하면 비워져요. 초안에는 첨부한 본문도 포함돼요.
4. 탭과 단축키
- 웹 주소 또는 검색어: 주소를 열거나 Google에서 검색해요. AI 질문은 아래 질문 입력란에서 보내요.
- 열린 탭 / @ 탭 첨부: 제목과 주소로 찾고 전환, 고정, 첨부해요. 한 질문에 웹페이지와 위키를 각각 5개까지 연결해요.
- 바로가기 저장: 새 탭 위쪽에 30개까지 보여요.
- 빠른 실행: Ctrl/⌘ + K로 기능과 최근 작업을 찾아요.
- 패널 열기: 웹페이지 옆에서 이음을 열어요.
- 테마: 자동, 밝게, 어둡게 순서로 바뀌어요.
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에서 받을 수 없어요. 서명 프로필에 등록된 기기에만 설치돼요.
- 컴퓨터와 같은 네트워크에 연결해요.
- 메뉴 막대의 이음에서 연결 코드를 복사해요.
- iOS 앱의 연결 탭에 붙여 넣어요.
연결은 TLS 암호화와 인증서 지문, 개인 연결 코드로 보호해요. 연결 코드는 개인 작업에 접근하는 권한이니 공개하지 마세요.
10. 문제 해결
- AI 연결이 안 돼요
- 터미널에서
codex login status또는claude auth status로 로그인을 확인하고, CLI를 최신 공식 버전으로 올려 주세요. 사용 한도에 닿으면 오류가 표시돼요. - BrowserOS를 찾지 못해요
- 응용 프로그램 폴더에 BrowserOS가 있는지 확인해 주세요.
- iPhone이 연결되지 않아요
- 컴퓨터가 켜져 있고 이음이 실행 중인지 확인해 주세요. 네트워크 주소가 바뀌었다면 이음을 다시 실행하고 새 연결 코드를 붙여 넣어요. 방화벽 안내가 뜰 수 있어요.
- 답변이 글자 단위로 나오지 않아요
- 일부 CLI는 답변 전체를 한 번에 내보내요. 처리 단계는 작업 상세에서 볼 수 있어요.
11. 제거
이음을 종료하고 앱을 휴지통으로 옮기면 제거돼요. 작업 기록까지 지우려면 데이터 폴더를 따로 삭제해야 하고, 복구하기 어려워요. BrowserOS와 AI CLI는 별도 앱이라 자동으로 지워지지 않아요.