AIHubMix Skill은 AI 코딩 Agent를 위한 로컬 확장 기능입니다. 설치 후 Codex, Claude Code, Cursor, Cline 등 Skills를 지원하는 Agent 안에서 자연어로 AIHubMix 연동, 모델 조회, 기능별 모델 선택, 예제 생성, 오류 진단을 진행할 수 있습니다.
이 Skill은 고정된 모델 목록을 포함하지 않습니다. 필요할 때 AIHubMix 공식 API에서 모델, 가격, 컨텍스트, 프로토콜 계약 등 실시간 정보를 읽어 Agent가 오래된 기억에 의존하지 않도록 합니다.
사용 시나리오
사전 조건
- Codex, Claude Code, Cursor, Cline, Gemini CLI, OpenCode 등 Skills 지원 AI Agent가 하나 이상 설치되어 있어야 합니다.
- 로컬에서 Python 3.8 이상을 실행할 수 있어야 합니다.
- 실제 모델을 호출하려면 AIHubMix API Key를 준비해야 합니다.
- 잔액, Key 목록, 현재 계정에서 호출 가능한 모델을 조회하려면 공식
aihubmix CLI를 추가로 설치하고 로그인해야 합니다.
방법 1: Agent에게 설치 요청
현재 사용하는 AI Agent에게 아래 지시를 전달하세요.
방법 2: 수동 설치
Agent마다 Skills 디렉터리가 다를 수 있습니다. 사용하는 도구가 공유 디렉터리를 쓴다면 해당 Agent의 Skills 문서를 먼저 확인하거나 Agent가 설치 위치를 판단하게 하세요.
선택 사항: AIHubMix CLI 설치
AiHubMixAPI 스크립트는 공개 모델 및 프로토콜 정보를 읽을 수 있습니다. 계정 잔액, Key 관리, 현재 계정에서 실제 호출 가능한 모델은 공식 CLI에 로그인한 뒤 조회해야 합니다.
설치 후 실행합니다.
사용 방법
설치 후에는 보통 명령을 외울 필요가 없습니다. Agent에게 작업을 바로 설명하세요.
Agent가 Skill을 자동으로 호출하지 않으면 명시적으로 호출할 수 있습니다.
명령줄 사용법
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 설명, 채팅 기록에 쓰지 않는 것이 좋습니다. 로컬 디버깅에는 환경 변수를 사용하세요.
관련 리소스
