빠른 시작
설치
다운로드 페이지 또는 GitHub Releases에서 최신 설치 프로그램을 다운로드하세요.
macOS
| 칩 | 파일 |
|---|---|
| Apple Silicon (M1 / M2 / M3 / M4) | AQBot_x.x.x_aarch64.dmg |
| Intel | AQBot_x.x.x_x64.dmg |
.dmg를 열고 AQBot을 응용 프로그램 폴더로 드래그합니다.- AQBot을 시작합니다. macOS가 앱을 차단하면 시스템 설정 → 개인 정보 보호 및 보안으로 이동하여 그래도 열기를 클릭하세요.
macOS: "앱이 손상되었습니다" 또는 "개발자를 확인할 수 없습니다"
이 메시지 중 하나가 표시되면 터미널을 열고 다음을 실행하세요:
xattr -c /Applications/AQBot.app그런 다음 앱을 다시 실행합니다. 이렇게 하면 macOS가 서명되지 않은 다운로드에 적용하는 격리 플래그가 제거됩니다.
Windows
| 아키텍처 | 파일 |
|---|---|
| x64 (대부분의 PC) | AQBot_x.x.x_x64-setup.exe |
| ARM64 | AQBot_x.x.x_arm64-setup.exe |
설치 프로그램을 실행하고 마법사를 따릅니다. 시작 메뉴 또는 바탕 화면 바로 가기에서 AQBot을 시작합니다.
Linux
| 형식 | 아키텍처 | 파일 |
|---|---|---|
| Debian / Ubuntu | x64 | AQBot_x.x.x_amd64.deb |
| Debian / Ubuntu | ARM64 | AQBot_x.x.x_arm64.deb |
| Fedora / openSUSE | x64 | AQBot_x.x.x_x86_64.rpm |
| Fedora / openSUSE | ARM64 | AQBot_x.x.x_aarch64.rpm |
| 모든 배포판 | x64 | AQBot_x.x.x_amd64.AppImage |
| 모든 배포판 | ARM64 | AQBot_x.x.x_aarch64.AppImage |
# Debian / Ubuntu
sudo dpkg -i AQBot_x.x.x_amd64.deb
# Fedora / openSUSE
sudo rpm -i AQBot_x.x.x_x86_64.rpm
# AppImage (모든 배포판)
chmod +x AQBot_x.x.x_amd64.AppImage
./AQBot_x.x.x_amd64.AppImage초기 설정
1. 설정 열기
AQBot을 시작하고 사이드바 하단의 기어 아이콘을 클릭하거나 Cmd/Ctrl+,를 누릅니다.
2. 제공업체 추가
설정 → 제공업체로 이동하여 + 버튼을 클릭합니다.
- 표시 이름을 입력합니다(예: OpenAI).
- 제공업체 유형을 선택합니다(OpenAI, Anthropic, Google Gemini 등).
- API 키를 붙여넣습니다.
- Base URL을 확인합니다 — 내장 유형에는 공식 엔드포인트가 미리 채워져 있습니다. 서드파티 릴레이나 프록시를 사용하는 경우에만 변경하세요.
TIP
원하는 만큼 제공업체를 추가할 수 있습니다. 각 제공업체는 자체 API 키와 모델 세트를 독립적으로 관리합니다.
3. 모델 가져오기
모델 가져오기를 클릭하여 제공업체의 API에서 사용 가능한 모델 목록을 가져옵니다. 필요한 경우 모델 ID를 수동으로 추가할 수도 있습니다.
4. 기본 모델 설정
설정 → 기본 모델로 이동하여 새 대화에서 기본으로 사용할 제공업체와 모델을 선택합니다.
첫 번째 대화
- 사이드바의 새 채팅을 클릭합니다(또는 Cmd/Ctrl+N을 누릅니다).
- 채팅 상단의 모델 선택기에서 모델을 선택합니다.
- 메시지를 입력하고 Enter를 누릅니다.
- AQBot은 실시간으로 응답을 스트리밍합니다. 사고 블록을 지원하는 모델(Claude, DeepSeek R1 등)은 답변 위의 접을 수 있는 섹션에 추론 과정을 표시합니다.
핵심 개념
대화 브랜치
임의의 메시지를 편집하거나 재생성하여 브랜치를 만듭니다. 원래 버전과 새 버전은 같은 대화 트리에 공존합니다 — 각 메시지의 화살표 컨트롤로 탐색할 수 있습니다.
메시지 버전
재생성할 때마다 새 버전이 만들어집니다. 메시지 버블의 ◀ ▶ 화살표로 버전을 전환합니다.
컨텍스트 첨부
파일, 검색 결과, MCP 도구 출력을 대화 컨텍스트에 직접 첨부하여 프롬프트를 풍부하게 합니다.
단축키
다음은 기본 키보드 단축키입니다. 모든 단축키는 설정 → 단축키에서 사용자 지정할 수 있습니다.
| 단축키 | 작업 |
|---|---|
| Cmd/Ctrl+Shift+A | 현재 창 표시/숨기기 |
| Cmd/Ctrl+Shift+Alt+A | 모든 창 표시/숨기기 |
| Cmd/Ctrl+Shift+W | 창 닫기 |
| Cmd/Ctrl+N | 새 대화 |
| Cmd/Ctrl+, | 설정 열기 |
| Cmd/Ctrl+K | 명령 팔레트 |
| Cmd/Ctrl+Shift+M | 모델 선택기 전환 |
| Cmd/Ctrl+Shift+↑ | 마지막 메시지 입력 |
| Cmd/Ctrl+Shift+K | 컨텍스트 지우기 |
| Cmd/Ctrl+Shift+Backspace | 대화 메시지 지우기 |
| Cmd/Ctrl+Shift+G | API 게이트웨이 전환 |
INFO
전역 단축키(창 표시/숨기기)는 AQBot이 백그라운드에 있을 때도 시스템 전체에서 작동합니다. AQBot은 다른 애플리케이션의 단축키와의 충돌을 감지하고 설정에서 경고합니다.
데스크톱 설정
설정을 열어 데스크톱 경험을 구성합니다.
| 설정 | 옵션 |
|---|---|
| 테마 | 다크, 라이트 또는 시스템(자동) |
| 언어 | 한국어, English, 简体中文 |
| 시스템 트레이 | 트레이로 최소화, 트레이로 닫기 |
| 자동 시작 | 컴퓨터 시작 시 AQBot 시작 |
| 항상 위에 표시 | 다른 애플리케이션 위에 창 유지 |
| 프록시 | 호스트와 포트를 지정한 HTTP 또는 SOCKS5 프록시 |
데이터 및 백업
데이터 디렉토리
AQBot은 두 위치에 데이터를 저장합니다:
| 경로 | 내용 |
|---|---|
~/.aqbot/ | 애플리케이션 상태 — 데이터베이스, 암호화 키, 벡터 DB, SSL 인증서 |
~/Documents/aqbot/ | 사용자 파일 — 이미지, 문서, 백업 |
TIP
Windows에서 경로는 %USERPROFILE%\.aqbot\와 %USERPROFILE%\Documents\aqbot\입니다.
자동 백업
설정 → 백업으로 이동하여 자동 백업을 구성합니다:
- 활성화 — 자동 백업 켜기/끄기.
- 간격 — 백업 빈도(시간 단위).
- 최대 수 — 가장 오래된 것이 삭제되기 전에 유지할 백업 수.
- 스토리지 대상 — 로컬 디렉토리(기본값:
~/Documents/aqbot/backups/) 또는 WebDAV 서버.
수동 백업 및 복원
백업 설정 패널에서 언제든지 수동 백업을 만들 수 있습니다. 복원하려면 기록 목록에서 백업을 선택하고 복원을 클릭합니다.
대화 내보내기
사이드바에서 대화를 오른쪽 클릭하여 내보냅니다:
- PNG — 채팅의 렌더링 스크린샷
- Markdown — 헤더, 코드 블록, LaTeX가 포함된 형식
- 일반 텍스트 — 메시지 구분 기호가 있는 간단한 텍스트
- JSON — 전체 메타데이터를 포함한 구조화된 데이터