사용 시나리오
사전 조건
- Codex, Claude Code, Cursor, Cline, Gemini CLI, OpenCode 등 Skills 지원 AI Agent가 하나 이상 설치되어 있어야 합니다.
- 로컬에서 Python 3.8 이상을 실행할 수 있어야 합니다.
- 실제 모델을 호출하려면 AIHubMix API Key를 준비해야 합니다.
- 잔액, Key 목록, 현재 계정에서 호출 가능한 모델을 조회하려면 공식
aihubmixCLI를 추가로 설치하고 로그인해야 합니다.
설치
방법 1: Agent에게 설치 요청
현재 사용하는 AI Agent에게 아래 지시를 전달하세요.방법 2: 수동 설치
선택 사항: AIHubMix CLI 설치
AiHubMixAPI 스크립트는 공개 모델 및 프로토콜 정보를 읽을 수 있습니다. 계정 잔액, Key 관리, 현재 계정에서 실제 호출 가능한 모델은 공식 CLI에 로그인한 뒤 조회해야 합니다.
사용 방법
설치 후에는 보통 명령을 외울 필요가 없습니다. Agent에게 작업을 바로 설명하세요.명령줄 사용법
Skill 디렉터리에서 스크립트를 직접 실행할 수도 있습니다.--lang zh를 추가하거나 다음을 설정하세요.
기능 빠른 참조
FAQ
설치 후 Agent가 자동으로 호출하지 않습니다
Agent마다 Skill 트리거 전략이 다릅니다. 먼저/AiHubMixAPI를 명시적으로 호출하거나 “AIHubMix”, “모델”, “Base URL”, “API Key”, “오류 코드” 같은 키워드를 포함해 더 직접적으로 설명해 보세요.
공개 모델 목록에는 있지만 내 Key로 호출할 수 없습니다
공개 모델 목록은 해당 모델이 플랫폼에 존재한다는 뜻일 뿐, 현재 계정에 권한이나 잔액이 있다는 뜻은 아닙니다.aihubmix models list 또는 candidates --mine으로 계정의 실제 호출 가능 범위를 확인하고, doctor --model <model-id>로 실제 검증하세요.
언제 aihubmix CLI가 필요한가요
공개 정보만 조회할 때는 필요하지 않습니다. 잔액, Key 관리, 호출 가능한 모델, --mine 필터 등 계정 관련 기능을 사용할 때는 CLI 설치와 로그인이 필요합니다.
API Key가 노출되나요
Skill 스크립트는 비밀 값을 마스킹합니다. 그래도 실제 Key를 저장소 파일, Issue, PR 설명, 채팅 기록에 쓰지 않는 것이 좋습니다. 로컬 디버깅에는 환경 변수를 사용하세요.관련 리소스
- Skill 저장소: https://github.com/AIhubmix/skills
- AIHubMix CLI: https://github.com/AIhubmix/platfrom-cli
- AIHubMix 모델 광장: https://aihubmix.com/models