콘텐츠로 이동

데스크톱 설치 & 문제 해결

Quantiq 데스크톱 앱 설치와 초기 문제 해결 방법을 안내합니다.

설치 방법

다운로드 페이지 접근 (베타)

  • 클라우드 로그인 후 상단 다운로드 탭에서 설치 파일을 받을 수 있습니다.
  • 다운로드 탭은 베타 런타임 allowlist 계정에만 노출됩니다.
  • 로그인하지 않았거나 대상 계정이 아니면 다운로드 페이지에서 안내 메시지가 표시됩니다.
  • macOS/Windows 카드에 표시되는 버전이 현재 배포 버전입니다.

macOS

  1. 다운로드한 .dmg 파일을 더블클릭하여 마운트합니다.
  2. 열린 창에서 Quantiq 아이콘을 Applications 폴더로 드래그합니다.
  3. 마운트된 디스크 이미지를 꺼냅니다 (Finder 사이드바에서 꺼내기).
  4. Launchpad 또는 /Applications 폴더에서 Quantiq를 실행합니다.

Windows

  1. 다운로드한 .exe 설치 파일을 더블클릭합니다.
  2. 설치 마법사의 안내에 따라 진행합니다.
  3. 설치가 완료되면 바탕화면 또는 시작 메뉴에서 Quantiq를 실행합니다.

설치 완료 확인

설치가 정상적으로 완료되었는지 아래 항목을 확인하세요.

  • [ ] 앱이 실행됨 (로딩 화면 또는 로그인 화면이 나타남)
  • [ ] Google 계정으로 로그인됨
  • [ ] 대시보드 화면 진입됨

모든 항목이 확인되면 설치가 완료된 것입니다.

설치 중 보안 경고

베타 빌드는 OS 보안 정책에 따라 처음 실행 시 경고 메시지가 표시될 수 있습니다. 이는 앱 배포사(Quantiq)가 OS 벤더(Apple/Microsoft)에 별도 서명 인증을 아직 완료하지 않아서 발생하는 알림으로, 앱 자체의 결함이 아닙니다. 아래 안내에 따라 진행하면 정상적으로 사용할 수 있습니다.

macOS — "개발자를 확인할 수 없음" 경고

앱 실행 시 차단 경고가 나오면:

  1. 시스템 설정 > 개인정보 보호 및 보안으로 이동합니다.
  2. 하단의 Quantiq 차단 안내에서 확인 없이 열기를 누릅니다.
  3. 앱을 다시 실행합니다.

고급 방법 (터미널)

위 방법이 작동하지 않으면 터미널에서 아래 명령을 실행하세요.

xattr -cr /Applications/quantiq.app
open /Applications/quantiq.app

Windows — SmartScreen 경고

SmartScreen(Windows 보안 필터)은 서명이 없는 프로그램을 처음 실행할 때 경고를 표시합니다.

  1. 경고 창에서 추가 정보를 클릭합니다.
  2. 실행 버튼을 클릭합니다.

계속 차단되면:

  1. 설치 파일을 우클릭 > 속성을 선택합니다.
  2. 하단의 차단 해제 체크박스를 선택 후 확인을 누릅니다.
  3. 설치 파일을 다시 실행합니다.

설치 위치

macOS

  • 설치 파일: .dmg
  • 권장 설치 위치: /Applications/quantiq.app

Windows

  • 설치 파일: .exe
  • 기본 설치 위치: C:\Program Files\quantiq

데이터 저장 위치

앱 설정과 운영 데이터는 설치 폴더와 별도로 사용자 데이터 경로에 저장됩니다.

macOS

  • ~/Library/Application Support/quantiq/runtime

Windows

  • %APPDATA%\\quantiq\\runtime

업데이트/재설치 후 데이터가 비어 보일 때는 설치 폴더가 아니라 위 사용자 데이터 경로를 먼저 확인하세요.

런타임 기동 대기 화면

앱 실행 직후 "런타임 기동 대기 중입니다" 화면이 나타날 수 있습니다.

30초가 지나도 전환되지 않으면 "런타임 기동이 지연되고 있습니다" 메시지와 함께 새로고침 버튼이 나타납니다. 버튼을 눌러 다시 시도하세요.

앱이 시작되지 않을 때

아래 순서로 점검하세요.

  1. 이미 실행 중인 Quantiq 앱이 있는지 확인
  2. 이전 실행이 비정상 종료되어 프로세스가 남아 있는지 확인
  3. 앱 재시작 후 다시 로그인 시도

Google 로그인 오류

로그인 버튼을 눌렀을 때 오류 화면이 반복되면:

  1. 인터넷 연결 상태를 확인합니다.
  2. 앱을 완전히 종료 후 다시 실행합니다.
  3. 다시 로그인해도 동일하면 잠시 후 재시도합니다.

오류가 계속되면 스크린샷과 함께 지원 채널로 문의하세요.

로그 위치

macOS

  • ~/Library/Logs/quantiq/main.log

Windows

  • %LOCALAPPDATA%\\quantiq\\Logs\\runtime.jsonl
  • (구버전 폴백) %APPDATA%\\Quantiq\\runtime를 사용하던 환경은 마이그레이션 상태에 따라 과거 로그가 남아 있을 수 있습니다.

로그인 시 자동 시작

  • 설정 탭 > 자동 시작을 켜면 OS 로그인 시 자동 실행됩니다.

자동 업데이트

앱 시작 시 자동으로 최신 버전을 확인합니다. 새 버전이 있으면 다운로드 후 다음 재시작 시 적용됩니다. 현재 버전과 업데이트 상태는 설정 탭 > 자동 업데이트 섹션에서 확인할 수 있습니다.

다음 단계

설치가 완료됐다면 증권사 계좌를 연결하고 첫 전략을 시작할 수 있습니다.