# AQBot — 로컬 우선 AI 데스크톱 클라이언트

> AQBot은 여러 제공자의 채팅, ACP Agent, 지식 베이스, MCP 도구와 API 게이트웨이를 한곳에 모으고 앱 데이터와 사용자 파일을 직접 관리할 수 있게 하는 로컬 우선 데스크톱 AI 작업 공간입니다.

AQBot은 무료 오픈소스 AI 데스크톱 클라이언트입니다. 어떤 제공업체의 모델과도 대화하고, 작업을 에이전트에게 맡기고, 내 문서를 근거로 답변을 받고, 로컬 API 게이트웨이를 통해 코딩 도구와 모델을 공유하세요.

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

## AQBot으로 할 수 있는 일

- **어떤 모델과도 대화**: OpenAI, Claude, Gemini, DeepSeek, Qwen 또는 OpenAI 호환 엔드포인트에 연결하세요. 여러 모델의 답변을 나란히 비교하고, 대화를 분기하고, 메시지 버전을 보관할 수 있습니다.
- **작업을 에이전트에게**: 채팅을 에이전트 모드로 전환하면 작업마다 승인하며 폴더 안의 코드를 읽고, 수정하고, 실행할 수 있습니다. ACP 워크벤치를 열어 Codex, Claude Agent, Gemini CLI 등 ACP 에이전트를 구동할 수도 있습니다.
- **MCP와 Skills로 확장**: stdio, SSE, StreamableHTTP로 MCP 서버를 실행하고, @aqbot/fetch 같은 내장 도구를 사용하며, AQBot, Codex, Claude, Agents의 Skills 폴더를 한곳에서 관리하세요.
- **내 문서를 근거로 답변**: 개인 파일을 로컬 sqlite-vec 지식 베이스에 인덱싱하고, Tavily, Exa, Zhipu, Bocha 웹 검색을 추가하고, 메모리와 파일을 컨텍스트에 첨부하세요.
- **모델을 로컬에서 제공**: 설정한 제공업체를 OpenAI, Claude, Gemini 호환 엔드포인트로 노출합니다. 게이트웨이 키, TLS, 요청 로그, 사용량 통계를 갖춰 Claude Code, Codex CLI 같은 도구에서 사용할 수 있습니다.
- **데이터는 내 컴퓨터에**: 앱 상태는 ~/.aqbot에, 파일은 ~/Documents/aqbot에 저장됩니다. API 키는 AES-256으로 암호화되며, 백업은 로컬 폴더, WebDAV, S3 호환 스토리지에 저장할 수 있습니다.

## 자주 묻는 질문

### 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을 게이트웨이 키로 설정하면 됩니다.

## 다운로드

v0.0.165: https://github.com/AQBot-Desktop/AQBot/releases/tag/v0.0.165