SUPPORT
지원과 자주 묻는 질문
막히면 아래 질문을 먼저 훑어 보세요. 대부분은 설치되지 않은 구성요소 하나가 원인입니다. 안 되면 문의 주소로 알려 주세요.
버전(설정 > 정보), Windows 버전, 어떤 에이전트였는지 적어 주세요.
[문의 이메일]01시작과 창
실행했는데 창이 뜨지 않습니다.
BOM은 설치된 Chrome 또는 Edge 를 제품 창으로 씁니다. 둘 중 하나가 설치돼 있어야 합니다.
이미 BOM이 돌고 있으면 두 번째 실행은 조용히 끝납니다. 트레이 아이콘의 「Bom 열기」로 창을 다시 띄우세요.
창을 닫았는데 앱이 계속 돕니다.
의도한 동작입니다. 창을 닫아도 세션이 끊기지 않도록 데몬은 계속 돕니다. 완전히 끝내려면 트레이 아이콘의 「종료」를 누르세요. 그때 모든 세션 프로세스가 함께 회수됩니다.
새로고침했더니 창이 사라졌습니다.
창 배치는 브라우저 회로와 함께 사라집니다. 세션은 그대로 살아 있습니다. 메뉴바의 「세션 N」 버튼이나 Dock 칩에서 다시 여세요. 스크롤백도 돌아옵니다.
02알림
Windows 알림이 오지 않습니다.
설정 > 알림의 「알림 상태」 줄이 이유를 말합니다. 흔한 원인은 넷입니다.
- Windows App Runtime 2.4 가 없음 — 위의 설치기를 받아 설치하세요.
- 관리자 권한으로 실행함 — 승격되면 알림을 띄울 수 없습니다. 일반 권한으로 실행하세요.
- 앱이 앞에 있음 — 창이 보이면 Windows 알림 대신 앱 토스트가 뜹니다.
- Windows 의 방해 금지 모드 — BOM은 알림 차단을 우회하지 않습니다.
알림을 잠시 끄고 싶습니다.
트레이 메뉴에서 20분 일시중지를 고르세요. 그동안 난 사건은 다시 재생하지 않습니다. 완전히 끄려면 설정 > 알림의 첫 스위치를 내리세요.
03격리 환경과 계정
격리 환경이 「준비되지 않음」입니다.
Docker 호환 엔진이 돌고 있어야 하고, 이미지 ghcr.io/bomtobe-hgkim/bom-env:1.0.0 을 받을 수 있어야 합니다. 이미지는 공개라 로그인 없이 받습니다. 설정 > 실행 환경의 「다시 확인」을 누르세요. 컨테이너는 첫 격리 세션이 만듭니다.
격리 환경에서 로그인은 어떻게 하나요?
격리 계정은 내 PC 계정과 별개이며 컨테이너 안에 저장됩니다. 설정 > 계정에서 적용 범위를 「격리 환경」으로 두고 추가하세요.
- ChatGPT — 기기 코드 로그인입니다. ChatGPT 보안 설정에서 기기 코드 로그인을 켜 두세요.
- Claude — 인증 코드를 터미널에 붙여 넣습니다. 화면에 안 보여도 Enter 를 누르세요.
칩이 「로그인 필요」이거나 보이지 않습니다.
칩은 설치된 CLI 의 자격증명으로 남은 양을 묻습니다. 그 CLI 에 먼저 로그인하세요. BOM_DISABLE_USAGE_PROBE=1 이 설정돼 있으면 칩이 감춰집니다.
04터미널 사용
복사와 붙여넣기가 다르게 동작합니다.
Ctrl+C 는 선택이 있을 때만 복사합니다. 선택이 없으면 인터럽트라, 첫 누름은 안내만 띄우고 2초 안의 두 번째 누름부터 보냅니다. 언제나 복사는 Ctrl+Shift+C, 붙여넣기는 Ctrl+V 또는 Ctrl+Shift+V 입니다.
세션이 「종료 상태 확인 필요」에 머뭅니다.
종료를 시작했지만 결과를 확인하지 못한 상태입니다. BOM은 지우지 않고 활성으로 셉니다. 세션 허브에서 「종료 상태 다시 확인」을 누르면 같은 종료를 다시 시도합니다.
macOS 나 Linux 에서 되나요?
지금은 Windows 만 배포합니다.
05데이터와 제거
앱을 제거하면 무엇이 남나요?
설정 폴더 ~/.bom, 브라우저 프로필 %LOCALAPPDATA%\Bom\browser-profile, 격리 볼륨 bom-home 이 남습니다. 두 폴더를 삭제하고 docker volume rm bom-home 을 실행하세요. 자세한 것은 개인정보 처리방침에 있습니다.
06단축키
07파일 위치
~/.bom/settings.json실행 환경과 알림 설정~/.bom/accounts.json등록한 계정 목록~/.bom/accounts/<에이전트>/<id>추가 계정의 CLI 홈 (자격증명 포함)~/.bom/agents.json에이전트 카탈로그 오버레이 (선택)%LOCALAPPDATA%\Bom\browser-profile제품 창의 브라우저 프로필docker volume bom-home격리 환경의 홈 (/home/bom)