데스크톱 앱은 이미 설치된 에이전트를 찾아 각 에이전트에 필요한 설정을 작성하고, 연결을 해제하면 설정을 원래대로 되돌립니다. 출시 기념 프로모션으로 DeepSeek V4.1 Flash 1017을 2주간 50% 할인된 가격에 이용할 수 있습니다.
요약
- AIHubMix Desktop 1.0.0이 macOS 12 이상 및 Windows용으로 출시되었습니다. 700개가 넘는 모델을 하나의 키로 이용하고, 에이전트가 이를 사용할 수 있도록 설정해 주는 앱입니다. 앱은 무료이며, 에이전트 요청 비용은 평소와 마찬가지로 AIHubMix 잔액에서 차감됩니다.
- 컴퓨터에서 이미 사용 중인 에이전트를 검색합니다. 출시 시점에는 Claude Code와 Codex를 포함한 11개 에이전트를 지원하며, 에이전트에 연결하면 각 에이전트에 필요한 설정을 작성합니다.
- 출시 프로모션: 2026년 11월 12일까지 DeepSeek V4.1 Flash 1017을 50% 할인합니다. 입력 토큰 100만 개당 $0.0775, 출력 토큰 100만 개당 $0.31부터 이용할 수 있습니다.
데스크톱 앱이 필요한 이유
코딩 에이전트마다 읽는 설정이 다릅니다. Claude Code는 환경 변수를, Codex는 제공자 블록이 포함된 config.toml을, Gemini CLI는 셸에 입력된 기본 URL과 키를, OpenCode는 JSON을 사용합니다. 각 도구마다 별도의 문서 페이지가 있고 모델 목록을 어디에 넣을지도 제각각입니다. 에이전트 하나를 게이트웨이에 연결하는 데는 10분이면 되지만, 에이전트 네 개를 같은 게이트웨이에 연결하고 버전이 두 번 바뀌는 동안 계속 설정을 유지하는 일은 누구도 일정에 넣지 않는 유지보수 작업입니다.
문제는 조용히 발생하기도 합니다. 에이전트는 계속 응답하지만, 의도하지 않은 제공자를 사용하고 원치 않는 계정으로 비용을 청구할 수 있습니다. 또는 키를 파일에 붙여 넣었다가 나중에 해당 파일이 커밋될 수도 있습니다.
AIHubMix Desktop은 바로 이런 문제를 해결하기 위한 앱입니다. 대화 창이 있는 또 하나의 채팅 클라이언트가 아닙니다. 이미 실행 중인 에이전트를 설정하는 도구입니다.
앱의 실제 기능
검색. 앱을 시작하면 지원되는 에이전트를 검색하고, 각 에이전트의 버전과 설치 경로를 표시한 뒤 설치 상태를 사용할 수 있는지 확인합니다.
연결. 에이전트에 필요한 엔드포인트, 모델 목록, 인증 정보를 작성하고, 설정 파일의 나머지 부분은 그대로 둡니다.
검증. 연결하면 설정 대상 모델마다 소액의 비용이 발생하는 테스트 요청을 보내고, 요청이 실제로 게이트웨이에 도착했는지 확인합니다. 다른 제공자가 응답한 HTTP 200은 검증된 것으로 간주하지 않습니다.
전환. 모델, 기본 모델, 추론 강도, 승인 모드를 파일에서 직접 설정하지 않고 앱에서 변경할 수 있습니다. 추론 수준은 모델별로 필터링됩니다. 즉, 모델이 지원한다고 명시한 수준만 앱에 표시되며, 전체 목록은 모델 페이지에서 확인할 수 있습니다. Codex CLI와 Codex Desktop은 설정 파일을 공유하므로 한쪽에서 변경하면 양쪽에 적용됩니다.
연결 해제. 앱이 작성한 항목만 제거합니다. 해당 파일을 직접 수정한 내용은 그대로 남고 이전 설정은 복원됩니다. 앱이 대체한 내용을 기록하므로 "기억해 둔 설정에서 복원"하는 단계가 필요하지 않습니다.
작업 방식을 나란히 비교해 보면 다음과 같습니다.
| 작업 | 직접 설정 | Desktop 사용 |
|---|---|---|
| 에이전트를 게이트웨이에 연결 | 각 도구의 설정 파일 편집 | 연결 버튼 한 번 클릭 |
| 모델 추가 또는 변경 | 파일 편집 후 재시작 | 앱에서 선택 |
| 추론 강도 | 도구의 유효성 검사를 믿고 기다리기 | 모델별로 수준 필터링 |
| 이전 설정으로 되돌리기 | 이전 값을 기억해 두기 | 연결 해제 시 복원 |
| 키 저장 위치 | 대개 설정 파일 | 운영체제 키체인 |
키는 macOS Keychain이나 Windows Credential Manager에 저장되며, 홈 디렉터리에 있는 일반 텍스트 파일에는 저장되지 않습니다. 수동 설정에서 가장 자주 잘못되는 부분이 바로 이것입니다. 가장 손쉬운 방법이 셸 프로필에 export ANTHROPIC_AUTH_TOKEN=...을 추가하는 것이기 때문입니다.
설치 및 연결
- 최신 릴리스 페이지에서 사용 중인 플랫폼에 맞는 설치 프로그램을 다운로드하세요. macOS는 12 이상이 필요하며, 두 Mac 빌드 모두 서명 및 공증을 거쳤습니다. Windows 설치 프로그램은 아직 Authenticode 서명을 받지 않았으므로 SmartScreen에서 게시자를 확인하라는 메시지가 표시될 수 있습니다. 설치 중 WebView2 런타임을 다운로드하려면 인터넷 연결이 필요할 수 있습니다.
- AIHubMix 계정으로 로그인하세요. 앱은 설정할 에이전트용 클라이언트 키를 보관합니다. 키가 폐기되거나 유출된 경우 앱에서 새 키를 발급한 뒤 연결된 에이전트에 다시 설정할 수 있습니다.
- 연결할 에이전트를 선택한 다음 연결을 누르세요. 설정을 캐시하는 도구는 다시 시작해야 합니다. Claude Desktop은 창만 닫는 것이 아니라 완전히 종료해야 하며, 새 터미널 세션에 변경 사항을 적용하려면 Codex의 백그라운드 서비스에서
codex app-server daemon restart를 실행해야 합니다.
이것으로 설정이 끝납니다. 직접 설정하려는 사용자를 위한 도구별 안내도 계속 제공됩니다. 앱을 사용하든 직접 파일을 작성하든 게이트웨이 작동 방식은 같습니다. Claude Code, Codex, Gemini CLI에는 각각 설정 페이지가 있으며, 앱은 바로 그 설정을 간편하게 처리하는 도구입니다.
지원되는 에이전트 11개
출시 시점에 앱은 Claude Code, Claude Desktop, Codex(CLI와 데스크톱 앱을 함께 관리), Gemini CLI, OpenCode, MiniMax Code, OpenClaw, Hermes, Pi 등 에이전트 11개를 검색하고 설정합니다. 앱에는 컴퓨터에서 실제로 검색된 에이전트만 표시되므로, 설치되지 않은 에이전트는 목록에 나타나지 않습니다.
내부적으로는 두 가지 연결 방식을 지원합니다. 일부 에이전트는 전체 제공자 항목을 사용하므로 모델 목록과 기본 모델을 한곳에서 관리할 수 있습니다. 다른 에이전트는 단일 엔드포인트와 키를 사용하며, 모델은 도구 내에서 선택합니다. 앱은 에이전트마다 두 방식을 구분하므로, 하나를 연결해도 다른 에이전트의 설정은 바뀌지 않습니다. Codex CLI와 Codex Desktop처럼 두 도구가 파일을 공유하는 경우에는 변경 사항을 한 번만 표시하고 양쪽에 적용합니다.
버전 차이는 앱이 예외 없이 처리하지 않는 유일한 경우입니다. Codex CLI와 Codex Desktop 내부의 CLI가 모델 목록을 공유하려면 버전 차이가 크지 않아야 합니다. 두 버전의 차이가 너무 크면 앱은 이전 버전에서 읽을 수 없는 목록을 작성하는 대신 연결을 차단하고 그 이유를 알립니다.
출시 프로모션: DeepSeek V4.1 Flash 1017 반값 할인
출시를 기념해 2026년 11월 12일까지 2주간 DeepSeek V4.1 Flash 1017을 50% 할인합니다. 캐시 읽기를 포함해 두 가격 구간의 요금이 모두 절반으로 내려갑니다.
| 토큰 1M개당 가격 | 정가 | 출시 프로모션 |
|---|---|---|
| 입력, 비혼잡 시간대 | $0.155 | $0.0775 |
| 출력, 비혼잡 시간대 | $0.62 | $0.31 |
| 캐시 입력, 비혼잡 시간대 | $0.0031 | $0.00155 |
| 입력, 혼잡 시간대 | $0.3098 | $0.1549 |
| 출력, 혼잡 시간대 | $1.2392 | $0.6196 |
혼잡 시간대는 UTC 기준 01:00–04:00 및 06:00–10:00이며, 나머지 시간은 비혼잡 시간대입니다. 동일한 엔드포인트의 동일한 모델인 deepseek-v4.1-flash-1017은 1M 토큰 컨텍스트, 최대 393K 출력 토큰, 비전 입력, 도구 호출, 프롬프트 캐싱을 지원합니다.
참고로 DeepSeek의 자체 정가는 비혼잡 시간대에 입력 토큰 100만 개당 $0.15, 출력 토큰 100만 개당 $0.60이며, 혼잡 시간대에는 두 배입니다. 프로모션 기간에는 게이트웨이의 입력 요금이 DeepSeek의 비혼잡 시간대 요금의 약 절반입니다.
프로모션은 입력량이 많은 에이전트를 연결하기에 적절한 기회입니다. 코딩 에이전트를 많이 사용하는 하루를 예로 들어 보겠습니다. 입력 토큰 20M개 중 18M개가 캐시에서 처리되고, 출력 토큰은 2M개인 경우입니다.
정가 기준 하루 비용은 캐시되지 않은 입력에 $0.31, 캐시 읽기에 $0.0558, 출력에 $1.24로 총 약 $1.61입니다. 프로모션 요금으로는 각각 $0.155, $0.0279, $0.62로 총 약 $0.80입니다. 계산에는 위의 토큰당 요금에 이 문단의 토큰 수를 곱했습니다. 실제 비용은 사용자의 입력과 출력 비율에 따라 달라집니다.
연결하기 전에 확인할 사항
- Windows: 아직 Authenticode 서명이 없으므로 SmartScreen 경고가 표시될 수 있습니다. macOS 빌드는 공증을 받았습니다.
- 셸 환경: 터미널에서 에이전트용 기본 URL이나 키를 내보내는 경우, 앱이 작성한 설정 파일보다 환경 변수가 우선 적용되므로 터미널의 설정이 우선합니다. 앱은 이 충돌을 조용히 무시하지 않고 알립니다.
- 기존 대화: 열려 있는 세션에서 선택한 모델이나 추론 수준은 해당 세션에 계속 적용될 수 있습니다. 새 세션에는 새로운 기본값이 적용됩니다.
- Hermes 추론 메뉴: Hermes 자체 메뉴는 모델별로 추론 수준을 필터링할 수 없어 모델이 지원하지 않는 수준도 표시될 수 있습니다. 앱에 표시된 수준을 사용하세요.
- 관리 대상 컴퓨터: 설정 파일이 읽기 전용이거나 관리자 소유인 경우, 앱은 이를 알리고 파일을 변경하지 않습니다.
앱을 다운로드하고 이미 사용 중인 에이전트를 연결한 다음, 가장 많은 입력을 처리하는 에이전트로 프로모션을 이용해 보세요. DeepSeek V4.1 Flash 1017 반값 할인은 2026년 11월 12일에 종료됩니다.
자주 묻는 질문
앱은 무료인가요?
다운로드는 무료입니다. 에이전트 요청은 다른 API 호출과 마찬가지로 일반 토큰당 요금으로 AIHubMix 잔액에서 차감되며, 앱에서 잔액과 오늘 사용 금액을 확인할 수 있습니다.
데스크톱 앱 없이도 사용할 수 있나요?
네. 설정 가능한 모든 에이전트는 문서를 참고해 직접 설정할 수 있습니다. 앱은 설정 변경을 자동화하고 변경한 내용을 기록할 뿐, 게이트웨이를 사용하는 데 필수는 아닙니다.
기존 설정은 어떻게 되나요?
연결하면 게이트웨이에 필요한 항목인 엔드포인트, 모델 목록, 인증 정보만 수정합니다. 파일의 나머지 내용은 그대로 유지됩니다. 연결을 해제하면 앱이 작성한 항목을 제거하고 대체된 값을 복원합니다.
API 키는 어디에 저장되나요?
일반 텍스트 설정 파일이 아니라 macOS Keychain 또는 Windows Credential Manager에 저장됩니다. 키가 폐기되면 앱에서 새 키를 발급하고 연결된 에이전트에 다시 설정할 수 있습니다.
연결했는데도 에이전트가 이전 모델을 사용하는 이유는 무엇인가요?
대부분의 도구는 시작할 때 설정을 읽습니다. 도구를 완전히 종료한 다음 다시 여세요. Claude Desktop은 창을 닫는 것만으로는 충분하지 않습니다.
어떤 에이전트를 지원하나요?
출시 시점에 Claude Code, Claude Desktop, Codex, Gemini CLI, OpenCode, MiniMax Code, OpenClaw, Hermes, Pi를 포함한 11개를 지원합니다. 앱에는 컴퓨터에서 실제로 찾을 수 있는 에이전트만 표시됩니다.
할인은 자동 적용되나요?
네. 모델 ID로 요청하면 코드나 쿠폰 없이 2026년 11월 12일까지 프로모션 요금이 적용됩니다. 해당 날짜 이후에는 정가로 돌아갑니다.
출처
- AIHubMix Desktop 1.0.0 릴리스 노트 — 버전, 플랫폼, 서명, 업데이트 프로그램
- AIHubMix 데스크톱 다운로드 — 설치 프로그램, 지원 플랫폼, 모델 수
- AIHubMix의 DeepSeek V4.1 Flash 1017 — 프로모션 혜택 및 유효 기간을 포함한 사양과 가격
- AIHubMix 문서: Claude Code, Codex, Gemini CLI — 앱에서 설정할 수 있는 에이전트를 수동으로 설정하는 방법
- DeepSeek API 변경 로그 — 공급사에서 사용하는 모델명과 정가
