AionUI 설정 튜토리얼: NextHub API 연동

AionUI는 오픈소스(Apache-2.0) 그래픽 AI 워크벤치입니다. Claude Code, Codex 등 CLI 에이전트에 통합 그래픽 인터페이스를 제공하는 동시에, LLM 모델을 직접 구성해 대화할 수도 있습니다. 대화와 파일 데이터는 로컬 SQLite 데이터베이스에 저장되며, 사용자의 기기를 벗어나지 않습니다.

연동 단계

1. 다운로드 및 설치

• Windows / macOS: GitHub Releases에서 사용 중인 운영체제에 맞는 설치 파일을 다운로드합니다(.exe / .dmg. macOS는 Intel과 Apple Silicon을 모두 지원합니다)
• macOS(Homebrew):

brew install aionui

• Linux: Releases 페이지에서 .deb 또는 .AppImage를 다운로드하여 설치합니다

2. 커스텀 모델 추가

AionUI를 열고 설정 → LLM 구성 → 모델 추가로 이동한 뒤, 플랫폼에서 커스텀을 선택하고 사용할 채널에 맞춰 입력합니다:

Claude 채널(Anthropic 프로토콜):

필드	입력 내용
API Key	당신의 NextHub ApiKey(Claude 계열 그룹)
API 요청 주소	https://api.nexthub.cc
모델	claude-opus-5-5, claude-fable-5 등

GPT 채널(OpenAI 호환 프로토콜):

필드	입력 내용
API Key	당신의 NextHub ApiKey(GPT-Azure / GPT-Pro 그룹)
API 요청 주소	https://api.nexthub.cc/v1
모델	gpt-5.6, gpt-6-astra 등

Gemini 채널(Google 네이티브 프로토콜):

필드	입력 내용
API Key	당신의 NextHub ApiKey(Gemini-aistudio / Gemini-Vertex 그룹)
API 요청 주소	https://api.nexthub.cc
모델	gemini-3.7-flash, gemini-3.8-flash 등

주소에 /v1을 붙여야 하나요?

Anthropic 프로토콜과 Google 네이티브 프로토콜은 모두 루트 도메인 https://api.nexthub.cc를 입력합니다(인터페이스 경로는 클라이언트가 자동으로 붙임). OpenAI 호환 프로토콜은 https://api.nexthub.cc/v1을 입력합니다. 모델 ID는 채널과 모델과 모델 광장의 실시간 데이터를 기준으로 하세요.

3. 검증

저장한 뒤 메인 화면으로 돌아가 방금 구성한 모델을 선택해 테스트 메시지를 하나 보내고, 응답이 오면 연동에 성공한 것입니다.

더 많은 활용법

AionUI는 다중 세션 병렬 처리, PDF / Word / Excel 등 형식의 미리보기, WebUI 원격 접근 등의 기능도 지원합니다. 자세한 내용은 AionUI 공식 Wiki를 참고하세요.