지원과 자주 묻는 질문

orke은 전용 데스크톱 창을 엽니다. Windows에서는 트레이 아이콘의 「orke 열기」를 누르고, macOS에서는 orke을 다시 실행해 보세요.

「desktop companion unavailable」이 표시되면 데스크톱 구성요소를 시작하지 못한 상태입니다. 이때는 기본 브라우저로 작업 화면을 여는 대체 경로를 사용합니다. 설치한 orke 버전과 오류 문구를 함께 알려 주세요.

데스크톱 창의 ×는 작업 화면을 숨기고, 실행 중인 터미널은 유지합니다. Windows에서 완전히 끝내려면 트레이 아이콘의 「종료」를 누르세요. orke을 종료하면 세션 프로세스도 함께 끝납니다.

작업 공간 안의 웹 창이나 웹 탭을 닫으면 그 페이지는 닫힙니다. 터미널 창 닫기와는 다르게 동작합니다.

새로고침하면 작업 화면의 연결과 창 배치가 다시 만들어집니다. 살아 있는 터미널은 세션 목록이나 Dock 칩에서 다시 열 수 있고, 남아 있는 출력도 돌아옵니다. 웹 페이지가 다시 로드되면 작성 중인 폼과 스크롤 위치는 사라질 수 있습니다.

설정 > 알림의 「알림 상태」 줄이 이유를 말합니다. 흔한 원인은 넷입니다.

• Windows App Runtime 2.4 가 없음 — Windows용 x64 설치기를 받아 설치하세요. macOS에는 필요하지 않습니다.
• 관리자 권한으로 실행함 — 승격되면 알림을 띄울 수 없습니다. 일반 권한으로 실행하세요.
• 앱이 앞에 있음 — 창이 보이면 Windows 알림 대신 앱 토스트가 뜹니다.
• Windows 의 방해 금지 모드 — orke은 알림 차단을 우회하지 않습니다.

Windows 트레이 메뉴에서 20분 일시중지를 고르세요. 그동안 난 사건은 다시 재생하지 않습니다. 완전히 끄려면 설정 > 알림의 첫 스위치를 내리세요.

Docker 호환 엔진이 돌고 있어야 하고, 이 orke이 쓰는 격리 이미지(ghcr.io/bomtobe-hgkim/orke-env)를 받을 수 있어야 합니다. 이미지는 공개라 로그인 없이 받습니다. 설정 > 실행 환경의 「다시 확인」을 누르세요. 컨테이너는 첫 격리 세션이 만듭니다.

격리 계정은 내 PC 계정과 별개이며 격리 볼륨에 저장됩니다. 계정을 추가하기 전에 격리 터미널에 그 CLI를 설치하세요. 설정 > 계정에서 적용 범위를 「격리 환경」으로 두고 추가하세요.

• ChatGPT — 기기 코드 로그인입니다. ChatGPT 보안 설정에서 기기 코드 로그인을 켜 두세요.
• Claude — 인증 코드를 터미널에 붙여 넣습니다. 화면에 안 보여도 Enter 를 누르세요.

칩은 설치된 CLI 의 자격증명으로 남은 양을 묻습니다. 그 CLI 에 먼저 로그인하세요. ORKE_DISABLE_USAGE_PROBE=1 이 설정돼 있으면 칩이 감춰집니다.

격리 환경은 에이전트를 미리 싣지 않습니다. 새 세션에서 에이전트를 고르면 orke이 설치 여부를 확인하고, 없으면 설치 명령과 「터미널에서 설치」를 보여 줍니다. 터미널에 입력된 명령을 확인하고 Enter를 누르세요.

• Claude Code — curl -fsSL https://claude.ai/install.sh | bash
• Codex — curl -fsSL https://chatgpt.com/codex/install.sh | sh
• OpenCode — curl -fsSL https://opencode.ai/install | bash
• Hermes — curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

홈(/home/orke)에 설치한 것은 이미지를 교체해도 남습니다.

네. 격리 환경은 네트워크를 막지 않습니다. 컨테이너 안에서 host.docker.internal로 이 PC의 localhost 서비스(개발 서버 등)에 접속할 수 있습니다. 격리가 막는 것은 이 PC 파일로의 직접 접근입니다. localhost 서비스가 파일이나 실행을 내준다면 그 서비스를 거쳐 이 PC에 닿을 수 있습니다.

이미지를 교체해도 orke은 옛 이미지를 지우지 않습니다. docker image ls ghcr.io/bomtobe-hgkim/orke-env로 태그를 확인하고, 쓰지 않는 태그를 지우세요. 예: docker image rm ghcr.io/bomtobe-hgkim/orke-env:<쓰지 않는 태그>. docker image prune은 태그가 있는 이미지를 지우지 않고, docker image prune -a는 다른 이미지까지 지우므로 권하지 않습니다.

격리 이미지는 이것들을 싣지 않습니다. 격리 터미널에서 sudo apt-get update 뒤 sudo apt-get install로 설치하세요(예: build-essential, fonts-noto-cjk, Playwright는 npx playwright install --with-deps). Hermes 브라우저 도구에 필요한 라이브러리는 npx playwright install-deps chromium으로 설치하세요. /usr에 설치한 것은 이미지를 교체하면 사라지므로 교체 뒤 다시 설치하세요.

격리 이미지는 linux/amd64 하나라 Apple Silicon에서는 에뮬레이션으로 실행하며, 확인하지 않았습니다.

Windows에서 Ctrl+C는 선택이 있을 때만 복사합니다. 선택이 없으면 인터럽트라, 첫 누름은 안내만 띄우고 2초 안의 두 번째 누름부터 보냅니다. 언제나 복사는 Ctrl+Shift+C, 붙여넣기는 Ctrl+V 또는 Ctrl+Shift+V 입니다. macOS에서는 ⌘+C로 선택한 내용을 복사하고 ⌘+V로 붙여넣습니다. Mac의 Ctrl+C는 선택 여부와 관계없이 인터럽트이며 같은 두 번 누름 규칙을 따릅니다.

종료를 시작했지만 결과를 확인하지 못한 상태입니다. orke은 지우지 않고 활성으로 셉니다. 세션 허브에서 「종료 상태 다시 확인」을 누르면 같은 종료를 다시 시도합니다.

Windows는 Microsoft Store에서, macOS 26 이상 Apple Silicon은 DMG 파일로 설치합니다. DMG를 열고 orke.app을 Applications로 드래그하세요. 설치·업데이트 방법은 릴리스 안내에서 확인하세요.

Linux 설치 파일은 제공하지 않습니다. Windows 트레이와 Windows 알림은 macOS에서 제공하지 않습니다.

설정 폴더 ~/.orke과 격리 볼륨 orke-home이 남습니다. 웹 프로필은 선택된 설정 폴더의 desktop/shell에, 방문 기록은 browser에 저장됩니다.

orke을 종료한 뒤 필요한 작업 파일을 보관하고 해당 폴더를 직접 삭제하세요. 격리 환경을 썼다면 컨테이너가 사용하지 않는 상태에서 docker volume rm orke-home을 실행하세요. 다른 브라우저로 orke에 접속했다면 그 브라우저의 기록과 쿠키도 별도로 지울 수 있습니다. 자세한 것은 개인정보 처리방침에 있습니다.

웹 창에서 요소 지시를 열고 대상을 고른 뒤 요청을 적으세요. 보낼 터미널이나 에이전트를 확인해 같은 작업 공간으로 전달합니다. 화면 갈무리도 활용할 수 있으며, 기본 웹 창과 요소 지시에는 Jev 키가 필요하지 않습니다.

Jev는 선택한 에이전트가 맡긴 웹 조작을 같은 페이지에서 이어가는 선택 기능입니다. 설정 > 브라우저에서 TypeSafe API 키를 저장하고 Jev를 켭니다. 기본은 꺼짐이며, 사용할 때 페이지 정보와 작업 목표·입력값이 TypeSafe로 전송됩니다.

키가 없거나 API·할당량 문제로 사용할 수 없으면 진행 상황을 에이전트에 돌려주어 직접 조작을 이어갑니다. TypeSafe의 이용 조건과 요금이 적용됩니다.

웹사이트의 로그인은 해당 서비스 화면에서 직접 진행합니다. orke 웹 창의 쿠키와 로그인 상태는 선택한 웹 프로필에 저장되며, 일반 Chrome의 로그인과 자동으로 공유되지 않습니다. 에이전트 계정 설정과 웹사이트 로그인은 별개입니다.

Claude Code·ChatGPT(Codex)·OpenCode·Hermes는 사용할 CLI와 해당 서비스의 로그인 또는 API 설정을 준비하세요. OpenCode·Hermes의 인증은 각 CLI에서 관리합니다. 일반 터미널은 AI 계정 없이 사용할 수 있습니다.

NVIDIA는 orke에 포함된 에이전트를 사용합니다. 설정 > 계정에서 NVIDIA API 키를 저장하고 새 세션에서 NVIDIA를 고르세요. 모델의 접근 조건과 한도는 NVIDIA 정책을 따릅니다. NVIDIA는 내 PC 환경에서 사용하며, Docker 격리 환경에서는 제공하지 않습니다.

패키지 창에서 지원되는 공급자의 스킬·명령·MCP 등을 확인하고 관리합니다. 내 PC에 Hermes가 설치되어 있으면 같은 창의 「Hermes 예약 작업」에서 작업과 실행 결과를 확인하고, 실행·일시중지 등의 조작을 할 수 있습니다. 예약 작업의 실제 실행은 Hermes가 맡습니다.

PC의 설정 > 다른 기기에서 접속에서 개인 ngrok 계정·연결 도구·할당 주소·Authtoken과 허용할 Google 이메일을 설정하고 접속을 시작하세요. 연결된 공개 주소나 QR로 다른 기기에서 열고 지정한 Google 계정으로 로그인합니다. ngrok의 이용 조건과 한도가 적용됩니다.

PC와 orke이 실행 중이고 인터넷에 연결되어 있어야 합니다. 모바일에서 접속해도 작업은 그 PC에서 실행됩니다.

Google Play의 Android 앱과 App Store의 iPhone 앱을 이용하세요. PC에서 원격 접속을 먼저 켜고 공개 주소를 준비합니다. 모바일 앱은 PC 연결용이며, 폰에서 에이전트를 독립적으로 실행하지 않습니다. 다른 기기의 웹 브라우저로도 접속할 수 있습니다.