모델 카탈로그
기준일: 2026-07-26
난이도: 초급
공식 기준: Model Catalog
개요
공식 Model Catalog는 프로바이더 패밀리별 대표 모델 ID, 라우팅 별칭, 선택 시 주의점을 모읍니다. 실시간 가용·가격은 각 프로바이더 콘솔이 권위입니다.
핵심 개념
| 항목 | 설명 |
|---|---|
| Model ID | provider/model 또는 프로바이더 네이티브 ID |
| Alias | hermes model / /model에서 쓰는 짧은 이름 |
| Auxiliary | 비전·압축·제목 생성 등 보조 슬롯 모델 |
| Custom endpoint | provider: custom + base_url |
| Fallback | 주 모델 실패 시 백업 체인 |
상세
카탈로그 사용법
hermes model # 인터랙티브 선택·OAuth·키 입력
hermes chat --model "anthropic/claude-sonnet-4"
hermes chat --provider openrouter
세션 중:
/model
/model provider:model
프로바이더 그룹 (원문 구조 요약)
- 클라우드 게이트웨이: OpenRouter, Nous Portal (다수 모델 단일 키/OAuth)
- 주요 벤더 직접: OpenAI, Anthropic, Google Gemini, xAI 등
- 코딩 플랜/지역 엔드포인트: Alibaba coding plan, Kimi CN, MiniMax CN 등
- 엔터프라이즈 클라우드: Bedrock, Azure Foundry
- 로컬·셀프호스트: Ollama, vLLM, LM Studio, custom
정확한 문자열 ID·지원 기능(도구 호출, 비전, 긴 컨텍스트)은 원문 표와 plugins/model-providers/를 따릅니다.
선택 기준
| 목표 | 힌트 |
|---|---|
| 범용 코딩 | 강한 툴콜·지시 준수 모델 |
| 저비용/대량 | flash/haiku급 + 압축 |
| 로컬 프라이버시 | custom + 충분한 context_length |
| 비전 | 비전 슬롯과 주 모델을 분리 가능 |
컨텍스트 길이
CLI 시작 줄·/usage로 감지값을 확인. 틀리면:
model:
default: your-model-name
context_length: 131072
관련
- Provider Runtime
- Environment Variables
- 프로바이더 추가: developer-guide/adding-providers
체크리스트
- 공식 원문과 명령·설정 키를 대조했다
- 로컬/
config.yaml/.env에서 재현 경로를 확인했다 - 권한·allowlist·시크릿 노출을 점검했다
- 실패 시 롤백·비활성화 방법을 알고 있다
다음 단계
기준일: 2026-07-26 — 공식 문서 동기화 코퍼스