게이트웨이를 통해 Claude와 함께 사용하는 Hermes Agent: 사용자 지정 제공업체 설정, 비용 관리 및 문제 해결
Hermes Agent는 비밀 정보를 다음에 저장하고 ~/.hermes/.env 그 외 모든 정보는 다음에 저장합니다 ~/.hermes/config.yaml. 게이트웨이를 통해 Claude에서 안정적으로 실행하려면 Anthropic Messages 형식을 사용하는 이름이 지정된 사용자 지정 제공자를 사용하세요. 간편 설정 방식인 provider: anthropic 에 다른 기본 URL을 지정하면 올바르게 보이지만, 인식하지 못하는 호스트의 경우 요청을 Anthropic으로 보냅니다.
설치
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bashiex (irm https://hermes-agent.nousresearch.com/install.ps1)hermes setup 전체 마법사를 실행합니다. hermes model 제공자와 모델만 처리합니다. hermes doctor 기존 설치를 확인합니다.
게이트웨이를 사용자 지정 제공자로 추가하기
AIPRIME_API_KEY=your_gateway_keyproviders:
aiprime:
api: https://aiprimetech.io/v1
key_env: AIPRIME_API_KEY
transport: anthropic_messages
catalog_provider: anthropic
model:
provider: custom:aiprime
default: claude-sonnet-5| 키 | 이유 |
|---|---|
transport: anthropic_messages | Anthropic의 Messages 형식을 사용합니다. 이 설정이 없으면 Hermes는 OpenAI Chat Completions 형식으로 대체합니다 |
key_env | 다음 파일에 있는 변수의 이름: .env 키를 저장하는 변수 |
catalog_provider: anthropic | 게이트웨이의 Claude 모델은 Anthropic의 컨텍스트 및 비전 메타데이터를 상속합니다 |
provider: custom:aiprime | 이름이 지정된 제공자를 선택합니다. /model custom:aiprime:<model> 채팅 중에 전환합니다 |
마법사에서도 같은 방식으로 설정합니다: hermes model, 그다음 **사용자 지정 엔드포인트**, 그다음 API 모드 **Anthropic Messages**를 선택하세요. 대신 Chat Completions를 선택한다면 다음을 유지하세요: /v1 URL에 포함된 상태로.
provider: anthropic에 기본 URL을 지정해도 작동하지 않는 이유
provider: anthropic 및 base_url: https://aiprimetech.io 올바르게 보이지만 효과가 없습니다. 현재 Hermes 소스에서는 내장 Anthropic 제공자의 기본 URL 재정의를 Anthropic, Claude, Azure 호스트에 대해서만 허용하므로, 요청은 여전히 Anthropic으로 전송됩니다. 위의 이름이 지정된 사용자 지정 제공자를 사용하세요.ANTHROPIC_BASE_URL 는 Anthropic 기본 URL을 재정의하는 설정으로 문서에 안내되어 있지만, 아직 해결되지 않은 Hermes 버그로 인해 모델 선택기가 이 설정을 무시합니다. 사용자 지정 제공자를 사용하면 두 문제를 모두 피할 수 있습니다.
토큰 사용량을 늘리는 요인과 이를 제한하는 설정
Hermes는 화면에 보이는 대화 외에도 작업을 실행하며, 별도로 라우팅하지 않으면 모든 작업의 요금이 같은 키에 청구됩니다.
| 사용량 발생 원인 | 다음 설정은 |
|---|---|
| Subagents (delegation) | delegation.max_concurrent_children (기본값 10), delegation.max_iterations (기본값 250), delegation.max_spawn_depth (기본값 1); 더 저렴한 delegation.model |
| 매 턴 이후 백그라운드에서 수행하는 메모리 및 스킬 검토 | auxiliary.background_review.enabled: false, 또는 더 낮은 max_input_tokens |
| 보조 작업(압축, 제목, 비전) | auxiliary.<task>.provider 및 .model 이러한 작업을 더 저렴한 모델로 보내기 위해 |
| 예약 작업 | cron.model 모든 작업에 적용; hermes cron pause <id> 또는 hermes pause |
| 메시징 게이트웨이(Telegram, Discord 등) | 다음과 같은 허용 목록: TELEGRAM_ALLOWED_USERS; 다음은 피하세요: GATEWAY_ALLOW_ALL_USERS=true |
delegation:
max_concurrent_children: 3
model: claude-haiku-4-5
auxiliary:
background_review:
enabled: false
cron:
model: claude-haiku-4-5hermes prompt-size 각 호출에 수반되는 고정 비용을 보여 줍니다. /usage 및 /compress 긴 세션 중에 도움이 됩니다.
키 대신 Claude Pro 또는 Max 계정으로 로그인하기
Hermes는 Claude 계정에 로그인할 수 있지만, 문서에 따르면 이 방식은 추가 사용 크레딧을 구매한 Max 요금제에서만 작동하며 Pro 구독자는 사용할 수 없습니다. 게이트웨이의 API 키를 사용하면 구독에 따른 사용 시간 제한이 없으며, 사용량은 토큰 단위로 잔액에서 차감됩니다.
모델
| 모델 ID | 권장 용도 |
|---|---|
claude-sonnet-5 | 코딩과 에이전트 작업의 기본 선택: 빠르고 성능이 뛰어나며 가격은 중간 수준입니다. |
claude-opus-5-5 | 더 어려운 추론, 대규모 리팩터링, 장시간 에이전트 실행. |
claude-fable-5-1 | 성능이 가장 뛰어나고 가격도 가장 높습니다. 가장 어려운 작업에 사용하세요. |
claude-haiku-4-5 | 저렴하고 빠름: 제목, 요약, 분류, 간단한 단계. |
Hermes에는 최소 64K 토큰의 컨텍스트 윈도우가 필요합니다. 표의 모든 모델이 이 조건을 충족합니다.
문제 해결
| 표시되는 내용 | 원인 | 해결 방법 |
|---|---|---|
| 첫 실행 시 HTTP 400 | 모델 이름이 게이트웨이 모델 ID와 일치하지 않음 | 위 표의 ID를 사용하세요 |
| 요청이 Anthropic으로 전송되거나 Anthropic 인증 오류로 실패함 | provider: anthropic 타사 기본 URL 사용 시 | 이름이 지정된 사용자 지정 공급자를 사용하세요 |
| 의미 없는 응답 또는 빈 응답 | URL에 맞지 않는 전송 방식 | transport: anthropic_messages Claude용 |
| 컨텍스트 길이 초과 | 설정된 컨텍스트 창보다 큰 세션 | 설정할 항목: model.context_length; /compress |
403 Your request was blocked | 엔드포인트 앞단의 방화벽이 클라이언트를 차단함 | 추가 extra_headers 브라우저와 유사한 User-Agent 사용 |
| 업데이트 후 설정 누락 | 설정 스키마 변경 | hermes config check, 그다음 hermes config migrate |
| Telegram 또는 Discord에서 봇이 응답하지 않음 | 게이트웨이가 실행 중이 아니거나 발신자가 허용되지 않음 | hermes gateway status; 확인하세요 ~/.hermes/logs/gateway.log |
에이전트 프레임워크를 비교하고 계신가요? 다음을 참고하세요: OpenClaw 설정 가이드.
자주 묻는 질문
사용자 지정 Claude 엔드포인트와 함께 Hermes Agent를 사용하려면 어떻게 해야 하나요?
Hermes가 Anthropic base_url을 무시하는 이유는 무엇인가요?
Hermes Agent의 토큰 사용량을 줄이려면 어떻게 해야 하나요?
Hermes Agent에서 Claude Pro 구독을 사용할 수 있나요?
API 키를 발급받으세요 — Anthropic 계정이나 대기자 명단 등록이 필요하지 않습니다.
API 키 발급받기AI Prime Tech는 독립적인 API 게이트웨이입니다. Anthropic과 제휴 관계가 없으며, Anthropic의 보증을 받거나 Anthropic의 리셀러로 활동하지 않습니다. Claude 및 관련 모델 이름은 각 소유자의 상표입니다.