# 자주 묻는 질문

AQBot이 무엇인지, 데이터를 어떻게 다루는지, 어떻게 시작하는지에 대한 간단한 답변입니다.

Source: https://app.aqbot.top/ko/faq

## AQBot은 무엇인가요?

AQBot은 macOS, Windows, Linux용 무료 오픈소스 AI 데스크톱 클라이언트입니다. 멀티 제공업체 채팅, 에이전트, MCP 도구, 로컬 지식 베이스, 로컬 API 게이트웨이를 하나의 앱에 담았으며, 앱 데이터와 사용자 파일은 사용자의 컴퓨터에 보관됩니다.

## AQBot은 무료인가요?

네. AQBot은 무료로 다운로드하고 사용할 수 있으며, 소스 코드는 AGPL-3.0 라이선스로 GitHub에 공개되어 있습니다. 비용은 직접 연결한 모델 제공업체에만 지불하면 되고, 로컬 모델을 사용하면 비용이 들지 않습니다.

## 어떤 AI 제공업체와 모델을 사용할 수 있나요?

AQBot은 OpenAI, Claude, Gemini, DeepSeek, Qwen은 물론 Ollama 같은 로컬 서버를 포함한 모든 OpenAI 호환 엔드포인트에 연결할 수 있습니다. 제공업체마다 Base URL, API 경로, 헤더, 프록시를 따로 설정할 수 있고, aqbot:// 링크나 CC Switch에서 제공업체를 가져올 수도 있습니다.

## 어떤 운영체제를 지원하나요?

Apple 실리콘 및 Intel 기반 macOS, x64 및 ARM64 기반 Windows 10과 11, 그리고 AppImage, deb, rpm 패키지를 통한 x64 및 ARM64 기반 Linux를 지원합니다.

## AQBot은 데이터를 어디에 저장하나요?

데이터베이스, 암호화 키, 벡터 저장소 같은 앱 상태는 ~/.aqbot에, 이미지, 첨부 파일, 백업은 ~/Documents/aqbot에 저장됩니다. API 키는 로컬 마스터 키를 사용해 AES-256으로 암호화됩니다.

## Claude Code, Codex CLI, Gemini CLI에서 AQBot을 사용하려면 어떻게 하나요?

AQBot에서 API 게이트웨이를 시작하고 게이트웨이 키를 생성하세요. 그러면 빠른 연결이 Claude Code, Codex, OpenCode, Gemini CLI, Cursor에 주소와 키를 대신 기록해 줍니다. 수동으로 설정하려면 Claude Code에 ANTHROPIC_BASE_URL=http://localhost:8080/v1을 지정하고 ANTHROPIC_AUTH_TOKEN을 게이트웨이 키로 설정하면 됩니다.

## AQBot은 MCP를 지원하나요?

네. AQBot은 MCP 클라이언트로서 stdio, SSE, StreamableHTTP로 Model Context Protocol 서버를 실행하며, @aqbot/fetch 같은 내장 도구도 제공합니다. 도구 호출의 최대 라운드 수는 설정에서 바꿀 수 있습니다.

## 채팅 에이전트와 ACP 워크벤치는 무엇이 다른가요?

채팅 에이전트는 AQBot에 설정한 제공업체를 사용해, 선택한 폴더에서 파일을 읽고 수정하며 명령을 실행하고, 승인 모드를 지원합니다. 이 폴더는 작업 시작 디렉터리일 뿐 샌드박스가 아닙니다. ACP 워크벤치는 Codex, Claude Agent, Gemini CLI, Cline, OpenCode처럼 Agent Client Protocol을 지원하는 외부 에이전트를 실행합니다.

## 기존 대화를 가져올 수 있나요?

네. AQBot은 ChatGPT 공식 내보내기, Cherry Studio 백업, Kelivo 백업을 가져올 수 있으며, 미리보기와 경고 표시, 중복 처리를 지원합니다. Cherry Studio와 Kelivo에서 가져올 때는 제공업체, API 키, 첨부 파일도 함께 옮길 수 있습니다.

## 백업은 어떻게 동작하나요?

로컬 폴더, WebDAV 서버, S3 호환 스토리지로 수동 또는 예약 백업과 복원을 할 수 있습니다. 로컬 백업은 기본적으로 ~/Documents/aqbot/backups에 저장됩니다.

## macOS에서 AQBot이 손상되었거나 확인할 수 없다고 나옵니다. 어떻게 해야 하나요?

AQBot은 Apple Developer ID가 아닌 프로젝트 자체 인증서로 서명되어 있습니다. Finder에서 Control 키를 누른 채 AQBot.app을 클릭하고 열기를 선택하거나, 시스템 설정 → 개인정보 보호 및 보안에서 허용하세요. Gatekeeper를 끌 필요는 없습니다.

## 어떤 인터페이스 언어를 지원하나요?

중국어 간체, 중국어 번체, 영어, 일본어, 한국어, 프랑스어, 독일어, 스페인어, 러시아어, 힌디어, 아랍어를 지원합니다.