내용 업데이트: 2026-10-12crazyrouter-hermes를 사용하면 Hermes Agent를 Crazyrouter를 모델 공급자로 변경할 수 있습니다. 설정이 완료되면 Hermes는
https://api.crazyrouter.com/v1를 OpenAI 호환 endpoint로 이용하고, 한 개의 Crazyrouter API Key로 Claude, GPT, DeepSeek, Gemini, Qwen 등 627개가 넘는 모델에 요청할 수 있습니다.
누구에게 적합한가요
- Hermes Agent 사용자 중 Crazyrouter를 모델 공급자로 사용하고 싶은 분
- 모델과 쿼터를 Crazyrouter로 통합 관리해야 하는 로컬 agent 사용 시나리오
OPENAI_API_KEY,OPENAI_BASE_URL, 기본 모델을 한 번에 설정하고 싶은 분
요구 사항
한 번에 설정하기
- 리눅스 / macOS / WSL2
- Windows PowerShell
- Windows CMD
수동 설정하기
스크립트를 실행하지 않으려면 Hermes를 수동으로 설정할 수 있습니다.환경 변수
~/.hermes/.env를 수정하세요:
기본 모델
~/.hermes/config.yaml를 편집하세요:
default를 Crazyrouter 토큰에 허용된 모델명으로 교체하세요.
모델 전환
설정이 완료되면 Hermes 내에서/model를 통해 모델을 전환할 수 있습니다:
model not allowed 또는 403 메시지가 나오면, 선택한 모델이 현재 Crazyrouter 토큰에서 허용되지 않은 경우가 많습니다.
체크리스트
-
OPENAI_API_KEY가~/.hermes/.env에 있는지, 유효한 Crazyrouter token인지 확인하세요. -
OPENAI_BASE_URL가https://api.crazyrouter.com/v1와 동일한지 확인하세요. -
provider가~/.hermes/config.yaml내의custom와 동일한지 확인하세요. - 기본 모델이 Crazyrouter token에 허용되어 있는지 확인하세요.
- Hermes가 테스트 메시지에 응답하는지 확인하세요.
-
/model gpt-5.5또는 허용된 다른 모델이 정상적으로 전환되는지 확인하세요.
자주 발생하는 문제
crazyrouter-hermes 저장소 열기
설정 스크립트, 수동 설정 예제, 최신 참고사항을 확인하세요.